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

    The LBR$PUT_RECORD routine writes a data record beginning at the
    next free location in the library.

    Format

      LBR$PUT_RECORD  library_index ,bufdes ,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.

 bufdes

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor
    Record to be written to the library. The bufdes argument is the
    address of a string descriptor pointing to the buffer containing
    the output record. The maximum record size for VAX libraries is
    symbolically defined as LBR$C_MAXRECSIZ; for Alpha libraries, the
    symbolic maximum record size is ELBR$_MAXRECSIZ.

 txtrfa

    OpenVMS usage:vector_longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference
    Record's file address (RFA) of the module header. The txtrfa
    argument is the address of a 2-longword array receiving the
    RFA of the newly created module header upon the first call to
    LBR$PUT_RECORD.

3 - Description

    If this is the first call to LBR$PUT_RECORD, this routine first
    writes a module header and returns its RFA to the 2-longword
    array pointed to by txtrfa. LBR$PUT_RECORD then writes the
    supplied data record to the library. On subsequent calls to
    LBR$PUT_RECORD, this routine writes the data record beginning
    at the next free location in the library (after the previous
    record). The last record written for the module should be
    followed by a call to LBR$PUT_END.

4 - Condition Values Returned

    LBR$_ILLCTL        Specified library control index not valid.
    LBR$_LIBNOTOPN     Specified library not open.