Node error program DSECTs
CICS provides a number of DSECTs for use in the node error program (NEP).
The following DSECTs are provided:
Node Error Table Header: This contains the table
name and
common information relevant for all the node error blocks (NEBs) in
the table.
DFHNETH DSECT
NETHNAM DS CL8 Table name
NETHNBN DS H Number of NEBs in table
NETHNBL DS H Length of NEBs in table
NETHTIM DS PL8 Error count time interval
NETHECT DS H Error count threshold
NETHFLG DS X Flag byte
NETHINI EQU X'01' Table initialized
DS X Reserved
NETHFNB DS 0F First NEB
Node Error Block: The table contains node error
blocks that are
used for recording error information for individual nodes. These
can be permanently assigned to specific nodes or dynamically assigned
at the request of error processors.
DFHNETB DSECT
NEBNAM DS CL4 Node name
NEBFLG DS X Flag byte
NEBPERM EQU X'01' Permanently assigned NEB
DS XL3 Reserved
NEBFESB DS 0X First NEB
Error Status Block: The NEBs can contain error
status blocks. These are reserved
for specific error processors and are identified by the corresponding
error group index. An ESB can have a format defined by you, or can
have a standard format suitable for counting errors over a fixed time
interval.
DFHNETE DSECT
ESBEGI DS X Error group index
ESBFLG DS X Flag byte
ESBSTAN EQU X'01' Standard format ESB
ESBTTE EQU X'02' Time threshold exceeded
ESBCTE EQU X'04' Count threshold exceeded
ESBSLEN DS XL2 Status area length
ESBHLEN EQU *-DFHNETE ESB header length
ESBSTAT DS 0X Status area
The following fields apply to the standard format:
ESBTIM DS PL8 Time stamp
ESBEC DS XL2 Error count
Common Subroutine Vector Table: The CSVT provides
error processors with addressability to the common subroutines. The
error processor link register gives addressability to the CSVT and
so the first section of the DSECT overlies the code required to branch
around the actual table.
DFHNEPC DSECT
DS F Load instruction
DS F Branch instruction
CSVTNEP DS A Node error program base address
CSVTESBL DS A NEPESBL - ESB locate routine
CSVTNEBD DS A NEPNEBD - NEB delete routine
CSVTECUP DS A NEPECUP - error count update
routine