ADDMIGRATEDDATASET: Adding an MCDS record for a migrated data set

Explanation: ADDMIGRATEDDATASET(volser) is an optional parameter specifying that a new type D MCDS record be added for a migrated data set residing on the specified volume. The record contains only the minimum information about the data set. See Adding a migrated data set record to the MCDS for an example of how to use the ADDMIGRATEDDATASET parameter of the FIXCDS command to add an MCDS record.

To make the data set eligible for recall, you must issue the PATCH parameter of the FIXCDS command to patch the data set’s fully-qualified migration name (MCDMCANM) padded to the right with blanks.

Field Name	FIXCDS Offset	Explanation
MCDMCANM	156 or X'9C'	The name of the migration copy of the data set that is the key of the MCA record.

In addition, it is necessary to patch the following fields:

Field Name	FIXCDS Offset	Explanation
MCDFRVSN	64 or X'40'	The volume serial number of the primary volume from which the data set has been migrated.
MCDUCBTY	76 or X'4C'	The device type of the primary volume from which the data set has been migrated.

See Verifying and patching a migrated data set record for examples of how to use the PATCH parameter of the FIXCDS command to patch an MCDS.

If the data set is migrated to tape and the data set spans more than one tape, the following fields must be filled in:

Field Name	FIXCDS Offset	Explanation
MCDTPDEV	90 or X'5A'	The bit setting for migrated copies that reside on a tape device.
MCDNVSN	212 or X'D4'	A 2-byte binary number of tape volumes after the tape volume where the data set started.
MCDNVSNO	214 or X'D6'	A binary number representing the offset from the MCDVSN field to the MCDAVSN field. This value can be calculated by issuing the DISPLAY parameter of the FIXCDS command and using the offsets displayed on the screen.

To add the extra volumes to the record, you must first use the EXPAND parameter of the FIXCDS command to increase the length of the D record. The D record must increase 6 bytes for each additional volume serial number that needs to be included. Enter the volume serial numbers of the other tape volumes in the expanded area. The first volume serial number starts at offset +0 in the expanded area, the second at offset +6, and so on. Pad the volume serial number with blanks to the right.

For volser, substitute the volume serial number of the migration level-1 or DASD migration level-2 volume where the migrated data set resides. For tape migration level-2 volumes, substitute the volume serial number of the volume where the migrated data set starts.

Note: This is only true when the data sets are migrated to DASD.

Abbreviations: None.

Defaults: If you do not specify one of the optional parameters of FIXCDS, the default is DISPLAY.

Note:

You can specify the ADDMIGRATEDDATASET parameter only for a type D record. The command fails if you issue it for another record type.
To recall the migrated data set after you have added the new type D MCDS record, add MCDMCANM padded by blanks, to the D record. This only applies to multifile format using migration level-2 tape.