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

INSERT Subcommand

The INSERT subcommand lets you create an XREF record for X‑SGP or X‑RGP records, depending on the type you specified in the SET command.

The INSERT subcommand has the following syntax:

        {*                     }
Insert  {recid Type(typelist)           }
         USING(modelrecid) newrecid
         Type(typelist)
        [SYSid(?|sysid)|DIVision(?|div)]
        [USYSid(?|sysid)|UDIVision(?|div)]
        [Source|Group ]
        [Resource|Group]
        [Include(entry1,...,entryn)]
        [Exclude(entry1,...,entryn)]
        [ADD|REP|DEL]

The INSERT subcommand accepts the following parameters:

* (asterisk)

Specifies the last record you processed while in this ACF command setting. The asterisk specifies only one record. You cannot use the asterisk to represent a record mask.

recid

Specifies the name of the XREF record you want to create. You cannot use masking characters to specify a group of records. 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 the 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‑SGP group records. The ADD, REP, and DEL parameters apply to the types you specify.

The type codes you specify must be defined in a resident typelist before you process the resource group record.

USING(oldrecid) newrecid

Identifies a model XREF record that you want to use to create a new XREF record. All values from the model record are inserted into the new record. Any other fields and values you specify 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.

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 USYSID), CA ACF2 for VM uses the SYSID value you specified when you establish 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 “Processing Shift and Zone Records” chapter. DIVISION is a synonym for SYSID.

USYSid(?|sysid)|UDIV(?|div)

Specifies the SYSID of a model XREF record you want to use to create a new XREF record. Specify this record ID with the a SYSID, the default SYSID is used. UDIV is a synonym for USYSID.

This time‑saving feature lets you insert a record that is similar to a record previously defined for another SYSID. To change any fields and values that differ between the model and the new record, use the ADD, REP, or DEL parameters (described below).

Source|Group

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

Resource|Group

Specify RESOURCE to create a resource group record. Specify GROUP to create a group of resource group records. These parameters apply to the X‑RGP 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 copied from the model 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 specified sources or resources in the model record with those you specify. If any source or resource is not part of the model record,
CA ACF2 for VM adds that source or resource to the record. This parameter applies to multivalued fields only.

DEL

Deletes the specified source or resource from the newly inserted record. If a field can contain multiple values, then CA ACF2 for VM deletes just the values you specify from the field. This parameter applies to multivalued fields only.