Activating tracing

You can declare tracing at the individual function level for a specific job.

All MainView SRM 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:

SET  FUNCTION=DSNCHECK
     ACTIVE=YES
     TRACE=PR44LGX        trace job PR44LGX for DSNCHECK
     MSG=I
     FLST= . . . . . .

Note

The job name that you specify on the TRACE parameter must be exact; name masking does not apply.

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 MainView SRM 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 MainView SRM 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 FLST
The 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.

Activating tracing

Comments