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.