Container DFHERROR

DFHERROR is a container of DATATYPE(BIT) that is used to convey information about pipeline errors to other message handlers.

Table 1. Structure of container DFHERROR. All fields in the structure contain character data.
Field name Length (bytes) Contents
PIISNEB-MAJOR-VERSION 1 "1"
PIISNEB-MINOR-VERSION 1 "1"
PIISNEB-ERROR-TYPE 1 A numeric value denoting the type of error. The values are described in Table 2.
PIISNEB-ERROR-MODE 1
P
The error occurred in a provider pipeline
R
The error occurred in a requester pipeline
Start of changeTEnd of change
Start of changeThe error occurred in a Trust clientEnd of change
PIISNEB-ABCODE 4 The abend code when the error is associated with a transaction abend.
PIISNEB-ERROR-CONTAINER1 16 The name of the container when the error is associated with a container.
PIISNEB-ERROR-CONTAINER2 16 The name of the second container when the error is associated with more than one container.
PIISNEB-ERROR-NODE 8 The name of the handler program in which the error occurred.
Table 2. Values for field PIISNEB-ERROR-TYPE
Value of PIISNEB-ERROR-TYPE Meaning
1 The handler program abended. The abend code is in field PIISNEB-ABCODE.
2 A container required by the handler was empty. The name of the container is in field PIISNEB-ERROR-CONTAINER1.
3 A container required by the handler was missing. The name of the container is in field PIISNEB-ERROR-CONTAINER1.
4 Two containers were passed to the handler when only one was expected. The names of the containers are in fields PIISNEB-ERROR-CONTAINER1 and PIISNEB-ERROR-CONTAINER2.
5 An attempt to link to the target program failed. If target program abended, the abend code is in container PIISNEB-ABCODE.
6 The pipeline manager failed to communicate with a remote server due to an error in the underlying transport.
Start of change7End of change Start of changeThere is an error with the DFHWS-STSACTION container. It is missing, corrupt or contains an invalid value.End of change
Start of change8End of change Start of changeDFHPIRT failed to start the pipeline.End of change
Start of change9End of change Start of changeDFHPIRT failed to put a message in a container.End of change
Start of change10End of change Start of changeDFHPIRT failed to get a message from a container.End of change
Start of change11End of change Start of changeAn unhandled error has occurred.End of change
The COBOL declaration of the container's structure is this:Start of change
01 PIISNEB.                              
  02 PIISNEB-MAJOR-VERSION PIC X(1).     
  02 PIISNEB-MINOR-VERSION PIC X(1).     
  02 PIISNEB-ERROR-TYPE PIC X(1).        
  02 PIISNEB-ERROR-MODE PIC X(1).        
  02 PIISNEB-ABCODE PIC X(4).            
  02 PIISNEB-ERROR-CONTAINER1 PIC X(16). 
  02 PIISNEB-ERROR-CONTAINER2 PIC X(16). 
  02 PIISNEB-ERROR-NODE PIC X(8).        
End of change The language copybooks that map the container are:
Table 3.
Language Copybook
COBOL DFHPIUCO
PL/I DFHPIUCL
C and C++ dfhpiuch.h
Assembler DFHPIUCD