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. Table 1 describes the keyword.

Table 1. Input ddnames in pairs 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-indexes1.

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

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

Warning

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.

Table 2 shows examples for the UNLDDLST keyword.

Table 2. UNLDDLST example

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

 

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

MAXM Reorg for IMS 5.0 and MAXM Reorg for IMS with Online/Defrag Feature 5.0