CICS VSAM Transparency for z/OS, Version 1.2


Trace parameters

The trace parameters can be specified as SYSIN DD *, or in an 80-byte sequential data set or partitioned data set member. The parameter list has the following format:

TRACE P0n,P0n,DIM=dim-name-1,dim-name2,dim-name-3

TRACE is a required keyword that starts in column 1 and must be followed by a space. The parameter descriptions are as follows:

P0n,P0n
Specify the trace points to be activated. The values are P01 through to P09, except for P02 which is reserved. Separate each trace point with a comma.
DIM=dim-name-1,dim-name-2, dim-name-3
Specify the required DIMs for tracing. Separate each DIM with a comma. You can specify up to a maximum of 10 DIMs. Specify the a read-only DDM module name instead of the DIM name for jobs that use the read-only DDM. Note that the trace records still refer to the DIM name in these circumstances.

You can continue specifying tracing in a second statement if needed. The first statement must end with a comma and the list of DIMs must be continued on the second statement starting in column one as follows:

TRACE P01,P03,P04,P05,P08,P09,DIM=VIDKSDS,VIDKA01,VIDKX02,
VIDKX03,VIDKX04

Optionally, you can trace a subset of calls. This can be useful for tracing batch programs that issue many calls and where you are only interested in specific calls. To trace a subset of calls, add an additional trace input statement after the TRACE statement, as follows:

TRACSET CALLS=nnnn,SKIP=nnnnnn

TRACSET is a required keyword that starts in column 1 and must be followed by a space. The parameter descriptions are as follows:

CALLS=nnnn
Specify four digits defining the number of calls to be traced. Pad with leading zeros.
SKIP=nnnnnn
Specify one to 6 digits defining the number of calls to be skipped before tracing begins. Pad with leading zeros.

The CALLS and SKIP parameters can be used individually but if both are defined, CALLS must come first. Here are some examples:

Example 1

TRACE P01,P03,P04,P05,P08,DIM=VIDKSDS
TRACSET CALLS=0013,SKIP=000007

Example 2

TRACE P01,P03,P04,P05,P07,P08,P09,DIM=VIDKSDS,VIDKX01
TRACSET SKIP=001990




Last updated: February 8, 2013 20:43:1