Telling CICS whether to route the request

When the routing program is invoked for routing, 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 CICS executes the request locally.
  • If the two sysids are not the same, CICS routes the request to the remote CICS region.

If you want CICS to reject the request, return a non-zero value.

Returning a value in DYRRETC has no effect when the routing program is invoked for notification, routing complete, transaction initiation, transaction termination, or abend.