Added February 2017
xcall FNDUSR, user'name, status, user'map
FNDUSR.SBX emulates the AMOS subroutine of the same name, acting as a companion to MUSER.LIT and LOGON.LIT to retrieve information about the current (or another) user from the database.
xcall FNDUSR, user'name, status, user'map
Parameters
user'name (String) [in/out]
is the name to look for. If blank, the current user is retrieved.
status (F,6) [out]
returns 0=success, else unable to locate user
user'map (Structure) [out]
returns attributes of found user:
MAP1 USER'MAP
MAP2 USER'NAME,S,20
MAP2 USER'FLAGS,F,6
MAP2 USER'ROOT'PPN,S,10
MAP2 USER'ROOT'DEVICE,S,10
MAP2 USER'MAIL'PPN,S,10
MAP2 USER'MAIL'DEVICE,S,10
MAP2 USER'MAIL'CPU,S,10
MAP2 USER'PRIV,F,6
MAP2 USER'CLASS,F,6
MAP2 USER'EXP,F,6
MAP2 USER'CPU'TIME,F,6
MAP2 USER'CONNECT'TIME,F,6
MAP2 USER'KRAM,F,6
MAP2 USER'DISK'READS,F,6
MAP2 USER'DISK'WRITES,S,6
MAP2 USER'PAGES'PRINTED,F,6
MAP2 USER'DEFAULT'PROTECTION,F,6
MAP2 USER'DEFAULT'PRIORITY,F,6
MAP2 USER'DEFAULT'LANGUAGE,F,6
MAP2 USER'DEFAULT'PROMPT,S,20
The above structure is also defined as DEFSTRUCT ST_USER_MAP in ASHINC:USER.DEF.
History
2017 February, A-Shell 6.4.1543: FNDUSR.SBX version 1.0(101) added to A-Shell
