Processing considerations
After CICSPlex® SM workload management processing, the WTRA_RESPONSE field contains a return code of either zero (0) or 8.
If the return code is 0, WTRA_SYSID contains the SYSID of the selected target region, and WTRA_APPLID contains its APPLID. With that information, you can proceed to route the unit of work to the target region.
If the return code is 8, you should inspect the WTRA_API_RESP and WTRA_API_REAS fields for more information. These fields contain the last response and reason codes returned to the CICSPlex SM workload management routing action module (EYU9WRAM). In most cases, the response and reason codes describe what caused CICSPlex SM workload management to generate the return code of 8. Based on that information, you can decide how to proceed.
In some cases, however, the WTRA_RESPONSE field may contain a return code of 8, while the WTRA_API_RESP and WTRA_API_REAS fields have not been set by CICSPlex SM workload management. In those cases, an error was detected before invoking the routing action process. CICSPlex SM user trace records are written to the CICS® trace data set for those types of errors. When this happens, your program should terminate processing.
- Set the WTRA_FUNC field to WTRA_FUNCTRM for route termination.
- Reinvoke CICSPlex SM workload management.
- Terminate processing for the proposed unit of work.
If the WTRA_OPTER field contains a value of WTRA_CALLNO, terminate further processing for the proposed unit of work.
- Set the WTRA_FUNC field to WTRA_FUNCTRM for route termination.
- Optionally, set the WTRA_NEXTTRAN field to the ID of the next transaction to be used in the process. If there is no next transaction, set the field to all blanks.
- Reinvoke CICSPlex SM workload management to request termination processing for the transaction.
- Set the WTRA_FUNC field to WTRA_FUNCABD to notify CICSPlex SM workload management that the routed transaction abended.
- Reinvoke CICSPlex SM workload management to request abnormal termination processing for the transaction.