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.
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.
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.
PARM=('...') specifies:
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 |
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 name |
Description |
---|---|
STEPLIB |
LOAD libraries (by default BSA.LOAD and BETA97.LOAD) |
B97DEF |
Database definition file |
SFFPARM |
Parameter library (BETA.PARMLIB) |
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. |
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.