UNLDD

The UNLDD keyword is valid with the REORG (Reorg function) command.

You can specify this option in a Reorg function global options module or in PLUSIN. Input ddnames with substitution characters keyword describes the keyword.

To do this	Specify this in PLUSIN
Specify input ddnames for primary databases.	UNLDD(ccc,n) ccc represents a 1- to 3-character string. n represents the position where you want the 1- to 3-character replacement string to appear.
Internal default: OLD,1

The Reorg function requires a set of new ddnames to distinguish between input ddnames and output ddnames for primary database and primary index data sets. The Reorg function uses the ddnames defined in the DBD for the new data set names to be used for output. The Reorg function uses different ddnames for the old data sets that will be used for the unload process. This is the opposite of how a traditional (non-Reorg function) reorganization uses the DBD ddnames.

You must define the input ddnames in a way that is meaningful to you. The UNLDD keyword supplies edit information that defines the ddnames that the Reorg function uses for the original (disorganized) data sets.

The Reorg function uses the DBD ddnames as a base. The characters from the first value of UNLDD are placed into the ddname at the starting position specified by the second value. The characters overlay as much of the ddname as the length of the set of characters or the length of the ddname allows.

The ddnames created by the UNLDD edit must be unique and must not match those defined in DBRC for the database. If you did not specify DYNALLOC(Y,Y,x), the ddnames must appear in the job step JCL. The data sets assigned to these ddnames must be the original database data sets that are registered to DBRC because they are the data sets of the disorganized database to be used in the unload process.

You cannot use UNLDD and UNLDDLST in the same job step. These two keywords accomplish the same thing, but in different ways. UNLDD uses substitution characters; if you want to specify output and input ddnames as pairs (full ddname replacements) in a one-to-one list, use UNLDDLST. For more information, see UNLDDLST.

To ensure that you have the JCL set up correctly, the Reorg function checks the ddnames and the data set names paired with them.

Note

Do not specify DD statements for the old (original) secondary indexes when you use the UNLDD keyword; the Reorg function ignores these DD statements. For more information, see Secondary indexes—Reorg function (Fast Reorg Facility/EP).

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

You can set the default value for the UNLDD option by changing the FRF$GLBL global options module. Sample JCL is in member #FRFGLBL of the sample library.

Example

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

To define the ddnames TESTZZ1, TESTZZ2, and TESTZZX for the unload data sets, specify the following keyword with the REORG command:

UNLDD(ZZ,5)

Positions 5 and 6 of the ddname (DD in the original ddnames) are replaced with ZZ in each ddname.

The following table shows examples for the UNLDD keyword.

Old DBD ddname	Associated data set name	Substituted ddname	Associated data set name
TESTDD1	New data set name for the primary database DSG1 that will be reloaded	TESTZZ1	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	TESTZZ2	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	TESTZZX	The old (original) data set name for the primary index database that will be unloaded

UNLDD

BMC AMI Online Reorg for IMS 5.1

On this page