In response to various unexpected events, FEPI writes a record, describing the event and its circumstances, to a transient data (TD) queue. Such events include:
If the event relates to a specific pool, the record is written to the queue specified by EXCEPTIONQ for that pool; if EXCEPTIONQ was not specified, no record is written. If the event does not relate to a specific pool, the record is written to queue CSZX. In all cases, if the appropriate TD queue does not exist or if it is not defined as non-recoverable, the record is lost.
The format of the record is as follows. The copy books DFHSZAPA, DFHSZAPO, DFHSZAPC, and DFHSZAPP (according to your programming language) provide declarations for this record structure.
DATATYPE | Fullword binary data-area |
EVENTTYPE | CVDA |
EVENTVALUE | Fullword binary data-area |
EVENTDATA | 8-character data-area |
Reserved | 4-character data-area |
POOL | 8-character data-area |
TARGET | 8-character data-area |
NODE | 8-character data-area |
CONVID | 8-character data-area |
DEVICE | CVDA |
FORMAT | CVDA |
Reserved | 8-character data-area. |
Event | Data |
---|---|
ACQFAIL | 2 fullword binary numbers:
|
SESSIONFAIL | 2 fullword binary numbers:
|
SESSIONLOST | 2 fullword binary numbers:
|
Others | Nulls |
If the count is nonzero, it indicates the number of times the node acquire or session start has failed; it will be tried again. A zero count indicates that several failures have occurred and that there will be no further attempts to acquire the node or start the session.
Exceptional events queued to common TD queue CSZX:
ACQFAIL | A node could not be acquired (its VTAM ACB could not be opened). |
DISCARDFAIL | A resource in a list could not be discarded by FEPI DISCARD. |
INSTALLFAIL | A resource in a list could not be installed by FEPI INSTALL. |
SESSION | An unsolicited bind was received. |
SETFAIL | A connection or resource in a list could not be set by FEPI SET or FEPI INSTALL. |
Exceptional events queued to pool-specific TD queue:
ADDFAIL | A connection in a list could not be added to the pool by FEPI ADD. |
DELETEFAIL | A connection in a list could not be deleted from the pool by FEPI DELETE. |
SESSIONFAIL | Session could not be started. |
SESSIONLOST | Active session was lost. |
Event | Value |
---|---|
ACQFAIL | 0 |
ADDFAIL | The RESP2 value describing the failure, as given in the description of the FEPI ADD command |
DELETEFAIL | The RESP2 value describing the failure, as given in the description of the FEPI DELETE command |
DISCARDFAIL | The RESP2 value describing the failure, as given in the description of the FEPI DISCARD command |
INSTALLFAIL | The RESP2 value describing the failure, as given in the description of the FEPI INSTALL command |
SESSION | 0 |
SESSIONFAIL | The RESP2 value describing the communication failure; it can be any of the RESP2 values in the range 182-199. |
SESSIONLOST | The RESP2 value describing the communication failure; it can be any of the RESP2 values in the range 182-199. |
SETFAIL | The RESP2 value describing the failure, as given in the description of the FEPI SET command |