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

INFOR$–Internal Format Table Interface Routines
12.3.1. RINF$–Read INFOR Table
The RINF$ routine performs a read operation to read the INFOR table and store it in an
area that the calling program supplies. The RINF$ routine must be called before the
SINF$, the SELT$, or the DUSE$ routines may be used.
INFOR$ is a word defined externally by the INFOR$ routine. If it is zero, then the RINF$
routine executes a read instruction and reads the INFOR table into the area indicated by
parameter start-addr. If INFOR$ is not zero, RINF$ assumes that the INFOR table has
already been read and immediately does a normal return to the caller. The calling
program must set INFOR$ to zero if the calling program is reusable and is making
multiple calls to the RINF$ routine.
The RINF$ routine is called by the MASM procedure I$NFOR. This procedure can be
used to generate the calling sequence for the relocatable version of the RINF$ routine,
the common bank version of the routine, or the common bank version of the routine
using the Auto Switch calling sequence. Section 3 describes the advantages and
disadvantages of using the different types of calls.
Calling Format
I$NFOR[,t] ‘RINF$’[,word-count,start-addr] [packet]
error return
normal return
Parameters
t
RINF$
Type of call to RINF$. This parameter is optional and may be omitted. CB or A, if
specified, must be enclosed by apostrophes.
blank Call the relocatable version of RINF$. This is the default if t is omitted.
'CB' Call the common bank version of RINF$.
'A' Call the common bank version of RINF$ using the Auto Switch method.
RINF$ is the function code which specifies which of the INFOR$ routines the
procedure I$NFOR should call. It must be enclosed by apostrophes.
word-count
Length in words of the memory area provided by the caller into which the RINF$
routine is to store the INFOR table. If this parameter is omitted, the RINF$ routine
uses the value in H1 of register A0 as the length.
12–4 7833 1733–004