IBM SC33-1683-02 User Manual
Page 602
Transaction routing
The possible values are:
0
Continue processing the transaction.
4
Terminate the transaction without message or abend.
8
Terminate the 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’.
To make CICS terminate the transaction (issuing a message or abend),
return a value of ‘8’.
To make 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’.
Notes:
1. Setting a return code of ‘4’ for APPC 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:
0
Continue 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’.
To make 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.
You do not need to set a return code when the routing program is invoked for
notification or at transaction termination. (Any code you set is ignored by CICS.)
DYRRTPRI
indicates whether or not the dispatch priority of the transaction or link request
should be passed to the application-owning region, if the connection between
the terminal-owning region and the application-owning region is MRO. The
possible values are:
N
The dispatch priority is not passed. This is the default.
Y
The dispatch priority is passed.
DYRSRCTK
is the MVS workload management service and reporting class token for the
routed transaction.
parameters passed to DFHDYP
570
CICS TS for OS/390: CICS Customization Guide
|
|
|
|
|
|
|
||
|
|
|
|
|
|
|
|
|
|