SPOC Feature of COPE

Description of the COPE SPOC Feature

The Single Point Of Control (SPOC) feature of IMS allows type 1 and type 2 commands to be issued from an ISPF session and displays the results of the commands. Commands and their responses are stored, and the commands may be reissued at any time. The COPE SPOC Feature modifies the operation of the IMS SPOC TSO Feature, and translates Program and Database names to COPE names for all or specific Logical Systems. Responses from IMS are also translated to display the COPE names ant the ’real’ user names.

In addition to the command facilities, the COPE SPOC feature also uses the Dynamic Resource Definition Feature (DRD) of IMS and updates an executing system with new definitions of transactions, databases (DBDs) and programs (PSBs) associated with all COPE Logical Systems

Accessing the COPE SPOC Command Application

When the feature is installed, the primary ISPF COPE panel appears as shown in the following figure.

Prime ISPF COPE Panel with SPOC Feature

Selecting Option 9 displays the following IMS Application Menu (see the following figure).

To exit the application, press PF3.

SPOC Command Entry Panel

Before commencing operations, position the cursor on the Options word on the top line and press Enter. Select Option 1 Preferences from the drop down panel. The following panel (see the following figure) displays.

Options Preferences Panel

The default IMSPLEX and Routing values must be entered and must match the XPLEX and XROUTE ZDEFAULT parameters specified for the Physical COPE System. The Default Exit Option (accessed by scrolling forward from the above panel) should be set to 2 (Keep Command Responses).

Example of Inputting IMS Command and the Response

Any Type 1 or Type 2 commands may be entered. An example of a Type 2 command is shown in the following figure.

Example of Inputting a Type 2 Command

The response from this command follows (see the following figure).

Response from Type 2 command

Generic (ending with a asterisk) are allowed but a complete name may also be entered. The resulting display shows the ’real user name’ as well as the COPE C-number name that IMS uses. The <LSYS cope-name> parameter limits the command to objects in the defined Logical System. If the <LSYS cope-name> parameter is omitted, all objects for all COPE logical systems are displayed. The <LSYS cope-name> parameter may be placed anywhere in the command.

Using IMS DRD (Dynamic Resource Definition)

Adding DBDs, PSBs, and transactions is prohibited using DRD commands if the COPE SPOC interface is used. The modification and deletion commands are allowed. If PSBs, DBDs or transactions are to be added to a COPE system definition, the existing process of updating the Stage 1 source via COPE Option 4.2;E;S must be used. This allows COPE to assign C-numbers for the defined objects. Generation of the Stage 1 source using option 4.2;GS will access the operational COPE system and add new objects dynamically using Type 2 commands. The Stage 1 source will also be generated in the normal manner but need not be compiled. If a generation is performed but IMS is not executing, and if the MODBLKS form of definition is not used, the generation job should be repeated when IMS is active so that definitions may be added or deleted.