CONVERT DD statements

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 CONVERT command. These DD statements are used for both online conversion and offline conversion.
Table 1. DD statements and record format for the CONVERT command
DD name Use Format Need
STEPLIB Input Same as IMS Required
DFSRESLB Input Same as IMS Optional
MACLIB Input Same as IMS Required
IMS Input Same as IMS Optional
IMSDALIB Input Same as IMS Optional
PROCLIB Input Same as IMS Optional
RECONx Input/Output Same as IMS Optional
PSBLIB Input Same as IMS Required for offline conversion with ACBGEN(Y)
IMSACB Output Same as IMS Required for offline conversion with ACBGEN(Y)
original_dbds Input Depends on database organization Optional
IHCSYSIN Input LRECL=80 Required
SYSPRINT Output LRECL=133 Optional
MSGPRINT Output LRECL=133 Optional
IHCLIST Output LRECL=133 Optional
DBDPRINT Output LRECL=133 Required
LNKPRINT Output LRECL=133 Required
AMSPRINT Output LRECL=133 Required
TRACE Output LRECL=133 Optional
SR01MSGP Output LRECL=133 Optional
SYSUDUMP Output LRECL=133 Optional
The following table shows additional DD statements that are used for online conversion.
Table 2. Additional DD statements and record format for the CONVERT command (online conversion)
DD name Use Format Need
IEFRDER Output RECFM=VB Required
IMSACB Output Same as IMS Required
PSBLIB Input Same as IMS Required
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.

MACLIB
This statement is required. The statement specifies the MACLIB data set for DBDGEN.
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.
original_dbds
This statement is optional. This statement defines the database data set. One statement of this type must be present for each data set in the DBD that describes this database. The DD name must match the DD name in the DBD.

For a HIDAM database, DD statements must also exist for the data sets that represent the index. The DD statements that relate to the index must contain DD names specified in the DBD for the index database.

The data sets, if specified, must reside on DASD. If you use dynamic allocation, do not code the DD statement for the database data sets.

Attention: If this DD statement is coded, do not code DCB=BUFNO=n or AMP='BUFND=n' to request access method buffers for database data sets because HSSR Engine of IMS HP Unload allocates its own buffer pools.
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 CONVERT command parameters.

SYSPRINT
This statement is optional. The statement defines the statistics output data set and output from other utilities that are executed under the control of IMS HALDB Toolkit.

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 it.

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.

DBDPRINT
This statement is required. The statement defines the output data set for the assemble step of DBDGEN.

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

LNKPRINT
This statement is required. The statement defines the output data set for the link step of DBDGEN.

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

AMSPRINT
This statement is required. The statement defines the output data set for the IDCAMS utility.

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

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.

SR01MSGP
This statement is optional. The statement defines the message data set for sort processing.
If specified, this file is reallocated dynamically as: 
//SR01MSGP DD SYSOUT=*.

This data set might be required for problem diagnosis of sort processing.

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.

IEFRDER
This statement is required for online processing. IEFRDER describes the log data set that is used by IMS Online Reorganization Facility during the Apply phase.

If changes are captured during the online reorganization process, these log data sets are registered to DBRC as batch logs that are needed in a recovery situation.

This data set must reside on DASD.

IMSACB

For offline conversion:

This statement is required when ACBGEN(Y). The statement describes the staging ACBLIB where IMS HALDB Toolkit generates the new ACBs for the converted DBDs.

This data set must reside on DASD.

For online conversion:

This statement is required. The statement describes the ACB library that is used by IMS Online Reorganization Facility during the Takeover phase.

This data set must reside on DASD.

For more information about IMSACB, see the IMS Database Solution Pack IMS Online Reorganization Facility User's Guide.

PSBLIB

For offline conversion:

This statement is required when ACBGEN(Y). The statement describes the PSB library to rebuild all PSBs in the ACB library that reference the DBD to be converted.

For online conversion:

This statement is required. The statement describes the PSB library to rebuild all PSBs in the ACB library that reference the DBD to be converted.