TOPS-10 Monitor Calls Manual Volume 2 AA-K039D ... - Trailing-Edge

RUN [CALLI 35]
22.142 RUN [CALLI 35]
FUNCTION
Transfers execution control from the current program to another
program. The monitor replaces both the high and low segments of your
address space with the segments of the called program. The function
of the RUN UUO is described in more detail in Chapter 2 Volume 1.
CALLING SEQUENCE
addr:
MOVSI ac,start-addr-increment
HRRI ac,addr
RUN ac,
error return
SIXBIT/device/
SIXBIT/filename/
SIXBIT/extension/
EXP 0
/ XWD proj,prog \
\ XWD O,addrl /
/ XWD O,core \
\ XWD -1"addr2 /
ior zero
iPPN word
icore word
In the calling sequence, the program supplies the following variables:
o
o
start-addr-increment is an increment to the starting address
of the called program. This increment is used to call
indirect command files and should be 0 or 1. If any other
value is used, the meddling bit is set for the job, unless
the program is execute-only. For an execute-only program,
this value can be only 0 or 1.
addr is the address of the argument block, which is formatted
like the ENTER argument block. See Volume 1, Chapter 11 for
a description of ENTER/LOOKUP argument blocks.
o core is the total amount of core to be reserved for the
called program. This word must be included, but may be zero.
For a program that contains both low and high segments, the
amount of core required to load the high segment is
subtracted from the core assignment first. The amount
reserved for the low segment is the remainder.
o addr2 contains a section offset indicating where the image
should be loaded. Using this argument results in an error if
the resulting section number is illegal.
When the monitor returns control to the program after RUN monitor
call, the accumulators are overwritten and Channel 0 is cleared.
SUCCESS RETURN
The new program is started at its new address plus
start-addr-increment. The contents of ac may be changed on the
return, and the new contents are unpredictable, because they vary from
one monitor release to the next. The RUN call also performs an
implicit RESET call.
22-356