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

INFOR$–Internal Format Table Interface Routines
To determine the length of the memory area needed to store the INFOR table, see the
section, "Determining the INFOR Table Size" in Appendix G. After this size value is
calculated, add 28 to it. The additional 28 words are needed because one extra word is
used for a word of zeroes that RINF$ puts after the last word of the INFOR table and 27
extra words are used as an overflow area when RINF$ reads the last block of INFOR
data.
Word-count = (size value calculated using Appendix G) + 28.
start-addr
packet
Address of the data area in which the RINF$ routine stores the INFOR table. If this
parameter is omitted, the RINF$ routine uses the value in H2 of register A0 as the
starting address of the data area.
Address of the 30-word packet required by the common bank version of INFOR$
routine. This parameter is ignored unless parameter t is set to 'A' or 'CB'. If the
common bank version of the RINF$ routine is being called and this parameter is
omitted, then the routine assumes the address has already been loaded into register
A2 by the calling program.
Returns
If the normal return is taken, the INFOR table has been read into the area specified by
parameter start-addr followed by a zero-filled word. H2 of register A1 contains the
address of this word.
If the error return is taken, register A1 contains the error code and register A0 contains
the PRINT$ control word for the error message. Table 12–1 lists the possible messages.
Table 12–1. INFOR$: RINF$ Error Messages
Error Code Error Message and Description
1 PROCESSOR CALL ERROR
Data images were returned on the first call to READ$, indicating that no INFOR
table was created for this program.
2 ABNORMAL RETURN FROM READ$
READ$ returned with an end-of-file or other status that indicates this program
has neither an INFOR table nor input data images.
3 TOO MANY SPECIFICATIONS
The buffer area is not large enough to hold the INFOR table.
7833 1733–004 12–5