IBM Software Group

© 2003 IBM CorporationMay, 2003

IMS V8 Operations Manager(OM)

Ken BlackmanIMS Advanced Technical Support

1

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Common Service Layer (CSL)Single Point of Control (SPOC)

Master Terminal

End User Terminal

Coupling Facility (CF)

Resource Structure

MSGQ Structures

Shared VSO Cache

OSAM Cache

LOGR Structures

Shared Databases

Operations Manager

(OM)

Structured Call Interface

(SCI)

Resource Manager

(RM)

SCI SCI SCI

SCI

IMS Control Region

(DL/I, Dep Regions, DBRC)

SCI

Common Queue Server (CQS)

Automation

IMS V8 IMSplex

2

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Provides an API allowing common point of command entry into IMSplexFocal point for operations management and automation

Provides the following services to members and clients of an IMSplexProvide an API for IMS commands for automation

Classic IMS commands (/cmd ...)New IMSplex commands

Command registration to support any command processing clientClients tell OM which commands it can process

Route commands to IMSplex members registered for the commandConsolidate command responses from individual IMSplex members into a single response to present to the command originator

Can specify time-out value for responseCommand security

Perform authorization within OM - before sending to IMSRACF (or equivalent)User-written command security exit

OM

3

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

OM in an IMSplex

SCI OM

SCI

OM

SPOC

Automation

SCIOM

IMS3

IMS2

IMS4

RM

CF

SPOC or AOP can specify routing for any command

OM routes command to one or more IMSs

Each IMS responds to OM

OM consolidates responses for SPOC

SCI

IMS1

OM

Additional OM address spaces are optional.

SCISCI

4

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

OM in an IMSplex

SPOC

Automation

SCI

IMS1

OM RM

SCI SCI

5

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Input User Exit called with command inputviews and manipulates a command before it is processed

Output User Exitcalled with command output such as responses, unsolicited output, undeliverable outputviews and manipulates output before it is returned

Security User Exitpermits command security checking

OM User Exits for Command Manipulation and Authorization

6

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Exploits OM's functions to improve systems management and automation Addresses many IMS command requirements

Long range direction is to convert classic IMS commands to enhanced command syntax

Supported only through the OM APInot supported from system console, MTO, E-MCS console, CMD/ICMD DL/I callsnot passed to AOI exits (DFSAOE00, DFSAOUE0)

OM Introduces Enhanced Command Syntax

7

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

DELETE LEINITIATE OLCQUERY IMSPLEXQUERY LEQUERY MEMBER TYPE(IMS)QUERY OLCQUERY STRUCTUREQUERY TRANTERMINATE OLCUPDATE LEUPDATE TRAN

OM Commands

8

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Response returned synchronously to improve automation

Replaces DFS058I COMMAND IN PROGRESS response

Classic database commands changed in IMS V8:/DBD DB/DBR AREA/DBLOCK DB/START AREA/DB/MADSIOT/STOP ADS/AREA/DB/MADSIOT/UNLOCK DB/VUNLOAD AREA

OM provides Synchronous Command Responses

9

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Types of SPOCsTSO SPOC

IMS system management application comprised of ISPF panel interface on a TSO terminal

Control Center for IMSIMS system management application with a graphical user interface

REXX Program using the REXX SPOC APIAn application programming interface that allows automation programs to perform SPOC functions

Vendor or user developed SPOCA program written to use or access OM API to perform SPOC functions

"Single" does not mean "only" ! Can have more than one type of SPOC in an IMSplexand any number of SPOCs active

OM enables Single Point of Control(SPOC)

10

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Operating System

Operations Manager (OM)

SCI

IMS Connect

SCI IMS4SCI IMS3

SCI IMS2

SCI IMS1

REXXSPOC API

Vendor SPOC Program

IMS Control Center SPOC

TSO/ISPF SPOC

TSO/ISPF SPOC

TSO/ISPF SPOC

Multiple SPOC Users in an IMSplex

11

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

TSO SPOC - OM Command Response Example

File Display View Options Help ------------------------------------------------------------------- IMS Single Point of Control Command ===> _____________________________________________________ ----------------------- Plex . _____ Route . IMS13____ Wait . ____ Response for: QRY TRAN NAME(A*) SHOW(ALL) More: +> Trancode MbrName CC PSBname QCnt LCls LQCnt LLCT LPLCT ADDINV IMS1 0 0 ADDINV IMS1 0 INVPSB 4 0 2 65535 ADDINV IMS3 0 0 ADDINV IMS3 0 INVPSB 4 0 2 65535 ADDPART IMS1 0 0 ADDPART IMS1 0 PARTPSB 23 0 65535 65535 etc.

F1=Help F3=Exit F4=Showlog F6=Expand F9=Retrieve F12=Cancel

Display formatted by SPOC from XML response.

12

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

TSO SPOC - /DBR DB Command Response Example File Display View Options Help --------------------------------- IMS Single Point of Control Command ===> _____________________________________________________ ----------------------- Plex . _____ Route . _________ Wait . ____ Log for . . : DBR DB BANKATMS BANKTERM BANKLDGR BE3ORDER IMSplex . . . . . : PLEX1 Routing . . . . . : Start time. . . . : 2002.023 12:15:14.13 Stop time . . . . : 2002.023 12:15:14.62 Return code . . . : 00000000 Reason code . . . : 00000000 Command master. . : IMS2 MbrName Messages -------- ----------------------- IMS2 DFS0488I DBR COMMAND COMPLETED. DBN= BANKATMS RC=04 IMS2 DFS0488I DBR COMMAND COMPLETED. DBN= BANKTERM RC=04 IMS2 DFS0488I DBR COMMAND COMPLETED. DBN= BANKLDGR RC=04 IMS2 DFS0488I DBR COMMAND COMPLETED. DBN= BE3ORDER RC= 0 SYS3 DFS0488I DBR COMMAND COMPLETED. DBN= BANKATMS RC=04 SYS3 DFS0488I DBR COMMAND COMPLETED. DBN= BANKTERM RC=04 SYS3 DFS0488I DBR COMMAND COMPLETED. DBN= BANKLDGR RC=04 SYS3 DFS0488I DBR COMMAND COMPLETED. DBN= BE3ORDER RC= 0 IMS3 DFS3466I DDIR FOR DATABASE BANKATMS NOT FOUND IMS3 DFS3466I DDIR FOR DATABASE BANKTERM NOT FOUND IMS3 DFS3466I DDIR FOR DATABASE BANKLDGR NOT FOUND IMS3 DFS0488I DBR COMMAND COMPLETED. DBN= BE3ORDER RC= 0

13

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

Single Point of Control (SPOC)

IMSControlRegion

SCI

StructuredCall

Interface

SCI

IMSControlRegion

SCI

IMSControlRegion

SCI

OperationsManager

(OM)

SCI

IMS Control CenterRequires IMS Connect 1.2Requires DB2 UDB Administration Client V8.1

Does not require DB2 UDB For more information, go to:

http://www-3.ibm.com/software/data/ims/imscc/index.html

IMSConnect

1.2

TCP/IP

IMS Control Center

14

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

IMS Control Center - ExampleSelect QRY TRAN - Identify Trancode(s)

15

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

MS Control Center - Example ...

16

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

– Classic Command Results – Classic Command Results

Display formatted by CC SPOC as received from IMS. Each line

is one XML tag.

IMS Control Center

17

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

IMSControlRegion

SCI

IMSControlRegion

SCI

IMSControlRegion

SCI

OperationsManager

(OM)

SCI

Register with SCICommand entry and response

/* REXX EXEC */...Address link 'cslulxsb'imscmdresults=cslulgts()......

StructuredCall

Interface

SCI

IMS provides MVS setup program, REXX functions,and variables to enable REXXexecs to interface withIMS through OM.

NetView

REXX Exec Interface to OM and IMS

18

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

REXX SPOC

Support for a REXX SPOC includes

CSLULXSB programSets up IMSSPOC host command environment for REXX with several subcommands Establishes REXX function for retrieving responseProvides REXX variables for return and reason codes

IMSSPOC commandHost command environment to send commands to OMSubcommands establish IMSplex parameters

CSLULGTS() functionREXX "function" to retrieve response from OM

19

© 2003 IBM CorporationIMS V8 Common Service Layer Overview

IBM Software Group

OM Summary Operations Manager is part of Common Service Layer

Joins IMSplexRegisters with SCIUses SCI to communicate with other IMSplex members

One OM address space required per IMSplexMay have multiple OMs for availability and performanceBuilt on Base Primitive Environment (BPE)

Provides services to IMSplex Command Processing (CP) and Automated Operations (AO) clients

API for submitting commandsCommand registration for CP clientsRoutes commands from AO clients to CP clientsConsolidates responses from CP clients and passes to AO clientProvides command security for classic and IMSplex commands

20