Batch mode

Use the sample JCL shown in Figure 1. Lowercase indicates required variable information. The actual JCL is determined by your installation. For example, A has been defined as a printer in the sample installation, and SYSOUT=A directs output to it. Similarly, the sample JCL assumes that all input data sets have been cataloged.

Modify the JCL by including appropriate DD names. Even though all DD names shown are not required for all runs, you might want to list them to avoid changing your JCL when you change parameters. The record format for the output data sets can be variable or variable blocked (RECFM=V or RECFM=VB).

Figure 1. Sample JCL for VIT analysis

  //jobname  JOB (account),'user name',etc.
  //ISTRAFT1 EXEC PGM=ISTRAFT1,REGION=0K
  //STEPLIB  DD DSN=SYS1.MIGLIB,DISP=SHR
  //SUMMARY  DD SYSOUT=A,DCB=(RECFM=V,LRECL=84)
  //DETAILS  DD SYSOUT=A,DCB=(RECFM=V,LRECL=84)
  //LOG      DD SYSOUT=A,DCB=(RECFM=V,LRECL=124)
  //OUTSTAN  DD SYSOUT=A,DCB=(RECFM=V,LRECL=124)
  //VITEXT   DD SYSOUT=A,DCB=(RECFM=V,LRECL=124)
  //PARM     DD DSN=userid.run1.parm,DISP=SHR
  //TRACE    DD DSN=userid.run1.trace,DISP=SHR

As shown in Figure 1, the JCL contains the following DD names:

SUMMARY is required and specifies where the output summarizing the trace is directed.
DETAILS is required only for storage analysis and RU counting. It specifies where details of the trace analysis are directed.
LOG is required. It specifies where VIT entries with possible errors are directed.
OUTSTAN is required only for storage analysis of outstanding entries. It specifies where the list of outstanding GBLK, VTAL, and REQS entries is directed.
VITEXT is required only for VIT extraction. It specifies where the VIT entries extracted from the trace are directed.
Note: Only the FORMAT and NOFORMAT output options should be used when directing VITEXT output to a printer as shown in Figure 1. VITEXT output using TRACEFORMAT should be directed to disk or tape.

For VITEXT output using TRACEFORMAT, the record length must be the length of the TRACE record or 284, whichever is smaller.
PARM is required and specifies the parameters to be passed to the VIT analysis tool. Parameters can be specified in-stream (in the JCL) or in a data set; do not use the PARM parameter on the EXEC statement for this purpose because of size restrictions. The PARM data set must have fixed records (can be blocked) with:
- LRECL=80
- RECFM=FB
TRACE is required and specifies the input data set containing the trace to be processed. The TRACE DCB information must match the actual data set characteristics. The record format can be V, VB, or VBA.