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