VMS Help  —  LBR Routines, LBR$PUT_HISTORY
    The LBR$PUT_HISTORY routine adds an update history record to the
    end of the update history list.

    Format

      LBR$PUT_HISTORY  library_index ,record_desc

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.

 record_desc

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor
    Library history record. The record_desc argument is the address
    of a string descriptor pointing to the record to be added to the
    library update history.

3  –  Description

    LBR$PUT_HISTORY writes a new update history record. If the
    library already contains the maximum number of history records
    (as specified at creation time by CRE$L_LUHMAX; see LBR$OPEN for
    details), the oldest history record is deleted before the new
    record is added.

4  –  Condition Values Returned

    LBR$_NORMAL        Normal exit from the routine.
    LBR$_INTRNLERR     Internal Librarian error.
    LBR$_NOHISTORY     No update history. This is an informational
                       code, not an error code.
    LBR$_RECLNG        Record length greater than that specified by
                       LBR$C_MAXRECSIZ. The record was not inserted
                       or truncated.
Close Help