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 Version 13 system with an IMS Version 13 CQS, and another IMS Version 12 system with an IMS Version 12, if an INIT OLC command (which is a ROUTE=ANY command) is issued, the IMS Version 13 system is selected as the command master.

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

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 13 Commands, Volume 1: IMS Commands A-M and IMS Version 13 Commands, Volume 2: IMS Commands N-V.