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

20.2.2. MASM SAR$ COM Procedure Buffers and Tables
SAR$ COM
All buffers and tables must be provided by the calling program. The buffers and tables
for the COM function are similar to the buffers and tables for the READ and WRITE
functions. See 17.1.2 and 18.1.2 for details on the buffers and tables. Note that for the
COM function, the image buffer is not used if the input and output images do not have
character attributes. The recommended lengths for the buffers and tables are equated
to labels in the S$ARCOMDEF PROC. These lengths and labels are listed in Table 20–4.
Table 20–4. SAR$: MASM COM Buffer and Table Lengths
Label Value
SC$IMGBUFDL (Image buffer word length) 25
SC$TEXBUFDL (Text buffer byte length) 80
SC$ATTRIBDL (Attribute table word length) 10
SC$SELLSTDL (Select list byte length) 4
20.2.3. SAR$ MASM COM Procedure Call (S$ARCOM)
The MASM procedure for the SAR$ COM function is S$ARCOM. The S$ARCOM PROC
constructs an image from the output text and output attributes and writes the image to
the operator's console. If input is solicited from the operator, an image is read from the
console, and the character text and attributes of the image are returned to the caller.
Initial Conditions
The calling program sets the following parameters in the COM packet to appropriate
values before calling the S$ARCOM PROC:
• Required parameters (described in 20.2.1.1)
SC$PKTVER
SC$ITEXTB
SC$OTEXTB
SC$ITEXTBL
SC$OTEXTBL
7833 1733–004 20–17