Controlling IMS with the TSO SPOC application
You can use the TSO SPOC to issue operator commands in an IMSplex. The TSO SPOC application uses an ISPF panel interface and communicates with the IMS™ Operations Manager (OM). OM then communicates with all of the other address spaces in the IMSplex (for example, IMS) as required for operations.
There can be more than one TSO SPOC in an IMSplex. However, the TSO SPOC is optional in an IMSplex.
The TSO SPOC provides the following functions to an IMSplex:
- Presents a single system image for an IMSplex by allowing the user to issue commands to all IMS systems in the IMSplex from a single console.
- Displays consolidated command responses from multiple IMS address spaces.
- Sends a message to an IMS terminal connected to any IMS control region in the IMSplex by using the IMS /BROADCAST command.
- Allows users to create, query, update, and delete various IMS resources online.
- Displays the OM audit trail log which records command input, command responses, and selected system messages from across the IMSplex.
- Allows users to define input user exits to modify or reject command parameters, set return and reason codes, and send text messages to the TSO SPOC session.
There are several ways to issue commands in the IMS TSO SPOC application:
- By command line
- By retrieving a command
- Using the ISPF RETRIEVE command
- Using a command listed in the response area
- Using the Command status panel
- By defining and using command shortcuts
You can use these methods in any combination at any time.
The following screen sample shows the format of the TSO SPOC screen:
File Action Manage resources SPOC View Options Help
--------------------------------------------------------------–
PLEX1 IMS Single Point of Control
Command ==> ___________________________________________________
_______________________________________________________________
----------------------- Plex . _____ Route . _____ Wait . _____
Response for:
CSLM000I (C) Copyright IBM Corp. 2000. All rights reserved.
F1=Help f3=Exit F4=Showlog F6=Expand F9=Retrieve F12=CancelYou can issue both IMS type-1 commands and type-2 commands by using the TSO SPOC interface. Enter the command next to the command prompt (Command ==> in the previous screen sample). Enter the IMSplex name in the Plex field. Enter the list of IMS systems to which to route the command, if applicable, in the Route field. If you specify an asterisk (*) in the Route field, the command is routed to all registered command processing clients in the IMSplex. If you specify a percent symbol (%) in the Route field, the command is routed to only one command processing client in the IMSplex that is registered for the command and that has MASTER capability. The Operations Manager chooses the command processing client. If no route list is specified, the default routing is to all registered command processing clients in the IMSplex.
After you type the command, press Enter. The command issued is shown in the Response for: field and the actual command response is shown below the Response for: field.
For more information about the TSO SPOC application, see the IMS TSO SPOC online tutorial. To see the IMS TSO SPOC online tutorial, select Help > Tutorial in the application.
- Starting and setting up the TSO SPOC
After you start the TSO SPOC through the IMS Application menu, you must add the IMS distribution libraries to the TSO user's environment. - Type-1 and type-2 command responses from the TSO SPOC
When you issue a type-1 command in the TSO SPOC, the command response is displayed in sequential format. The command response consists of messages prefixed by the member name. Information from each member is grouped together in the command response. - Displaying command status in the TSO SPOC
You can use the TSO SPOC to display command status, reissue commands that were previously issued, or edit and delete commands. - Command shortcuts in the TSO SPOC
You can use the command shortcuts option of the TSO SPOC if you prefer to use shortened versions of commands or nicknames for commands. Define the shortcuts (the short commands or nicknames) in the TSO SPOC. - Defining groups of IMS systems in the TSO SPOC
You can use the Route field in the TSO SPOC application to issue commands to a specific IMS or IMS systems. However, the Route field is long enough for only two IMS systems. To work around this restriction, you can define groups of IMS systems in the group definitions panel of the TSO SPOC. - Reissuing commands in the TSO SPOC
When you issue a command, the command is saved in the TSO SPOC. You can reissue commands in several ways. - Managing IMS resources by using TSO SPOC
The TSO SPOC application provides a set of resource management panels to help you manage IMS resources. You can use TSO SPOC to query IMS resources and, if dynamic resource definition (DRD) is enabled in your IMS systems, you can also use the TSO SPOC panels to create, delete, export, import, and update IMS resources. - Viewing the OM audit trail log by using TSO SPOC
You can view the OM audit trail log by using the TSO SPOC application if the CSL Operations Manager (OM) is configured to produce an audit trail log. The OM audit trail log contains log records of commands, command responses, and system messages routed through OM.
