Previous Topic: GAP Keyword—Specify if a Profile is Globally AdministeredNext Topic: GROUP Keyword—Define Groups to an ACID

Keywords › GID Keyword—USS Group Security

GID Keyword—USS Group Security

Valid on z/OS and z/VM.

Use the GID keyword to assign a numeric value to an ACID of type GROUP for security within USS. The GID is shared by one or more ACIDs by adding the GROUP to every ACID allowed to use it. GID's may be explicitly assigned to a GROUP or automatically assigned within a numeric range by CA Top Secret. A range for the assignment may be specified or will default to the range in the DFLTRNGG control option.

Note: After you add a GID to a GROUP, the assignment will take effect after performing the following command:

TSS MODIFY(OMVSTABS)

Attempts to use the GID assignment before the OMVSTABS have been refreshed will have unpredictable effects on the acid's attempts to use USS services.

This keyword has the following format:

TSS ADD(acid) GID(USS_group_id)

TSS ADD(acid GID(?)[RANGE(low—gid,high—gid)]
acid

Indicates the accessor-id being updated.

GID

Indicates that a USS GID is assigned to this acid.

USS_group_id

Indicates the administrator has selected a numeric GID for this acid. The GID is uniquely assigned to an acid of type GROUP.

Range: 1 to 2147483647

?

(This is the autogid feature.) Indicates that the USS GID is assigned by CA Top Secret. If RANGE is specified in the command, the GID is the first unused positive integer greater than or equal to the low-GID, and less than or equal to the high-GID. If RANGE is not specified, the product will assign the first available integer in the range defined by DFLTRNGG control option. This value cannot be used with REMOVE.

RANGE
low-gid

Indicates the lowest assignable GID available to this ACID.

Range: 1 to 2147483647

high-gid

Indicates the highest assignable GID available to this ACID

Range: 1 to 2147483647

This keyword is used with the commands ADDTO, REMOVE, and REPLACE.

Examples: GID keyword

This example indicates that group ID GRPACID1 has a GID of 93456:

TSS ADDTO(GRPACID1) GID(93456)

Note: After you add a GID to an ACID, issue:

TSS MODIFY(OMVSTABS)

This example removes the connection between a GID and an ACID:

TSS REMOVE(GPACID1) GID(93456)

This example automatically assigns a number to an ACID using the default range:

TSS ADDTO(groupacid) GID(?)

This example automatically assigns a number to an ACID in the inclusive range 10,000 to 200,000:

TSS ADDTO(groupacid) GID(?)
                     RANGE(10000,200000)