The syntax of the TRACE command for tracing the VSAM RLS component
is: TRACE CT,WTRSTART=membername or TRACE CT,WTRSTOP=membername or
TRACE CT,ON|nnnK|nnnM|OFF,COMP=SYSSMS,PARM=CTISMSxx-->
PARM=CTISMSxx identifies the SYS1.PARMLIB
member that contains the tracing options.
The default SYSSMS trace table size is 72KB.
The nnnK or nnnM
keywords can be used to specify trace table sizes of 16–999 KB or
1–2047 MB, respectively.
You are then prompted to specify the trace options to be in effect.
You must respond with the REPLY command, using the following syntax:
REPLYid ,JOBNAME=SMSVSAM ,ASID=(smsvsam-asidlist.) ,OPTIONS=(namename...)
,WTR=procname|DISCONNECT ,END-->
Note: - The id value is the identification number,
0-99, specified on the prompting message.
- The REPLY may be continued on multiple lines; the END must be
given as the final parameter to identify the end of the REPLY.
- Optionally (this is needed only when using CTRACE WRITER) create
a member in SYS1.PROCLIB to allocate a CTRACE WRITER data sets. Refer
to the Using an External Writer to Capture Trace Data section
in the z/OS MVS Initialization and Tuning Reference
for
an example procedure. Note that the name of the procedure is the
name specified when starting the trace writer. For example, to start
the trace writer with a procedure named CTWDASD, issue the following
command:
TRACE CT,WTRSTART=CTWDASD
- When specifying the REPLY command, you should ensure that JOBNAME
and ASID parameters are specified as directed by VSAM RLS support.
Not specifying the JOBNAME and ASID parameters will result in CTRACE
buffers being allocated for all address spaces, which may affect the
operation of those address spaces, as this storage will not be freed
up until end-of-job and end-of-task (EOJ/EOT), with the CTRACE off.
- Do not issue two SYSSMS CTRACE start commands without an intermediate
SYSSMS CTRACE stop command. Two consecutive SYSSMS CTRACE start commands
will result in two sets of CTRACE buffers being allocated for the
jobs and address spaces specified on the JOBNAME and ASID parameters,
which may affect the operation of those jobs and address spaces.
The TRACE and REPLY commands are fully described in z/OS MVS System Commands.