VMS Help  —  LBR Routines, LBR$GET_HISTORY
    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.
Close Help