JCL requirements for Trace Format utility
The following figure shows JCL for executing the Trace Format utility. Member #ARCTRC0 of the sample library contains a sample of this JCL.
Trace Format utility JCL
// CLASS=x,NOTIFY=userid
//*
//ARCTRC EXEC PGM=ARCTRC00,REGION=4096K
//STEPLIB DD DSN=BMC.AES.LOAD,DISP=SHR
// DD DSN=BMC.ARC.LOAD,DISP=SHR
//SYSUDUMP DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//TRACEOUT DD SYSOUT=*
//TRACECOP DD DSN=bmc.arctrcfm.copy,SPACE=(CYL,(1,1)),
// DISP=SHR,DCB=BLKSIZE=32760
//TRACEIN DD DSN=bmc.arctrace.data,DISP=SHR
//*
//SYSIN DD *
control statement
//*
EXEC | (Required) The program name is ARCTRC00. BMC Software recommends a region of at least 4096 KB. |
|---|---|
STEPLIB DD | (Required) Include the AR/CTL execution library in the STEPLIB or JOBLIB concatenation. |
SYSUDUMP DD | (Optional) Include this statement to obtain a system dump in case of an abend. This data set typically is defined as SYSOUT=*. |
SYSPRINT DD | (Required) The Trace Format utility writes messages to this data set. This data set typically is defined as SYSOUT=*. |
TRACEOUT DD | Required for printing trace records. This data set contains the output of the print function. The ddname corresponds to the value of the OUTDD keyword. You can use any ddname; however, if you use any ddname other than the default (TRACEOUT), the OUTDD keyword is required in the SYSIN data set. The output of the print function is a formatted hexadecimal dump or a fully formatted report, depending on the value of the FORMAT keyword. The content of the trace output depends on the type of records (selected with the SUBSYS and PCBNUMBER keywords) and on the subset of data (selected with the DLIDATA keyword). |
TRACECOP DD | Required for copying trace records. This data set contains the output of the copy function. The ddname corresponds to the value of the COPYDD keyword. You can use any ddname; however, if you use any ddname other than the default (TRACECOP), the COPYDD keyword is required in the SYSIN data set. Use the same allocation parameters as those used for the trace data set, as described in Allocating-the-ARCDLTRC-data-set. |
TRACEIN DD | (Required) This data set contains the input records or data to print or copy. The ddname corresponds to the value of the INDD keyword. You can use any ddname; however, if you use any ddname other than the default (TRACEIN), the INDD keyword is required in the SYSIN data set. If AR/CTL allocated the trace data set dynamically during execution of the application program, the data set name of the trace data set is defined by the DSN option in the dynamic allocation record. |
SYSIN DD | (Required) This data set contains the utility control statements. It typically is specified instream, although it can be a data set on DASD. The next section describes the control statements you can include in the SYSIN data set. |