EXEC and DD statements for FF Stand-alone DB Sensor

You must include the EXEC statement and appropriate DD statements in your FF Stand-alone DB Sensor JCL.

Subsections:

EXEC statement

The EXEC statement must be in the following format:
//STEP EXEC PGM=BBESENSR,PARM='IMSPLEX=imsplex,DBRCGRP=dbrcgrp'
where:
PGM
Specifies the FF Stand-alone DB Sensor program, which is BBESENSR.
PARM
Specifies the parameters. For information about specifying the PARM parameter, see IMS System Programming APIs.

DD statement summary

The following table summarizes the DD statements for FF Stand-alone Database Sensor.
Table 1. BBESENSR DD statements
DD name Use Required or optional Format
STEPLIB Input Required RECFM=U
BBESIN Input Required RECFM=FB,LRECL=80
database ddname Input Required  
IMS Input Optional RECFM=FB,LRECL=80
IMSDALIB Input Optional RECFM=U
RECONx Input Optional VSAM
BBESPRT Output Required RECFM=FBA,LRECL=133
SYSUDUMP or SYSABEND Output Optional RECFM=FBA,LRECL=133

DD statements for input

Specify the following input DD statements:

STEPLIB DD
This required DD statement specifies the following load module libraries. All of these libraries must be APF-authorized.
  • IMS Database Solution Pack product load module library or IMS Database Utility Solution product load module library (SHPSLMD0 data set, which includes DB Sensor)
  • DB Sensor site default library
  • IMS RESLIB, IMS user exit library (randomizer), and DFSMDA members
  • SCI exit library for parallel RECON access (if used)
  • IMS Tools Base product library (SHKTLOAD, SGLXLOAD, and SFOILOAD data sets)
    Notes:
    • The SFOILOAD data set is required when you specify the TOSIXCFGRP keyword on the BBESIN control statement.
    • The SGLXLOAD data set is required when you specify the IMSCATHLQ keyword on the BBESIN control statement.
BBESIN DD
This required DD statement specifies the input data set that contains the input control statements to specify the DB Sensor runtime options.
For details about the control statement format, commands, and keywords, see the following topics:
database ddname DD
This required DD statement specifies the name of the database data set to process. The DD name must match the DD name in the DBD.
You must specify this DD statement except in the following cases:
  • If the database is a HALDB database, you do not need to specify this DD statement. The name of the database data set is obtained from the RECONx data sets, and this DD is allocated dynamically.
  • If the database is a non-HALDB database, you can omit this DD statement if one of the following conditions is met:
    • The data set will be allocated dynamically by the IMS DFSMDA macro.
    • The DFSMDA member is included in the STEPLIB DD or the IMSDALIB DD.
Restriction: You cannot specify the following resources for this DD:
  • An image copy data set
  • An ILDS of a HALDB
  • A HALDB partition that is being processed by OLR
IMS DD
This DD statement specifies the DBDLIB data set. APF-authorization is not required for the DBDLIB data set. You can omit this DD statement when you specify the IMSCATHLQ keyword on the BBESIN control statement.
IMSDALIB DD
This optional DD statement specifies the DFSMDA member modules. Specify this DD statement only if you do not want to APF-authorize the DFSMDA members data set. If both IMSDALIB and STEPLIB contain the DFSMDA members, IMSDALIB is used.
RECONx DD
These DD statements specify the RECON1, RECON2, and RECON3 data sets when DBRC is used (DBRC=YES specification in BBESIN DD). You can omit these DD statements if the DFSMDA member is included in the STEPLIB DD or the IMSMDALIB DD.

DD statements for output

Specify the following output DD statements:

BBESPRT DD
This required DD statement specifies the output data set for the FF Stand-alone DB Sensor reports.
If you omit this DD statement, it is allocated dynamically with SYSOUT=* and the reports are printed in the SYSOUT data set.
For details about the FF Stand-alone Database Sensor reports that are generated in the BBESPRT data set, see Output from FF Stand-alone DB Sensor.
SYSUDUMP DD (or SYSABEND DD)
This optional DD statement defines the output for a system ABEND dump routine. Specify this DD statement if you want to generate a dump.