EXEC and DD statements for FP Stand-alone DB Sensor
You must include the EXEC statement and appropriate DD statements in your FP Stand-alone DB Sensor JCL.
Subsections:
EXEC statement
The EXEC
statement must be in the following format:
//STEP EXEC PGM=HFPSENSR,PARM='IMSPLEX=imsplex,DBRCGRP=dbrcgrp,GSGNAME=gsgname'
where:- PGM
- Specifies the FP Stand-alone DB Sensor program, which is HFPSENSR.
- 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 FP Stand-alone Database
Sensor.
DD name | Use | Required or optional | Format |
---|---|---|---|
STEPLIB | Input | Required | PDS |
HFPSYSIN | Input | Required | LRECL=80 |
area ddname | Input | Required | VSAM |
IMSACB, IMSACBA, or IMSACBB | Input | Required when IMSCATHLQ=*NO | PDS |
IMSDALIB | Input | Optional | PDS |
MODSTAT | Input | Optional | PS |
MODSTAT2 | Input | Optional | PS |
OLCSTAT | Input | Optional | PS |
RECONx | Input | Optional | KSDS |
HFPAPARM | Input | Optional | LRECL=80 |
HFPAUOWC | Input | Optional | LRECL=80 |
HFPSPRT | Output | Required | LRECL=133 |
HFPPRINT | Output | Required | SYSOUT |
itttSMSG | Output | Optional | LRECL=133 |
itttWKnn | Input and output | Optional |
|
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 Fast Path Solution Pack product load module library (including DB Sensor)
- DB Sensor site default library
- IMS RESLIB and DFSMDA members
- SCI exit library for parallel RECON access
- IMS Tools Base product library
- HFPSYSIN DD
- This required DD statement specifies the input data set that contains the input control statement to specify the DB Sensor runtime options.
- area ddname DD
- This required DD statement specifies the name of the area data set to process. The DD name must match the area name in the DBD.
- 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, FP Stand-alone DB Sensor checks the time stamp and determines which one is the latest.
- 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.
- 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.
- 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.
- 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.
- 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.
- RECONx DD
- These DD statements specify the RECON1, RECON2, and RECON3 data sets when DBRC is used (DBRC=YES specification in HFPSYSIN DD). You can omit these DD statements if the DFSMDA member is included in the STEPLIB DD or the IMSDALIB DD.
- HFPAPARM DD
- This DD statement is an optional DD statement that contains execution
control parameters.
If you want the Online Space Management utility to obtain values for the RBASEFS keyword, the RDOVFFS keyword, or both from the Sensor Data repository, specify a valid value for these keywords with this DD statement.
The HFPAPARM DD statement can be coded as a sequential data set or as a PDS member. LRECL=80 is required for the DCB of this data set. The HFPAPARM keywords must be written on one line. It can be coded as follows://HFPAPARM DD * ARDIGIT=5 RBASEFS=30 RDOVFFS=50 RGROUP=IMS1 /*
- HFPAUOWC DD
- This DD statement is optional. Each record in the data set specifies a range of UOW numbers of an area, which defines a UOW group of the area. The information about the UOW group is recorded in a sensor data record set in the order that is specified in the HFPAUOWC data set, even if the UOW ranges overlap or are in reverse order. When you specify UOW ranges of multiple areas, the records must be in ascending order of their area number.
DD statements for output
Specify the following output DD statements:
- HFPSPRT DD
- This required DD statement specifies the output data set for the FP Stand-alone DB Sensor reports. You can specify NULLFILE or DUMMY for this data set.
- HFPPRINT DD
- This required DD statement specifies the processing log output data set, which contains the processing messages that are issued by FP Stand-alone DB Sensor. You can specify NULLFILE or DUMMY for this data set.
- itttSMSG DD
- These optional DD statements specify an output data set for storing DFSORT messages. For the naming rules for the DD names, see the description of the itttWKnn DD.
DD statements for input and output
Specify the following input and output DD statement:
- itttWKnn DD
- These optional DD statements specify intermediate storage data sets that are used by DFSORT. For more information about coding the SORTWKnn DD statements, see the DFSORT Application Programming Guide. Allocating twice the space that is used by the SORTIN data set is usually adequate for each work data set.