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

Creating VMO Records

The INSERT subcommand under the CONTROL(VMO) setting creates a VMO record to define system options. The syntax for this INSERT subcommand is:

       { *                          }
Insert { recordname                 }
       { USING(oldrecord newrecord) }
 
       [ SYSid(?|sysid)             ]
       [ USYSid(?|sysid)            ]
       [ field1,field2,...,fieldn   ]
       [ ADD|REP|DEL                ]

Issue the INSERT subcommand with the SYSID, record ID, and fields defined in the record:

ACF
SET CONTROL(VMO)
INSERT SYSID(cpu1) PSWD MAXTRY(2) MINPSWD(5)

This sample subcommand inserts the PSWD VMO record. It defines the password options MAXTRY and MINPSWD. When CA ACF2 for VM is running under the SYSID of CPU1, users have a maximum of two attempts to enter the correct password before the session is canceled. All passwords must contain at least five characters. If you do not specify the SYSID parameter, options are defined for the default SYSID.

The INSERT subcommand has the following parameters:

*

Specifies that you want to use the same recordname as the last record processed since you established the CONTROL(VMO) setting. The asterisk does not work with multiple records or masking.

recordname

Specifies the name of the VMO record being inserted. You cannot mask this field. Acceptable values are:

• APPLDEFqual
• BACKUP
• CLASMAPqual
• CMDLIM
• DBSYNC
• DIAGLIM
• EXITS
• LINUXqual
• MAINTqual
• PSWD
• OPTS
• RESCLASS
• RESTYPE
• RESWORD
• RULEOPTS
• SAFDEFqual
• SSFTYPE
• TAPEVOLS
• WARN

USING(oldrecord newrecord)

Identifies a model record to create the new VMO record. All values from the model record are inserted into the new record. Any other fields and values specified in the INSERT subcommand add to or replace the fields and values in the new record. If you specify the USYSID parameter, the USING parameter is not required. (CA ACF2 for VM assumes that you want to copy the record for the SYSID specified in the USYSID parameter, but with the same record identification as the record you are inserting.)

USYSID(?|sysid)

Specifies the SYSID for a model record to create the new VMO record. You can specify the ID for this record ID with the USING or RECID parameter. If you specify a question mark (?) instead of a SYSID, the currently active SYSID is used. This time‑saving feature inserts a record similar to a record previously defined for another SYSID. You can change any fields and values that differ with the INSERT or CHANGE subcommand. You cannot mask the SYSID in this parameter. USYS is an acceptable abbreviation for the name of the USYSID parameter.

SYSID(?|sysid)

Specifies the one‑ to eight‑character SYSID where this record applies. A question mark (?) indicates that you want to use the currently active SYSID for this system. If you do not specify this operand, CA ACF2 for VM uses the default SYSID when you establish the CONTROL(VMO setting or the SET SYSID(sysid) subcommand for this session. SYS is an acceptable abbreviation for SYSID.

field1,field2,...,fieldn

Specifies the fields and values added to the new record (or to replace fields copied from a model record). For the specific field names in each record, refer to the previous description of the VMO records and their fields. These rules apply to field names:

• State the field name to turn on bit fields. Prefix the field name with NO to turn them off.
• Specify the value in parentheses for fields with variable or character values. For example, TIME(12:30).
• Specify the multiple values in parentheses for fields that are defined with the capacity to contain multiple values. Use a space or comma as a delimiter in the parentheses.

ADD

Indicates that the specified fields and values are added to those copied from the model record. If a value already exists in a VMO field, the new value replaces the copied value. If the field allows multiple values, the new value is added to the existing values. ADD is the default. If you do not specify the ADD, REP, or DEL parameters, ADD is assumed.

REP

Indicates that any value specified for a field completely replaces the value of that field as copied from the model record. If any specified field was not copied from the model record, that field and its value are added to the record.

DEL

Deletes the specified field and its value from the newly inserted record. If a field contains multiple values, only the specified values are deleted from the field.