EXEC and DD statements for the FP Site Default Generation utility

You must include the EXEC statement and appropriate DD statements in your FP Site Default Generation utility JCL.

Subsections:

EXEC statement

The EXEC statement must be in the following format:

//STEP EXEC PGM=HFPSTGEN,PARM='parameter'
where:
PGM
Specifies the FP Site Default Generation program, which is HFPSTGEN.
PARM
Specifies the function to run. Specify either of the following values:
GEN
Generates a site default table.
REPORT
Reports the contents of the site default table.

DD statement summary

The following table summarizes the DD statements for the FP Site Default Generation utility.

Table 1. HFPSTGEN DD statements
DD name Use Format When EXEC PARM=’GEN’ When EXEC PARM=’REPORT’
STEPLIB Input
RECFM=U
 Required Required
HFPSYSIN Input
RECFM=FB
LRECL=80
 Required Not applicable
IMSACB, IMSACBA, or IMSACBB Input PDS Optional Not applicable
MODSTAT Input PS Optional Not applicable
MODSTAT2 Input PS Optional Not applicable
OLCSTAT Input PS Optional Not applicable
SYSMSG Output
RECFM=FBA
LRECL=133
BLKSIZE=1330
 Required Required
SYSPRINT Output
RECFM=FBA
LRECL=133
BLKSIZE=1330
 Required Required
SYSPUNCH Output
RECFM=FB
LRECL=80
 Required Not applicable

DD statements for input

Specify the following input DD statements:

STEPLIB DD
This required DD statement specifies the load module library of DB Sensor. You must APF-authorize this library.
When you specify PARM='REPORT' on the EXEC statement, you must also specify the library that contains the site default table module (HFPSCTL0).
HFPSYSIN DD
This DD statement is required when you specify PARM='GEN' on the EXEC statement. This DD statement specifies the HFPSYSIN data set that contains the HFPSYSIN control statement.
IMSACB DD
This optional DD statement specifies the library that contains the DMB for the database. The IMSACB DD statements (IMSACB, IMSACBA, IMSACBB, MODSTAT, MODSTAT2, and OLCSTAT) can be used to identify the active ACB library. When both OLCSTAT or MODSTAT and MODSTAT2 are found, the FP Site Default Generation utility checks the time stamp and determines which one is the latest.
DB Sensor determines the active IMSACB library according to the following rules:
  1. Check the IMSACB DD statement in the JCL statement.
  2. Check the OLCSTAT DD statement in the JCL statement.
  3. Check the MODSTAT and MODSTAT2 DD statements in the JCL statement.
  4. Allocate the OLCSTAT data set dynamically and check the OLCSTAT member.
  5. Allocate the MODSTAT and MODSTAT2 data sets dynamically and check the MODSTAT and MODSTAT2 members.

If you specify the IMSCATHLQ keyword, IMSACB DD statements are not used. The IMS directory is used instead of the ACB library

IMSACBA DD
This DD statement specifies the library that contains the DMB for the database. This statement must be provided if MODSTAT and MODSTAT2, or the OLCSTAT DD statement is specified.
IMSACBB DD
This DD statement specifies the library that contains the DMB for the database. This statement must be provided if MODSTAT and MODSTAT2, or the OLCSTAT DD statement is specified.
MODSTAT DD
This optional DD statement specifies the MODSTAT data set. When this statement is specified, the IMSACBA and IMSACBB DD statements must be specified instead of the ACBLIB DD statement.
If this statement is not specified in the JCL statement when the data set is required, the data set is allocated dynamically by using a DFSMDA member. You can build the DFSMDA member for the MODSTAT library by using a TYPE=DATABASE statement of the DFSMDA macro.
MODSTAT2 DD
This optional DD statement specifies the MODSTAT2 data set. When this statement is specified, the IMSACBA and IMSACBB DD statements must be specified instead of the ACBLIB DD statement.
If this statement is not specified in the JCL statement when the data set is required, the data set is allocated dynamically by using a DFSMDA member. You can build the DFSMDA member for the MODSTAT2 library by using a TYPE=DATABASE statement of the DFSMDA macro.
OLCSTAT DD
This optional DD statement specifies the OLCSTAT data set. When this statement is specified, the IMSACBA and IMSACBB DD statements must be specified instead of the ACBLIB DD statement.
If this statement is not specified in the JCL statement when the data set is required, the data set is allocated dynamically by using a DFSMDA member. You can build the DFSMDA member for the OLCSTAT library by using a TYPE=DATABASE statement of the DFSMDA macro.

DD statements for output

Specify the following output DD statements:

SYSMSG DD
This required DD statement specifies the output data set for the messages that will be issued while generating or reporting the site default table. You can specify NULLFILE or DUMMY for this data set.
If you omit this DD statement, it is allocated dynamically with SYSOUT=* and the messages are printed in the SYSOUT data set.
SYSPRINT DD
This required DD statement specifies the output data set for the FP Site Default Generation utility reports. You can specify NULLFILE or DUMMY for this data set.
If you omit this DD statement, it is allocated dynamically with SYSOUT=* and the reports are printed in the SYSOUT data set.
SYSPUNCH DD
This DD statement is required when you specify PARM='GEN' on the EXEC statement. This DD statement specifies the output data set in which the source code for the site default table is generated.