VMS Help
RTL Routines, LIB$, LIB$CRF_OUTPUT
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
The Output Cross-Reference Table Information routine extracts
the information from the cross-reference tables and formats the
output pages.
Format
LIB$CRF_OUTPUT control-table ,output-line-width ,page1 ,page2
,mode-indicator ,delete-save-indicator
None.
control-table
OpenVMS usage:vector_longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference, array reference
Control table associated with the cross-reference. The control-
table argument is the address of an array containing the control
table. The table contains the address of the user-supplied
routine that prints the lines formatted by LIB$CRF_OUTPUT.
output-line-width
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Width of the output line. The output-line-width argument is the
address of a signed longword integer containing the width.
page1
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Number of lines on the first page of the output. The page1
argument is the address of a signed longword integer containing
this number. This allows the user to reserve space to print
header information on the first page of the cross-reference.
page2
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Number of lines per page for the other pages. The page2 argument
is the address of a signed longword integer containing this
number.
mode-indicator
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Output mode indicator. The mode-indicator argument is the address
of a signed longword integer containing the mode indicator.
This indicator allows the user to select which of three output
modes is desired.
Output Mode Description
CRF$K_VALUES Only the value and key fields are to be printed.
LIB$CRF_OUTPUT creates multiple columns across
the page. Each column consists of the KEY1, KEY2,
VAL1, and VAL2 fields. A minimum of one space
between each column is guaranteed.
CRF$K_VALS_ Requests a cross-reference summary that has no
REFS column space saved for a defining reference. If
the user inserted a reference with the CRF$K_DEF
indicator, the entry is ignored.
CRF$K_DEFS_ Requests a cross-reference summary with the first
REFS REF1 and REF2 fields used only for definition
references. If no definition reference is
provided, the fields are filled with spaces.
delete-save-indicator
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Delete/save indicator, which LIB$CRF_OUTPUT uses to determine
whether the table's built-in accumulating symbol information
is to be saved or deleted once the cross-reference is produced.
The delete-save-indicator argument is the address of a signed
longword integer containing the delete/save indicator.
The indicator can be either of the following:
CRF$K_SAVE To preserve the tables for subsequent processing
CRF$K_ To delete the tables
DELETE
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.