IBM SC34-6814-04 - page 639

8Terminatethe transaction with either a message or an abend.
Whenever the routing program is invoked, DYRRETC is set to ‘0’. When it
is invoked for route selection or because an error occurs in route selection,
if you want CICS to continue processing the transaction, you must leave it
set to ‘0’.
Tomake CICS terminate the transaction (issuing a message or abend),
return a value of ‘8’.
Tomake CICS terminate the transaction without issuing a message or
abend (indicating that DFHDYP has done all the processing that is
necessary), return a value of ‘4’.
Note:
1. Setting a return code of ‘4’ forAPPC transaction routing leads to
unpredictable results, and should be avoided.
2. Setting any non-zero return code other than X'4' is equivalent to
setting X'8'.
Program-link requests
The possible values are:
0Continue processing the link request.
Non-zero
Return an error condition to the program.
Whenever the routing program is invoked, DYRRETC is set to ‘0’. When it
is invoked for route selection or because an error occurs in route selection,
if you want CICS to continue processing the link request, you must leave it
set to ‘0’.
Tomake CICS reject the link request, return a non-zero value. The program
that issued the EXEC CICS LINK command receives a PGMIDERR
condition, with a RESP2 value of 27.
bridge requests
The possible values are:
0Continue processing the request.
4Terminateprocessing the request without issuing any error
messages.
8Terminateprocessing the request with an error message.
Whenever the routing program is invoked, DYRRETC is set to ‘0’. When it
is invoked for route selection or because an error occurs in route selection,
if you want CICS to continue processing the link request, you must leave it
set to ‘0’.
Tomake CICS terminate the request without issuing a message return a
value of 4. The BRIH returned to the client contains a return code informing
the client that the dynamic routing program has rejected the request, and a
compcode that gives details of the reason the last attempt to route the
request failed.
Tomake CICS terminate the request (issuing a message) return a value of
8. The BRIH returned to the client contains a return code informing the
Chapter17. Writing a dynamic routing program 617