Coding the JCL

The IBM Z Workload Scheduler sample library (SEQQSAMP) contains samples to execute the batch loader. For the data set name of the library, see your system programmer.

These samples are provided:
  • EQQBSCAN uses the scan action to syntax check an AD.
  • EQQBSUBS creates three new application descriptions and operator instructions through the controller.
  • EQQBVSAM updates VSAM data sets directly with new application descriptions and operator instructions.

If you use the batch loader a lot, you might find it easier to allocate a PDS and create a member for each batch-loader request type. This ensures that syntax errors are not repeated, and could save you time. You can use the samples provided in SEQQSAMP as the basis for your batch-loader PDS.

Following is a sample JCL for executing the batch loader: 
//XRAYNERE JOB (890122,NOBO),'SIMON RAYNER',
//     MSGCLASS=H,NOTIFY=XRAYNER,CLASS=A
//STEP1    EXEC PGM=EQQYLTOP
//STEPLIB  DD DSN=OPCESA.VvRrMm.LOAD,DISP=SHR
//EQQMLIB  DD DSN=OPCESA.VvRrMm.MSGLIB,DISP=SHR
//EQQMLOG  DD SYSOUT=*
//EQQDUMP  DD SYSOUT=*
//EQQUDUMP DD SYSOUT=*
//* -- Required if your operator instructions are in
//* -- separate members
//* //EQQOIPDS DD DSN=XRAYNER.OPCESA.MESSAGES,DISP=SHR
//SYSIN    DD DSN=XRAYNER.OPCESA.BATCH(PAYROLL),DISP=SHR
//* -- Required if you are writing to VSAM data sets
//* //EQQWSDS  DD DISP=SHR,DSN=OPCESA.WORK.STATIONS
//* //EQQADDS  DD DISP=OLD,DSN=OPCESA.NEW.AD
//* //EQQOIDS  DD DISP=OLD,DSN=OPCESA.NEW.OI

The program name EQQYLTOP is required on the EXEC statement in your JCL. EQQYLTOP should reside in the IBM Z Workload Scheduler load module library, or at least in an APF-authorized library. If this library is not defined in the active z/OS® LNKLSTxx member of SYS1.PARMLIB, you must provide a STEPLIB DD statement in your JCL so that EQQYLTOP can be found.

The data set requirements depend on whether you are directing the batch-loader output to an IBM Z Workload Scheduler subsystem or to VSAM data sets. If the output is directed to VSAM data sets, you must allocate them with the correct VSAM data set characteristics for an AD or OI database. The Planning and Installation Guide and the sample library have JCL and IDCAMS control statements for creating an AD or OI database.

The DD names for the required data sets are listed here with a description of their function:
SYSIN
The batch-loader input data set that contains your control statements. You can use a disk or tape data set, with fixed blocked 80-byte records, or use SYSIN DD * and place the control statements in your JCL.

SYSIN data cannot exceed 72 characters. For details, see Syntax and construction.

EQQMLIB
The IBM Z Workload Scheduler message library.
EQQMLOG
Message log. This can be allocated to a data set or to SYSOUT.
EQQDUMP
Diagnostics data set. If batch-loader output is directed to a VSAM data set, diagnostic information is written to this data set during validity checking of the records in the input data set. If output is directed to an IBM Z Workload Scheduler subsystem, diagnostic information is written to the diagnostics data set of that subsystem.
SYSUDUMP
For z/OS® dumps.
EQQOIPDS
Required if the MEMBER keyword is specified on an OISTART control statement. EQQOIPDS specifies a partitioned data set, fixed blocked with a record length of 80 bytes, which contains operator instruction text.
EQQADDS
Required if output is being directed to a VSAM data set. Specifies the VSAM data set that is to receive the AD information. This DD statement is also used to check:
  • That applications and operations identified on ADDEP and ADAPD control statements exist.
  • That applications and operations identified on OISTART control statements exist.
  • That JCL variable tables identified on ADRUN control statements exist.
EQQAD2DS
This optional DD statement is used only if batch loader output is directed to a VSAM data set. If present, it is used with EQQADDS to check that applications and operations on ADDEP, ADAPD, and OISTART statements exist. You might need to specify this DD name if you are merging two sets of application descriptions (the batch-loader statements and an old database, represented by this DD name) into a new database, represented by the EQQADDS DD name.
If no match is found on the EQQADDS data set, IBM Z Workload Scheduler searches:
  • EQQAD2DS for an application description that can be the predecessor.
  • The operator instruction database for a matching application description.
No information is ever written to EQQAD2DS.
EQQOIDS
Required only if output is directed to a VSAM data set. EQQOIDS specifies the VSAM data set that is to receive OI information.
EQQWSDS
Required only if output is directed to a VSAM data set. EQQWSDS specifies the data set name of your existing workstation description database. This is required so that the batch loader can check that the specified workstations, calendars, periods, and run cycle groups exist.