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.