Unloading the Security Information › Run the Unload Utility › Control Statements › GLOBALID Control Statement—Specify the Global ID

GLOBALID Control Statement—Specify the Global ID

A global ID connects userids from several systems to a single user. For example, an individual user can have two userids (TESTID1 and TESTID2) on system image SYSTEMT and one userid (PRODID1) on system image SYSTEMP. A global ID allows all of the userids to be associated to the individual user.

By default, the unload utility populates the GLOBALID column in the IDMAP table with a value that corresponds to the eight-character ACID that is being processed.

To substitute a different value in the GLOBALID field, use the GLOBALID control statement to specify an ACID field or an exit routine to populate the GLOBALID column.

Note: Only one GLOBALID input control statement can be specified in the SYSIN file. The GLOBALID keyword cannot be abbreviated.

This control statement has the following format:

GLOBALID FIELD(field_name)|EXIT(exit_name)

GLOBALID FIELD(field_name)

Specifies the external name of a field from a predefined list of fields in the userid (ACID) or specifies a user-defined field that has a length of less than 32 bytes. The unload utility uses the value of the field as the GLOBALID value. If a GLOBALID value does not exist on the userid for the specified field, the GLOBALID field is left blank and a warning message appears in the Unload report.

Note: The FIELD keyword cannot be specified with the EXIT keyword. The FIELD keyword cannot be abbreviated.

GLOBALID FIELD(exit_name)

Specifies the name of a user GLOBALID exit module residing in the link pack area (LPA). The unload utility calls this exit to supply a GLOBALID. The utility passes a parameter list to the exit that contains the current userid value that is being processed. The utility expects the user exit to return a valid, 1- to 32-byte GLOBALID value for that userid in the parameter list. If the exit does not return a GLOBALID value, the unload utility terminates with an error.

Note: The EXIT keyword cannot be specified with the FIELD keyword. The EXIT keyword cannot be abbreviated. For more information about using the GLOBALID exit, see the appendix GLOBALID Exit.