Sample extended batch JCL

Sample JCL for running the extended batch mode is shown in the following example.

Figure 1. Sample JCL for running the extended batch mode

//JOBNAME job JOB INFORMATION
//*
//*
//*
//S1       EXEC PGM=HPCAMAIN,PARM='hpca-id,LIST'
//STEPLIB  DD  DISP=SHR,DSN=smphlq.SHPCLMD0
//         DD  DISP=SHR,DSN=imsvs.17ists27.creslib
//RECON1   DD  DISP=SHR,DSN=hpca.ims.recon1
//RECON2   DD  DISP=SHR,DSN=hpca.ims.recon2
//*
//HPCACTL  DD  DISP=SHR,DSN=hpchlq.CONTROL
//HPCPRINT DD SYSOUT=*
//HPCDBPRT DD SYSOUT*
//HPCMSG00 DD SYSOUT=*
//SYSPRINT DD DSN=dsname,DISP=SHR
//JCLOUT   DD DSN=dsname,DISP=SHR
//JCLPDS   DD DSN=dsname,DISP=SHR
//GENJCLIN DD DSN=dsname,DISP=SHR
//SYSOUT   DD DUMMY,LRECL=133
//HPCAPROC DD DSN=dsname,DISP=SHR
//HPCAJLIB DD DSN=dsname,DISP=SHR
//HPCSYSIN DD *

    Parallel Logs = 4
   Parallel Sorts = 6

      Sort.Filsz = 1000000

         CA.Space = CYLS
        CA.Primary = 100
       CA.Secondary = 100
      CA.Unit Count = 2

     GEN.GENJCL = MEMBER(CAJCLTST)
     GEN.GENJCL = DEFAULT(KEYR819C)
     GEN.GRPNAME = CAGRP1
     GEN.GRPNAME = CAGRP42
     GEN.GRPNAME = CAGRP50
     GEN.GRPNAME = CAGRP51
     GEN.GRPNAME = CAGRP52
     GEN.GRPNAME = CAGRP53

/*

where:

JOB statement

Specifies a valid JOB statement

EXEC statement

HPCAMAIN is the extended batch program name.
hpca-id is the optional 1-to-4 character identifier that IMS HP Change Accumulation Utility uses as the prefix for members of the IMS HP Change Accumulation Utility control file and PROCLIB. This parameter value overrides the id= command value from HPCSYSIN. The default is IMS HP Change Accumulation Utility.
LIST/NOLIST are optional keywords to include or exclude the command lines listing in the IMS HP Change Accumulation Utility report. This parameter value overrides the LIST/NOLIST commands from HPCSYSIN. If both are provided, NOLIST overrides LIST. The default is NOLIST.
WARN=action is described under the GEN.WARN command later in this topic. The WARN= parameter overrides the value specified in GEN.WARN.
SCAN analyzes setup parameters and JCL. Analysis is presented in the IMS HP Change Accumulation Utility Report file HPCPRINT DD.
The optional PROC= parameter selects the standard procedure or AS1 method for JCL processing. The reserved name HPCSTASK indicates AS1 mode. For any other name, the name must be a member of the concatenation DD IEFPDSI of the master scheduler, DD IEFJOBS of the master scheduler, or DD PROC00 of the active JES.
The optional STC= parameter selects the STC method for JCL processing. The STC parameter overrides the STC NAME= command and also the standard procedure method.

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 either the LINKLST or in the LPALIB.

HPCACTL DD statement (optional)

This DD statement defines the IMS HP Change Accumulation Utility control data set that is used for communicating between the IMS HP Change Accumulation Utility main task and the IMS HP Change Accumulation Utility SORT address spaces.

Write access is required.

The IMS HP Change Accumulation Utility control data set can be the same data set that is used in the ISPF user interface and two-step processes, in which case the hpca-id members of the control file are overwritten. If you omit the HPCACTL DD statement, IMS HP Change Accumulation Utility allocates a temporary file.

HPCPRINT DD statement

This DD statement defines the IMS HP Change Accumulation Utility report file. Write access is required. The report file can be spooled SYSOUT or a user-defined data set. The minimum required DCB is LRECL=133.

HPCDBPRT DD statement

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

HPCMSG00 DD statement

This DD statement defines a file for selected error messages from the HCADRIV program. Write access is required. The file can be spooled SYSOUT, a user-defined data set, or DUMMY. The minimum required DCB is LRECL=121.

SYSPRINT DD statement (optional)

This DD statement defines a sequential data set to contain output listings from the GENJCL command. It is defined with LRECL=133, blocked or unblocked. You can use any dsname that is approved by your site. Write access is required. If you omit the SYSPRINT DD statement, IMS HP Change Accumulation Utility allocates a temporary data set, when necessary.

JCLOUT DD statement (optional)

This DD statement defines a sequential data set to contain the generated JCL of the GENJCL command. It is defined with LRECL=80, blocked or unblocked. You can use any dsname that is approved by your site. Write access is required for modes 1 and 2. If you omit the JCLOUT DD statement, IMS HP Change Accumulation Utility allocates a temporary data set, when necessary.

JCLPDS DD statement

This DD statement defines the skeletal JCL library that is used by the GENJCL procedure to build the change accumulation JCL. The data set is created when IMS is installed. You can 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. Write access is required. 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 CAGROUPS 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.

If you omit the GENJCLIN DD statement, IMS HP Change Accumulation Utility allocates a temporary data set, when necessary.

SYSOUT DD statement

This DD statement defines a sequential data set to contain error messages from the HPCAMAIN program. Write access is required. 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. The file can be spooled SYSOUT, a user-defined data set, or DUMMY.

HPCAPROC DD statement

This DD statement defines a procedure library that can be used by IMS HP Change Accumulation Utility. Write access is required. 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.

HPCAPROC DD is optional for the standard procedure mode and for the single address space mode (AS1).

HPCAJLIB DD statement (optional)

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

HPCSYSIN DD statement

This DD statement defines the control statements that are submitted to HPCAMAIN. The file can be fixed or variable, maximum record length is 254. The file can be spooled SYSIN or a user-defined data set. Concatenation can be used to provide standard parameters that are seldom changed and local one-time overrides. You generally use the HPCSYSIN DD statement if the HPCAMAIN JCL was stored as a PROCLIB member for multiple reuse.

For example, you can use the following setup file to define typical default values and then require for processing only the names of the CA groups:

//HPCSYSIN DD DSN=some.set.of.defaults,DISP=SHR
//     DD DDNAME=LCLSYSIN
...
...
...
//LCLSYSIN DD *
    GEN.GRPNAME = CAGRP01
    GEN.GRPNAME = CAGRP02
    GEN.GRPNAME = CAGRP06
/*

HPCACOLP, HPCACOLS, HPCACSV, HPCAHTML, HPCAXML DD statements (optional)

Use these DD statements to select optional report outputs.