(SYSLIB) Programming Reference Manual - Public Support Login ...

Appendix F
Interface to Selected Extended Mode
Executive Requests
This appendix describes an interface from Extended Mode Object Modules (EMOM) to a
small subset of basic mode Executive requests (ER). The interface allows a MASM
program executing in Extended Mode (as an object module) to perform selected ERs.
The purpose of this interface is to provide the EMOM programmer with a way to dump
data and perform simple symbiont requests. This is a temporary solution only, provided
for the EMOM programmer’s convenience until the Exec callable interfaces are available.
To use this interface, the MASM program uses PROCs to execute ERs. These PROCs
save the contents of all registers they use (including B-registers), jump to a basic mode
SYSLIB common bank (SYSLIB$1), execute the ER, return to the EMOM, and restore
the contents of registers they use. These PROCs are contained in the omnibus element
EM2CB$P, which must be obtained by the MASM ‘$INCLUDE’ directive. The element
EM2CB$P is contained in the SYSLIB product file. No file name is necessary on the
$INCLUDE directive if SYSLIB is installed using the default product file name
SYS$LIB$*SYSLIB.
This interface requires MASM level 4R2 (or later) and Exec level 40R1 (or later).
F.1. Calling Sequence
The EM to ER interface PROCs in element EM2CB$P call the EM$ERS routine in the
SYSLIB common bank. The following ERs may be performed by calling these PROCs:
APRINT$ PRINT$ SNAP$
AREAD$ READ$ TREAD$
ATREAD$
7833 1733–004 F–1