Telling CICS whether to route the activity
When the routing program is invoked for routing, if you want the process or activity 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 RUN request locally. When it executes the request locally, CICS writes message DFHSH0102 to the CSSH transient data queue.
- If the two sysids are not the same, CICS routes the request to the remote CICS region.
If you want CICS to treat the request as unserviceable, return a non-zero value. For information about unserviceable requests, see Dealing with unserviceable requests.
Returning a value in DYRRETC has no effect when the routing program is invoked for notification, routing complete, transaction initiation, transaction termination, or abend.