Writing Your Own Node Error Program; Restrictions On The Use Of Exec Cics Commands - IBM SC34-6814-04 Customization Manual

CSVTESBL
CSVTNEBD
CSVTECUP

Writing your own node error program

You can write your own NEP in any of the CICS-supported languages. However,
CICS-supplied NEP code is provided in assembler language only. The
communication area parameter list is supplied in assembler-language and C
versions. The names of the supplied source files, copy books, and macros, and the
libraries in which they can be found, are listed in Table 26.
If you code in assembler language, you can use the sample NEP as a framework
on which to construct your own node error program.

Restrictions on the use of EXEC CICS commands

There are certain restrictions on the commands that a NEP can issue. The use of
any commands which require a principal facility causes unpredictable results,
and should be avoided. In particular, you should not use commands which invoke
the following functions:
v Terminal control. For example, issuing EXEC CICS DELAY may cause the CSNE
v BMS (except routing)
v ISC communication (including function shipping). This includes START requests
DS A
DS A
DS A
Table 26. Supplied source files, copy books, and macros
Name Type
DFHZNEP0 Program
DFHZNEPX Source
DFHSNEP Macro
DFHZNEPI Macro
DFHNEPCA Macro
DFHNEPCA Copy
book
task to suspend and never resume, which can cause shutdown of the region to
hang. ("CEMT-type" commands, such as EXEC CICS INQUIRE TERMINAL, are
permissible)
for remote transactions. Such requests are not recommended because CSNE
(Node Abnormal Condition task) might become suspended while doing an
ALLOCATE to the remote system.
If you need to start a remote transaction, start a local transaction which starts a
remote one in turn.
NEPESBL - ESB locate routine
NEPNEBD - NEB delete routine
NEPECUP - error count update
routine
Description
Default node error
program (assembler
language)
Default NEP (embedded
by DFHZNEP0 via COPY
statement)
Sample NEP program
generator (assembler
language)
NEP interface generator
(for multiple NEPs)
Assembler-language
communication area
C-language
communication area
Chapter 9. Writing a node error program
Library
CICSTS32.CICS.SDFHSAMP
CICSTS32.CICS.SDFHSAMP
CICSTS32.CICS.SDFHMAC
CICSTS32.CICS.SDFHMAC
CICSTS32.CICS.SDFHMAC
CICSTS32.CICS.SDFHC370
505