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

INFOR$–Internal Format Table Interface Routines
The only values allowed for the function code on the I$NFOR procedure call are RINF$,
SINF$, SELT$, and DUSE$. Any other value entered for the function code parameter on
the I$NFOR procedure call causes MASM to generate an E flag on that line and print the
error message:
ILLEGAL I$NFOR FUNCTION
All of the code in the INFOR$ routines is I-bank reentrant. The INFOR$ code is quarterword
and third-word insensitive.
12.3. INFOR$–Routines
The INFOR$ routines are a set of routines that read and manipulate the INFOR table.
The INFOR$ routines are:
• RINF$
Read the INFOR table into memory.
• SINF$
Search the INFOR table for a specification subfield.
• SELT$
Transfer a subfield from the INFOR table to the ELT$ table.
• DUSE$
Perform a dynamic @USE to attach an internal name to a file (see ECL and FURPUR
Reference Manual.
Limitation of INFOR Routines
Because the field number (the FN subfield, see Appendix G) is limited to 6 bits, only 63
fields (octal 1 to octal 77) can be uniquely numbered in the INFOR table. If more than 63
fields are given, then the field numbers start over going from 1 to 63 again. For
example, if a processor had 68 parameters on its call line, all 68 parameters would be
included in the INFOR table. However, they would be numbered 1 to 63 and then 1 to 5.
In this case, the INFOR$ routines SINF$ and SELT$ cannot be used to access the last
five fields.
The field number given on these calls must be in the range of 1 to 63, and the
information returned would always come from one of the first 63 fields. If a programmer
wishes to allow more than 63 parameters on the call line, the RINF$ routine can be used
to create the INFOR$ table but all subsequent processing of the data would have to be
done by the processor itself.
7833 1733–004 12–3