GNTRAN
The GNTRAN system initialization parameter specifies the transaction that you want CICS® to invoke when a user's terminal-timeout period expires.
- GNTRAN={NO|transaction_id}
- Valid values are as follows:
- NO
- The default value, NO, specifies that no special transaction is to be executed when the timeout period expires. Instead, the user is signed off (subject to the SIGNOFF attribute of the TYPETERM resource definition for the terminal, as described below). After the signoff, if the LOGONMSG(YES) option is specified in the TYPETERM resource definition for the terminal, the transaction specified in the GMTRAN system initialization parameter is executed.
- transaction_id
- The name of a timeout transaction to signoff the user at the timed-out
terminal. You can specify CESF as the timeout transaction. Specifying
your own transaction allows you to specify functions in addition to,
or instead of, signoff. For example, your own transaction could issue
a prompt for the terminal user's password, and allow the session to
continue if the correct password is entered.
The transaction to be used must have been specially written to handle the GNTRAN COMMAREA that is passed to it. Of the CICS-supplied transactions, only CESF has been written to handle the GNTRAN COMMAREA. For more information about writing your own transactions for GNTRAN, see Writing a good night program.
Note: When either the CICS CESF transaction, or your own transaction, attempts to sign off a terminal, the result is subject to the SIGNOFF attribute of the TYPETERM resource definition for the terminal, as follows:- SIGNOFF
- Effect
- YES
- The terminal is signed off, but not logged off.
- NO
- The terminal remains signed on and logged on.
- LOGOFF
- The terminal is both signed off and logged off.
Note: If GNTRAN fails to attach, and SIGNOFF(LOGOFF) has been specified, the terminal which has reached timeout will be signed off and logged off. GNTRAN will not run and will have no effect.