The following sections describe the CICSPlex® SM trace facilities and the type of information they provide about CMASs and MASs.
The CICS® internal trace facilities must always be active in a CMAS.
When a CMAS is initialized, CICSPlex SM ensures that the CICS trace facility is active and the trace table is large enough. The trace table settings required by the CMAS, along with the CICS SIT options that you need to use in order to establish these settings, are in Table 2:
Trace variable | Required setting | CICS SIT option |
---|---|---|
Internal trace | On | INTTR=ON |
Trace table size | 2MB | TRTABSZ=2048 |
Master trace | Off | SYSTR=OFF |
User trace | On | USERTR=ON |
If the CICS trace facilities cannot be activated with these settings, CMAS initialization is canceled and you receive an error message.
Additionally, the CICS AUXTRACE facility should be active (for user records only) in a CMAS. If this facility is not active when a problem occurs, it may be necessary to recreate the problem with the facility turned on.
The CICS trace facilities do not have to be active in a MAS. Provided CICSPlex SM communication facilities are available, MAS trace records are sent to a connected CMAS for recording; the only exceptions are trace records written for the CICSPlex SM communication facility itself. If communication is not available, or if you are diagnosing a problem in the MAS, you may need to activate CICS tracing in the MAS.
Each CMAS and MAS component can make use of three types and up to 32 levels of tracing.
Standard trace points are designed to track the normal processing path of a component. There are two levels of standard tracing, level 1 and level 2. Trace points of this type are provided by every CMAS and MAS component. However, standard tracing is not normally active because it can cause additional overhead.
Level 1 and 2 trace points should be activated only for a specific CMAS or MAS component and only at the request of customer support personnel.
Level 1 trace points are used for:
Level 2 trace points provide information to supplement a level 1 trace and they require level 1 tracing to be active for the same component. Level 2 trace points are used for:
Special trace points can be used by a component for special-purpose traces that are unique to its situation. Each CMAS and MAS component has levels 3 through 32 available for special tracing. These trace levels provide detailed internal information about the component. For example, trace level 16, called a timing trace, is used by some components to record how long a request took to complete. This type of trace data can be used to evaluate the performance of a component under specific conditions.
Level 3-32 trace points should be activated only for a specific CMAS or MAS component and only at the request of customer support personnel.
Exception tracing is always performed by each CMAS and MAS component when it detects an exceptional condition. The goal of this type of trace is first failure data capture, to capture data that might be relevant to the exception as soon as possible after it is detected. All CMAS and MAS errors result in an exception trace entry. Exception tracing cannot be disabled and all exception trace points are always active.
[[ Contents Previous Page | Next Page Index ]]