How to Write the Output File Generated from a Batch Execution of a Migration to a Dataset?

Document ID : KB000024624
Last Modified Date : 14/02/2018
Show Technical Document Details

Question:

How do I write the Output File Generated from a Batch Execution of a Migration to a Dataset to Avoid Filling up the JES Message Spool?

Answer:

To use the .LIST command to write the output to a specific dataset, the following statements need to be added/changed in the JCL that is used:

Add a DDname statement for the output dataset, for example: DDNAME=OUTDD

//OUTDD    DD DSN=hlq.OUTPUT.DATA,
//          UNIT=SYSDA,SPACE=(CYL,(1,5),RLSE),
//          DCB=(LRECL=80,BLKSIZE=3200,RECFM=FB),
//          DISP=(NEW,CATLG,DELETE)

Change the .LIST SYSOUT(*), the default, (which routes the output to the terminal) to .LIST DDNAME(DDname) which references the DDname specified in the dataset allocation step referenced above. Using the example above, the .LIST command would be: .LIST DDNAME(OUTDD).

A partial example of the JCL that shows the output dataset and the .LIST DDname:

//OUTDD    DD DSN=hlq.OUTPUT.DATA,
//          UNIT=SYSDA,SPACE=(CYL,(1,5),RLSE),
//          DCB=(LRECL=80,BLKSIZE=3200,RECFM=FB),
//          DISP=(NEW,CATLG,DELETE)
//SYSUT1   DD UNIT=SYSDA,SPACE=(CYL,(30,30))
//SYSREC   DD UNIT=SYSDA,SPACE=(TRK,(1,1))
//BPIIPT   DD DISP=SHR,
//        DSN=hlq.RCM.BPCODE(DDLIN)
//BPIOPT   DD   *
.CONTROL BPID(hlq.RCM.BPCODE-DDLIN) +
 LOGID(ssid) UNIT(SYSDA)
.LIST DDNAME(OUTDD)
.OPTION   ERRORS   SQLERRORS RETRY(01) NOBINDERRORS    +
   WRAPLINE
.CONNECT ssid

Additional Information::

Batch Processor has a .LIST command that specifies the destination of the audit trail. The batch processor .LIST command which is found in DD BPIIPT creates an audit trail that will consist of error messages, return codes and SQL statements. The output can be the execution of an analysis resulting from a Migration or Compare strategy. The .LIST command can be used to write to other output methods (like a printer or SYSOUT class) as identified in TEC471582. The use of this command makes diagnosing a problem during batch execution easier as the messages and the output will be displayed in the file specified.