Writing a dynamic routing program

Considerations common to all user-replaceable programs

Note that the comments contained in General notes about user-replaceable programs apply to this section.

This section describes the CICS® default dynamic routing program and tells you how to write your own version. It assumes you are familiar with the principles of transaction routing, distributed program link (DPL), and dynamic routing.

You can use the dynamic routing program to route:

For detailed information about which transactions initiated by START commands, and which program-link requests, are eligible for dynamic routing, see the CICS Intercommunication Guide.

Notes:
  1. You cannot use the dynamic routing program--that is, the program named on the DTRPGM system initialization parameter--to route:
    • CICS business transaction services activities and processes.
    • Method requests for enterprise beans or CORBA stateless objects.
    • Non-terminal-related EXEC CICS START requests.
    • Start of changeInbound Web services requests.End of change

    To route these types of request you must use the distributed routing program named on the DSRTPGM system initialization parameter. How to write a distributed routing program is described in Writing a distributed routing program.

  2. The dynamic routing program and the distributed routing program may, of course, be the same program.
Important

If you use the CICSPlex® System Manager (CICSPlex SM) product to manage your CICSplex, you may not need to write a dynamic routing program. CICSPlex SM provides a fully-functioning dynamic 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 dynamic routing, and define any transaction affinities that govern the target regions to which particular transactions must be routed. For introductory information about CICSPlex SM, see the CICSPlex SM Concepts and Planning manual.

The rest of the section is divided into the following sections:

  1. Routing transactions dynamically
  2. Routing DPL requests dynamically
  3. Routing bridge requests dynamically
  4. Routing by user ID
  5. Parameters passed to the dynamic routing program
  6. Naming your dynamic routing program
  7. Testing your dynamic routing program
  8. Dynamic transaction routing sample programs.
[[ Contents Previous Page | Next Page Index ]]