57B GetUserParam¶
Stub MON 57B (47 decimal) · Mnemonic PAGEI · Group: Monitor Calls for Error Handling (manual section 2.8)
Available from: Background programs (manual compatibility box)
Emulation source: src/handlers/mon_57B_GetUserParam.c
Description¶
Gets information about why the last program terminated. There are 5 parameters for each background user. These can be set by SINTRAN III or your background program.
- Use SetUserParam to set the parameter values.
- SINTRAN III sets some of the parameter values if you give the command @ENABLE-TERMINATION-HANDLING first.
Parameters¶
| Name | Type | Direction | Description |
|---|---|---|---|
Buff |
INTEGER2[5] | Out | 5-word buffer for user parameters. [0]=dir/user index, [1]=terminal LDN, [2]=error number (-1 if escape), [3-4]=user defined. |
Direction: In = the program supplies the value, Out = the call returns it, In/Out = both.
See also¶
TerminationHandling, GetND500Param, @DEFINE-TERMINATION-HANDLING, @DISABLE-TERMINATION-HANDLING, and @SET-USER-PARAMETERS
Compatibility¶
| Machines | Users | Programs |
|---|---|---|
| ND-100 and ND-500 | All users | Background 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 |
|---|---|---|---|---|
| No | No | Yes | Yes | No |
Disagreement
The manual box says ND-100 and ND-500, but the yes/no fields say ND-100 = No, ND-500 = No. The manual box is the source.
Examples¶
From the manual (OCR text, not corrected).
BYTES : Buff(0:9)
...
Monitor_Call('GetUserParam', Buff(0))
INTEGER Buff(5)
...
Monitor_Call('GetUserParam', Buff(1))
Buff : RECORD...END;
...
GetUserParam(Buff);
01 Buff.
02 array COMP OCCURS 5 TIMES.
...
MONITOR-CALL "GetUserParam" USING Buff.
Buff : H BLOCK 5
GetUserParam : EQU 37B9 + 57B
CALLG GetUserParam, 1, Buff
LDA (PAR %Load register A with address of parameter list.
MON 57 %Monitor call GetUserParam.
PAR BUFF
%Buffer of 5 words to receive user parameters.
BUFF |
---|
0 | %Left byte: dir.index. Right byte: user index.
0 | %Logical device number, terminal number.
0 | %-1 if escape, otherwise error number.
0 | %User defined.
0 | %User defined.
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_57B_GetUserParam |
| Code lines | 5 (non-blank, non-comment lines in the file) |
Source¶
SINTRAN III Monitor Calls (ND-860228.2 EN), page 301.