CREATE: Creating a new control data set record

Explanation: CREATE(offset data) is an optional parameter specifying that you want to create a new data set. The LENGTH parameter controls the size of the record to be created.

For offset, substitute a decimal number for the offset where you want the data inserted. The number you specify can be any number from zero up to a number equal to the length of your CDS record. You specify the data for the variable portion of the record. The FIXCDS command automatically creates the key and header portions of the record.

For data, substitute hexadecimal characters or alphameric characters and $, #, or @ to be inserted into the new record. You cannot specify more than 256 bytes (512 hexadecimal digits), and you should 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'. The new record contains all zeros after the header field, unless you supply data.

Abbreviations: None.

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

Note:

The offset of the first byte of the variable data of the record is zero. The offset of the last byte of the variable data of the record is one less than the length of the variable data.
If you are creating a tape table of contents (TTOC) extension record, be sure to update the TTCNUM field for the TTOC base record for the volume. This halfword field is the total count of the base and the extension records for the volume.
If you are creating a migration level-1 free space (MC1) or JES3 volume activity count (VAC) continuation record, be sure to patch the continuation flag in the appropriate lower-level record to binary ‘1’.
If you are creating an MCL record, an associated MCD record must currently exist. If the MCD record does not exist, the FIXCDS command is failed. If the MCD does exist, the MCD record is updated to contain the 43rd character of the newly created MCL record key.
If you are creating an MCL record, the first two bytes of the record cannot be changed. This area contains the 43rd and 44th character of the data set name. If this area is specified to be updated, the FIXCDS command is failed.