© 2009 IBM Corporation

Using the TSO SPOC to Manage Your IMS Environment

Diane Goff, IMS Advanced Technical Skillsdgoff@us.ibm.com

Central Ohio IMS User Group MeetingSeptember 27, 2012

2Central Ohio IMS User Group Meeting - 9/27/2012 2

Agenda

� Common Service Layer Refresh• Operations Manager• Resource Manager• Structured Call Interface• Open Database Manager

� IMS TSO SPOC Overview• Function and Use • TSO SPOC Audit Trail

• Batch SPOC Utility

� IMS TSO SPOC Usage• Configuration/Settings• Type-2 Commands

3Central Ohio IMS User Group Meeting - 9/27/2012 3

Common Service Layer Refresh

4Central Ohio IMS User Group Meeting - 9/27/2012 4

� An architecture to improve the systems management capabilities for IMS systems• OM provides SPOC for command entry + routes

commands/consolidates responses + provides API for automation + has user input/output exits

• RM coordinates IMSplex-wide processes + maintains global resource information in structure

• SCI provides communication ability to IMSplex members, within or across z/OS images + member registration services

• ODBM allows distributed/local Java applications access to IMS data on mainframe

CSL Refresh

5Central Ohio IMS User Group Meeting - 9/27/2012 5

Single Point of Control (SPOC)

Single Point of Control

(SPOC)

Register with SCICommand entry and response

CSL ArchitectureAddress Spaces

IMSControlRegion

SCI

StructuredCall

Interface

SCI

IMSControlRegion

SCI IMS

ControlRegion

SCI

OperationsManager

(OM)

SCI

ResourceManager

(RM)

SCI

SCICommunications

Open DatabaseManager(ODBM)

SCI

SCICommunications

6Central Ohio IMS User Group Meeting - 9/27/2012 6

IMS TSO SPOC Overview

7Central Ohio IMS User Group Meeting - 9/27/2012 7

� A SPOC is a program that interfaces between a user and the OM

� From this single point, user can enter commands to any or all IMSs• It can run on the mainframe

• TSO SPOC• Batch SPOC• REXX SPOC APIs

• It can run on the workstation• IMS Control Center

IMS Single Point of Control (SPOC)

Provided in IMS

8Central Ohio IMS User Group Meeting - 9/27/2012 8

� Functions provided• Single-system view of an IMSplex using a single console• Consolidated display of command responses from multiple

IMS systems• Message sending to IMS terminals connected to any IMS in

the IMSplex

� There can be multiple SPOCs in an IMSplex

IMS Single Point of Control (SPOC)

9Central Ohio IMS User Group Meeting - 9/27/2012 9

� Runs under z/OS as a TSO/ISPF application (DFSSPOC)� May or may not be on the same z/OS as OM

• Must be on a z/OS with an SCI

� Provides a ‘green screen’ terminal interface from which IMS commands (type-2 or type-1) may be entered by an operator to one or more members of an IMSplex (including DB/DC, DBCTL, DCCTL)

� Formats command responses for display• OM response encapsulated in XML

� OM provides security checking• TSO user ID is used to determine RACF authorization

TSO SPOC

10Central Ohio IMS User Group Meeting - 9/27/2012 10

� Route field only holds space for 2 IMS names

� Define a named group of IMS systems using SPOC Group Definitions panel and route commands to group instead

Defining groups of IMSs in the TSO SPOC

11Central Ohio IMS User Group Meeting - 9/27/2012 11

Using command shortcuts in the TSO SPOC

� Using the SPOC command shortcuts panel, you can set up shortened versions of commands or nicknames for commands

12Central Ohio IMS User Group Meeting - 9/27/2012 12

� When a command is issued, it is saved in the TSO SPOC

� Use the command status panel to work with previously entered commands:

• Display commands/responses

• Delete commands

• Edit commands

• Reissue commands

Displaying command status in the TSO SPOC

13Central Ohio IMS User Group Meeting - 9/27/2012 13

� After command entry, position the cursor on the entered command, press Enter and the command will be moved to the command line, where you can edit the command or press Enter to issue the command again

� Use the ISPF retrieve key to display commands that were previously entered (includes TSO SPOC commands plus others entered during TSO session)

� Use the ISPF RETP command to list previously entered commands, select a number and press Enter

Reissuing Commands in the TSO SPOC

14Central Ohio IMS User Group Meeting - 9/27/2012 14

� Use the TSO SPOC command status panel � Use the TSO SPOC shortcuts panel � Use the TSO SPOC expand command panel which gives

an ISPF edit panel to edit a long command

Issuing Commands in the TSO SPOC

15Central Ohio IMS User Group Meeting - 9/27/2012 15

TSO SPOC Operations Manager Audit Trail

� Keeps track of IMSplex activity, including: • IMS command input from OM clients (TSO SPOC, IMS

Control Center)• Reponses to commands • Unsolicited messages

16Central Ohio IMS User Group Meeting - 9/27/2012 16

User IDs shown with commands entered

TSO SPOC Operations Manager Audit Trail

17Central Ohio IMS User Group Meeting - 9/27/2012 17

User IDs shown with commands entered, filtered by User ID

TSO SPOC Operations Manager Audit Trail

18Central Ohio IMS User Group Meeting - 9/27/2012 18

Batch SPOC

� Provides a capability to submit IMS commands from a batch job step• Uses the Operations Manager (OM) interface

� IMSplex environment defined in execution parameters• IMSplex name, command routing, wait time

� Commands defined in SYSIN file• All commands supported by OM API (type-2 and most

type-1) � Output to SYSPRINT

• Responses formatted to look like SPOC screen format� Benefits

• Batch jobs may include steps with "online" commands• For example, steps to /DBR, reorganize, and /START

databases

19Central Ohio IMS User Group Meeting - 9/27/2012 19

Batch SPOC Utility – Input Example

� JCL invokes CSLUSPOC program�Execution parameters specified with PARM=�SYSIN DD statement includes commands to be issued

when utility is run�Specify DD SYSOUT=* to view utility output with SDSF

after utility is run

20Central Ohio IMS User Group Meeting - 9/27/2012 20

Batch SPOC Utility – Output Example with Wait Time Specified

Command response

included in output

21Central Ohio IMS User Group Meeting - 9/27/2012 21

SPOC Usage

22Central Ohio IMS User Group Meeting - 9/27/2012 22

SPOC Usage

� IMSplex group definitions – routing to 3+ IMS systems� Command shortcuts – abbreviated command versions� Command status – display/reissue commands� Resource management

• Display transaction/database attributes and status Queue/dequeue messages to/from transactions Update database attributes

• Stop/start transactions • Using MTO versus TSO SPOC

• Activate individual resources with ACBLIB Member Online Change

• Dynamically manage (create/delete) MODBLKS Resources

23Central Ohio IMS User Group Meeting - 9/27/2012 23

IMSplex Group Definitions

24Central Ohio IMS User Group Meeting - 9/27/2012 24

25Central Ohio IMS User Group Meeting - 9/27/2012 25

26Central Ohio IMS User Group Meeting - 9/27/2012 26

27Central Ohio IMS User Group Meeting - 9/27/2012 27

Command Shortcuts

28Central Ohio IMS User Group Meeting - 9/27/2012 28

29Central Ohio IMS User Group Meeting - 9/27/2012 29

30Central Ohio IMS User Group Meeting - 9/27/2012 30

31Central Ohio IMS User Group Meeting - 9/27/2012 31

32Central Ohio IMS User Group Meeting - 9/27/2012 32

Display/Reissue Commands

33Central Ohio IMS User Group Meeting - 9/27/2012 33

34Central Ohio IMS User Group Meeting - 9/27/2012 34

35Central Ohio IMS User Group Meeting - 9/27/2012 35

36Central Ohio IMS User Group Meeting - 9/27/2012 36

37Central Ohio IMS User Group Meeting - 9/27/2012 37

38Central Ohio IMS User Group Meeting - 9/27/2012 38

39Central Ohio IMS User Group Meeting - 9/27/2012 39

40Central Ohio IMS User Group Meeting - 9/27/2012 40

41Central Ohio IMS User Group Meeting - 9/27/2012 41

Querying Databases/Transactions

42Central Ohio IMS User Group Meeting - 9/27/2012 42

43Central Ohio IMS User Group Meeting - 9/27/2012 43

44Central Ohio IMS User Group Meeting - 9/27/2012 44

45Central Ohio IMS User Group Meeting - 9/27/2012 45

46Central Ohio IMS User Group Meeting - 9/27/2012 46

47Central Ohio IMS User Group Meeting - 9/27/2012 47

48Central Ohio IMS User Group Meeting - 9/27/2012 48

49Central Ohio IMS User Group Meeting - 9/27/2012 49

50Central Ohio IMS User Group Meeting - 9/27/2012 50

Queuing/Dequeuing Messages to/from Transactions

51Central Ohio IMS User Group Meeting - 9/27/2012 51

52Central Ohio IMS User Group Meeting - 9/27/2012 52

53Central Ohio IMS User Group Meeting - 9/27/2012 53

54Central Ohio IMS User Group Meeting - 9/27/2012 54

55Central Ohio IMS User Group Meeting - 9/27/2012 55

56Central Ohio IMS User Group Meeting - 9/27/2012 56

57Central Ohio IMS User Group Meeting - 9/27/2012 57

58Central Ohio IMS User Group Meeting - 9/27/2012 58

59Central Ohio IMS User Group Meeting - 9/27/2012 59

60Central Ohio IMS User Group Meeting - 9/27/2012 60

61Central Ohio IMS User Group Meeting - 9/27/2012 61

62Central Ohio IMS User Group Meeting - 9/27/2012 62

63Central Ohio IMS User Group Meeting - 9/27/2012 63

64Central Ohio IMS User Group Meeting - 9/27/2012 64

65Central Ohio IMS User Group Meeting - 9/27/2012 65

66Central Ohio IMS User Group Meeting - 9/27/2012 66

67Central Ohio IMS User Group Meeting - 9/27/2012 67

68Central Ohio IMS User Group Meeting - 9/27/2012 68

Updating Databases

69Central Ohio IMS User Group Meeting - 9/27/2012 69

70Central Ohio IMS User Group Meeting - 9/27/2012 70

71Central Ohio IMS User Group Meeting - 9/27/2012 71

72Central Ohio IMS User Group Meeting - 9/27/2012 72

73Central Ohio IMS User Group Meeting - 9/27/2012 73

74Central Ohio IMS User Group Meeting - 9/27/2012 74

75Central Ohio IMS User Group Meeting - 9/27/2012 75

76Central Ohio IMS User Group Meeting - 9/27/2012 76

77Central Ohio IMS User Group Meeting - 9/27/2012 77

78Central Ohio IMS User Group Meeting - 9/27/2012 78

79Central Ohio IMS User Group Meeting - 9/27/2012 79

Starting/Stopping Transactions with Type-1 Commands Using MTO

80Central Ohio IMS User Group Meeting - 9/27/2012 80

81Central Ohio IMS User Group Meeting - 9/27/2012 81

82Central Ohio IMS User Group Meeting - 9/27/2012 82

83Central Ohio IMS User Group Meeting - 9/27/2012 83

84Central Ohio IMS User Group Meeting - 9/27/2012 84

85Central Ohio IMS User Group Meeting - 9/27/2012 85

Starting/Stopping Transactions with Type-2 Commands Using TSO SPOC

86Central Ohio IMS User Group Meeting - 9/27/2012 86

87Central Ohio IMS User Group Meeting - 9/27/2012 87

88Central Ohio IMS User Group Meeting - 9/27/2012 88

89Central Ohio IMS User Group Meeting - 9/27/2012 89

90Central Ohio IMS User Group Meeting - 9/27/2012 90

91Central Ohio IMS User Group Meeting - 9/27/2012 91

Activating Individual Resources with ACBLIB Member Online Change

92Central Ohio IMS User Group Meeting - 9/27/2012 92

93Central Ohio IMS User Group Meeting - 9/27/2012 93

94Central Ohio IMS User Group Meeting - 9/27/2012 94

95Central Ohio IMS User Group Meeting - 9/27/2012 95

96Central Ohio IMS User Group Meeting - 9/27/2012 96

97Central Ohio IMS User Group Meeting - 9/27/2012 97

98Central Ohio IMS User Group Meeting - 9/27/2012 98

99Central Ohio IMS User Group Meeting - 9/27/2012 99

Dynamically Managing MODBLKS Resources

100Central Ohio IMS User Group Meeting - 9/27/2012 100

101Central Ohio IMS User Group Meeting - 9/27/2012 101

102Central Ohio IMS User Group Meeting - 9/27/2012 102

103Central Ohio IMS User Group Meeting - 9/27/2012 103

Contact Information

Angie Greenhawgreenhaw@us.ibm.com

104Central Ohio IMS User Group Meeting - 9/27/2012 104

Questions?