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

INFOR$–Internal Format Table Interface Routines
12.3.2. SINF$–Search INFOR Table
SINF$ searches the INFOR table (previously read by RINF$; see 12.3.1) for a
specification subfield.
The SINF$ 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 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] ‘SINF$’[,ftfnsfn] [packet]
no-find-return
find return
Parameters
t
SINF$
ftfnsfn
Type of call to SINF$. This parameter is optional and may be omitted. CB or A,
if specified, must be enclosed by apostrophes.
blank Call the relocatable version of SINF$. This is the default if t is omitted.
'CB' Call the common bank version of SINF$.
'A' Call the common bank version of SINF$ using the Auto Switch method.
SINF$ is the function code which specifies which of the INFOR$ routines the
procedure I$NFOR should call. It must be enclosed by apostrophes.
Subfield specification that the SINF$ routine is to search for.
ft Field type (see FT in Appendix G)
fn Field number (see FN in Appendix G)
sfn Subfield number (see SFN in Appendix G)
The field type value may only be 1 (specification field). If 0 is specified, SINF$ will
use a field type value of 1. The field number value may be equal to or greater than
01. The subfield number may be a number between 01 and 10 8 . For example, to
return the element name subfield of field 3, the parameter would be set to 010306.
If this parameter is omitted, the SINF$ routine assumes the calling program has
already loaded the information into H2 of register A0.
12–6 7833 1733–004