JCL for the LOAD function

Use the LOAD step to reload messages to your shared queues.

The purpose of the LOAD step is to reinsert messages to the shared queues.

You can run the LOAD function in batch mode by submitting a JCL job stream.

Sample JCL to run the LOAD function

The following example shows the JCL that is required to start a LOAD step. Replace the items in lowercase with values that are appropriate for your environment:

//**********************************************************************
//* SAMPLE JCL TO EXECUTE THE LOAD FUNCTION                            *
//**********************************************************************
//LOAD     EXEC PGM=IQCINI0$,
//     PARM='BPEINIT=IQCBINI0,BPECFG=IQCIVPCF,IMSPLEX=IPLEX,QCFIMS=IMS1'
//STEPLIB  DD  DISP=SHR,DSN=hlqual.SIQCLINK
//         DD  DISP=SHR,DSN=IMSREL.RESLIB
//*
//QCFPRINT DD SYSOUT=A
//*
//LOAD     DD DISP=SHR,DSN=QCF.UNLOAD
//*
//* SCRAPLOG IS AN OPTIONAL DD STATEMENT. IT WILL CONTAIN THE 
//* REJECTED MESSAGES FROM THE LOAD STEP. 
//* DCB PARAMETERS SHOULD BE THE SAME AS THOSE FOR THE LOAD 
//* DATA SET.
//* HOWEVER, IT IS RECOMMENDED THAT THE MAXIMUM SIZES FOR LRECL
//* AND BLKSIZE ARE USED.
//*
//SCRAPLOG DD DSN=QCF.SCRAPLOG,UNIT=SYSDA,DISP=(NEW,CATLG),
//         DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VB),
//         SPACE=(CYL,(5,5))
//*
//SNAPDUMP DD SYSOUT=A
//*
//QCFIN    DD DSN=USER.PRIVATE.PROCLIB(load),UNIT=SYSDA 

DD statements for LOAD

STEPLIB DD
Defines the library containing the IMS Queue Control Facility program load modules and IMS libraries that are required for the load step to run. Required.

This DD statement is required.

QCFPRINT DD
Defines the output report data set.

This DD statement is required.

LOAD DD
Defines the input data set. This can be the output from BROWSE or the UNLOAD function.

This DD statement is required.

SCRAPLOG DD
Defines an output data set to receive message records that are rejected in the LOAD step.

This DD statement is optional.

SNAPDUMP DD
Defines an output data set for collecting debugging information.

This DD statement is optional. However, the statement is required if the DEBUG control statement is present.

QCFIN DD
Defines the input control statement data set.

This DD statement is required.

Example of the PROC USER.PRIVATE.PROCLIB(load)

The following example shows the PROC that was specified in the sample JCL, in the QCFIN DD statement as, USER.PRIVATE.PROCLIB(load):

*********************************************************
* load all of the messages in the data set
*********************************************************
function load queuetype=all 
end