Modify component

The Modify Component function (option M) changes attribute values for a cluster. This function allows incorrect values to be modified without deleting and reallocating the cluster.

To modify the attributes of a VSAM cluster or alternate index, fill in the following fields of the VSAM utilities panel (VSAM Utility Screen):

Enter M in the select option field.
Enter the Cluster Name in the dataset name field.
Set processing option to O (online), B (Batch), or I (Batch IDCAMS).
If the data set is cataloged in a catalog which is not connected to the master catalog through the high level qualifier, enter the catalog name in the catalog name field.

When you press Enter, File-AID displays the VSAM Modify screen (see the following figure) which will contain attribute values reflecting the current status of the object and on which you enter the new attributes. Press Enter to process your changes online or in batch.

VSAM Modify Screen

File-AID ---------------------- VSAM Modify ---------------------------------
COMMAND ===>
                                                                    More:     +
Cluster:                    TSOID01.FASAMP.EMPLOYEE
Owner ID               ===>

Specify SMS Class Information:
   Storage     ===>           Management    ===>

Specify Current Options:
   Buffer size           ===> 6144
   Region share option   ===> 3          (1; 2; 3; 4)
   System share option   ===> 3          (3; 4)
   % free bytes/CI       ===> 0          (0 - 100)
   % free CI/CA          ===> 0          (0 - 100)
   Inhibit update        ===> NO         (Y = Yes; N = No)
   Write check           ===> NO         (Y = Yes; N = No)
   Erase on delete       ===> NO         (Y = Yes; N = No)
   Expiration Date       ===>            (YYYY/MM/DD or blank)
   Exception-Exits:
      Data component     ===>
      Index component    ===>
   Account Information   ===>
   RLS                   ===>            (E=RLSENABLE; Q=RLSQUIESCE)
   LOGREPLICATE          ===>            (L=LOGREPLICATE; N=NOLOGREPLICATE)
   LOG                   ===>            (N=NONE; U=UNDO; R=REDO; A=ALL)
   FRLOG (BATCH LOGGING) ===>            (N=NONE; U=UNDO; R=REDO; A=ALL)
   LOGSTREAMID           ===>
   BWO                   ===>            (C=TYPECICS; I=TYPEIMS; N=NO)

Use ENTER to modify data, END to cancel request

Field Descriptions

Attributes of the cluster that are not displayed on this screen cannot be changed. In such case, reallocate the cluster. Use the END command (PF3) to cancel the cluster modification process.

Cluster

Name of the cluster specified on the VSAM Utility screen.

Owner ID

Specify the owning user ID.

Specify SMS Class Information:

(These fields are displayed for SMS sites only.)

Storage

SMS storage class. The storage class describes the hardware requirements of the data set.

Management

SMS management class. The management class describes the migration, backup, and retention for the data set.

Specify Current Options:

Specify the cluster’s new attributes by verifying or changing the values on the screen.

Buffer size

Specify a value.

Region share option

Specify one of four values:

1 - Multi-user: read only; single user: read/write

2 - Multi-user: read; single user: write

3 - Multi-user: read/write

4 - Multi-user: read/write, requires ENQ and DEQ.

System share option

Specify one of two values:

3 - Fully shared system

4 - User is responsible for system integrity.

% free bytes/CI

The number of free bytes in one control interval will be the percentage applied to the control interval size rounded down.

% free CI/CA

The number of free control intervals in one control area will be the percentage applied to the number of control intervals in one control area rounded down.

Inhibit update

Specify a value of Y (Yes) or N (No). If set to Y the data set cannot be processed except for read.

Write check

Specify a value of Y (Yes) or N (No).

Erase on delete

Specify a value of Y (Yes) or N (No).

Expiration Date

(Optional) Specify a date after which deletion or update of data set is permitted in the format: YYYY/MM/DD. To remove the expiration date, change it to today’s date.

Exception-Exits (Data and Index components):

The name of a user-written exception-exit routine that receives control when an exceptional I/O error occurs for the Component.

Account Information

Change the up to 32 bytes of accounting information and user data for the data set.

RLS

(z/OS 2.1 and up) Specifies whether the cluster's components are to be created in the RLSQUIESCE or ENABLE mode.

LOGREPLICATE/NOLOGREPLICATE

(z/OS 2.1 and up) Identifies whether or not the VSAM dataset being defined is eligible for VSAM replication.

LOG(NONE/UNDO/ALL/REDO)

Establishes whether the sphere to be accessed with VSAM RLS is recoverable or nonrecoverable.

FRLOG

Specifies whether VSAM batch logging can be performed for your data set.

LOGSTREAMID

Changes or adds the name of the forward recovery log stream.

BWO

Use this parameter if backup-while-open is allowed for the VSAM sphere.