Client trace components

The TRACE parameter specifies the Client components to trace when tracing is enabled.

TRACE=<list>
Description
Specify a comma-separated of all the Client components to trace. The possible components to trace are as follows:
Configuration tool fields ctg.ini file trace parameters Description
  ALL Trace everything
Client API level 1 API Client API layer level 1
Client API level 2 API.2 Client API layer level 1 and 2
CICSCLI command line CLI cicscli command interface
CICSTERM and CICSPRINT EMU cicsterm and cicsprnt emulators
CPP classes CPP C++ class libraries
Client daemon CCL Client daemon
Transport layer level 1 TRN.1 Interprocess communication. The TRN.1 component traces the internal interprocess transport between Client processes. Use it if entries in the Client log refer to functions such as FaarqStart, FaarqStop.
Transport layer level 2 TRN.2 Interprocess communication. The TRN.2 component traces the internal interprocess transport between Client processes. Use it if entries in the Client log refer to functions such as FaarqGetMsg, FaarqPutMsg. TRN.2 is the most verbose tracing component.
Protocol drivers level 1 DRV Protocol drivers, for example, TCP. This traces data sent and received and provides supplementary information about failures.
Protocol drivers level 2 DRV.2 This traces internal flows through the protocol drivers and interactions with other software components. This enhanced tracking level currently has the same functionality as level 1.
Workload manager LMG Workload Manager
You can also use the -m parameter of the cicscli command to specify to specify Client trace components. This overrides any settings in the configuration file. For more information about the cicscli command, see Client daemon administration.

This parameter is in the CLIENT section of the configuration file.

Default value
If you enable tracing without specifying the components in either the cicscli command or in the configuration file, the following set of components are traced:
  • Protocol drivers
  • The Client daemon
  • Client API level 1
  • Transport layer level 1
Configuration Tool
In the Configuration Tool, you can specify the list of Client components using the check boxes in the Client component trace section of the Trace settings page. To find this page, click Options > Trace Settings. Alternatively, you can specify that all the Client components are traced and Gateway daemon tracing is enabled by selecting the Enable Gateway daemon trace and select all component trace modules check box on the same page.