LS_TRC_DOMAIN (Parameter)

Parameter: LS_TRC_DOMAIN

Definition

The tracing domains that will generate additional trace messages

Description and Use

Caution

Do not change the value of this SAP CC system parameter in a productive system landscape, except under the direct supervision of a support specialist from your SAP Support Team, or under specific recommendation provided within the SAP CC documentation.

The generation of trace messages impacts the global performance of the systems and leads to business or technical errors.

Before changing the value of this system parameter, check the severity threshold configured in your SAP CC system.

Recommendation

SAP recommends that you use the default settings in a productive SAP CC Core Server system:

The SAP CC system generates the traces to the destination fileset #2
The trace severity threshold is set to ERROR
No tracing domain is filtered so the system records all the relevant traces

Use the reset command of SAP CC Admin+ to retrieve the factory settings.

This system parameter allows you to filter the trace messages generated by the instances of the SAP CC Core Server system. Only some traces can be excluded from the generation. They are grouped by tracing domains.

Important Note

If no value is set for this parameter, the value of the "ls.trc.domain" system property located in the startup configuration file (jstart.config) of the instance is used instead.
If this system property is not set, the "SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA" value is used instead to disable the domain exclusions.

Tracing Domains

By default, the SAP CC system generates and records the trace messages that relate to all the available tracing domains. This configuration may help your SAP Support Team to troubleshoot problems in your system landscape.

No trace is filtered by using these domains.

Domains and Definitions Domain Codes

Tracing domain for database management SQL

Tracing domains for communications via the following technical interfaces of SAP CC

Message TCP technical interface and its packets over TCP/IP channel: see NET , AK , and HB

Web Services technical interface and its SOAP over HTTP(S) channel: see the WS and WSBUS domains

HTTP Communication Interface (HCI) technical interface and its XML over HTTP(S) channel: see the HCI domain

RFC/JCo (SAP Java Connector) technical interface: see the JCO domain

Tracing domain for barbus message debugging (interinstance communications) MSG

Tracing domain for bulk loading mechanism BLK

Tracing domains for master data management

Data caching: See CACHE

Data locking: See LOCK

Tracing domain for data troubleshooting
Example: rating context data during a charging operation DATA

Other domains:

NOTIF: Tracing domain for system notification management

ADMIN: Tracing domain for system administration management

CIF: Tracing domain for CIF calls; the Charging output Integration Framework (CIF) is configured in the instances of the SAP CC system.

RIF: Tracing domain for RIF calls

SLDDS: Tracing domain for System Landscape Directory Data Supplier

PPI: Tracing domain for the debugging of the SAP Passport Infrastructure

PERF: Tracing domain for performance

Domains and Definitions	Domain Codes
Tracing domain for database management	SQL
Tracing domains for communications via the following technical interfaces of SAP CC	Message TCP technical interface and its packets over TCP/IP channel: see `NET` , `AK` , and `HB` Web Services technical interface and its SOAP over HTTP(S) channel: see the `WS` and `WSBUS` domains HTTP Communication Interface (HCI) technical interface and its XML over HTTP(S) channel: see the `HCI` domain RFC/JCo (SAP Java Connector) technical interface: see the `JCO` domain
Tracing domain for barbus message debugging (interinstance communications)	MSG
Tracing domain for bulk loading mechanism	BLK
Tracing domains for master data management	Data caching: See `CACHE` Data locking: See `LOCK`
Tracing domain for data troubleshooting Example: rating context data during a charging operation	DATA
Other domains: NOTIF: Tracing domain for system notification management ADMIN: Tracing domain for system administration management CIF: Tracing domain for CIF calls; the Charging output Integration Framework (CIF) is configured in the instances of the SAP CC system. RIF: Tracing domain for RIF calls SLDDS: Tracing domain for System Landscape Directory Data Supplier PPI: Tracing domain for the debugging of the SAP Passport Infrastructure PERF: Tracing domain for performance

Syntax and Constraints

The possible values are:

<empty or no value>: The SAP CC Core Server system does not use this parameter when preparing its system configuration. Use "" to set up an empty string. The values of this parameter specify the instance types that do not consider this parameter at startup. When starting, the specified instances read the startup configuration file (jstart.config) instead.
UNSET: The SAP CC system generates no trace associated to a tracing domain. All the domains are excluded in the generated traces.

or a combination of the following domain codes separated with a comma (','):

ADMIN: Tracing domain for system administration management (business operations and technical operations)
AK: Tracing domain for barbus connection keep alive management via the Message TCP technical interface
BLK: Tracing domain for bulk loading mechanism
CACHE: Tracing domain for data caching
CIF: Tracing domain for CIF call debugging and troubleshooting
DATA: Tracing domain for debugging and troubleshooting information that relates to treated data such as the rating context during a charging operation
HB: Tracing domain for the barbus heartbeat management debugging
HCI: Tracing domain for the communications via the public HTTP Communication Interface (HCI) technical interface
JCO: Tracing domain for JCo call debugging and troubleshooting
LOCK: Tracing domain for data locking
MSG: Tracing domain for barbus message debugging
NET: Tracing domain for barbus message handling
PERF: Tracing domain for performance troubleshooting. This domain groups performance specific traces. The recording of traces impacts the global performances of the running SAP CC system. When analyzing the information provided by these traces, consider also the possible side effects introduced by the trace generations; the response times may vary significantly.
PPI: Tracing domain for SAP Passport infrastructure
NOTIF: Tracing domain for system notification management
RIF: Tracing domain for RIF call debugging and troubleshooting
SQL: Tracing domain for database management
SLDDS: Tracing domain for System Landscape Directory Data Supplier
WS and WSBUS: Tracing domains for communications via the public Web Services technical interface
- WS gives the possibility to display the SOAP messages
- WSBUS gives the possibility to display information about the processing of the SOAP messages, such as parsing, validation, authentication, and so on. This tracing domain may lead to the generation of a large number of tracing messages, which can impact the global performance of the systems. It is thus not recommended to enable this domain on a productive landscape, except sporadically during off-peak periods.

The codes must be separated with a comma.

Each tracing domain defines additional trace messages recorded in files specified by the trace destinations.

Use the reset command of SAP CC Admin+ to retrieve the default values (factory settings).

Additional Information

See the LS_TRC_SEVERITY system parameter for more information and user assistance.

Technical Details

For more information, consult this section.

Name

LS_TRC_DOMAIN

The tracing domains that will generate additional trace messages

Category Parameter

Type String

Access (RO/RW)

RW(+): Dynamic Read / Static and Dynamic Write

An immediate change is possible but is temporary. When it is relevant, change the permanent settings used by the SAP CC Core Server system when it restarts.

Use the Admin+ user interface to change the runtime values or the permanent values of this system parameter in an instance of the SAP CC Core Server system or in multiple instances.

Groups

System: Log and Trace Settings

Instance Types

This system parameter is available in the following types of instances in a running SAP CC Core Server system:

rater, updater, guider, bulkloader, taxer, dispatcher

Default Values (Factory Settings)

The predefined default values are:

Instance Type	Value
Rater	`SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA`
Updater	`SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA`
Guider	`SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA`
Bulkloader	`SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA`
Taxer	`SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA`
Dispatcher	`SQL,NET,MSG,HB,AK,BLK,CACHE,LOCK,NOTIF,ADMIN,HCI,WS,WSBUS,CIF,RIF,SLDDS,JCO,PPI,PERF,DATA`

You can use a default value to reset the runtime value or the restart value (persistent) in the Admin+ user interface.

Note

A default value is part of the factory settings of the SAP CC Core Server systems. It differs from the original value set during the installation or after the Customizing activities.

In Admin+, you can reset a parameter value to this default value, but it is not recommended:

This value may differ from the original value set during the installation of your SAP CC system.
Note that it may also differ from the value defined by the implementation project team and set during the Implementation Phase of the integration project.

Verify the values in your running SAP CC systems before to use the reset command.