TRANSFER Reference Manual

TAREQ Event Packages
Programmatic Interface to the TRANSFER Delivery System
1–22 069139, Update 1 to 40969 Tandem Computers Incorporated
In this definition, fields have the following meanings:
ERROR-RETURN
notifies the TAREQ of any action it should take at this point. The ERROR-
RETURN field is required and must contain one of the values listed in Table 1-23.
Caution To avoid degradation of system performance, AGENT-RESTART (3) should be returned only for a
transient problem, such as a file lock. Returning the AGENT-RESTART for a problem such as record-not-
found is not useful because the problem will not go away. AGENT-RESTART might cause previously
successful deliveries to be backed out and then performed again. For additional ramifications of TMF
restart, see the TRANSFER Programming Guide.
ERROR-MSG
contains ASCII text that describes any error encountered. This field is optional.
The text is written to the scheduler process log file if logging to this file is enabled.
Table 1-23. TAREQ Actions for Values of ERROR-RETURN and ERROR-MSG
ERROR-
RETURN Value
ERROR-MSG
(optional) TAREQ Action
0 GO-TO-NEXT-AGENT Goes to the next agent in the sequence. If TAREQ
started the session for this agent, TAREQ ends the
session.
100 Goes to the next agent in the sequence. If TAREQ
started the session for this agent, TAREQ does not end
the session.
1 DON'T-GO-TO-NEXT-
AGENT
Discontinues the search. If TAREQ started the session
for this agent, TAREQ ends the session.
101 Discontinues the search. If TAREQ started the session
for this agent, TAREQ does not end the session.
2 AGENT-ERROR Logs the error detected by the agent and invokes the
next agent. If TAREQ started the session for this agent,
TAREQ ends the session.
102 Logs the error detected by the agent. If TAREQ started
the session for this agent, TAREQ does not end the
session.
3 AGENT-RESTART Logs the error detected by the agent and restarts the
current transaction.
TAREQ Event Packages The TAREQ generates event packages with predefined formats for certain events.
These packages always have an application ID of TAREQ (100). The agent selector
value indicates the event that triggered the packages, as entered in the AGENT-
SELECTOR field of the agent notification message. The events are listed in Appendix
B. The event package format is described in the TRANSFER Programming Guide.