Maintaining Cross-Reference Records › Processing XREF Records › CHANGE Subcommand

CHANGE Subcommand

The CHANGE subcommand lets you change an existing XREF record. The CHANGE subcommand has the following syntax:

        {*                       }
CHange  {recid                   }
        {LIKE(recidmask)         }
        [Type(typelist)]
        [SYSid(?|sysid)|DIVision(?|div)     ]
        [MSYSid(?|sysidmask)|MDIV(?|divmask)]
        [Source|Group ]
        [Resource|Group]
        [Include(entry1,...,entryn)]
        [Exclude(entry1,...,entryn)]
        [ADD|REP|DEL]

The CHANGE subcommand takes the following parameters:

* (asterisk)

Specifies that you want to change the last record you processed since you established this ACF command setting. (The asterisk does not work in the case of multiple records or masking.)

recid

Specifies the name of the XREF record that you want to change. Record IDs for source group records can be from one to eight characters. Record IDs for resource group records can be from 1 to 24 characters.

Type(typelist)

Specifies a list of type codes of the resources in the INCLUDE and EXCLUDE lists. You can mask this field. This field applies to X‑RGP resource records only. It does not apply to X‑RGP group records. The ADD, REP, and DEL parameters apply to the type codes you specify.

You must define the type codes you specify in a resident typelist before you process the resource group record.

LIKE(recidmask)

Specifies a mask for the XREF records that you want to change. You cannot abbreviate the LIKE parameter. This masking follows the same conventions that apply to logonids, as described in the chapter “About the Logonid Record” in this guide.

SYSid(?|sysid)|DIVision(?|div)

Specifies the one‑ to eight‑character SYSID that you want this to indicate that you want the record to apply to the current active SYSID.

If you do not specify a SYSID (or MSYSID), CA ACF2 for VM uses the SYSID value you specified when you established the ACF command setting. If you did not supply a SYSID when you established the ACF command setting,

CA ACF2 for VM uses the default value defined at CA ACF2 for VM startup time. For further information, see the section on the concept of SYSID. DIVISION is a synonym for SYSID.

MSYSid(?|sysidmask)|MDIV?|divmask)

Specifies a mask to indicate the SYSIDs that you want this changed record to apply to. This SYSID mask must contain at least one asterisk or a trailing dash. Structured infostorage records that you change using this parameter have the same record ID, but different SYSIDs. MDIV is a synonym for MSYSID.

Resource|Group

Specify RESOURCE to create a resource record. Specify GROUP to create a resource group record. These parameters apply to the X‑RGP setting only.

Source|Group

Specify SOURCE to change a source record. Specify GROUP to change a source group record. These parameters apply to the X‑SGP setting only.

Include(entry1,...,entryn)

Specifies a group of sources, source groups, resources, or resource groups that you want this record to apply to. The ADD, REP, and DEL parameters apply to the names you specify in this field.

Exclude(entry1,...,entryn)

Specifies a group of sources, source groups, resources, or resource groups that you do not want this record to apply to. Specify names here only if you specify a mask in the INCLUDE parameter. The ADD, REP, and DEL parameters apply to the names you specify in this field.

ADD

Adds the specified sources or resources to those in the existing record. If a value already exists in a record field, the new value replaces the copied value. This parameter applies to multivalued fields only. The new value is added to the existing values. ADD is the default.

REP

Replaces the sources and resources in an existing record with the fields and values you specify. If any field you specify is not part of the existing record, CA ACF2 for VM adds that field and its value to the record. This parameter applies to multivalued fields only.

DEL

Deletes the specified sources and resources from the existing record. This parameter applies to multivalued fields only. CA ACF2 for VM deletes the values you specify from the field.