CANCEL job step

Use the CANCEL job step to select (from the SELECT job step) just those messages that have not been successfully processed by IMS.

The CANCEL job step is run between the SELECT and LOAD job steps in the RECOVERAB procedure.

The purpose of the CANCEL step is to select specific output from the SELECT job step. That output includes only those messages that have not been successfully processed by IMS.

Example: CANCEL job step JCL

The following example shows sample JCL to run the CANCEL job step.

 
//*******************************************************************
//*                                                                 *
//*              CANCEL JOB STEP                                    *
//*                                                                 *
//*******************************************************************
//CANCEL  EXEC PGM=IQCCANCL,COND=((0,NE,SELECT),(0,NE,SORTA)),
//             REGION=0M
//STEPLIB  DD  DISP=SHR,DSN=hlqual.SIQCLINK
//CANCLIN  DD  DISP=(OLD,DELETE),DSN=*.SORTA.SORTOUT
//CANCLOUT DD  DSN=QCF.CANCLOUT,UNIT=SYSDA,DISP=(NEW,PASS),
//         DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VB)
//SCRAPCAN DD  DSN=QCF.SCRAPCAN,UNIT=SYSDA,DISP=(NEW,CATLG),
//         DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VB)
//QCFPRINT DD  SYSOUT=A
//SNAPDUMP DD SYSOUT=A
//*

DD statements for CANCEL job step

STEPLIB DD: Defines the library containing the IMS Queue Control Facility program load modules. Required.
CANCLIN DD: Defines the input data set, which was the output from the SELECT job step and sorted by the SORTA job step. Required.
CANCLOUT DD: Defines the output data set, which will contain the message records to be passed (through the SORTB job step) to the LOAD step for reinsertion into the IMS message queue. Required.
SCRAPCAN DD: Defines an output data set for collecting message records rejected by the CANCEL job step. Optional.
QCFPRINT DD: Defines the output report data set. Required.