Changing VMO Records

Defining Structured Infostorage Records › Maintaining VMO Options › Changing VMO Records

Changing VMO Records

Use the CHANGE subcommand under the CONTROL(VMO) setting to change existing VMO records. The syntax for this CHANGE subcommand is:


       { *                 }
CHange { recordname        }field,...,field
       { LIKE(recordmask)  }[ADD|DEL|REP]
 
       [ SYSid(sysid)      ]
       [ MSYSid(sysidmask) ]

The following CHANGE subcommand alters the BACKUP VMO record so that the time of the automatic backup is scheduled for 02:00:

ACF
SET CONTROL(VMO)
CHANGE BACKUP TIME(02:00)

Because we did not specify a SYSID, the subcommand affects the BACKUP VMO record for the default SYSID. The CHANGE subcommand has the following parameters:

*: Specifies that you want to use the same recordname as the last record you processed since you established the CONTROL(VMO) setting. The asterisk does not work with multiple records or masking.
SYSID(sysid): Specifies the SYSID of the VMO record to be changed. If you specify a question mark (?) as the SYSID value, CA ACF2 for VM uses the default value for the system. Any value you specify with the SYSID parameter can contain asterisks or a trailing dash. These characters are treated as part of the SYSID itself and not as an indication of masking. If you specify the SYSID parameter, you cannot specify the MSYSID parameter. SYS is an acceptable abbreviation for the parameter name SYSID.
MSYSID(sysidmask): Specifies a mask to indicate the SYSIDs where the specified VMO record is changed. This SYSID mask must contain at least one asterisk or a trailing dash. VMO records changed with this parameter have the same record ID, but different SYSIDs. MSYS is an acceptable abbreviation for the parameter name MSYSID.
recordname: Specifies the record ID to be changed.
LIKE(recordmask): Specifies a mask for the VMO record IDs to be listed. You cannot abbreviate the LIKE parameter. Masking follows the same conventions that apply to logonids.
ADD: Indicates that CA ACF2 for VM adds any fields and values specified with the CHANGE subcommand to the existing fields and values in the specified VMO record. If a field already exists in a record, then it is not added. However, if a field takes multiple values, then the specified values are added to the existing values in the field. If you do not specify the ADD, REP, or DEL parameters, ADD is assumed.
REP: Indicates that any fields specified with this CHANGE subcommand completely replace the corresponding field in the specified VMO record. If a specified field does not currently exist in the record, that field and value is added to the record.
DEL: Indicates that any fields and values specified with this CHANGE subcommand are deleted from the specified VMO record. If any specified value does not exist in a field, the field remains unchanged.
field,...,field: Specifies the fields and any values to change as the ADD, REP, or DEL parameter directs. For the specific field names in each record, refer to the previous description of the VMO records and their fields.