The LBR$GET_HISTORY routine returns each library update history record to a user-specified action routine. Format LBR$GET_HISTORY library_index ,action_routine
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. action_routine OpenVMS usage:procedure type: procedure value access: modify mechanism: by reference User-supplied routine for processing library update history records. The action_routine argument is the address of the procedure value of this user-supplied routine. The routine is invoked once for each update history record in the library. One argument is passed to the routine, namely, the address of a descriptor pointing to a history record.
3 – Description
This routine retrieves the library update history records written by the routine LBR$PUT_HISTORY.
4 – Condition Values Returned
LBR$_NORMAL Normal exit from the routine. LBR$_EMPTYHIST History empty. This is an informational code, not an error code. LBR$_INTRNLERR Internal Librarian routine error occurred. LBR$_NOHISTORY No update history. This is an informational code, not an error code.