CSL OM command routing

In an IMSplex environment, commands issued to OM can behave differently than commands issued to a single IMS system. Commands that are issued to OM are, by default, routed to all IMS systems in the IMSplex that are active and registered to process that particular command.

If you want to route a command to one or more specific command processing clients in the IMSplex, use the ROUTE parameter on the CSLOMCMD request or the CSLOMI API. When an OM command has a ROUTE parameter, IMS chooses the highest level IMS in the route list as the command master. For example, in an IMSplex configuration that includes an IMS 15.3 system with an IMS 15.3 CQS, and another IMS 15.2 system with an IMS 15.2, if an INIT OLC command (which is a ROUTE=ANY command) is issued, the IMS 15.3 system is selected as the command master.

You can also specify routing information with the TSO SPOC. For information about how to specify the ROUTE parameter, see IMS Version 15.3 System Programming APIs. Refer also to the online help provided with the TSO SPOC.

In an IMSplex, a command originates from a SPOC or automated operator program (AOP) and is sent to OM. It is then routed to IMS systems; each IMS system returns its command output. OM then consolidates the individual responses and sends consolidated output, encapsulated in XML tags, back to the client originating the request. The following figure shows this routing. OS1 has an SCI, a SPOC TSO/ISPF application, and an automation program. OS2 has an OM with an SCI, and IMS control region with an SCI. OS3 has two IMS control regions, each with an SCI. The command is routed from OS1's SCI to OM in OS2. The SCI that is associated with that OM routes the command to other IMS systems through those system's SCI.
Figure 1. Command routing in an IMSplex with CSL
begin figure description. OS1 includes an AOP, an SCI, and a SPOC TSO/ISPF application. OS2 includes OM and an IMS control region, each with an SCI. OS3 includes two IMS control regions, each with an SCI. Communication occurs between all of the SCIs. end figure description.

When commands are issued to an OM, command responses are encapsulated in XML tags.

For information about IMS commands and their responses, see IMS Version 15.3 Commands, Volume 1: IMS Commands A-M and IMS Version 15.3 Commands, Volume 2: IMS Commands N-V.