Activating tracing
All
BMC AMI Storage
activity for that function is traced for any job with the specified name. The TRACE action parameter on the function definition SET statement specifies the name of the target job:
ACTIVE=YES
TRACE=PR44LGX trace job PR44LGX for DSNCHECK
MSG=I
FLST= . . . . . .
You can also activate tracing by specifying TRACEDD=ddname in the SMMSYSxx PARMLIB member and including a DD name in the JCL for the job to be traced. All BMC AMI Storage functions are traced for the job step that contains the specified DD name (see Additional-trace-options).
The output of the trace is a series of BMC AMI Storage messages (SMS0042I), which are directed to the job log or TSO user. The following variations of the 042I message are issued:
- Selection start
This message is issued at each SET statement (the beginning of a selection process) and is identified by a question mark as the first character in the text:
SMS0042I TRACE ?SET FLSTThe message text identifies a SET statement and the source (filter list or rule list) of the statement.
- Selection failure
This message is issued for each parameter of each INC or EXC statement that is not satisfied by the current resource. It is identified by a minus sign as the first character in the text:
SMS0042I TRACE - JOB : EMPCRMX = EMPDJE/The message text identifies the selection parameter (JOB, in this example), the current resource name (EMPCRMX), and the parameter value (EMPDJE/).
- Selection success
This message is issued for each parameter of each INC or EXC statement that is satisfied by the current resource. It is identified by a plus sign as the first character in the text:
SMS0042I TRACE + JOB : EMPCRMX = EMPC/The message text identifies the selection parameter (JOB, in this example), the current resource name (EMPCRMX), and the parameter value (EMPC/).
Due to the nature of Data Set Size Assist processing, tracing output from the SPACAQTY function can be found in the user job log, TSO user, and SVOS job log. SPACAQTY tracing displayed in the user job log or TSO user is for FLST processing that determines whether a data set is qualified for Data Set Size Assist processing. SPACAQTY tracing displayed in the SVOS job log is for FLST/RLST processing that determines whether a qualified data set should have its allocation parameters modified.