DFHERROR is a container of DATATYPE(BIT) that is used
to convey information about pipeline errors to other message handlers.
Table 1. Structure of the DFHERROR container.
| 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
- T
- The error occurred in a Trust client
|
| 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 the PIISNEB-ERROR-TYPE field
| Value of PIISNEB-ERROR-TYPE |
Meaning |
| 1 |
The handler program failed. 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 the target program failed, the abend code is in container PIISNEB-ABCODE. |
| 6 |
The pipeline manager failed to communicate with
a remote server because of an error in the underlying transport. |
| 7 |
The DFHWS-STSACTION container has an error.
It is missing, corrupt, or contains an incorrect value. |
| 8 |
DFHPIRT failed to start the pipeline. |
| 9 |
DFHPIRT failed to put a message in a container. |
| 10 |
DFHPIRT failed to get a message from a container. |
| 11 |
An unhandled error has occurred. |
The COBOL declaration of the container's structure is this:
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).
The following table shows the language copybooks that
map the container.
Table 3. Copybooks that map the container
| Language |
Copybook |
| COBOL |
DFHPIUCO |
| PL/I |
DFHPIUCL |
| C and C++ |
dfhpiuch.h |
| Assembler |
DFHPIUCD |