Library /sys$common/syshlp/helplib.hlb  —  LGI Routines, LGI$ICR_LOGOUT
    The LGI$ICR_LOGOUT callout routine permits the site callout
    images to respond to the DCL command LOGOUT.

                                   NOTE

       This routine is not called if the calling process is deleted
       with STOP/PROCESS ($DELPRC). If the calling terminal is
       disconnected when logout occurs, this routine must not
       produce output.

    Format

      LGI$ICR_LOGOUT  username ,processname ,creprc_flags ,write_fao

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

    Returns logout status from the site program.

2  –  Arguments

 username

    OpenVMS usage:descriptor
    type:         character string
    access:       read
    mechanism:    by reference
    User name.

 processname

    OpenVMS usage:descriptor
    type:         character string
    access:       read
    mechanism:    by reference
    Process name.

 creprc_flags

    OpenVMS usage:mask_longword
    type:         longword_unsigned
    access:       read
    mechanism:    by reference
    Process creation status flags.

 write_fao (fao_string[,arg1[,arg2][,...]]])

    OpenVMS usage:routine
    type:         procedure
    access:       read
    mechanism:    by reference
    Procedure for writing data. The value is 0 if output is not
    permitted.

    Address of a routine that may be called to format and display
    output. The routine has fao_string as its first argument,
    followed by a variable number of arguments. (See the $FAO system
    directive in the VSI OpenVMS System Services Reference Manual for
    more information.)

3  –  Description

    The LGI$ICR_LOGOUT routine is invoked after auditing is completed
    and immediately before LOGOUT prints the logout message. This
    routine cannot prevent the logout from finishing, but it may
    prevent display of the standard logout message.

4  –  Typical Condition Values

    LGI$_SKIPRELATED   Access permitted; omit calls to the LGI$ICR_
    or any error       LOGOUT callout routine in subsequent images.
    value

5  –  Associated OpenVMS Policy Function

    None.
Close Help