44B GetUserEntry¶
Stub MON 44B (36 decimal) · Mnemonic RUSER · Group: File System Operations (manual section 2.9)
Available from: All programs (manual compatibility box)
Emulation source: src/handlers/mon_44B_GetUserEntry.c
Description¶
Gets information about a user. The user entry in the directory is returned. It contains the user name, default file accesses, the pages in use, the password, the table of friends, and more.
- Only user RT and user SYSTEM may read the user entries of other users.
Parameters¶
| Name | Type | Direction | Description |
|---|---|---|---|
UserName |
STRING | In | User name string. May include directory name, e.g. PACK-ONE:P-HANSEN. |
Buff |
ARRAY | Out | Buffer to receive the 64-byte user entry. See appendix C. |
Direction: In = the program supplies the value, Out = the call returns it, In/Out = both.
See also¶
GetUserName, @DUMP-USER-ENTRY
Compatibility¶
| Machines | Users | Programs |
|---|---|---|
| ND-100 and ND-500 | All users | All programs |
The manual's compatibility box for this call, word for word.
Yes/no fields from the YAML extraction (not in the manual's words):
| ND-100 | ND-500 | User programs | RT programs | System programs |
|---|---|---|---|---|
| Yes | Yes | No | No | No |
Examples¶
From the manual (OCR text, not corrected).
BYTES : UserName(0:63)
BYTES : Buff(0:63)
**ON ROUTINEERROR DO**
IF ErrCode > 0 THEN ...
ENDON
Monitor_Call('GetUserEntry', UserName, Buff(0))
CHARACTER UserName*64
INTEGER Buff(32)
...
Monitor Call('GetUserEntry', UserName(1:64), Buff(1))
IF (ErrCode .NE. 0) THEN ...
UserName : PACKED ARRAY [0..63] OF CHAR;
Buff : ARRAY [0..1] OF RECORD...END;
...
ReadUserEntry(UserName, Buff); [Note routine name.]
IF ErrCode <> 0 THEN ...
01 UserName PIC X(64).
01 Buff.
02 array COMP OCCURS 32 TIMES.
01 ErrCode COMP.
...
MONITOR-CALL "GetUserEntry" USING UserName, Buff.
CALL "CbError" USING ErrCode.
IF ErrCode NOT = 0 GO ...
UserName : STRINGDATA 'A-HANSEN' %Get entry of user A-HANSEN.
Buff : H BLOCK 40B
ErrCode : W BLOCK 1
GetUserEntry : EQU 37B9 + 44B
...
CALLG GetUserEntry, 2, UserName, Buff
IF K GO ERROR
ERROR : W1 := ErrCode %ErrorCode in W1 register.
LDA (BUFF %Address for receiving user entry.
LDX (USER %Address of string containing user name.
MON 44 %Monitor call GetUserEntry.
JMP ERROR %Error return from monitor call.
... %Normal return.
ERROR, ... %Error number in register A.
USER, 'A-HANSEN' %Obtain user entry for A-HANSEN.
BUFF, 0
*+40/ %Make a buffer of 32 words.
ndmonlib implementation¶
Stub Registered MON_STATUS_NOT_IMPLEMENTED: the handler is a stub. mon_dispatch() in src/core/mon_dispatch.c reports the call as unimplemented without calling it.
| Handler | mon_44B_GetUserEntry |
| Code lines | 6 (non-blank, non-comment lines in the file) |
Source¶
SINTRAN III Monitor Calls (ND-860228.2 EN), page 297.