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  (Struct)  [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