27B GetRTDescr¶
Stub MON 27B (23 decimal) · Mnemonic RTDSC · Group: RT Program Execution (manual section 2.10)
Available from: RT programs (manual compatibility box)
Emulation source: src/handlers/mon_27B_GetRTDescr.c
Description¶
Reads an RT description. The RT description contains various information about an RT program. You specify the RT program address. See the SINTRAN III Real Time Guide (ND-860133) for further details.
- Use GetRTAddress if you only know the name of the RT program.
- This monitor call is only available to background programs in SINTRAN III VSX, version K.
Parameters¶
| Name | Type | Direction | Description |
|---|---|---|---|
RTProgram |
INTEGER | In | RT description address. Use 0 for the calling RT program. |
RTDescriptor |
ARRAY | Out | A 52 byte buffer receiving RT description. |
NoOfConnDev |
INTEGER | Out | Number of devices connected to the RT program through StartOnInterrupt. Returns -1 on invalid RT description address. |
Direction: In = the program supplies the value, Out = the call returns it, In/Out = both.
See also¶
GetOwnRTAddress, @LIST-RT-DESCRIPTION
Compatibility¶
| Machines | Users | Programs |
|---|---|---|
| ND-100 and ND-500 | User RT and user SYSTEM | RT 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 | Yes | No |
Examples¶
From the manual (OCR text, not corrected).
INTEGER : RTProgram, NoOfConnDev
BYTES : RTDescriptor(0:51)
...
Monitor_Call('GetRTDescr', RTProgram, RTDescriptor(0), NoOfConnDev)
INTEGER RTProgram, NoOfConnDev
INTEGER RTDescriptor(26)
...
Monitor_Call('GetRTDescr', RTProgram, RTDescriptor(1), NoOfConnDev)
RTPogram, NoOfConnDev : INTEGER2;
RTDescriptor : ARRAY [0..1] OF RECORD...END;
...
GetRTDescr(RTProgram, RTDescriptor, NoOfConnDev);
01 RTProgram COMP.
01 NoOfConnDev COMP.
01 RTDescriptor.
02 array COMP OCCURS 26 TIMES.
...
MONITOR-CALL "GetRTDescr" USING RTProgram, RTDescriptor, NoOfConnDev.
RTProgram : W BLOCK 1
NoOfConnDev : W BLOCK 1
RTDescriptor : H BLOCK 32B
GetRTDescr : EQU 37B9 + 27B
...
CALLG GetRTDescr, 2, RTProgram, RTDescriptor
IF K GO Error
W1 =: NoOfConnDev %Result is returned in W1 register.
...
Error, ...
LDA (PAR %Load register A with address of parameter list.
MON 27 %Monitor call GetRTDescr.
JAN ERROR %Handle error if register A is negative.
STA NODEV %Store number of connected devices.
...
ERROR, ... %Handle this error, register A = -1.
...
NODEV, 0
PAR, RTPRO %Address of RT description.
BUFF %Buffer receiving RT description.
...
RTPRO, ...
BUFF, 0
*+32B/ %Make a 52 byte buffer.
Scanned by Jonny Oddene for Sintran Data © 2020
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_27B_GetRTDescr |
| Code lines | 6 (non-blank, non-comment lines in the file) |
Source¶
SINTRAN III Monitor Calls (ND-860228.2 EN), page 271.