Guardian Procedure Calls Reference Manual

Condition Code Settings
indicates that the default information is returned for the specified user.= (CCE)
indicates that the specified user ID or user name is undefined.> (CCG)
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).
< (CCL)
Returned Value
INT
A file-system error code that indicates the outcome of the call. Common errors returned are:
No error. Default user information is returned as requested.0
End-of-file. The specified user ID or user name is undefined.11
Parameter out of bounds. One of the parameters supplied overlays the stack marker that was created by
calling this procedure.
22
Missing parameter. This procedure was called without specifying one of the required parameters (either
user-id or user-name).
29
For more information on file-system error messages, see the Guardian Procedure Errors and
Messages Manual .
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
The following example code can be used to allow a process to acquire default user information
about its actual creator (process access id):
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
USERDEFAULTS Procedure (Superseded by USER_GETINFO_ Procedure) 1463