Telling CICS whether to route or terminate a DPL request
When the routing program is invoked for routing, it can choose whether the link request should be routed or rejected. If you want the request to be routed, whether you have changed any values or not, return a zero value to CICS® in field DYRRETC of the communications area.
When you return control to CICS with return code zero, CICS first
compares the returned SYSID with its own local SYSID:
- If the SYSIDs are the same (or the returned SYSID is blank) CICS executes the link request locally.
- If the two SYSIDs are not the same, CICS routes the request to the remote CICS region, using the returned program and transaction names.
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 25.
Returning a value in DYRRETC has no effect when the routing program is invoked for notification or at termination of the request.