Previous Topic: @SYSID-System Identification MacroNext Topic: @VALUES-Generate Verification Values


@UID-User Identification String Macro

The @UID macro specifies the logonid character fields CA ACF2 for z/VM concatenates (in the specified sequence) to form the UID. CA ACF2 for z/VM dynamically constructs the UID by concatenating these fields from the user's logonid record. It then uses the UID for comparisons during rule interpretation. You can specify only one @UID macro in the ACFFDR. The maximum length of the total UID is 24 characters. CA ACF2 for z/VM considers the LID field to be eight characters, unless you specify only a partial field. The default ACFFDR defines the UID as the LID field of the logonid record. The syntax of the @UID macro is:

@UID field,...,field|(lidname,length),...,(lidname,length)
field

Specifies the external name (specified in the name operand of the @CFDE macro) of the logonid character field to use (NAME). If the UID should not include the full field, you can specify the lidname,length format instead of the field name to select a partial field.

lidname,length

Specifies the internal name of the logonid character field CA ACF2 for z/VM uses (LIDNAME, the symbol operand of the @CFDE macro) and its length. The internal name is the name from the LIDREC DSECT and can be any valid equate, such as LIDLID or LIDLID+1. The length value can be a constant or any valid equate, such as L'LIDLID‑1. For example, to specify a UID made up of the default account number (TSOACCT) plus only the second through fourth characters of the LID, the @UID entry is @UID TSOACCT,(LIDLID+1,3).

The following ACF subcommand displays the configuration of the UID as defined in the @UID macro:

SHOW UID