Explanation: EXPAND(bytes)
is an optional parameter specifying that a control data set record
be expanded by the specified number of bytes. The new portion of the
record is set to binary zeros. For bytes,
substitute a decimal number for the number of bytes by which you want
the record to be expanded.
Abbreviations: None.
Defaults: If you do not specify one of the
optional parameters of FIXCDS, the default is DISPLAY.
Note: - If the expanded record length is more than 2040 bytes, the FIXCDS
command fails.
- If you expand the CDS record length beyond the maximum record
length specified when the control data set was defined, your CDS may
become unreadable.
- If a backup cycle volume record (BVR) is being expanded, the specified
length must be an even multiple of 12 bytes, the length of the volume
entry in the BVR.
- If a BVR is being expanded, the resultant record length must not
be able to contain more than the maximum number of volume entries.
If the maximum record length is 1016 bytes in length, 78 entries can
be put in each BVR. If the maximum record length is 2040 bytes in
length, 164 entries can be put in each BVR.
- When a BVR is expanded, the number of volume entries is incremented
to reflect the new number of volume entries. If you subsequently update
these new volume entries with volume serial numbers, you must ensure
that the volume full flag is turned off in the BVR by using the appropriate
FIXCDS PATCH command.
- When expanding a record that was created by a previous release
of DFSMShsm, the results may not be as expected. The length of CDS
records may change from release to release, and DFSMShsm enforces
writing and rewriting records to the correct release. After issuing
an EXPAND request, DISPLAY the record to ensure that the expected
results have been achieved.