Submitting JCL for processing (RUN command)

IMS HP Change Accumulation Utility runs as a batch job submitted through the RUN or FAST command.

The JCL for the batch job is created with the GEN command and placed in member hpca-id#DRIV JCL of the control data set.

You can also tailor the sample HPCABAT0 job that is provided in the hpchlq.SAMPLIB library to the requirements of your site.

The following example shows sample generated JCL:

Figure 1. Sample generated JCL

VIEW        USRT004.CONTROL(R81DRIV) - 01.00          Columns 00001 00072
Command ===>
000001 //HPCA      JOB (IMSUTIL-HPCA),CLASS=A,MSGCLASS=H,
000002 //              REGION=0M,TIME=NOLIMIT,
000003 //              NOTIFY=&SYSUID
000004 //*
000005 //*
000006 //*
000007 //*
000008 /*MESSAGE   *** START OF HPCA UTILITY ***
000009 //STEP01   EXEC PGM=HPCDRIV
000010 //STEPLIB   pd DISP=SHR,
000011 //             DSN=VND0459.HPC140.SHPCLMD0
000012 //          pd DISP=SHR,
000013 //             DSN=IMSBLD.I81RTS2A.CRESLIB
000014 //HPCACTL   pd DISP=SHR, 
000015 //             DSN=USRT004.CONTROL.(R81#CTL)
000016 //HPCPRINT  pd SYSOUT=*
000017 //SYSUDUMP  pd SYSOUT=*
000018 //HPCAXML   pd SYSOUT=X
****** ****************************** Bottom of Data ***********************

Field descriptions for sample generated JCL

JOB statement

Specify the statement that you entered in the Current Environment Data panel.

EXEC statement

Specify the main entry program for IMS HP Change Accumulation Utility (HPCADRIV).

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. The dsnames are provided on the DBRC Utility Data Sets panel.

HPCACTL DD statement

Specify 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 the ISPF user interface.

HPCPRINT 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.

SYSUDUMP, HPCAXML, etc.

Specify IMS HP Change Accumulation Utility spool data sets which are used for *messages and system dumps. You can choose these data sets from the Execution JCL pd Control panel, setup option 9.