Previous Topic: Modify VSAM FileNext Topic: VSAM Utility – Define Path

Utility Functions › VSAM Utility › Modify VSAM File › Field Descriptions

Field Descriptions

Update Allocation Parameters:
% Free CI & CA

CI – Type the amount of empty space to be left in each Control Interval when the file is initially loaded. The free space lets records be inserted or expanded within a Control Interval before requiring a Control Interval split.

CA – Type the percentage of Control Intervals to be left unused in each Control Area as the file is initially loaded. The use of control area freespace lets some Control Interval splits occur before requiring a Control Area split.

Share options

Cross-region – Type a value of one-through-four to indicate how the file can be shared among regions within the same system or within multiple systems using GRS. The meaning of each value is as follows:

  1. The data set can be opened for read processing by an unlimited number of users, but the data set may be accessed by only one user when that user is doing read and write processing.
  2. The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing for read processing.
  3. The data set can be fully shared by any number of users.
  4. The data set can be fully shared by any number of users. For each PUT request, VSAM immediately updates the data set. For each GET request, all input buffers are refreshed.

Cross-system – Type a value of 3 or 4 to indicate how the file can be shared among systems. The meaning of each value is as follows:

The data set can be fully shared by any number of users.

The data set can be fully shared by any number of users. For each PUT request, VSAM immediately updates the data set. For each GET request, all input buffers are refreshed.

Buffer space

This field is used to specify the minimum buffer space allocated when this VSAM file is accessed.

Erase on delete?

Type Y for the Erase on Delete? option to request that the VSAM component definition use the ERASE parameter causing all components of the file to be overwritten with binary zeros when the VSAM file is deleted from the catalog. Type N to have the VSAM component use the NOERASE parameter.

Write check?

Type Y for the Write check? option to request that the VSAM component definition use the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer. Type N to have the VSAM component use the NOWRITECHECK parameter.

Inhibit update?

Type Y for the Inhibit Update? option to request that the VSAM component be altered using the INHIBIT parameter causing the VSAM file to be accessible only for read operations.

Changing the value of this field from 'Y' to 'N' causes the file to be altered using the UNINHIBIT parameter which removes the restriction placed by a previous INHIBIT parameter.

Expiration date

If the VSAM cluster may be deleted after a certain date, type an Expiration Date in CCYYMMDD format.

SMS Class
Storage

Update the one-to eight-position name of the SMS Storage Class to alter the VSAM file to use the specified storage class. The storage class can be used to control the storage hardware used for the data set.

Management

Update the one-to-eight-position name of the SMS Management Class to alter the VSAM file to use the specified management class. You can use the SMS Management Class to control data set characteristics related to the backup, migration, and retention of the data set.

Update Allocated Volumes:
Data and Index

The Update Allocated Volumes section presents a list of the volumes allocated to the data component and if applicable, the index component. To add more volumes to the data or index component, type volume serials in the blank fields at the end of the volume list. To delete or change volume serials allocated to a component, erase or over-key the volume serial in the list. The volume serial of volumes that contains records is protected and cannot be updated.