VMS Help RTL Routines, LIB$, LIB$CRF_INS_REF  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Insert Reference to a Key in the Cross-Reference Table
    routine inserts a reference to a key in a cross-reference symbol
    table.

    Format

      LIB$CRF_INS_REF  control-table ,longword-integer-key

                       ,reference-string ,longword-integer-reference

                       ,ref-definition-indicator

1 - Returns

    None.

2 - Arguments

 control-table

    OpenVMS usage:vector_longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference, array reference

    Control table associated with this cross-reference. The control-
    table argument is the address of an array containing the control
    table.

 longword-integer-key

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Key referred to by LIB$CRF_INS_REF. The longword-integer-key
    argument is the address of a signed longword integer containing
    the key. The key is a counted ASCII string that contains a symbol
    name or an unsigned binary longword. It must be a permanent
    address in the user's symbol table.

 reference-string

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Counted ASCII string with a maximum of 31 characters, not
    including the byte count. The reference-string argument is the
    address of a descriptor pointing to the counted ASCII string.

 longword-integer-reference

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       write only
    mechanism:    by reference

    The 16-bit value used in selecting the contents of the REF1
    field. The longword-integer-reference argument is the address of
    a signed longword integer containing this value. When preparing
    the output line, LIB$CRF_OUTPUT uses longword-integer-reference
    and the bit mask in the field descriptor table to extract the
    data. The high-order bit of the word is reserved for LIB$CRF_INS_
    REF.

 ref-definition-indicator

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Reference/definition indicator that LIB$CRF_INS_REF uses to
    distinguish between a reference to a symbol and the definition of
    the symbol. The ref-definition-indicator argument is the address
    of a signed longword integer containing this indicator. The only
    difference between processing a symbol reference and a symbol
    definition is where LIB$CRF_INS_REF stores the information.

    The reference/definition indicator can have either of the
    following values:

    Symbolic
    Name        Description

    CRF$K_REF   Reference to a symbol
    CRF$K_DEF   Definition of a symbol