NET/MASTER Network Control Language (NCL) Reference Manual

SWGUID
Verbs
3–184 106126 Tandem Computers Incorporated
SWGUID The SWGUID verb changes the Guardian user ID under which an NCL process is
running. The new value must be one that is valid as defined for the user in the user’s
current profile. The current profile is the profile of a user that exists in memory; this is
not necessarily the same as the profile of the user that exists in the User ID
Management Services (UMS) database. Because a user may (with the necessary
authority) change the list of valid Guardian user IDs in the UMS database, the list of
valid user IDs contained in the database may differ from the list of valid user IDs in
memory. If it is important that these images coincide, you must use the SIGNON
command or log off and log on again to NonStop NET/MASTER MS.
If you use SWGUID with no operands, the default Guardian user ID of the current
user is installed.
SWGUID NUMBER= (group,user)
NUMBER= (group,user)
specifies the new Guardian user ID.
Considerations
NCL sets the &SYS.RETCODE system variable to 0 (zero) if the change is effected,
or to 16 if the new user ID was not allowed.
All NonStop NET/MASTER MS users may have one or more Guardian user IDs
(GUIDs) defined in their user ID definition record: for example, 100,21 and
100,255. A user can use the PROFILE GUID command to switch from one GUID
to another in OCS. When an NCL procedure is executed by a user, the NCL
process executes under the current GUID of the user.
When an NCL process is started by a SUBMIT command, the submitted process’s
user ID can be changed to one of the user IDs valid for the submitter. For
example, if you enter the following command string:
SUBMIT LOGP START PROC1
and the NCL process PROC1 changes the user ID, the new user ID must be one
that is valid for the submitter and replaces that of the process. That is, the new
user ID replaces the user ID that was current for the submitter when the SUBMIT
command was issued.