Generating JCLPROC

If you plan to run IMS HP Change Accumulation Utility as a two-step batch job, you must generate the JCLPROC.

Sample JCL for is shown in the following example:

Figure 1. Sample JCL for first step

VIEW        IMSTOOL.HPCA13.SHPCSAMP(HPCSBAT0) - 01.00     Columns 00001 00072
Command ===>                                                 Scroll ===> PAGE
//Jobname              JOB information
//*
//*
//*
//S1        EXEC PGM=HPCABAT0,PARM='hpca-id'
//STEPLIB   DD DISP=SHR,DSN=smphlq.SHPCLMD0
            DD DISP=SHR,DSN=ims.reslib
//RECON1    DD DISP=SHR,DSN=ims.recon1
//RECON2    DD DISP=SHR,DSN=ims.recon2
//*
//SYSOUT    DD SYSOUT=*,BLKSIZE=133
//HPCACTL   DD DISP=SHR,DSN=hpchlq.CONTROL
//HPCPRINT  DD SYSOUT=*
//HPCDBPRT  DD SYSOUT=*                       (optional)
//HPCAPROC  DD DSN=user.dsname,DISP=SHR
//HPCAJLIB  DD DSN=user.dsname,DISP=SHR       (optional)
//*
//GENJCLIN  DD DSN=user.dsname,DISP=SHR
//JCLOUT    DD DSN=user.dsname,DISP=SHR       (optional)
//JCLPDS    DD DSN=user.dsname,DISP=SHR

JCL statement definitions for the first step are as follows:

JOB statement

This is the statement you entered in the Current Environment Data panel.

EXEC statement

HPCABAT0 is the main entry program for this step. hpca-id is a parameter that identifies the IMS HP Change Accumulation Utility ID associated with the IMS system for which the CA is to run.

LIST=n (0,4,8) requests that the DBRC output be included in the IMS HP Change Accumulation Utility report file (HPCDBPRT) for DBRC RC>=n.

MAXLOGS=nnn specifies the upper limit on the number of log files that will be processed. Because a log file on tape can span multiple volumes, the actual number of mount requests might exceed MAXLOGS. Valid values are 1 to 255.

MAXLGRC=nn specifies the final return of the job if log truncation occurs due to the MAXLOGS threshold being met. If MAXLOGS is specified but the MAXLGRC=nn parameter is omitted, the default value for MAXLGRC is 1.

PROC=procname selects standard procedure or AS1 mode. The reserved name HPCSTASK identifies AS1 mode. For any other name, a corresponding member of a system library (IEFPDS,IEFJOBS,PROC00) will be used by the master scheduler to initiate IMS HP Change Accumulation Utility started tasks. HPCAPROC and HPCAJLIB DD's are optional.

SCAN analyzes setup parameters and JCL. Analysis is presented in the IMS HP Change Accumulation Utility Report file HPCPRINT DD. The SCAN reported information is described in SCAN.

STC=procname selects the STC method for JCL processing. The procname names a member of IEFPDSI or IEFJOBS that will be used by the master scheduler to initiate IMS HP Change Accumulation Utility started tasks. The value STC=procname overrides the STC Name= command. STC overrides the standard procedure mode, as well.

STEPLIB DD statement

This DD statement is always included. It defines the IMS HP Change Accumulation Utility program load library. smphql is the high-level qualifier for all IMS HP Change Accumulation Utility product libraries and is determined at installation time.

The data set concatenated to the IMS HP Change Accumulation Utility product library is the DBRC utility program load library. If the data set is not provided, IMS HP Change Accumulation Utility expects the module DSPURX00 (DBRC utility program) to be available through the LINKLST data sets or in the LPALIB.

For DBRC API sequencing, the IMS RESLIB must be included in the IMS HP Change Accumulation Utility JCL.

RECON1 DD RECON2 DD RECON3 DD statements

These statements are present if they are not to be dynamically allocated. If the RECON data sets are to be dynamically allocated, then members for the RECON data sets that were built using the IMS DFSMDA macro must be present in the STEPLIB or in a library in LINKLST or in the LPALIB.

HPCACTL DD statement

This DD statement defines the IMS HP Change Accumulation Utility control data set. hpchlq is the IMS HP Change Accumulation Utility high level qualifier for data sets you provide when invoking ISPF.

HPCPRINT DD statement

This DD statement defines the IMS HP Change Accumulation Utility report data set. This can be SYSOUT or a user-allocated data set. Minimum DCB information is LRECL=133.

HPCDBPRT DD statement

This DD statement defines the IMS HP Change Accumulation Utility data set that will be a copy of the DBRC generated output (SYSPRINT). This can be SYSOUT or a user-allocated data set.

SYSOUT DD statement

This DD statement defines a sequential data set to contain error messages from the HPCABAT0 program. The dsname can be assigned to the JES SPOOL data set and is defined with LRECL=133, blocked or unblocked. You can use any dsname that is approved by your site.

SYSPRINT DD statement

This DD statement defines a sequential data set to contain output listings from the GENJCL procedure. It is defined with LRECL=133, blocked or unblocked. You can use any dsname that is approved by your site.

JCLOUT DD statement

This DD statement defines a sequential data set to contain the generated JCL of the GENJCL procedure. It is defined with LRECL=80, blocked or unblocked. You can use any dsname that is approved by your site.

JCLPDS DD statement

This DD statement defines the skeletal JCL library used by the GENJCL procedure to build the change accumulation JCL. The data set is created when IMS is installed. You should use the data set name that was defined at that time.

(JCLPDS is owned by DBRC and is an integral component of IMS, not IMS HP Change Accumulation Utility.)

GENJCLIN DD statement

This DD statement defines a sequential data set that contains input statements for the GENJCL procedure. This input can contain one or more GENJCL commands. Each command creates the JCL for the change accumulation. IMS HP Change Accumulation Utility processes change accumulation for each CAGROUP in parallel up to the threshold value specified as MAXOUT limit. The remaining are processed after the change accumulation SORT task becomes available.

The order of these commands in the GENJCL in/out stream determines the order in which the CAGROUPS are processed. If you want to process a CAGROUP with the highest priority, then place the GENJCL command for that CAGROUP as the first GENJCL command. It is recommended that CAGROUPS that have a higher number of log records to accumulate be given a higher priority.

HPCAPROC DD statement

This DD statement defines a procedure library that can be used by IMS HP Change Accumulation Utility. If a JOBLIB is not defined through the presence of the HPCAJLIB DD statement, this library must be accessible through the JES startup procedure for starting IMS HP Change Accumulation Utility subordinate address spaces. You can use any dsname that is approved by your site.

HPCAJLIB DD statement

This DD statement defines the JOBLIB into which IMS HP Change Accumulation Utility places the JCL of jobs to start the SORT address spaces.

HPCSYSIN DD statement

This DD statement defines IMS HP Change Accumulation Utility command statements.