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

20.2. SAR$ COM Function/MASM Interface
The SAR$ COM function writes a symbolic image to the operator's console and
optionally reads a symbolic image from the operator's console.
SAR$ COM
The SAR$ COM procedure is callable directly from MASM. The SAR$ data structure
definitions and procedure calls are defined by MASM procedures (PROCs). The element
SAR$PROCS contains these PROCs.
20.2.1. SAR$ COM Packet and Data Area Description
The SAR$ COM function requires a SAR$ COM packet and data area for the COM
procedure call. The S$ARCOMDEF PROC generates the EQUFs defining the COM
packet fields. The word length of the SAR$ MASM COM packet and data area is at label
SC$PKTWLEN defined by the S$ARCOMDEF PROC (the current length is 57 words).
20.2.1.1. Required Information for SAR$ COM Procedure
The calling program must set the following fields of the COM packet to appropriate
values:
SC$PKTVER
The SAR$ COM packet data structure version. The current version is equal to the
label SC$CURVER defined by the S$ARCOMDEF PROC.
SC$OTEXTB
The address of the output text buffer which contains the character text of the image
that the SAR$ COM function writes out.
SC$OTEXTBL
The length in 9-bit bytes of the character text in the text buffer. This is the number
of characters that the SAR$ COM function writes out.
SC$ITEXTB
The address of the input text buffer which contains the character text of the image
that the SAR$ COM function reads in. This field is not necessary if SC$ITEXTBL is
set to zero.
SC$ITEXTBL
The length in 9-bit bytes of the input text buffer; this is the maximum number of
characters that the SAR$ COM function will read in. If this field is set to zero, no
input is solicited from the operator's console.
7833 1733–004 20–11