Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-52
USERDEFAULTS Procedure
(Superseded by USER_GETINFO_ Procedure )
<10:12> execute
<13:15> purge
where the legitimate fields are encoded with numbers that represent the following
information:
0 A (any local user)
1 G (any local group member)
2 O (only the local owner)
3 not used
4 N (any network user)
5 C (any network group/community user)
6 U (only the network owner)
7 - (only the local super ID)
Condition Code Settings
= (CCE) indicates that the default information is returned for the specified user.
> (CCG) indicates that the specified user ID or user name is undefined.
< (CCL) indicates that a required parameter is missing, that a buffer is out of
bounds, or that an I/O error occurred on the user ID file
($SYSTEM.SYSTEM.USERID).
Considerations
Either user-id or user-name must be supplied. When both parameters are
supplied, then
user-id is used and user-name is treated as an output parameter; in
this case, no attention is paid to the current contents of the
user-name parameter.
Example
Suppose that a process needs to acquire default user information about its actual
creator (process access id). Code similar to the following example might be used to
obtain such information:
INT ERROR;
INT USERID;
INT .USERNAME[ 0:7 ];
INT USERFILESEC;
INT .USERVOLSVOL[ 0:7 ];
.
.
.
USERID := CREATORACCESSID;
ERROR := USERDEFAULTS (USERID, USERNAME,
USERVOLSVOL, USERFILESEC);
IF ERROR THEN
BEGIN ! error !
.
.
END
ELSE