DFHERROR container
DFHERROR is a container of DATATYPE(BIT) that is used to convey information about pipeline errors to other message handlers.
| 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 |
|
| 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. |
| 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.| Language | Copybook |
|---|---|
| COBOL | DFHPIUCO |
| PL/I | DFHPIUCL |
| C and C++ | dfhpiuch.h |
| Assembler | DFHPIUCD |