Using Batch Executions

There are two ways of integrating CA7 with AAI. This topic describes the batch integration method that uses tailored JCLs o create the required data files and an additional JCL to send those files to the AAI server.

This page includes the following:

Tailor and Schedule the AAI JCL Jobs

The sample JCLs on this page (JOBDEF and EVENT) can be used to create the data files that must be sent to the AAI server. Use the supplied samples and adapt them to your installation.

You will need an additional JCL steps to perform a file transfer that sends those data files to the Data Delivery Path defined on the AAI server. The file transfer process can use whatever methodology is best in your environment. The data files must be transferred as text files. They must be named as below on the AAI server:

JobDef files:
	LDSN
	LJOB
	SCALyyxx or SCALyy 	(see Note: below)
	TIMEZONE
Event file:
	RPT70

JOBDEF JCL

This JCL creates the following job definition files: LDSN, LJOB, SCAL, TIMEZONE.

Note:

Step SCAL001 should be repeated for every calendar that is defined in CA7. Each step should contain the appropriate calendar suffix, for example PE.

AAI also accepts one file with all of the calendars for one year in it. The name of this file must be SCAL followed by the last two digits of the year. For example, 2023 calendars would be SCAL23. See Note below for sample JCL on creating one file with many calendars.

Tailor the following JOBDEF JCL sample to fit your installation:

//JOBDEF JOB (ACNT-DATA),'JOB DEF JOB',

// CLASS=B,MSGCLASS=X

//*

// SET BASEDSN='ADCDMST.JAWS.'

// SET CAL2LOAD='ADCDMST.CA7.CAL2LOAD'

//*

//** CREATE OUTPUT FILE FOR LJOB

//LJOB EXEC PGM=CAL2X2WB,PARM=',CA71'

//STEPLIB DD DISP=SHR,DSN=&CAL2LOAD

//SYSPRINT DD DSN=&BASEDSN.LJOB,DISP=(OLD,CATLG,CATLG)

//ERRORS DD SYSOUT=*

//SYSUDUMP DD SYSOUT=*

//SYSIN DD *

/LOGON MASTER

LJOB,JOB=*,LIST=ALL

/LOGOFF

//LDSN EXEC PGM=CAL2X2WB,PARM=',CA71'

//STEPLIB DD DISP=SHR,DSN=&CAL2LOAD

//SYSPRINT DD DSN=&BASEDSN.LDSN,DISP=(OLD,CATLG,CATLG)

//ERRORS DD SYSOUT=*

//SYSUDUMP DD SYSOUT=*

//SYSIN DD *

/LOGON MASTER

LDSN,DSNBR=DS*

/LOGOFF

//** CREATE OUTPUT FILE FOR SCAL23PE

//SCAL001 EXEC PGM=CAL2X2WB,PARM=',CA71'

//STEPLIB DD DISP=SHR,DSN=&CAL2LOAD

//SYSPRINT DD DSN=&BASEDSN.SCAL23PE,DISP=(OLD,CATLG,CATLG)

//ERRORS DD SYSOUT=*

//SYSUDUMP DD SYSOUT=*

//SYSIN DD *

/LOGON MASTER

PRINT,SCAL=PE,YEAR=23

/LOGOFF

//** CREATE OUTPUT FILE FOR MAINFRAME TIMEZONE

//TIMEZONE EXEC PGM=BPXBATCH,

// PARM='SH echo $TZ'

//STDOUT DD DSN=&BASEDSN.TIMEZONE,DISP=(OLD,CATLG,CATLG)

To create one calendar file for all years, replace the SCAL0001 step above that creates the output file SCAL23PE with the following example. This example performs a PRINT of multiple CA7 calendars and stores them in a SCAL23 file:

//** CREATE OUTPUT FILE FOR SCAL23

//SCAL001 EXEC PGM=CAL2X2WB,PARM=',CA71'

//STEPLIB DD DISP=SHR,DSN=&CAL2LOAD

//SYSPRINT DD DSN=&BASEDSN.SCAL23,DISP=(OLD,CATLG,CATLG)

//ERRORS DD SYSOUT=*

//SYSUDUMP DD SYSOUT=*

//SYSIN DD *

/LOGON MASTER

PRINT,SCAL=PE,YEAR=23

PRINT,SCAL=WE,YEAR=23

/LOGOFF

Schedule the JOBDEF JCL job to run on a schedule in CA7 (typically once per day) at a time that completes the delivery of these data files prior to the time defined in AAI to process definition data (default is 1AM).

Note:

After running the JOBDEF JCL, the STDOUT DD for the TIMEZONE step should have a valid time zone in the format MST7MDT.

EVENT JCL

Tailor the following EVENT JCL sample to fit your installation:

//EVENT JOB (ACCT),EVENT.EXTRACTOR,

// CLASS=B,

// REGION=0M,

// TIME=NOLIMIT

//*

// SET RPTBASE='ADCDMST.JAWS'

// SET CA7LOGP='ADCDMST.CA7.LOGP'

// SET CA7LOGS='ADCDMST.CA7.LOGS'

//*--------------------------------------------------------

//* IF THE OUTPUT FILE EXISTS, DELETE IT. WE WILL CATALOG

//* A NEW ONE LATER

//*--------------------------------------------------------

//DELETE EXEC PGM=IEFBR14

//DD1 DD DSN=&RPTBASE..RPT70,DISP=(MOD,DELETE,DELETE),

// UNIT=SYSDA,SPACE=(CYL,(0))

//*--------------------------------------------------------

//* GENERATE THE HISTORY FILE FOR JAWS AND PASS IT TO THE

//* NEXT STEP TO BE CATALOGED

//*--------------------------------------------------------

//REPORT EXEC CA7LOG,PG=SASSHIS8,PA='O,MAX'

//SASSRA01 DD DUMMY

//SASSRA02 DD DUMMY

//SASSRA03 DD DUMMY

//COMMANDS DD DSN=&&COMMANDS,DISP=(,PASS),

// DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),

// UNIT=SYSDA,SPACE=(CYL,(1,1))

//UCC7HIST DD DISP=SHR,DSN=&CA7LOGP

// DD DISP=SHR,DSN=&CA7LOGS

//SYSIN DD *

70 01HRS

//SYSLIST DD DSN=&&RPT70,

// DISP=(NEW,PASS,DELETE),

// UNIT=SYSDA,SPACE=(CYL,(50,35)),

// DCB=(RECFM=FBA,LRECL=133,BLKSIZE=13300)

//SYSOUT DD DUMMY

//*--------------------------------------------------------

//* CATALOG THE TEMPORARY FILE CREATED IN THE PREVIOUS STEP

//*--------------------------------------------------------

//COPYRPT EXEC PGM=IEBGENER

//SYSPRINT DD DUMMY

//SYSOUT DD DUMMY

//SYSUT1 DD DISP=OLD,DSN=&&RPT70

//SYSUT2 DD DSN=&RPTBASE..RPT70,

// DISP=(,CATLG),

// UNIT=SYSDA,SPACE=(CYL,(50,35))),

// DCB=(RECFM=FBA,LRECL=133,BLKSIZE=0)

//SYSIN DD DUMMY

Schedule the EVENT JCL job in CA7 using REPEAT Scheduling to run this every minute throughout the day, 7 days a week.

Configure a Data Set Trigger to trigger the EVENT JCL job in CA7.

Note:

The triggering dataset must be the same as the DSN configured in the AAI Add Scheduler dialog as Trigger DSN.

Next Step

The last step to integrate the CA7 environment with AAI is to create the CA7 scheduler within AAI. For more information, see: