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

    The LGI$ICB_GET_INPUT callback routine enables interaction with
    the user.

    Format

      LGI$ICB_GET_INPUT  rab ,flags

1 - Returns

    No value. Does not return on failure.

2 - Arguments

 rab

    OpenVMS usage:rab
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    Data structure used to set up a read-with-prompt OpenVMS RMS
    operation. Normally you pass the RAB address in LGI$A_ICR_INPUT_
    RAB.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    A data structure that determines the error response as follows:

    Flags
    ValueResponse

    0    Normal error message.
    1    LOGINOUT exits quietly.
    2    Normal error message; however, the callback routine returns
         control to the caller rather than exiting on timeout
         (timeout status is in RAB).

3 - Description

    The LGI$ICB_GET_INPUT callback routine invokes the LOGINOUT input
    routine to enable interaction with character-cell terminal users.
    The read operation provides a timeout to ensure that the UAF
    record does not remain locked if the user presses Ctrl/S.

4 - Condition Values Returned

    No return value. Examine status in RAB to determine the results
    of the read operation.