Library /sys$common/syshlp/helplib.hlb  —  LBR Routines, LBR$FIND
    The LBR$FIND routine sets the current internal read context for
    the library to the library module specified.

    Format

      LBR$FIND  library_index ,txtrfa

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

    Longword condition value. Most utility routines return a
    condition value in R0. Condition values that this routine can
    return are listed under Condition Values Returned.

2  –  Arguments

 library_index

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Library control index returned by the LBR$INI_CONTROL routine.
    The library_index argument is the address of the longword that
    contains the index.

 txtrfa

    OpenVMS usage:vector_longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Record's file address (RFA) of the module header for the module
    you want to access. The txtrfa argument is the address of a 2-
    longword array containing the RFA. You can obtain the RFA of a
    module header by calling LBR$LOOKUP_KEY or LBR$PUT_RECORD.

3  –  Description

    Use the LBR$FIND routine to access a module that you had accessed
    earlier in your program. For example, if you look up several
    keys with LBR$LOOKUP_KEY, you can save the RFAs returned by
    LBR$LOOKUP_KEY and later use LBR$FIND to reaccess the modules.
    Thus, you do not have to look up the module header's key every
    time you want to access the module. If the specified RFA is
    valid, LBR$FIND initializes internal tables so you can read the
    associated data.

4  –  Condition Values Returned

    LBR$_ILLCTL        Specified library control index not valid.
    LBR$_INVRFA        Specified RFA not valid.
    LBR$_LIBNOTOPN     Specified library not open.
Close Help