Transient data queue records

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.

Fields

CONVID(8-character data-area)
the conversation ID for which the event occurred; null if not applicable.
DATATYPE(fullword binary data-area)
identifies the type and structure of the data. A value of 2 indicates FEPI TD queue data.
DEVICE(cvda)
the device type of the conversation for which the event occurred (the values are as for FEPI INQUIRE POOL); zero if not applicable.
EVENTDATA(8-character data-area)
contains data about the event:
Event Data
ACQFAIL 2 fullword binary numbers:
  • VTAM® reason code
  • Count
SESSIONFAIL 2 fullword binary numbers:
  • VTAM reason code
  • Count
SESSIONLOST 2 fullword binary numbers:
  • VTAM reason code
  • Count
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.

EVENTTYPE(cvda)
indicates what the event was.

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.
EVENTVALUE(fullword binary data area)
provides further information about the event. Values are:
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
FORMAT(cvda)
the data format of the conversation for which the event occurred (the values being as for FEPI INQUIRE POOL); zero if not applicable.
NODE(8-character data-area)
the name of the node for which the event occurred; nulls if not applicable.
POOL(8-character data-area)
the name of the pool for which the event occurred; nulls if not applicable.
TARGET(8-character data-area)
the name of the target for which the event occurred; nulls if not applicable. For the SESSION event, it is the VTAM application name of the back-end system, rather than the FEPI target name.
Reserved
nulls.
[[ Contents Previous Page | Next Page Index ]]