PSEXIT DD statements

Edit online

DD statements are used to identify the source of input and the placement of output information.

The following table shows DD statements and record format for the PSEXIT command.
Table 1. DD statements and record format for the PSEXIT command
DD name Use Format Need
STEPLIB Input Same as IMS Required
DFSRESLB Input Same as IMS Optional
IMS Input Same as IMS Optional
IMSDALIB Input Same as IMS Optional
PROCLIB Input Same as IMS Optional
RECONx Input Same as IMS Optional
DFSURGU1 Input Same as IMS Required
IHCSYSIN Input LRECL=80 Required
KEYS Input LRECL=80 Optional
MSGPRINT Output LRECL=133 Optional
IHCLIST Output LRECL=133 Optional
TRACE Output LRECL=133 Optional
SYSUDUMP Output LRECL=133 Optional
STEPLIB
This statement is required. The library data sets pointed to from the STEPLIB DD statement must always be APF-authorized, even if a DFSRESLB DD statement is provided. Authorized library data sets include:
  • IMS HALDB Toolkit load library
  • IMS utilities that are available for IMS HALDB Toolkit
  • IMS RESLIB library
  • Any other libraries
The libraries can appear in any order.
//STEPLIB DD DISP=SHR,DSN=ihcload
//        DD DISP=SHR,DSN=imstools
//        DD DISP=SHR,DSN=reslib
where:
  • ihcload is the name of the library that contains the IMS HALDB Toolkit load modules.
  • imstools is the optional name of the library that contains the IMS reorganization utilities load modules.
  • reslib is the name of the library that contains the IMS load modules.
If you do not specify an IMSDALIB DD statement in the JCL, you must specify the MDALIB in the STEPLIB for dynamic allocation purposes.
DFSRESLB
This statement is optional. The statement points to an authorized library that contains IMS SVC modules.

IMS HALDB Toolkit dynamically allocates this DD if you do not provide it.

IMS
This statement is required only if the IMS management of ACBs is not enabled. The statement describes the library that contains the DBDs of the database that you are processing.

This data set must reside on DASD.

When the IMS management of ACBs is enabled, IMS HALDB Toolkit ignores the IMS DD statement.

IMSDALIB
This statement is optional. The statement specifies a partitioned data set or data sets that contain the dynamic allocation members for the database data sets of non-HALDB and the RECON data sets.

If DBRC is active and the IMSDALIB DD statement is coded, IMSDALIB is always referred to by DBRC, and DBRC determines the data sets to be allocated for each RECON DD.

For the database data sets of non-HALDB, IMSDALIB is referred to only when the dynamic allocation for the original data sets is requested. Dynamic allocation of the database data sets is attempted in the following order:
  1. Dynamic allocation members in the IMSDALIB concatenation
  2. Dynamic allocation members in JOBLIB or STEPLIB concatenation
PROCLIB
This statement is optional. The statement points to the IMS.PROCLIB data set. If DFSDF(ddd) is specified in the IHCSYSIN data set, you must specify this DD statement and ensure that the DFSDFddd member exists in the IMS.PROCLIB data set.
RECONx
These statements are optional. The statements define the database recovery control (DBRC) RECON data sets. RECON data sets dictate which databases and IMS online systems to use during the processing.
Attention: If you specify IMSDALIB DD dynamic allocation, do not use these RECON DD statements. If you used JCL to allocate RECON1 as a spare data set, you must restart the database.
DFSURGU1
This statement is required. The statement defines the DBD unload file that the DBD parameter specifies.
IHCSYSIN
This statement is required. The statement defines a control statement or data set that contains control statements that specify the functions of IMS HALDB Toolkit.

For more information about the format of IHCSYSIN DD statements, see PSEXIT command parameters.

KEYS
This statement is required for selection exits that require a string for partition selection. If the selection routine does not need keys or strings, use the PARTNUM parameter instead.

The statement defines the KEYS file that contains a list of keys. Use this statement with the KEYLEN and the KEYOFF parameters.

MSGPRINT
This statement is optional. The statement defines the IMS HALDB Toolkit output data set for progress messages issued during the job. For more information, see MSGPRINT data set.

The data set can reside on DASD, or it can be routed through the output job. IMS HALDB Toolkit dynamically allocates this data set if you do not provide this DD statement.

IHCLIST
This statement is optional. The statement defines the IMS HALDB Toolkit output data set for reports. For more information about the reports generated in this data set, see IHCLIST data set.

The data set can reside on DASD, or it can be routed through the output job. IMS HALDB Toolkit dynamically allocates this data set if you do not provide this DD statement.

TRACE
This statement is optional. The statement defines the output data set that IMS HALDB Toolkit uses to write diagnostic trace records. This data set might be required for problem diagnosis.

This data set can reside on DASD, or it can be routed through the output job. If you do not provide this DD statement, it is dynamically allocated to SYSOUT by IMS HALDB Toolkit.

SYSUDUMP
This statement is required only if a dump is requested by IBM® Software Support. The statement defines a dump data set. If the IMS HALDB Toolkit detects an error and ends with a U0999 abend, this dump is not necessary. However, if any other system or user abend occurs, this data set might be required for problem diagnosis.

This data set can reside on DASD, or it can be routed through the output job.