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

19.2.2. MASM ATREAD Procedures Buffers and Tables
SAR$ ATREAD
All buffers and tables must be provided by the calling program. The recommended
lengths for the buffers and tables are equated to labels in the S$ARATRDEF PROC.
These lengths and labels are listed in Table 19–5. The buffers and tables for the
ATREAD 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.
Table 19–5. SAR$: MASM ATREAD Buffer and
Table Lengths
Label Value
SA$IMGBUFDL (Image buffer word length) 63
SA$TEXBUFDL (Text buffer byte length) 132
SA$ATTRIBDL (Attribute table word length) 40
SA$SELLSTDL (Select list byte length) 4
19.2.3. ATREAD Procedures Called from MASM
The MASM procedures for the ATREAD function are
• S$ARINITATR (initialize ATREAD)
• S$ARATREAD (call ATREAD)
• S$ARRSATR (reset ATREAD)
19.2.3.1. Initialize ATREAD Procedure Call (S$ARINITATR)
The ATREAD packet and data area must be initialized before any calls are made to
ATREAD. The S$ARINITATR PROC performs the ATREAD packet initialization.
Initial Conditions
The calling program sets the following parameters in the ATREAD packet to appropriate
values before calling S$ARINITATR:
• Required parameters (described in 19.2.1.1)
SA$PKTVER
SA$IMGBUF
SA$IMGBUFL
7833 1733–004 19–19