406B AccessRTCommon¶

Stub MON 406B (262 decimal) · Mnemonic RWRTC · Group: RT Program Execution (manual section 2.10)

Available from: RT programs (manual compatibility box)

Emulation source: src/handlers/mon_406B_AccessRTCommon.c

Description¶

Reads from or writes to RT common from an ND-500 program. RT common is an area in physical memory where RT programs may exchange data.

Some SINTRAN III systems are generated without RT common. The size of RT common is defined at the time of system generation. The size may be increased by up to 8 pages by the SINTRAN-SERVICE-PROGRAM command DEFINE-RTCOMMON-SIZE (see the SINTRAN III Commands Reference Manual, ND-860128, for more information).

Parameters¶

Name	Type	Direction	Description
`Func`	INTEGER	In	Function: 0=read, 1=write.
`RTCommon`	INTEGER	In	RT common address (ND-100 16-bit word address).
`NoOfBytes`	INTEGER	In	Number of bytes to read or write.
`Buffer`	ARRAY	In/Out	Buffer of data to be read or written.

Direction: In = the program supplies the value, Out = the call returns it, In/Out = both.

Compatibility¶

Machines	Users	Programs
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
No	Yes	No	Yes	No

Examples¶

From the manual (OCR text, not corrected).

PLANCFORTRANPascalCOBOLASSEMBLY-500

INTEGER : Func, RTCommon, NoOfBytes
BYTES : Buffer(0:199)

Monitor_Call('AccessRTCommon', Func, RTCommon, NoOfBytes, Buffer(0))

INTEGER Func, RTCommon, NoOfBytes
INTEGER Buffer(100)
...
Monitor_Call('AccessRTCommon', Func, RTCommon, NoOfBytes, Buffer(1))

Func, RTCommon, NoOfBytes : LONGINT;
Buffer : ARRAY [0..6] OF RECORD...END;

    AccessRTCommon(Func, RTCommon, NoOfBytes, Buffer);

01 Func COMP.
01 RTCommon COMP.
01 NoOfBytes COMP.
01 Buffer.
   02 array COMP OCCURS 100 TIMES.
...
MONITOR-CALL "AccessRTCommon" USING Func, RTCommon, NoOfBytes, Buffer.

Func : W BLOCK 1
RTCommon : W BLOCK 1
NoOfBytes : W BLOCK 1
Buffer : W ARRAY 100
ErrCode : W BLOCK 1
AccessRTCommon : EQU 37B9 + 406B

CALLG AccessRTCommon, 4, Func, RTCommon, NoOfBytes, Buffer
IF K GO ERROR


Error : W1 = ErrCode  %Error code in the W1 register.

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_406B_AccessRTCommon`
Code lines	9 (non-blank, non-comment lines in the file)

Source¶

SINTRAN III Monitor Calls (ND-860228.2 EN), page 73.