Specifying the trace components

Use the cicscli command plus options to specify which client components to trace.

The format of the command is:Start of change
cicscli -m[=components]
End of change where [components] is a comma-separated list of component identifiers for the components to be traced.
For example:
cicscli -m=TRN,API.2

where TRN, API.2 specifies that tracing is performed on the internal interprocess transport between Client processes, and on the client API layer levels 1 and 2.

To display the list of components set enter the command:
cicscli -m 
The following component identifiers are available for use with the cicscli -m command:
Identifier Trace
ALL All components. Use this option if performance allows, and consider using the binary formatting tool to filter information. For more information see Formatting the binary trace file.
API Synonymous with API.1.
API.1 The client API layer level 1. This traces the boundary between the Client application and the Client daemon.
API.2 The client API layer level 1 and 2. This gives level 1 plus additional parameter tracing.
CCL The Client daemon.
CLI The cicscli command interface.
CPP The C++ class libraries.
DEF The default components, that is the API, CCL, DRV and TRN components.
DRV Synonymous with DRV.1.
DRV.1 Protocol driver tracing level 1. This traces data sent and received and provides supplementary information about failures.
DRV.2 Protocol driver tracing level 2. This traces internal flows through the protocol drivers and interactions with other software components.
EMU The cicsterm and cicsprnt emulators.
LMG The Workload Manager
TRN Synonymous with TRN.1.
TRN.1 Internal interprocess transport between Client processes level 1.
TRN.2 Internal interprocess transport between Client processes level 2. Use if entries in the Client log refer to functions such as FaarqStart, FaarqStop, FaarqGetMsg or FaarqPutMsg.
The -m option specifies the components to trace. To turn tracing on use the -d option. Consider using wrapping trace (-b option) for improved performance: Start of change
cicscli -m=<components> -d -b
End of change

If you specify -m with no parameters, a list of the possible component identifiers is displayed, with an "x" for each component that it is currently enabled for tracing.

You can also specify settings for trace components using the Configuration Tool. For more information see Configuring trace settings. Component tracing specified using cicscli overrides component tracing specified using the Configuration Tool. If component tracing is not specified either by the cicscli command or by using the Configuration Tool, these default components are traced: API, CCL, DRV and TRN.


Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/ntopvdz.html