When your routing program is invoked
CICS® invokes the dynamic routing program in the following situations.
- When a transaction defined as DYNAMIC(YES) is initiated. Note:
- If a transaction definition is not found, CICS uses the common transaction definition specified on the DTRTRAN system initialization parameter. See Using a single transaction definition in the TOR.
- If the transaction is defined as DYNAMIC(YES) in the target region, as well as in the routing region (TOR), the dynamic routing program is invoked, for routing, in the target region, as well as in the TOR. Thus, it is possible to “daisy-chain” routed requests from one region to another. Take care that this does not occur unintentionally.
If the transaction was initiated from a terminal, the dynamic routing program can route the request —see Overview of transaction routing.
If the transaction was initiated by an EXEC CICS START command, the routing program may or may not be able to route the request—see Routing transactions invoked by START commands.
- If an error occurs in route selection.
- At the end of a routed transaction, if the initial invocation requests re-invocation at termination.
- If a routed transaction abends, if the initial invocation requests re-invocation at termination.
- For routing of DPL requests, at all the points described in Dynamically routing DPL requests.
- If the return code from the dynamic routing program is not zero, CICS attempts to execute the transaction in the routing region.