Skip to Content
Information

This site will undergo maintenance on Friday, 26 September at 2:00 AM CDT / 12:30 PM IST and may experience a short period of instability during that time.

UNLDDLST

The UNLDDLST keyword is valid with the REORG (Reorg function) and GROUP commands.

This keyword is available in PLUSIN; it is not available as a global option.Input ddnames in pairs keyword describes the keyword.

To do this

Specify this in PLUSIN

Specify input ddnames for primary databases.

UNLDDLST((dbddnam1,xxddnam1), + (dbddnam2,xxddnam2))

dbddnam1 represents the ddname as defined in the DBD to be used for the new database to be loaded.

xxddnam1 represents a different ddname to be used for the original data set to be unloaded.

Internal default: none

The UNLDDLST keyword performs a function similar to that of the UNLDD keyword—it defines the ddnames for output and input into the Reorg function reorganization process.

The UNLDDLST keyword values make up a list of ddname pairs—each output (reload) ddname and its corresponding input (unload) ddname appear together. UNLDDLST is more flexible than UNLDD in the ddnames it can create, but you must specify all ddnames of a primary database (including the primary index and multiple data set groups) in the list. You can specify up to 20 ddname pairs.

The first value you specify with UNLDDLST keyword is the DBD ddname that will be used for the new output data set. The second value is the ddname that will be used for the associated unload data set. This is the opposite of how a traditional (non-Reorg function) reorganization uses the DBD ddnames.

Warning

Note

Do not specify secondary indexes with the UNLDDLST keyword; the Reorg function ignores secondary indexes specified with UNLDDLST. For more information, see Secondary indexes—Reorg function (Fast Reorg Facility/EP).

If you use the UNLDDLST keyword, the UNLDD keyword is not valid.

The UNLDDLST keyword is not valid when you specify INPUT(UNLDFILE).

Information
Example

Database TESTDB is a HIDAM database containing two data set groups, TESTDD1 and TESTDD2. The primary index ddname is TESTDDX.

The following example uses the UNLDDLST keyword to define the ddnames for the output (reorganized) data sets and the input (disorganized) data sets:

UNLDDLST((TESTDD1,MYDD1),(TESTDD2,MYDD2),+
(TESTDDX,MYDDX))

All six ddnames must be included in the job step JCL for the Reorg function. You do not need to specify ddnames for the secondary indexes in UNLDDLST because the existing secondary index data sets are not used as input to the reorganization.

The following table shows examples for the UNLDDLST keyword.

Old DBD ddname

Associated data set name

New ddname

Associated data set name

TESTDD1

New data set name for the primary database DSG1 that will be reloaded

MYDD1

The old (original) data set name for the primary database DSG1 that will be unloaded

TESTDD2

New data set name for the primary database DSG2 that will be reloaded

MYDD2

The old (original) data set name for the primary database DSG2 that will be unloaded

TESTDDX

New data set name for the primary index database that will be reloaded

MYDDX

The old (original) data set name for the primary index database that will be unloaded

Related topic

Keyword descriptions—user-controlled options

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Online Reorg for IMS 5.2