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
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.
| Field | Description |
| 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:
|
| System share option | Specify one of two values:
|
| % 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. |
Related topics