NEWKEY: Renaming a control data set record

Explanation: NEWKEY(keyname) is an optional parameter specifying that a control data set record be renamed. For keyname, substitute 1 to 44 EBCDIC characters or specify the new key as hexadecimal. Do not include the 1-byte hexadecimal identification in the keyname. The 1-byte hexadecimal ID is the first byte of the internal format of keys. The types are E, F, G, H, I, J, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, and 1 records.

Abbreviations: None.

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

Note:

You must specify the same record type as the one you specified with the type parameter. The record with the new key is the same as the record with the old key.
When you specify the key as hexadecimal, specify an even number of hexadecimal digits. If you specify an odd number of hexadecimal digits, DFSMShsm inserts a zero to the left of the value to make it an even number. Hexadecimal characters must be in the form X'n'.
If the FIXCDS NEWKEY parameter is performed on a DFSMShsm record and the new data set name (DSN) that is specified by the NEWKEY parameter differs from the original data set name, then any subsequent function which references the original data set name will fail.
If an MCL record is specified, the FIXCDS command will fail.