Coding For Specific Vtam Sense Codes; Writing Multiple Neps; Dfhznepi Macros - IBM SC34-6814-04 Customization Manual

If used in this way, the initiated transaction can write an appropriate signon
message when the session has been acquired. Note, however, that if
LOGONMSG=YES is specified on the CEDA DEFINE TYPETERM command, the
CICS "good morning" message is also initiated when the session is opened. Refer
to "Restrictions on the use of EXEC CICS commands" on page 505.

Coding for specific VTAM sense codes

Figure 35 shows how your NEP error processors could test for the presence of
specific VTAM sense codes.
TEST1 EQU *
CLC TWASENSR(2),SNS1
BNE TEST2
NI TWAOPT1,TWAOAF
OI TWAOPT2,TWAOAS+TWAOAR+TWAOAT ABANDON SEND,RECEIVE AND TASK
NI TWAOPT2,255-TWAOASM
OI TWAOPT3,TWAOINT
NI TWAOPT3,255-TWAONINT
B END
.
.
.
SNS1 DC X'NNNN'
Figure 35. Sample code, showing how your node error program could test for specific VTAM sense codes

Writing multiple NEPs

You can write several node error programs, as described in "Multiple NEPs" on
page 485. When an error occurs, the node abnormal condition program passes
control to an interface module, DFHZNEPI, which determines the transaction class
and passes control to the appropriate node error program.
If only one node error program is used, the interface module (DFHZNEPI) is not
required. If the node error program is named DFHZNEP, the node abnormal
condition program branches directly to that. If more than one node error program is
used, the interface module (DFHZNEPI) is required. In this case, the node error
programs must be given names other than DFHZNEP. There must be an installed
program definition for every node error program generated.

DFHZNEPI macros

The following macros are required to generate the node error program interface
module (DFHZNEPI):
v DFHZNEPI TYPE=INITIAL to specify the name of the default transaction-class
v DFHZNEPI TYPE=ENTRY to associate a transaction-class with a
v DFHZNEPI TYPE=FINAL to end the DFHZNEPI entries.
The DFHZNEPI interface module must be generated when you require the node
abnormal condition program to pass control to the appropriate user-written node
error program for resolution of the error.
508
Customization Guide
SENSE CODE EQUAL TO NNNN
NO, THEN NEXT TEST
PRINT ACTION MESSAGES ONLY
SET SIMLOGON OFF
SET INTLOG NOW ALLOWED
OR RESET NOINTLOG
routine.
transaction-class error handling routine.