Note that the comments contained in General notes about user-replaceable programs apply to this section.
This section describes the CICS® default distributed routing program and tells you how to write your own version. It assumes you are familiar with the principles of dynamic and distributed routing described in the CICS Intercommunication Guide, and that you have read the CICS Business Transaction Services and Java™ Applications in CICS manuals.
You can use the distributed routing program to route:
For detailed information about which non-terminal-related START requests are eligible for distributed routing, see the CICS Intercommunication Guide.
To route these, you must use the dynamic routing program named on the DTRPGM system initialization parameter. How to write a dynamic routing program is described in Writing a dynamic routing program.
If you use the CICSPlex® System Manager (CICSPlex SM) product to manage your CICSplex, you may not need to write a distributed routing program. CICSPlex SM provides a fully-functioning routing program that supports workload balancing and workload separation. All you have to do is to tell CICSPlex SM, through its user interface, which regions in the CICSplex can participate in the workload, and define any transaction affinities that govern the regions to which particular requests must be routed. For introductory information about CICSPlex SM, see the CICSPlex SM Concepts and Planning manual.
The rest of the section is divided as follows: