Customizing The Sample "Good Night" Program - IBM SC34-6814-04 Customization Manual

Cics transaction server for z/os
Table of Contents

Advertisement

3. If this is not the first invocation for this timeout:
4. If the number of incorrect responses exceeds the maximum specified to your
5. If the correct password is entered, DFH0GNIT:

Customizing the sample "good night" program

You can write your "good night" program in any of the languages supported by
CICS, with full access to the CICS application and system programming interfaces.
If you customize the supplied program, or write your own "good night" program,
note the following:
v Like the sample, your program should be pseudoconversational, because it could
v Your program should always start, like the sample program, by testing the
v To obtain the communications area of the timed-out transaction in a
v If your program tries to sign off the terminal user, the result depends on what is
804
Customization Guide
c. Writes the communication area, if any, to a temporary storage queue.
d. Displays a screen asking the user to input his or her password, and sets the
flag indicating that this has been done.
e. Issues EXEC CICS RETURN with TRANSID GNIT and the COMMAREA
option, to continue the timeout process as a pseudoconversation.
a. Recovers the original communication area, if any, from the temporary
storage queue.
b. Checks the password received from the user, and redisplays the timeout
screen with an error message if it is incorrect.
external security manager, DFH0GNIT returns immediately with TRANSID
CESF, which tries to sign off the userid.
v Restores the screen contents
v Restores the cursor position.
If the terminal timed out during a pseudoconversational transaction, DFH0GNIT
also:
v Restores the communications area of the timed-out transaction
v Returns with the TRANSID of the next transaction in the interrupted
conversation.
be invoked simultaneously for many users (if, for example, many terminals time
out during the lunch period). If your program is conversational, CICS maximum
number of tasks (MXT) could quickly be reached.
When you are continuing your timeout program's pseudoconversation, always
specify the name of your "good night" transaction (for example, GNIT) as the
next TRANSID. If you do not, CICS does not know that you are still handling the
timeout, and results may be unpredictable.
GNTRAN_START_TRANSID field of the communications area passed by CICS.
If it finds that the "good night" transaction was started for any reason other than a
terminal timeout (for example, by an EXEC CICS START request), timeout
processing may not be appropriate.
pseudoconversation, your program must issue an EXEC CICS RECEIVE
command. (The communication area passed to it on invocation is not that of the
timed-out transaction, but contains information about the timed-out transaction.)
specified on the SIGNOFF option of the terminal's TYPETERM definition:
YES
The terminal is signed off, but not logged off.
NO
The terminal remains logged on and signed on.

Advertisement

Table of Contents
loading

Table of Contents