JCL

Overview

To run a batch utility, you can use the JCL from the BETA97.CNTL. This JCL has been tailored during the installation for the names of libraries and databases used by your Adabas Audit Data Retrieval system.

Alternatively, you can use online option S.3 to generate JCL for a number of Adabas Audit Data Retrieval batch utilities. This process tailors JCL from a skeleton using the names of libraries and databases specified in the subsystem options record.

Standard JCL structure

This is the standard JCL structure which applies to most Adabas Audit Data Retrieval batch utilities.

+------------------------------------------------------------------------+
|jobcard |
|//stepname EXEC PGM=BST01RFF,REGION=0M,PARM=('S=97', |
|// 'PGM=B97xxxx', |
|// 'B01LST=xx', |
|// 'B97LST=xx', |
|// 'B97_SSID=ssid', |
|// 'SIGNON=YES') |
|//* |
|//STEPLIB DD DISP=SHR,DSN=BETA97.LOAD |
|// DD DISP=SHR,DSN=BSA.LOAD |
|//* |
|//B97DEF DD DISP=SHR,DSN=BETA97.DB.DEF |
|//SFFPARM DD DISP=SHR,DSN=BETA.PARMLIB |
|//* |
|//SYSPRINT DD SYSOUT=* |
|//IRMLOG DD SYSOUT=* |
|//IRMPRINT DD SYSOUT=* |
|//IRMERROR DD SYSOUT=* |
|//* |
|//SFFFDUMP DD SYSOUT=* |
|//SYSABEND DD SYSOUT=* |
|//* |
|//SYSIN DD * |
|parameters |
|/* |
+------------------------------------------------------------------------+

If SIGNON=YES, it is okay for most Adabas Audit Data Retrieval batch utilities to use DUMMY in the DD statement B97DEF of the database definition file:

+------------------------------------------------------------------------+
|... |
|//B97DEF DD DUMMY |
|//SFFPARM DD DISP=SHR,DSN=BETA.PARMLIB |
|... |
+------------------------------------------------------------------------+

For more information, see "B97DEF DD DUMMY".

DD statements and parameters, which are used only by individual batch utilities, are described in the section of the corresponding batch utility.

Remote Function Facility (RFF)

EXEC PGM=BST01RFF indicates that the batch job runs in an RFF environment (RFF = Remote Function Facility). All Adabas Audit Data Retrieval batch utilities run in this fashion.

EXEC parameter

PARM=('...') specifies:

  • Which program is to be executed by BST01RFF
  • Which parameters are to be used for controlling the execution of this program

The parameters that can be used are listed below.

Parameter

Description

S=97

Product number (for Adabas Audit Data Retrieval it is always97)

PGM=name

Name of the program to be executed, for example, B97BUTLT or B97DELOG

B01LST=xx
B97LST=xx

Specify the BETA.PARMLIB member whose parameters should be used

B97_SSID=ssid

Adabas Audit Data Retrieval Subsystem ID

This entry is optional, as the system ID is normally also specified in the B97LSTxx member.

SIGNON=YES|NO

Yes

means that the batch utility accesses the Adabas Audit Data Retrieval database via the Adabas Audit Data Retrieval started task; the Adabas Audit Data Retrieval started task must be active when the batch utility is started (default setting).

No

means that the batch utility requests exclusive access to the Adabas Audit Data Retrieval database; the Adabas Audit Data Retrieval started task must be inactive when the batch utility is started.

DD statements

DD name

Description

STEPLIB

LOAD libraries (by default BSA.LOAD and BETA97.LOAD)

B97DEF

Database definition file

DD DUMMY is okay for most batch utilities.

SFFPARM

Parameter library (BETA.PARMLIB)
The members B01LSTxx and B97LSTxx must be located in this library.

SYSPRINT

If required, the system messages are written via this DD statement.

IRMLOG

The processing log is written via this DD statement.

IRMPRINT

The results log is written via this DD statement.

IRMERROR

If required, an error log is written via this DD statement.

SFFFDUMP

If required, the subsystem dumps are written via this DD statement.

SYSABEND

If required, the system dumps are written via this DD statement.

SYSIN

This DD statement is used for the specification of the control cards for the function to be executed.

B97DEF DD DUMMY

If SIGNON=YES, it is okay for most Adabas Audit Data Retrieval batch utilities to code B97DEF DD DUMMY in the JCL.

The following batch utilities do not work with a DD DUMMY statement, but always require the name of the Adabas Audit Data Retrieval database definition file in the B97DEF DD statement. The submitting user must have CONTROL access to the Adabas Audit Data Retrieval database.

  • B97ARC
  • B97DEARC
  • B97DECCH
  • B97DEONL
  • B97GLOBL
  • B97MRLD
  • B97RLD
  • BST05ANA
  • BST08OCP