Automation Using Tivoli NetView OS-390 V1R3 and System Automation OS-390 V1R3 Sg245515
Automation Using Tivoli NetView OS-390 V1R3 and System Automation OS-390 V1R3 Sg245515
Automation Using Tivoli NetView OS-390 V1R3 and System Automation OS-390 V1R3 Sg245515
Holger Stamme, Ling Xiao Gao, Marcio Guimaraes, Clive Kennedy, Jason Wyer
SG24-5515-00
SG24-5515-00
International Technical Support Organization Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
March 2000
Take Note! Before using this information and the product it supports, be sure to read the general information in Appendix D, Special notices on page 245.
First Edition (March 2000) This edition applies to Tivoli NetView for OS/390 V1R3 and System Automation for OS/390 V1R3 for use with the OS/390. This document created or updated on March 14, 2000. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. OSJB Building 003 Internal Zip 2834 11400 Burnet Road Austin, Texas 78758-3493 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.
Copyright International Business Machines Corporation 2000. All rights reserved. Note to U.S Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .ix The team that wrote this redbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Comments welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi Chapter 1. Introduction to Tivoli NetView for OS/390 V1R3 . 1.1 At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.1 IP management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.2 Graphical console. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.3 Automation features . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3.4 Other customer satisfaction enhancements . . . . . . . . 1.3.5 Product positioning in the market . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .. .. .. .. .. .. .. .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 .1 .1 .3 .3 .5 .6 .7 .9
Chapter 2. Benefits of using System Automation for OS/390 . . . 2.1 Why automate? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2 Proactive management of OS/390 subsystem tasks . . . . . . . . . . 2.3 Monitoring and recovery capabilities of OS/390 subsystems . . . 2.4 Automation features of System Automation for OS/390 V1R3 . . 2.4.1 New Interface - Single system image support . . . . . . . . . . . 2.4.2 Better managing your applications . . . . . . . . . . . . . . . . . . . 2.4.3 Simultaneously updating policy databases for applications . 2.4.4 Notifying the Tivoli Enterprise Console . . . . . . . . . . . . . . . . 2.4.5 Other enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 3. The ITSO automation project environment . 3.1 Types of communication. . . . . . . . . . . . . . . . . . . . . . . 3.1.1 Communication using a LU 6.2 session . . . . . . . 3.1.2 Communication using a LUC session . . . . . . . . . 3.1.3 Communication using an OST-NNT session . . . . 3.2 Resource Object Data Manager (RODM) . . . . . . . . . . 3.2.1 RODM object oriented structure . . . . . . . . . . . . . 3.3 Graphic Monitor Facility Host Subsystem (GMFHS) . . 3.4 Status Display Facility (SDF) . . . . . . . . . . . . . . . . . . . Chapter 4. Customization of Tivoli NetView OS/390. . 4.1 Planning the Tivoli NetView for OS/390 environment 4.2 Defining the Tivoli NetView for OS/390 environment 4.2.1 Recommended library structure in multi-system 4.2.2 OS/390 subsystem extensions . . . . . . . . . . . . . 4.2.3 Usage of OS/390 system symbolics . . . . . . . . . .. .. .. .. .. .. .. .. .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .. .. .. .. .. .. .. ..
. 11 . 11 . 12 . 12 . 13 . 13 . 13 . 14 . 14 . 14 . 17 . 19 . 19 . 20 . 20 . 20 . 21 . 21 . 22 . 25 . 26 . 27 . 27 . 31 . 32
iii
4.3 Network management environment . . . . . . . . . . . . . . . . . . . . . . . . 4.3.1 Creation of common networking NetView libraries . . . . . . . . . 4.3.2 Setting up the base components NetView for OS/390. . . . . . . 4.3.3 Setting up the Resource Object Data Manager . . . . . . . . . . . . 4.3.4 Setting up the Graphic Monitor Facility Host Subsystem . . . . . 4.3.5 Setting up the Automated Operation Network feature . . . . . . . 4.3.6 Creation of local (domain specific) NetView libraries . . . . . . . 4.4 Automation environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.4.1 Creation of common automation NetView libraries . . . . . . . . . 4.4.2 Setting up the base NetView for OS/390. . . . . . . . . . . . . . . . . 4.4.3 Setting up the Resource Object Data Manager . . . . . . . . . . . . 4.4.4 Customizing RODM load jobs in the automation environment . 4.4.5 Setting up the Graphic Monitor Facility Host Subsystem . . . . . 4.4.6 Creation of local (domain specific) NetView libraries . . . . . . .
. . . . . . . . . . . . . .
. 33 . 34 . 36 . 36 . 37 . 37 . 37 . 39 . 40 . 47 . 47 . 49 . 49 . 50
Chapter 5. Customization of System Automation for OS/390 . . . . . . . 53 5.1 Base System Automation customization . . . . . . . . . . . . . . . . . . . . . . . 53 5.1.1 Preparation and set up jobs for System Automation . . . . . . . . . . 53 5.1.2 Preparing the OS/390 system environment and library . . . . . . . . 55 5.1.3 Creating System Automation policy database dialog panels . . . . 56 5.2 Usage of system symbolics and System Automation synonyms . . . . . 59 5.3 Defining all systems and objects to System Automation . . . . . . . . . . . 60 5.3.1 Starting the System Automation policy database dialog . . . . . . . 61 5.3.2 Creating a new System Automation policy database. . . . . . . . . . 62 5.3.3 Entering all systems and objects . . . . . . . . . . . . . . . . . . . . . . . . 64 5.3.4 Building SA Automation Control File (ACF) . . . . . . . . . . . . . . . . . . . . 98 5.3.5 Build RODM loader input file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 5.4 Defining dependencies and start-up behavior . . . . . . . . . . . . . . . . . . 103 5.4.1 Define dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 5.4.2 Define start-up behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 5.5 Customizing the Status Display Facility (SDF) . . . . . . . . . . . . . . . . . 108 5.5.1 Customizing the panel member AOFPNLS . . . . . . . . . . . . . . . . 108 5.5.2 Customizing the status member AOFTREE . . . . . . . . . . . . . . . 110 5.5.3 Defining SDF gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 5.5.4 Starting the SDF monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Chapter 6. Installation of the NetView Management Console . . . 6.1 Prerequisites for NetView Management Console Version 1.3 . . . 6.2 Setting up the NMC Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.2.1 Installing NMC Server to run as a Windows NT service . . . 6.2.2 Setting up NMC Topology Server for Systems Automation . 6.2.3 Starting the NMC Topology Server using TCP/IP . . . . . . . . 6.2.4 Uninstalling the NMC Topology Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 . 117 . 117 . 117 . 123 . 127 . 128
iv
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
6.2.5 Hints and tips for the NMC Topology Server . . . . . . . . . . . . . . 6.3 Setting up the NMC client workstation . . . . . . . . . . . . . . . . . . . . . . 6.3.1 Installing the NMC Topology Console . . . . . . . . . . . . . . . . . . . 6.3.2 Starting the NMC Console using a TCP/IP connection . . . . . . 6.3.3 Uninstalling the Tivoli NMC Topology Console . . . . . . . . . . . . 6.3.4 Hints and tips for the NMC Topology Console . . . . . . . . . . . . 6.3.5 Issuing SA OS/390 commands using the NMC . . . . . . . . . . . . 6.4 Setting up the Web interface to Tivoli NetView OS/390 . . . . . . . . . 6.5 Setting up the NetView 3270 Management Console . . . . . . . . . . . . 6.5.1 Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.5.2 Selecting the correct files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.5.3 Available documentation and technical information. . . . . . . . . 6.5.4 Setting up the host (mainframe) environment . . . . . . . . . . . . . 6.5.5 Installing NetView 3270 Console on Windows 95, 98, and NT 6.5.6 Uninstalling the NetView 3270 Console . . . . . . . . . . . . . . . . . 6.5.7 Replicating the NetView 3270 Console . . . . . . . . . . . . . . . . . . 6.5.8 Operating notes, hints, and tips . . . . . . . . . . . . . . . . . . . . . . . Chapter 7. Maintenance of Tivoli NetView and System Automation 7.1 Automation table maintenance using AUTOMAN . . . . . . . . . . . . . . 7.1.1 Enabling the AUTOMAN function for the Automation NetView 7.1.2 Using AUTOMAN command . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2 Netview and automation table optimization for performance . . . . . . 7.2.1 NetView automation table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2.2 Additional hints and tuning considerations . . . . . . . . . . . . . . . 7.3 Maintenance of the System Automation policy data base . . . . . . . . 7.3.1 Design a hierarchical structure . . . . . . . . . . . . . . . . . . . . . . . . 7.3.2 Using ADD/REMOVE commands . . . . . . . . . . . . . . . . . . . . . . 7.3.3 RACF considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3.4 System Automation migration . . . . . . . . . . . . . . . . . . . . . . . . . 7.3.5 Building for ACF and RODM . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3.6 Policy report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3.7 ACFPLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 8. Base automation features . . . . . . . . . . . . . . . . . . . 8.1 New automation table features of NetView for OS/390 V1R3 8.1.1 Multi-line message support . . . . . . . . . . . . . . . . . . . . . . 8.1.2 IF-THEN condition item substrings . . . . . . . . . . . . . . . . 8.1.3 Greater-than and less-than operator support . . . . . . . . 8.1.4 Numeric comparison and current time support . . . . . . . 8.1.5 Variable value function support. . . . . . . . . . . . . . . . . . . 8.1.6 Message reformatting . . . . . . . . . . . . . . . . . . . . . . . . . . 8.1.7 Automation table tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. .. .. .. .. .. .. .. .. . . . . . . . . . . . . . . . . . .
. 129 . 131 . 131 . 133 . 134 . 135 . 135 . 140 . 142 . 142 . 143 . 144 . 144 . 146 . 150 . 151 . 152 . 155 . 155 . 155 . 156 . 166 . 166 . 168 . 170 . 170 . 171 . 171 . 172 . 172 . 173 . 173 . 175 . 175 . 175 . 176 . 177 . 177 . 177 . 178 . 179
8.1.8 The AUTOMATED function . 8.2 System Automation framework . . 8.2.1 Automating subsystems . . . 8.2.2 Automating messages . . . . 8.3 System Automation and NetView
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . . . . . . . . . . . . . . . . . .
. 180 . 180 . 181 . 193 . 197 . 199 . 199 . 199 . 200 . 201 . 202 . 203 . 204 . 205 . 214 . 214 . 215 . 217 . 218 . 224 . 225
Chapter 9. Automation example scenarios . . . . . . . . . . . . . . . . . . . 9.1 NetView SMTP mail gateway support . . . . . . . . . . . . . . . . . . . . . . 9.1.1 NetView provided samples . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.2 Required customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.3 Sending SMTP e-mail with EZLEMAIL . . . . . . . . . . . . . . . . . 9.1.4 Sending SMTP e-mail from AON Inform policies. . . . . . . . . . 9.1.5 Sending SMTP e-mail from user-written clists. . . . . . . . . . . . 9.2 System Automation in a multi-system focal point environment . . . 9.2.1 Defining Automation Network process . . . . . . . . . . . . . . . . . 9.3 Using NetView AON inform policies by System Automation . . . . . 9.3.1 Installation of AON inform policy in the Automation NetView. 9.3.2 Inform policy customizing . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3.3 Calling the Inform policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3.4 Calling AON Inform policy from System Automation . . . . . . . 9.4 Brief comparison of NMC and SDF Consoles . . . . . . . . . . . . . . . . 9.5 Example NMC screens of the ITSO project scenario . . . . . . . . . .
Appendix A. NetView 1.3 toleration for System Automation 1.3 . . . . 231 Appendix B. System Automation V1R3 members and jobs . . . . . . . . 233 B.1 Other System Automation jobs and definitions . . . . . . . . . . . . . . . . . . . . 234 B.1.1 Automation NetView start-up procedure . . . . . . . . . . . . . . . . . . . . . 235 B.1.2 System Automation RODM procedure . . . . . . . . . . . . . . . . . . . . . . 237 B.1.3 Automation GMFHS start-up procedure . . . . . . . . . . . . . . . . . . . . . 238 B.1.4 SA RODM data model load job. . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Appendix C. One RODM/GMFHS focal point configuration. . . . . . . . . 241 Appendix D. Special notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Appendix E. Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 E.1 IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 E.2 IBM Redbooks collections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 E.3 Other resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 E.4 Referenced Web sites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 How to get ITSO redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 IBM Redbook fax order form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
vi
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Abbreviations and acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 IBM Redbooks review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
vii
viii
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Preface
The objective of this redbook is to provide an easy to use and understand automation guide for large organizations. The major focus of this redbook is on how to efficiently set up and customize Tivoli NetView for OS/390 and Systems Automation for OS/390 in a multi-systems enterprise environment. In addition to this, this redbook provides best practices and tips for maintenance issues of the Tivoli NetView and System Automation environment. This will include the AUTOMAN feature for maintenance of multiple automation tables, basic tuning considerations to improve general NetView and automation table performance, as well as an optimized structure of the System Automation policy database. To help system administrators and operators establish and leverage their automation environment, this redbook provides further information on basic automation features, such as the System Automation framework, and some automation scenarios using the new NetView AON inform policy feature. Examples include an automation scenario of the ITSO project environment, as well as integration aspects of System Automation using the new NetView AON inform policy features, such as notifications via pager support or escalations by sending e-mails using the SMTP gateway support. The steps outlined in this redbook are based on, and supported by, examples derived from the actual installation, set up, and customization of Tivoli NetView for OS/390 and System Automation for OS/390 at the ITSO.
ix
Marcio Guimaraes is an Advisory IT Specialist in Brazil. He has eight years of experience in the IT field, of which the last five years have been in developing, designing, and supporting the System Management area. His areas of expertise include Tivoli NetView for OS/390 and System Automation for OS/390. Clive Kennedy is a Network Automation Specialist with AT&T Global Networks in the UK. He has over 20 years experience in Systems and Network Management in large MVS installations and over 12 years experience using NetView OS/390 for Systems and Network Automation. Jason Wyer is an IT Consultant working for PricewaterhouseCoopers in the USA. He has three years of experience in the Systems Administration field. He holds a BS from the University of Connecticut along with being an A+ Certified Technician and Microsoft Certified Professional. His areas of expertise include Microsoft Windows environments. Thanks to the following people for their invaluable contributions to this project: Adam Barry Tivoli Systems Raleigh, Network Management Applications Development Denny Beary IBM Gaithersburg, S/390 Systems Management Technology Support Budi Darmawan International Technical Support Organization, Austin Center Gary Forghetti Tivoli Systems Raleigh, Tivoli Product Introduction Roland Haibl IBM Boeblingen, System Automation for OS/390 Information Development Robert Haimowitz International Technical Support Organization, Raleigh Center Stephan Hartig IBM Boeblingen, System Automation for OS/390 Information Development Joseph Macera IBM Los Angeles, Tivoli Migration Team Wade Miller Tivoli Systems Raleigh, NetView Performance Group
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Paul Quigley Tivoli Systems Raleigh, Network Management Applications Development Phil Riedel Tivoli Systems Raleigh, Network Management Applications Development Joachim Schmalzried IBM Boeblingen, System Automation for OS/390 Information Development Aimee Tattersall Tivoli Systems Raleigh, NetView for OS/390 Technical Evangelist
Comments welcome
Your comments are important to us! We want our redbooks to be as helpful as possible. Please send us your comments about this or other redbooks in one of the following ways: Fax the evaluation form found in IBM Redbooks review on page 265 to the fax number shown on the form. Use the online evaluation form found at http://www.redbooks.ibm.com/ Send your comments in an Internet note to redbook@us.ibm.com
xi
xii
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
1.1 At a glance
Tivoli NetView for OS/390 V1R3 targets enterprise control of the e-business complexity. Building on the already rich functionality of Tivoli NetView for OS/390, V1R3 provides enhancements in the following areas: It is possible to issue any TCP/IP, SNMP, or UNIX command from Tivoli NetView for OS/390 either through a user-friendly panel interface or in Clists that are written to extend the functions NetView provides. SNMP services include a MIB compiler/loader and a MIB browser launched from the NMC. There is also a robust 3270 interface for issuing SNMP requests, such as GET/SET/etc. MIB polling and thresholds also aid in monitoring and automation. Graphical Network Management now includes IP agents available for: - Tivoli NetView on Sun Solaris or Windows NT - HP OpenView on Sun Solaris or HP-UX - Tivoli NetView on AIX Tivoli NetView for OS/390 now provides the ability to convert SNMP traps to SNA alerts and SNA alerts to SNMP traps. Web interfaces for third-party Web applications can be launched. The timer and automation capabilities are further enhanced.
1.2 Overview
Tivoli NetView for OS/390 addresses the challenges of network and systems management by focusing on operator productivity through the use of graphical displays and embedded automation capability. Tivoli NetView for
OS/390 continues its leadership in SNA management and strongly addresses the management of mixed network architecture environments. Tivoli NetView for OS/390 V1R3 focuses on management of IP networks and SNMP-based devices, management of IP clients accessing mainframe applications, and integration with third-party network and element management vendors. TCP/IP management can be accomplished through the use of native OS/390 TCP/IP management or in cooperation with management applications on distributed platforms. This includes IP agents available for Tivoli NetView on AIX, Sun Solaris, or Windows NT, and HP OpenView on Sun Solaris or HP-UX. An SNMP stack and MIB services (MIB compiler/loader, MIB browser) improve the management of TCP/IP resources and sessions. In addition, NetView can receive and process any SNMP V1 trap. Full function SNMP command support from the NMC, 3270 panels, or command procedures, support for logical groupings of MIB variables, remote Ping support, MIB polling, and thresholds aid in resource monitoring and automation. Not all functions are available from both the NMC and 3270 interfaces. Any socket can now be monitored for availability. If the socket is down, then automation can attempt to restart its associated application, job, or task. TN3270 session management now includes support for the remote TN3270 server feature on both Cisco and IBM routers plus support for connections with any TCP socket. Tivoli NetView for OS/390 provides the ability to launch a Web interface for any vendor application from the NetView Management Console (NMC). NMC improvements include view cycling, view and resource security, and other ease-of-use enhancements. In addition, there are enhancements that integrate the NMC and NetView 3270 Management Console into a single console. Tivoli NetView's robust timer and automation table capabilities are expanded to assist in automation table management, and a new CHRON command with calendering support. Tivoli NetView for OS/390 now adapts dynamically to daylight savings time and other system time changes without requiring a recycle.
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
1.3 Description
Building on the already rich functionality of Tivoli NetView for OS/390, the V1R3 provides the additional enhancements, which are discussed in the following sections.
1.3.1 IP management
Tivoli NetView for OS/390 V1R3 provides the operator with the ability to monitor and control the enterprise-wide, multi-protocol network from a single console. This includes the ability to view and manage the protocol-based network topologies, network devices, and the interrelationships between them. Graphical Network Management now includes IP agents available on Tivoli NetView for Sun Solaris, Tivoli NetView for Windows NT, HP OpenView for Sun Solaris, and HP OpenView for HP-UX. The agents enable collection of IP topology and status discovered by the distributed SNMP-based network managers and forwarded to Tivoli NetView for OS/390 on a TCP/IP session. This enables management of IP networks from one central location. There is also a TCP/IP connection between the agent on Tivoli NetView for AIX and Tivoli NetView for OS/390 as well as an LU6.2 connection. For topology updates and status changes, Tivoli NetView for OS/390 now has the ability to receive SNMP traps about IP resources and convert them to SNA alerts and status updates. Conversion of SNA alerts into SNMP traps allows OS/390 captured alerts to be forwarded to distributed SNMP management applications. A sample IP Layer 3 discovery engine that runs natively on OS/390 minimizes the need to define resources to be managed. Topology correlation has been enhanced to generate enterprise specific views more easily. Critical resources can now be automatically linked to a hierarchy of topology resources, such as "Room 12, Warehouse 2, Hong Kong, Manufacturing." If business views are not found, they will be created. Topology correlation is now easier to invoke through integration with BuildViews and Visual BuildViews. Continuing to build on end-to-end network management, NetView for OS/390 provides the ability to launch a Web interface for any vendor application from the NetView Management Console. Use of this function includes CiscoWorks Blue and IBM Nways Manager Element Manager. This allows operators to manage the enterprise from one control console
and seamlessly work with other management tools without changing management consoles. From the NMC, you can retrieve inventory data for IBM and Cisco network interconnect devices from the Tivoli Inventory database. The Tivoli Inventory database is populated by Tivoli Manager for CiscoWorks 2000 and Tivoli Manager for IBM NWAYS. An NMC-based MIB Browser functions as a client of MIB services and SNMP services on OS/390. The MIB services provide a MIB compiler/loader function, which allows Tivoli NetView for OS/390 to support any vendor specific MIB described using the standard ASN.1 format. SNMP services provide an SNMP stack facility. Full SNMP command support is provided from NMC command pull-downs. The Tivoli Management Region (TMR) agent is enhanced to collect topology and monitors for critical Tivoli Management Agents (TMAs). The ATM topology agent supports new alerts for status updates. Operators can now issue SNMP GET, GETNEXT, SET, and WALK commands from Tivoli NetView for OS/390 in addition to PING, TRACERTE, IPSTAT, and NETSTAT. In general, it is possible to issue any IP, SNMP, or UNIX command. These commands can also be used in REXX clists and other automation routines. It is possible to define which MIB variables to check at specified intervals and take action if a threshold is exceeded. User exits are available for MIB polling and MIB thresholding to provide the capability to do more extensive analysis or automation. Extending previous support for managing TN3270 and FTP sessions, any socket connection can now be monitored for availability. Operators can display session status for any socket connection, including TN3270 sockets, FTP, SMTP, telnet, and Web browser. If the socket is down, automation can attempt to restart its associated application, job, or task. If you are running OS/390 V2R6, or later, and have it properly configured to support multiple TN3270 sockets, then Session Management can also be configured to support multiple sockets for TN3270 connections. Sessions being displayed by Session Management can be filtered. For example, operators can set filters to see only TN3270 sessions from subnet 146.48.*.* to applications starting with CICS. IP session management has been extended to include sessions between IP clients and SNA mainframe applications connected through TN3270 servers. Servers supported include IBM 2210 and 2216 and Cisco's Channel Interface Processors (CIP) and Channel Port Adapters (CPAs).
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Tivoli NetView for OS/390 has predefined MIB group definitions to collect SNMP data that is most meaningful to the operators. Additionally, it is possible to define your own groups to present MIB data best suited for the specific SNMP environment.
The ability to write a client application to send a command to Tivoli NetView for OS/390 and receive a correlated response back for subsequent processing Built-in Java runtime environment eliminating the need for a separate installation and configuration of the Java Development Kit Productivity kit - The ability to write console-based Java applications - The ability to extend console operation using plug-ins - Advanced customization guide - Self-standing demonstration mode of the NMC (server not required)
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Upgrading of MEMSTORE and IDLEOFF from samples to supported Tivoli NetView for OS/390 commands. BROWSE NETLOG support for the HDRMTYPE field. Enhanced ability to locate network node (NN) servers in APPN environments and run commands remotely at these network nodes. Security enhancements include: - Enhanced security for DB2 access. - Disk read security for %INCLUDE members. - Security for VTAM commands prefixed with 'MVS'. - Checking an operator's READSEC or WRITESEC authorization before reading from or writing to a data set member when EXECIO is done in a NetView command list. - More granularity in submitting jobs via NetView's SUBMIT command. Resource monitor enhancements to help determine which task is queuing too many messages and to provide more flexibility in logging usage statistics in SMF. Several customer requested enhancements to the NetView 3270 Management Console (previously known as the 3270 Java client), such as remappable colors and keyboard, an editable session list, and an option to hide the PF keys palette. Access to Tivoli NetView for OS/390 using a standard Web browser includes these enhancements: - An operator sending a LOGOFF command to NetView from a Web browser can be prompted for their operator ID and password the next time they send a command to NetView from the browser. Previously, the operator had to close the browser. - Set an idle time limit for Web-connected operator tasks, after which the operator will be prompted again for an ID and password. - The ability to specify which operators are authorized to access NetView from a Web browser. - The ability to differentiate commands entered through Web access from commands entered through traditional NetView tasks. - Support for frames and support for JavaScript (.js) as a valid file type.
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Tivoli NetView for OS/390 Version 1 Release 3 is the last release that will support the OS/2-based NetView Graphical Monitor Facility (NGMF). Subsequent to Release 3, only the NetView Management Console (NMC) will be supported for graphical topology and status display. This information is being provided for customer awareness and is based on IBM best technical judgement at this time. IBM makes no guarantee that this information will not change based on future business decisions.
10
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
11
12
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
13
14
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The default of the SHUTSYS command is now set to VERIFY=NO for unattended processing. Overall performance The overall performance has been improved by restructuring tasks, which accelerates the start-up and the shutdown of subsystems. In the System Automation customization dialog it is now possible to define a set of auto operators to handle subsystem automation.
15
16
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
Within this ITSO project, it was decided to set up the environment consisting of the three systems, SC66, SC42, and SC69, without any system resource (storage/workload) limitations. Assuming the networking and automation objects within the enterprise should be managed by their own RODM, it was decided to run separate RODM/GMFHS applications for the networking and the automation environment on the focal point system. For a limited system resource (storage/workload) approach on the focal point system, when managing a reasonable number of networking and System Automation objects, a configuration with only one RODM/GMFHS on the focal point system for both environments can be chosen. Refer to Appendix C, One RODM/GMFHS focal point configuration on page 241, for a customization checklist.
17
18
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The NetView DSI6DST task must be active to use the LU 6.2 session transports.
19
20
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Based on any change in your system or network configuration as reported through a NetView alert, for example, if a subsystem goes off-line, RODM dynamically updates the object information and triggers as required automation procedures. To ensure fast response time, RODM operates in memory. It supports sophisticated systems and network process control applications that need to access, interpret, and respond to rapidly changing configuration and status data.
21
Note
GMFHS is required only in the system defined as the Focal Point System or Backup Focal Point System. It is not required to be active in target systems
A Gateway is a group of one NetView-NetView task session and its two automated operator tasks, which allows communication of messages, commands, and responses between the two NetView systems. SDF is also able to show spool problems and assist requests from OS/390 subcomponents. SDF consists of a hierarchy of dynamically updated panels showing color-coded status conditions. SDF is set up during the customization of System Automation for OS/390. The screen shown in Figure 2 on page 23 is an actual sample of the ITSO focal point system SC66.
22
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
23
24
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
# 1
Description
Obtain details of the environment and what features are to be installed: - Number of enterprise Focal Point NetViews - Number of procedural NetViews - What NetView features will be running - Where these NetView will features be running Document the findings.
Decide on naming conventions for the planned environment. Clarify existing system symbolics being used and consider any new symbolics that may be required or useful. Install a full featured copy of NetView on a test system. This will validate findings previously obtained and will help with the creation of the common/local library structure. Create and populate the common libraries (which is in effect an install in itself) and create a task list for the local (domain specific) installations. See Section 4.3.6.1, Local install process for the networking NetView domains on page 38, for an example of a local install task list. Follow the task list for each local (domain specific) NetView installation and create and populate the domain specific libraries.
25
Note
Refer to Tivoli NetView for OS/390 Installation and Administration Guide, SC31-8236, for full details of the NetView installation process.
Within this ITSO project it was decided to setup the environment without any system resource (storage/workload) limitation. Assuming the networking and automation objects within the enterprise should be managed by their own RODM, it was chosen to run separate RODM/GMFHS applications for the networking and the automation environment on the focal point system SC66. For a limited system resource (storage/workload) approach on the focal point system, when managing not too many networking and System Automation objects, a configuration with only one RODM/GMFHS on the focal point system for both environment could be chosen. For a customization checklist, refer to Appendix C, One RODM/GMFHS focal point configuration on page 241.
26
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
For the target systems, it is noted that it is not always required to implement RODM instances (see Note box).
Note
A RODM instance on the networking target environment is only required if network resources are to be managed on that particular target system. A RODM instance on the automation target environment is only required if using the System Automation enterprise monitoring functions. Only the Focal Point NetViews will have the graphical interface to the NetView Management Console topology servers, which will be provided by two instances of the Graphical Monitor Facility Host Subsystem (GMFHS). Therefore, in addition to six NetViews to be installed and customized, there will be also six RODM and two GMFHS installations in the ITSO environment.
27
Given the recommendation for the NetView library structure, the following tables will specify the explicit naming conventions for the NetView install libraries, common network and automation libraries, and all domain specific libraries.
Table 2. Tier 1: Tivoli NetView install libraries
28
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
It is strongly recommended to never modify the level of product install libraries. If modifications are necessary to effect all instances of NetView, then copy the required shipped members to next library level (NetView common libraries) and modify them on this library level. If the modifications are effective only for some NetView domains, the required members need to be copied to, and afterwards modified in, the NetView domain specific libraries.
Table 3. Tier 2: Tivoli NetView common libraries for the Network environment
Common library dataset names NETVUSER.NETWORK.DSIPARM NETVUSER.NETWORK.DSIPARM.ENTERP NETVUSER.NETWORK.DSIPARM.AON NETVUSER.NETWORK.CNMCLST NETVUSER.NETWORK.CNMCLST.ENTERP NETVUSER.NETWORK.CNMPNL1
Content Modified DSIPARM members Modified DSIPARM members, specifically for Network Focal Points Modified DSIPARM members, specifically for AON Modified CLIST members Modified CLIST members, specifically for Network Focal Points Modified PANEL members
Modifications to this library level effect all instances of NetViews in the Network environment.
Table 4. Tier 2: Tivoli NetView common libraries for the Automation environment
Content Modified DSIPARM members Modified DSIPARM members, specifically for Automation Focal Points Modified DSIPARM members, specifically for System Automation
29
Content Modified CLIST members Modified CLIST members, specifically for Automation Focal Points Modified PANEL members
Modifications to this library level effect all instances of NetViews in the Automation environment. If modifications are necessary to effect only some NetView domains, then copy the required members from the NetView common libraries (or NetView install libraries) to the next library level (NetView domain specific libraries) and modify them on this library level.
Table 5. Tier 3: Tivoli NetView domain specific libraries
Common library dataset names NETVUSER.<domain name>.DSIPARM NETVUSER.<domain name>.CNMCLST NETVUSER.<domain name>.CNMPNL1 where <domain name>
Content Modified DSIPARM members Modified CLIST members Modified PANEL members Denotes the specific NetView domain name, for example, SC66N or SC66A
As a common rule, it is recommended to specify a numeric system identifier, as well as an indicator of the specific environment, into the NetView domain name. In this project, the following naming convention for the NetView domain names were chosen: Character 1, 2 - System string SC Character 3, 4 - Numeric system identifier, for example, 66 or 42 Character 5 - Environment identifier, for example, N or A The library structure of datasets within any single implementation of Tivoli NetView for OS/390 will then be: a. NetView install libraries b. NetView common (global) libraries c. NetView domain specific (local) libraries However, the concatenation order of these library dataset names in the NetView for OS/390 start-up procedure is reverse because existent members
30
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
of the domain specific libraries should be loaded first instead of members of common or install libraries. The concatenation order is thus: a. NetView domain specific (local) libraries b. NetView common (global) libraries c. NetView install libraries The following example shows the DSIPARM concatenation in a procedural Network NetView for OS/390:
//DSIPARM // // // DD DD DD DD DSN=&Q1..&DOMAIN..DSIPARM,DISP=SHR DSN=&Q1..NETWORK.DSIPARM.AON,DISP=SHR DSN=&Q1..NETWORK.DSIPARM,DISP=SHR DSN=&SQ1..DSIPARM,DISP=SHR
And, in addition, the example of the DSIPARM concatenation of an enterprise Network NetView for OS/390:
//DSIPARM // // // // DD DD DD DD DD DSN=&Q1..&DOMAIN..DSIPARM,DISP=SHR DSN=&Q1..NETWORK.DSIPARM.AON,DISP=SHR DSN=&Q1..NETWORK.DSIPARM.ENTERP,DISP=SHR DSN=&Q1..NETWORK.DSIPARM,DISP=SHR DSN=&SQ1..DSIPARM,DISP=SHR
These subsystem extensions created in this ITSO project lead to the following subsystem and start-up procedure naming conventions for NetView and RODM (for GMFHS, just start-up procedure names): Networking environment: - Subsystem names: RODM: EKGN NetView: NETC
31
- Start-up procedure names: RODM: EKGNss NetView: NETCssN GMFHS: GMFHSssN where <ss> reflects the system identifier. Automation environment: - Subsystem names: RODM: EKGA NetView: NETV - Start-up procedure names: RODM: EKGAss NetView: NETVssA GMFHS: GMFHSssA where <ss> reflects the system identifier.
MVS V5R2M0 or higher is required for system and user defined symbolic support. The symbolics used in this project are listed in Table 6.
Table 6. System symbolics used in this project
COMMENTS Name of the system - On the systems in this project, this was SC followed by the clone ID (see below). On the project systems, a two-character numeric field used to identify the clone ID.
32
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
For example, on system SC66, the values coded in the IEASYMxx member of PARMLIB would be :
SYSNAME(SC66) SYSCLONE(&SYSNAME(3:2))
To determine current symbols on one system, issue the following MVS command from the TSO system log (SDSF) or from the NetView NCCF interface (with prefixed command string MVS): D SYMBOLS An example of the use of this technique is in the NetView start-up procedure, where the symbolic &SYSNAME. was used to generate the NetView domain name :
// DOMAIN=&SYSNAME.N, ** NETVIEW DOMAIN NAME
This enabled the usage of common JCL across systems running the same NetView configuration (that is, procedural or enterprise).
Note
The &DOMAIN. symbolic generated in this way can be used in the various NetView configuration members and will be automatically resolved to its correct value. It was found that &DOMAIN. was, in fact, the most commonly used symbolic and was the most useful in setting up the common libraries.
33
34
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
All other networking customizations could be achieved by modifying the common networking library level, as described below. 4.3.1.1 Common networking DSIPARM library The following table lists the modified members in the common networking DSIPARM library.
Table 7. Modified members in NETVUSER.NETWORK.DSIPARM
MEMBER DSIDMNB
COMMENTS TASK MOD=CNMCSSIR,TSKID=&DOMAIN.SIR, etc. TASK MOD=DSIZDST,TSKID=&DOMAIN.LUC,MEM=DSILUCTD, etc. TASK MOD=CNMTARCA,TSKID=&DOMAIN.VMT,PRI=5,INIT=N TASK MOD=CNMTGBRW,TSKID=&DOMAIN.BRW,PRI=5,INIT=N NCCFID DOMAINID=&DOMAIN.,DMNPSW=&DOMAIN., etc. SYN %NV_DOMAIN% = '''&DOMAIN.'''; VPDINIT ACBNAME=VPDACB,PASSWORD=&DOMAIN.,VPDREQ=001 SC = &DOMAIN. RODMNAME=RODM&SYSCLONE.N DOMAIN=&DOMAIN. RODMNAME="RODM&SYSCLONE.N" APPLNAME="&SYSNAME.NSNA" APPLPASS="&SYSNAME.N" APPLPASS="&SYSNAME.N"
FLBSYSDA
4.3.1.2 Common networking DSIPARM library (specific AON) The following table lists the modified members in the common networking DSIPARM library specifically for AON.
Table 8. Modified members in NETVUSER.NETWORK.DSIPARM.AON
MEMBER EZLCFG01
35
4.3.1.3 Common networking DSIPARM library (Enterprise feature) The following table lists the modified members in the common networking DSIPARM library specifically for the Focal Point NetView (Enterprise feature).
Table 9. Modified members in NETVUSER.NETWORK.DSIPARM.ENTERP
MEMBER DSIDMNB
COMMENTS TASK TASK etc. TASK TASK MOD=CNMCSSIR,TSKID=&DOMAIN.SIR,PRI=5,INIT=N MOD=DSIZDST,TSKID=&DOMAIN.LUC,MEM=DSILUCTD, MOD=CNMTARCA,TSKID=&DOMAIN.VMT,PRI=5,INIT=N MOD=CNMTGBRW,TSKID=&DOMAIN.BRW,PRI=5,INIT=N
4.3.1.4 Common networking CLIST library (Enterprise feature) The following table lists the modified members in the common networking CLIST library specifically for the Focal Point NetView (Enterprise feature).
Table 10. Modified members in NETVUSER.NETWORK.CNMCLST.ENTERP
MEMBER CNME1034
36
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
The services file on the NMC server also has to be updated to use the same port address. See Tivoli NetView for OS/390: NetView Management Console Users Guide, SC31-8665, Section 1.3.6.3.
37
Members EZLCFG01 and EZLTREE in the local (domain specific) DSIPARM library. Procedural NetViews SC42N and SC69N: Member EZLTREE in local (domain specific) DSIPARM library. All NetViews SC66N, SC42N and SC69N: Update of all DDF panels and control files in the local (domain specific) AON panel library SEZLPNLU with the correct Domain ID. 4.3.6.1 Local install process for the networking NetView domains The created local install library (NETVUSER.&domain..INSTALL) was used to run the local install process. Table 11 shows the steps needed to perform the specific install. The TASK column cross references to the relevant section in the product documentation Tivoli NetView for OS/390, Installation and Administration Guide, SC31-8236.
Table 11. Local networking NetView install process
TASK 2.1.9 - Allocate all PDS 2.1.10 - Change domain and SA numbers 2.1.15 - Allocate VSAM clusters 2.1.16 - Load VSAM files 2.1.17 - Assemble VTAM tables 2.4.3 - 2.4.6 - Create procedures 3.3.2.7 STATMON preprocessor
COMMENTS CNMSJ002 CNMSJ000 JCL and control cards CNMSJ004 - Change domain in JCL CNMSJ005 - Change VSAM high-level qualifier CNMSJ006 - Change high-level qualifier and add domain - may not be required if shared VTAMLIB Specimen procedures in LOCAL.INSTALL Copy to PROCLIB and update as required May not be required
38
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
4.3.6.2 Local install process for AON The TASK column in Table 12 cross references the relevant section in the product documentation Tivoli NetView for OS/390, Installation and Administration Guide, SC31-8236.
Table 12. Local AON install process
TASK 2.2.2 - Copy AON members to local (domain specific) AON panel library SEZLPNLU
COMMENTS EZLSJ100 - First allocate the local (domain specific) AON library SEZLPNLU. Then run the step in EZLJS100 that copies the named members into the local AON library SEZLPNLU. The AON members for the libraries DSIPRF and DSIPARM are already in the NetView common libraries. Run against local SEZLPNLU only. EZLSJ005, if required. EZLJS006, if required. EZLJS008. As required. As required.
2.2.3 - Change domain ID 2.2.4 - Allocate datasets 2.2.5 - Allocate RACF datasets 2.2.6 - Allocate VSAM files 3.9.2 - Tailor DDF 3.9.5 - Tailor Gateways and FP
39
40
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
modifications represent global changes to run System Automation in the NetView automation environment.
Table 13. Modified members in NETVUSER.SYSTEM.DSIPARM
MEMBER AOFMSGSY
COMMENTS Changed the following statements: SYN %AOFDOM% = '''&DOMAIN.''' SYN %AOFSYS% = '''&SYSNAME.''' SYN %AOFLOADERJOB% = '''AOFLOAD''' SYN %AOFOPGATOPER% = 'GAT&DOMAIN.' SYN %AOFSIRTASK% = '''&DOMAIN.SIR''' Comment out the reference to clist CNME1035 Comment out %INCLUDE AOFMSGPM Comment out %INCLUDE AOFMSGPA Comment out %INCLUDE AOFMSGST Comment out %INCLUDE AOFMSGOP Change DEFAOF PPIRCVR=NETQTSK Comment out DEFAOF PPIRCVR=PPICMDID Change DSTINIT FUNCT=VSAM Include %INCLUDE AOFCMD Comment out %INCLUDE DSICMDT Uncomment O SECSTAT Comment out O MONIT Include DEFFOCPT PRIMARY=SC66ALUC,TYPE=ALERT Include DEFFOCPT PRIMARY=SC66ALUC,TYPE=STATUS Comment out %INCLUDE DSIDMNT Include %INCLUDE AOFDMN
AOFMSG00 AOFMSG01
41
MEMBER DSIDMNB
COMMENTS Comment out TASK MOD=CNMCSSIR,TSKID=CNMCSSIR, PRI=5,INIT=N Include TASK MOD=CNMCSSIR,TSKID=&SYSNAME.ASIR, PRI=5,INIT=N Change the following statements: TASK MOD=DSIZDST,TSKID=&DOMAIN.LUC,MEM=DSILUCTD, PRI=7,INIT=N TASK MOD=CNMTARCA,TSKID=&DOMAIN.VMT,PRI=5,INIT=N TASK MOD=CNMTGBRW,TSKID=&DOMAIN.BRW,PRI=5,INIT=N Include TASK MOD=CNMCALRT,TSKID=NETCALRT, PRI=6,INIT=Y Comment out TASK MOD=CNMCALRT,TSKID=CNMCALRT, PRI=6,INIT=Y Include TASK MOD=DSIZDST,TSKID=CNMTAMEL,MEM=DUIISC, PRI=5,INIT=N Comment out TASK MOD=DSIZDST,TSKID=CNMTAMEL, MEM=DUIISFP,PRI=5,INIT=N
DSIDMNK
Include NCCFID DOMAINID=&DOMAIN,DMNPSW=&DOMAIN., DROP=YES,SUPPCHAR=? Comment out NCCFID DOMAINID=CNM01, DMNPSW=CNM01, DROP=YES, SUPPCHAR=? Include NCCFIC IC=CNME1034 AOFMSG00 Comment out NCCFIC IC=CNME1034 DSITBL01 Include VTAMCP USE=NO Comment out VTAMCP USE=YES Include SC66A RRD Include SC42A RRD Include SC69A RRD
DSIOPF DSIOPFU
Comment out %INCLUDE DSIOPFT Include %INCLUDE AOFOPF Include the following operators: GATSC66A, GATSC69A, GATSC42A
Change the synonym statements using the system symbolics available. AOFMSG00
42
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The clist CNME1035 is no longer used in this NetView release. The NetView initialization steps are now concentrated in the new clist CNME1034, which is coded in REXX and uses PIPEs. AOFMSG01 The members AOFMSGST and AOFMSGOP will only be used in the enterprise automation environment (focal point). BNJMBDST Change FUNCT=VSAM will ensure that NPDA will come up as secondary on the Automation NetView environment. DSICMD The DSICMDT member will only be used in the enterprise automation environment. DSICMD should be copied and modified (uncomment DSICMDT statement) in the enterprise specific DSIPARM. DSICNM Changes will set STATMON as secondary on System Automation NetView. DSICRTTD The project environment used the LUC transport method to forward alerts to the specified focal point task. DSIDMN The DSIDMNT member will only be used in the enterprise automation environment. DSIDMN should be copied and modified (uncomment DSIDMNT statement) in the enterprise specific DSIPARM. DSIDMNB The TSKID value for the task CNMCALRT needs to be different than the one specified for networking NetView. The TSKID value for the LUC task, the VMT task and the BRW task need to be different than the ones specified for the networking NetView. Specifying a different initialization member for the task CNMTAMEL is necessary to allow resource status forwarding from the status collectors to the status focal point. DSIDMNK Change VTAMCP to USE=NO to set up the automation NetView to be the secondary (non networking) NetView. Change NCCFIC IC=CNME1034 AOFMSG00 to reflect the specific System Automation message table AOFMSG00.
43
DSIOPF The DSIOPFT member will only be used in the enterprise automation environment. DSIOPT should be copied and modified (uncomment DSIOPFT statement) in the enterprise specific DSIPARM. 4.4.1.2 Common automation DSIPARM library (Enterprise feature) Table 14 lists the modified members in the common automation DSIPARM library specifically for the Focal Point NetView (Enterprise feature) compared to the NetView install DSIPARM library. These modifications represent global changes to run System Automation in the NetView automation focal point environment.
Table 14. Modified members in NETVUSER.SYSTEM.DSIPARM.ENTERP
COMMENTS Only copy to enterprise DSIPARM library as reference. No changes. Include statement %INCLUDE AOFCMD Only copy to enterprise DSIPARM library as reference. No changes. Include statement %INCLUDE AOFDMN Comment out TASK MOD=CNMCSSIR,TSKID=CNMCSSIR, PRI=5,INIT=N Include TASK MOD=CNMCSSIR,TSKID=&SYSNAME.ASIR, PRI=5,INIT=N Change the following statements: TASK MOD=DSIZDST,TSKID=&DOMAIN.LUC,MEM=DSILUCTD, PRI=7,INIT=N TASK MOD=CNMTARCA,TSKID=&DOMAIN.VMT,PRI=5,INIT=N TASK MOD=CNMTGBRW,TSKID=&DOMAIN.BRW,PRI=5,INIT=N Include TASK MOD=CNMCALRT,TSKID=NETCALRT, PRI=6,INIT=Y Comment out TASK MOD=CNMCALRT,TSKID=CNMCALRT, PRI=6,INIT=Y Do not change MOD=DSIZDST,TSKID=CNMTAMEL,MEM=DUIISFP, PRI=5,INIT=N
DSIOPF
44
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
It is not necessary change anything in this member. Copy only to enterprise DSIPARM library to override its reference in the common DSIPARM library. DSICRTTD It is not necessary to change anything in this member. Copy only to enterprise DSIPARM library to override its reference in the common DSIPARM library. DSIDMNB The TSKID value for the task CNMCALRT needs to be different than the one specified for networking NetView. The TSKID value for the LUC task, the VMT task, and the BRW task need to be different than the ones specified for the networking NetView. For the task CNMTAMEL, keep the focal point initialization member DUIISFP. 4.4.1.3 Common automation CLIST library Table 15 lists the modified members in the common automation CLIST library compared to the NetView install CLIST library.
Table 15. Modified members in NETVUSER.SYSTEM.CNMCLST
MEMBER CNME1034
COMMENTS Comment out DUIFNAM = 'GMFHS'||SUBSYM('&SYSCLONE.')||'N' Comment out DUIFHPRC = 'GMFHS'||SUBSYM('&SYSCLONE.')||'N' Comment out 'GLOBALV PUTC DUIFHNAM DUIFHPRC' Comment out EKGHNAM = 'EKGN'||SUBSYM('&SYSCLONE.') Comment out EKGHPRC = 'EKGN'||SUBSYM('&SYSCLONE.') Comment out 'GLOBALV PUTC EKGHNAM EKGHPRC'
CNME1015
Comment out SLIST3.2 = AUTOTASK FLBTOPO Comment out SNUM= 2 Include SNUM = 1 Comment out SLIST3.8 = AUTOTASK FLBTOPO Comment out SLIST.0 = 8 Include SLIST.0 = 7
Additional comments on the above listing of modifications are as follows: CNME1034 An alias for the automation GMFHS job name and procedure name used with CNME2101 is not needed in the procedural automation environment.
45
An alias for the automation RODM job name and procedure name used with CNME1098 is not needed in the procedural automation environment. CNME1015 The Automation NetView does not need to monitor the SNA Topology events and, therefore, does not need to start the SNA Topology features. Comment out entries for the task, FLBTOPO, in this clist. 4.4.1.4 Common automation CLIST library (Enterprise feature) Table 16 lists the modified members in the common automation CLIST library specifically for the Focal Point NetView (Enterprise feature) compared to the NetView install CLIST library.
Table 16. Modified members in NETVUSER.SYSTEM.CNMCLST
MEMBER CNME1034
COMMENTS Include DUIFHNAM = 'GMFHS'||SUBSYM('&SYSCLONE.')||'A' Include DUIFHPRC = 'GMFHS'||SUBSYM('&SYSCLONE.')||'A' Include 'GLOBALV PUTC DUIFHNAM DUIFHPRC' Include EKGHNAM = 'EKGA'||SUBSYM('&SYSCLONE.') Include EKGHPRC = 'EKGA'||SUBSYM('&SYSCLONE.') Include 'GLOBALV PUTC EKGHNAM EKGHPRC'
Additional comments on the above listing of modifications are as follows: CNME1034 Specify an alias for the automation GMFHS job name and procedure name used with CNME2101 in the enterprise automation environment. Specify an alias for the automation RODM job name and procedure name used with CNME1098 in the enterprise automation environment.
Note
Please be aware that within this project the string EKGA, as well as the string EKGN, was specified as a subsystem identification to OS/390.
46
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
4.4.1.5 Common automation VTAMLST library Table 17 lists the modified or added members in the common automation VTAMLST library.
Table 17. Modified/added members in NETVUSER.SYSTEM.VTAMLST
COMMENTS Comment out &SYSNAME.NPPT APPL AUTH=(NVPACE,PPO), PRTCT=&SYSNAME.N,EAS=1, Include &SYSNAME.NPPT APPL AUTH=(NVPACE,SPO), PRTCT=&SYSNAME.N,EAS=1,
Additional comments on the above listing of modifications are as follows: NETVAPPL or A01APPLS If necessary, create a new VTAM APPL deck or update an existing NetView application member to apply changes to the PPT statement to specify the secondary program operator (SPO) interface. The following sections will describe the steps necessary to customize the base NetView to be used with System Automation and cloning support.
47
members shown in Table 18 to the local (domain-specific) libraries and change them afterwards:
Table 18. Modified members in NETVUSER.&domain..DSIPARM
COMMENTS Define the correct RODMNAME and RODMUSER Define the correct RODMNAME Comment out CMDRCVR ID=DSIQTSKI Include CMDRCVR ID=NETQTSK Include REP <rodm name>,CONN=Y,AO=Y,T=12,ID=NETQTSK Comment out REP RODM01,CONN=N,AO=N,T=12, CMD=STARTCNM Comment out REP RODM02,CONN=N,AO=N,T=20,ID=NETOP1 Comment out REP RODM03,CONN=N,AO=Y,T=30 Comment out REP RODM04,CONN=N,AO=N,T=30 Comment out REP RODM05,CONN=N,AO=N,T=19 Comment out REP RODM06,CONN=N,AO=N,T=30
Additional comments on the above listing of modifications are as follows: AOFRODM This member defines the RODMNAME and the RODMUSER used by System Automation for bulk updates to RODM. AOFSFMAP This member contains user defined mapping tables of System Automation status information to RODM specific status information. DSIQTSKI This is the initialization member of the NetView task to communicate with RODM. In the System Automation environment, the CMDRCVR statement should be customized to reflect a different receiver ID than the network environment. The REP statement should, accordingly, be changed to include this receiver ID definition and the RODM name related to this local (domain specific) system. Figure 4 shows an example:
CMDRCVR ID=NETQTSK REP EKGA42,CONN=Y,AO=Y,T=12,ID=NETQTSK
Figure 4. DSIQTSKI member of the local DSIPARM library for System SC42
48
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The ID must be defined to RODM. If the ID is not specified correctly, then NetView assumes the receiver ID is DSIQTSK. This initialization member should only be customized in either the networking or the automation environment.
Define the status collectors that will be connected to the status focal point. Synchronization will be attempted with these status collectors when the resource status manager is initialized. These keywords are optional but are highly recommended for quick synchronization. The following is a project example:
&ENTERP. &ENTERP. &ENTERP. &PROCED. SC SC SC SC = = = = SC66A SC69A SC42A &SYSCLONE.A
DUIGINIT
49
TASK 2.1.9 - Allocate PDS 2.1.10 - Change domain and SA numbers 2.1.11 Loading members of partioned data sets 2.1.15 - Allocate VSAM clusters 2.1.16 - Load VSAM files
COMMENTS CNMSJ002 CNMSJ000 JCL and control cards CNMSJ003 JCL CNMSJ004 - Change domain in JCL CNMSJ005 - Change VSAM high-level qualifier
50
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
TASK 2.1.17 - Assemble VTAM tables 2.4.3 - 2.4.6 - Create procedures 3.3.2.7 STATMON preprocessor
COMMENTS CNMSJ006 - Change high-level and add domain. May not be required if shared VTAMLIB. Specimen procedures in LOCAL.INSTALL Copy to PROCLIB and update as required. May not be required.
4.4.6.2 Local install process specifically for SA The TASK column cross references to the relevant section in the product documentation, Tivoli NetView for OS/390, Installation and Administration Guide, SC31-8236. Also refer as well to the System Automation for OS/390 V1R3 Customization, GC28-1566.
Table 20. Local SA install process
TASK 2.2.2 - Copy SA members 2.1.1.2 Allocate data sets common to systems 2.1.1.3 Allocate Data Sets for Dialogs 3.9.2 - Tailor SDF 3.9.5 - Tailor Gateways and FP
COMMENTS DSIPRF and DSIPARM members will already be in the common libraries INGESYSA - Change qualifiers and volumes INGEDLGA As required As required
51
52
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
53
Automation status file Gateway password verification file HCD trace file Local volume name Change all occurrences of INGVOL to the corresponding local volume name. Mid-level qualifier for datasets In the ITSO environment, the mid-level qualifier, USER.&domain., was used where the dataset names, for example on the focal point system SC66 ING.USER.SC66A.xxxx, match with the System Automation start-up procedure. 5.1.1.2 Allocating datasets using INGEDLGA The member INGEDLGA is used to allocate System Automation datasets required only for the focal point system. It allocates datasets for the System Automation I/O operation and the SA policy customization dialog. Modify the following statements in member INGEDLGA and submit the job to create the required datasets: Mid-level qualifier for datasets In the ITSO environment, it was set to be SC66A, as this was the designated focal point system. Therefore, all datasets allocated by this job began with ING.SC66A.xxxx. As an example, the SA policy dialog ISPF output table was set to be ING.SC66A.AOFTABL. OPTION statement Change the OPTION statement to reflect the correct volume name and device type. 5.1.1.3 Creating System Automation start-up procedures The members, INGESSI and INGESO, are used as System Automation (Automation NetView) sample start-up procedures. Since the subsystem name for the NetView automation environment is defined to NETV, as described in Section 4.2.2, OS/390 subsystem extensions on page 31, the two members, INGESSI and INGESO, were copied into the appropriate OS/390 procedure library (SYS1.PROCLIB) and renamed as NETVssSI and NETVssA, where <ss> denotes the specific system identifier. Modify the members, NETVssSI and NETVssA, to reflect specific common and local (domain specific) library dataset names.
54
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Modify the DSIPARM library concatenation in the Automation NetView start-up procedure, NETVssA, by adding the dataset name of the System Automation DSIPARM input (&SQ2..SINGNPRM) as in the following example:
//DSIPARM DD // DD // DD DSN=&Q1..&DOMAIN..DSIPARM,DISP=SHR DSN=&SQ2..SINGNPRM,DISP=SHR DSN=&SQ1..DSIPARM,DISP=SHR
5.1.1.4 Preparing load job for System Automation RODM In contrast to the networking environment, the RODM load procedure for the System Automation environment needs to load the RODM structure and instances during different steps of the job. The sample load job, INGELOAD, provided in the library, ING.SINGSAMP, can be copied to the system procedure library (SYS1.PROCLIB) and modified to reflect the following changes:
//EKGIN1 DD DSN=NETVUSER.POLICYDB(LOADSTR0),DISP=SHR //AOFIN3 DD DSN=NETVUSER.POLICYDB,DISP=SHR
The library, NETVUSER.POLICYDB, is the designated output library of the System Automation RODM building function to contain the managed RODM objects. Modify the RODMNAME statement to reflect the appropriate RODM on the specific system.
55
5. Modify/Check IEFSSNxx to include the additional subsystem names. The following subsystem strings were used for the automation environment within the ITSO project:
NETV /* for Netview PPI and netview address space */ EKGA /* for RODM prefix */
Restart, step by step, (IPL) the OS/390 system with CLPA on completion of all the above procedures. CPLA is still required when migrating from ESCON Manager to System Automation V1R3. If not migrating from ESCON Manager to SA V1R3, and the IPL of the OS/390 system is not possible for a longer time frame, all the above modified parameters can be made effective dynamically by using the following OS/390 commands:
SETPROG APF,FORMAT,FORMAT=DYNAMIC SETPROG APF,ADD,DSNAME=ING.SINGMOD1 SETPROG APF,ADD,DSNAME=ING.SINGMOD2 SETPROG APF,ADD,DSNAME=ING.SINGMOD3 SETPROG LNK,ADD,DSNAME=ING.SINGMOD2,NAME=LINKITSO SETPROG LPA,ADD,DSNAME=ING.SINGMOD3,MODNAME=(*),MASK(*) SETSSI ADD,SUBNAME=NETV SETSSI ADD,SUBNAME=EKGA
The System Automation address spaces are now ready to be started on the OS/390 system.
56
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
policy dialog in the TSO logon procedure. A CLIST may also be used to create a procedure for the System Automation policy dialog. After OS/390 ServerPac basic installation, the dataset CPAC.CMDPROC by default will be the system CLIST or REXX library. Create a new member by copying the existent ISPPDF member and add the System Automation datasets to related ALLOCATE statements. The modifications in the newly-created member might be similar to the following example:
***************************** Top of Data ****************************** PROC 0 PANEL() ALLOC FI(SYSPROC) SHR DA( + 'ING.SINGIREX' + 'DGO.V5R1M0.SDGOEXEC' + 'CPAC.CMDPROC' + 'OS261270.SCPPCENU' ALLOC FI(ISPLLIB) SHR DA( + 'DGO.V5R1M0.SDGOLOAD' + 'ING.SINGIMOD' + 'DSN510.SDSNLOAD' + 'DSN510.RUNLIB.LOAD' + 'SYS1.DGTLLIB' ALLOC FI(ISPPLIB) SHR DA( + 'DSN510.SDSNSPFP' + 'ING.SINGIPNL' + 'DSN510.SDSNPFPE' ALLOC FI(ISPMLIB) SHR DA( + 'DSN510.SDSNSPFM' + 'ING.SINGIMSG' + 'QMF330.DSQMLIBE' ALLOC FI(ISPTLIB) SHR DA( + '&DSNAME' + 'ING.SINGITBL' + 'ING.USER.SC66A.AOFTABL' + 'SYS1.SERBT' ALLOC FI(ISPSLIB) SHR DA( + 'QMF330.DSQSLIBE' + 'ING.SINGISKL' + 'SYS1.SBLSKEL0' ALLOC FI(AOFTABL) SHR DA('ING.USER.SC66A.AOFTABL') ALLOC FI(AOFIPDB) SHR DA('ING.SINGIPDB') ALLOC FI(IHVCONF) SHR DA('ING.USER.SC66A.IHVCONF')
57
Note
Part of the System Automation datasets allocated are for reference use only. 5.1.3.2 Update ISPF panel After modifying the TSO logon procedure, update the master ISPF panel to include the System Automation dialog function. Therefore, modify the ISP@MSTR member in ISPF panel library to include the following statements: 1. INIT section
$SA @SA @- System Automation dialog for ITSO TI3110
2. PROC section
SA,CMD(%INGDLG SELECT(ADMIN) ALLOCATE(NO))
After completing modifications to the TSO logon procedure and the ISPF panel, the next time you log on to TSO and enter into the new TSO logon procedure, the new TSO/ISPF master menu will appear as demonstrated in Figure 5.
Enter SESSION MANAGER Mode ===> NO SA CN CP EJ HC IH IP IS LR OL OP P R SD SJ SA CONS CPSM EJES HCD IHV IPCS ISMF LOGREC OPERLOG OPC PDF RACF SDSF J3SD -
(YES or NO)
System Automation dialog for ITSO TI3110 Console Display and Search Facility CICSPlex SM 1.4 *NEW with CICS TS 1.3* A JES3 Spooler Interface - (E)JES (Phoenix Software) Hardware Configuration Definition ESCON Manager Interactive Problem Control Facility Interactive Storage Management Facility Interactive LOGR (CF) LOGREC Viewer Interactive OPERLOG (Syslog) Browser Operations Planning and Control / ESA ISPF/Program Development Facility Resource Access Control Facility System Display and Search Facility System Display and Search Facility (JES3) F3=END F9=SWAP F4=RETURN F10=LEFT F5=RFIND F11=RIGHT F6=RCHANGE F12=RETRIEVE
F1=HELP F7=UP
F2=SPLIT F8=DOWN
58
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
COMMENTS System name, for example, SC66, SC42 or SC69. System identifier. It is defined as the last 2 digits of SYSNAME, for example, 66,42, or 69.
In addition to these system symbolics, NetView clone synonyms and System Automation message automation table synonyms help to decrease duplicated policy and object definitions. Some NetView clone synonyms were used based on system symbolics. Some System Automation synonyms were used, as well, for message automation table references. A summary of the different synonyms used for the Automation NetView and System Automation is shown in Table 22 and Table 23. The first table lists the most important NetView clone synonym used in this ITSO project. Using &DOMAIN., instead the hard-coded NetView domain name, enables usage of the member, AOFMSGSY, in a shared DSIPARM library.
Table 22. NetView clone synonym used in the ITSO project
COMMENTS NetView domain name, for example, SC66A, SC42A, or SC69A. This synonym is defined in the start-up procedure of the specific NetView.
59
Table 23 on page 60 lists the System Automation message automation table synonyms used in this ITSO project.
Table 23. SA message automation table synonyms used in the ITSO project
COMMENTS NetView domain name, for example, SC66A for focal point system. SC42A and SC69A are for target systems. This synonym is defined in the SA member AOFMSGSY. System name, for example, SC66 for focal point system. SC42 and SC69 are for target systems. This synonym is defined in the SA member AOFMSGSY. VTAM job name defined in the SA member AOFMSGSY. RODM loader job name defined in the SA member AOFMSGSY.
&AOFSYS.
&AOFVTAMJOB. &AOFLOADERJOB.
60
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
61
or Enter the following TSO command from the ISPF command line panel:
INGDLG SELECT(ADMIN) ALLOCATE(NO)
SA OS/390 PolicyDB Selection Select an entry Command ===> ________________________________________________ SCROLL===> PAGE Action PolicyDB Name Enterprise Name/Data Set Name ******************************* Bottom of data *******************************
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
62
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Create a New Policy Database Command ===> To define a new policy database, specify the following information: PolicyDB Name. . . . . . ITSO_ENTERPRISE Enterprise Name. . . . . ITSO_ENTERPRISE Data Set Name. . . . . . 'NETVUSER.SA.POLICYDB' More: Managed storage. . . . . NO YES NO Management class . . . . Blank for default management class Storage class. . . . . . Blank for default storage class Volume serial. . . . . Blank for authorized default volume Data class . . . . . . . Blank for default data class Space units. . . . . . CYLINDERS CYLS TRKS BLKS KB MB Primary quantity . . . 1 1 to 999 - In above units Secondary quantity . . 1 0 to 999 - In above units Directory blocks . . . 50 1 to 999 or blank - Required for PDS Record format. . . . : FB Record length. . . . : 80 Block size . . . . . . 3120 Data Set Name type . . PDS LIBRARY PDS Device Type. . . . . . SYSDA * Used only if Managed storage = YES Specify one of the existing policy databases to serve as the model for the policy database that is being created: Model PolicyDB name. . . *SYSPLEX PolicyDB name or "?" for list of names F1=HELP F7=UP F2=SPLIT F8=DOWN F3=END F9=SWAP F4=RETURN F10=LEFT F5=RFIND F11=RIGHT F6=RCHANGE F12=RETRIEVE
+ * * *
When all data entry is completed, press PF3 to start the generation process of the System Automation policy database with default policy and object definitions according to the specified model PolicyDB. Figure 9 on page 64 shows all automated resources and resource policy objects that are generated. Select any resource definition on the left side, or any resource policy on the right side, by their item label.
63
SA OS/390 Entry Type Selection Command ===> PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Resource Definitions 1 2 3 4 5 6 7 8 9 10 11 Enterprise Group SubGroup System ApplicationGroup Application (*) VolumeGroup Volume OperatorView Processor Communications Path F2=SPLIT F8=DOWN ( ( ( ( ( ( ( ( ( ( ( ENT GRP SBG SYS APG APL VLG VOL OPV PRO CMP ) ) ) ) ) ) ) ) ) ) )
PolicyDB created
F1=HELP F7=UP
F3=END F9=SWAP
Resource Policy Definitions More: + 30 Timers ( TMR ) 31 Timeout Settings ( TMO ) 32 Tape Attendance ( TPA ) 33 MVS Component ( MVC ) 34 MVSCOMP Defaults ( MDF ) 35 System Defaults ( SDF ) 36 Application Defaults ( ADF ) 37 Auto Operators ( AOP ) 38 Auto Msg Classes ( AMC ) 39 Network ( NTW ) 40 NNT Sessions ( NNT ) 41 Resident CLISTs ( RES ) F4=RETURN F5=RFIND F6=RCHANGE F10=LEFT F11=RIGHT F12=RETRIEVE
This base System Automation policy database dialog screen allows you to create and enter all resource objects and their specific policy rules.
64
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Object type (class or instance) Application mode (online or batch) Application type (STANDARD, JES2, or JES3) The name of procedure that runs the job Service warning and alert thresholds Automation definition and policy From the System Automation main menu, as shown in Figure 9 on page 64, select Option 6 or APL. An application dialog will be displayed as shown in Figure 10.
Action
F1=HELP F7=UP
Entry Name C Short Description *SYSTEM Special system job APPC APPC/MVS automation policy ASCH ASCH automation policy DEFAULTS Application default policy GMFHS Graphical Monitoring Facility definition INGERMFB RMF batch enquirer definition INGESO Automation NetView definition INGESSI NetView subsystem interface IO_HEARTBEAT_TASK I/O exception monitoring heartbeat IO_MON_EVENTPROC I/O exception monitoring event analyzer IO_MON_MSGPROC I/O monitoring message processing task IO_MON_QUERYPROC I/O exception monitoring query task IO_OPERATIONS I/O Operations functions main component F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
There are two types of applications to select: Class The application class is designed for applications that inherit a common policy. If there are multiple applications owning generic policies, a class can be created for these types of applications to allow for easy definitions of application instances. Using application classes will minimize the maintenance workload when updating or changing something in the System Automation policy database. Instance
65
The application instance definition is used when the application will be managed by OS/390. The policy items omitted for an application instance will be inherited from the application class associated with this type of application instance. A policy item specified for an instance will override any application class specification. In the ITSO project environment, there are two NetView subsystems on each system, one for network environment, and another for system automation environment. Both NetViews have the common start-up, WTOR messages, and shutdown policy. Therefore, a class application called NETVIEW_CLASS was defined for both NetViews, allowing them to share one CLASS for those policies common to both. Since start-up, WTOR messages, and shutdown policies are defined in the CLASS, there is no need to define them when defining the NetView instances for AON and System Automation. The next section will detail how to create a CLASS in the policy database, and how to apply class to an instance application. On the SA application selection panel, enter the NEW command on the command line to go to the panel that is shown in Figure 11.
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type. . . . . . . . . . Application Application Name. . . . NETVIEW_CLASS Subsystem Name. . . . . NETVIEW_CL -----------------------------------------------------------------------------More: + Object Type . . . . . . CLASS CLASS INSTANCE Application Type . . . STANDARD STANDARD JES2 JES3 (These values cannot be changed after) (the application has been created )
INFOBridge Resource . . Application Mode. . . . BATCH BATCH ONLINE Clone Job Name. . . . . NO YES NO Job Name. . . . . . . . Scheduling Subsystem. . MSTR, JES Subsystem or blank -----------------------------------------------------------------------------F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE Figure 11. Define Application Entry panel
On the Object Type field, choose CLASS to define this class application.
66
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
It is important to notice that, in the class application definition, the Job Name field should be left empty, or it will be valid for all application instances of this applications class. Press PF3 to quit to application selection panel as shown in Figure 12 on page 67. The following steps will define Automation Info, Messages, and Shutdown policy items. These items will be inherited by the applications instances associated to this application class.
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Action Policy Name DESCRIPTION LINK TO INSTANCES APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES SYSTEM ASSOCIATION TRIGGER
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Policy Description Enter description Link class to instances Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags Define primary and secondary associations Select Application trigger
The following options can be customized in an application class. Application Info: Enter or modify application mode (batch or online) and the MVS application or job name by using the replication capability to generate the application name. Automation Info: This policy item is used to define the application to System Automation automation and will be used to define job type, system name, Parent, start option, and restart option. Automation Flags: Automation flags allow the user to enable and disable automation and can also enable or disable automation for specific automation phases.
67
Messages: This policy item allows the user to specify automated actions, such as the issuing of a command or reply, to be taken in response to a message issued by the application. Shutdown: Specifies normal shutdown commands for any application using System Automation. Thresholds: Error threshold definitions for applications to define how many abend errors may occur before a message is logged, or a restart process is stopped. Minor Resources: This policy is used to define minor resources for an application. System Association: This policy item is used to define the primary and secondary system for the application. Trigger: Each application may be linked to one or more trigger(s) that control the start-up or shutdown. Creating automation Info for an application class Select Automation Info from the panel, which is shown in Figure 12, and the Application Automation Definition panel will be displayed as shown in Figure 13 on page 69. Enter the JobType and the additional definitions that might be necessary for this application class. Keep in mind that this is a class definition that will be valid for other application instances. The following fields are contained in this automation info Panel: Job type Can be set to MVS, NOMVS, or TRANSIENT. As a standard MVS start procedure, use MVS for this class definition. Startup This field specifies how the application will be started. Edit startup Select YES if using extra parameters. For this example, it will be keep the default. Restart option This field defines the circumstances under which the application should be restarted. In this example, it will be used ALWAYS.
68
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Application Automation Definition Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Subsystem : NETVIEW_CL Description : Netview Defaults Job Name :
Top of data
More: (MVS NONMVS TRANSIENT) Transient Jobtype can be rerun (YES or NO) Console command character(s) JES Sysname
Creating shutdown policy for an application class Select Shutdown from the panel, which is shown in Figure 12 on page 67, and the Subsystem Shutdown Processing panel will be displayed as shown in Figure 14 on page 70. The following panels define the shutdown commands for the example application class NetView for OS/390. There are four levels of shutdown commands that may be used: 1. INIT Enter commands and/or replies to be executed before a shutdown is actually initiated, for example, sending warning information to users. 2. NORM Enter the commands and replies that perform a normal shutdown of the subsystem. 3. IMMED Enter the commands that perform an immediate shutdown of the subsystem. 4. FORCE Enter the commands and replies that perform a forced stop of the subsystem (class) without any delay. The following panels illustrate examples for the NetView application class. First, Figure 14 on page 70 shows the Subsystem Shutdown Processing panel, followed by one Shutdown Reply Processing panel for the normal
69
shutdown reply sequence, and one Shutdown Command Processing panel for the immediate shutdown commands. Using the commands CMD or REP at the Actions column of the specific shutdown procedure will enter the appropriate data entry panel.
SA OS/390 Subsystem Shutdown Processing Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Subsystem : NETVIEW_CL Description : Netview Defaults To specify automated commands or replies when shutting down this subsystem, enter the appropriate action for the particular shutdown type. Actions: CMD = Command Action Type INIT NORM IMMED FORCE REP = Reply Description Executed Executed Executed Executed when when when when shutdown initiated normal shutdown invoked immediate shutdown invoked force shutdown invoked CMD REPLY PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
REP
When entering the Shutdown Reply Processing panel, enter the Pass and Reply Text fields with the commands that will be issued in a normal shutdown procedure as shown in Figure 15 on page 71.
70
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Shutdown Reply Processing Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS
Subsystem: NETVIEW_CL Shutdown Type: NORM Enter the replies to be issued when the selected shutdown type is invoked for this subsystem. Pass Retry Count 1 _____ 2 _____ Reply Text CLOSE IMMED____________________________________________ CLOSE IMMED____________________________________________
When entering the Shutdown Command Processing panel, use the common System Automation symbolic &SUBSJOB to substitute the subsystem name. This variable will be resolved to the specific subsystem name when application instances are generated.
SA OS/390 Shutdown Command Processing Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Subsystem: NETVIEW_CL Shutdown Type: IMMED
Enter commands to be executed when the selected shutdown type is invoked for this subsystem. Pass Automated Function 1 2 3 Command Text MVS P &SUBSJOB MVS C &SUBSJOB MVS FORCE &SUBSJOB,ARM
Automation Flags System Automation sets the Automation Flags to default values, which should be kept to enable automation and ensure best performance. The following step is only necessary if Automation Flags for specific resources are to be
71
changed from their default settings. If the main Automation Flag is set to NO, it disables the effect of the remaining Automation Flags. The following Automation Flags for the application class can be specified: Automation Recovery Start Shutdown Initstart Restart To check the Automation Flags, select the menu item Automation Flags on the main Application Policy Selection panel as shown in Figure 12 on page 67, and it displays the Flag Automation Specification panel illustrated in Figure 17.
SA OS/390 Flag Automation Specification Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Resource: NETVIEW_CL Enter level of automation desired. Automation Flags: Y = Yes N = No E = Exits Assist Flags: D = Display L = Log N = None Actions Flag Automation . Recovery . . Start. . . . ShutDown . . Initstart. . Restart. . . Enter or Display times Auto _____ _____ _____ _____ _____ _____ to disable Assist _____ _____ _____ _____ _____ _____ automation . . NO PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Yes
No
In the ITSO environment, the Automation and Recovery flags were kept to the default value of blank. The System Automation menu may also be used to manually define and display automation flags in the System Automation NetView.
72
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Using link to application instances After completing the application class definitions for start-up, shutdown, and automation and recovery flags, link this application class to the appropriate application instances that will inherit these application class policy definitions. This newly created application class, NETVIEW_CLASS, was linked to the application instances of the networking and automation NetView. If these application instances have already been defined, select the option Link To Instance on the main Application Policy Selection panel as shown in Figure 12 on page 67. The following panel (Figure 18) is a sample screen of the ITSO application instances linked to their application classes.
SA OS/390 Link Class to Instances Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Action Status SELECTED
SELECTED
Entry Name NETWORK_NETVIEW Currently linked to. NETWORK_NETVIEW_SSI Currently linked to. NETWORK_RODM Currently linked to. PROCESSOR_OPERATIONS Currently linked to. SAOS390_GMFHS Currently linked to. SAOS390_NETVIEW
An application instance is a subsystem, started task, or application that can operate on OS/390. An application instance is created practically by using the same procedure as for application classes with the exception of the keyword INSTANCE instead of CLASS as shown in Figure 11 on page 66. As a practical example within the ITSO project, the application instance SAOS390_NETVIEW was chosen to be automated. This application instance will inherit the policy features defined in the application class NETVIEW_CLASS. The following illustrates the ease of an application instance creation using application class association. Issue the command, NEW SAOS390_NETVIEW, on the command line of the Entry Selection panel for applications as shown in Figure 19 on page 74.
73
SA OS/390 Entry Selection Command ===> NEW SAOS390_NETVIEW Entry Type : Application
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE C Short Description LLA automation policy * Netview Defaults Automation NetView definition Network GMFHS Network Netview Network Netview Interface Network RODM Processor Operations functions * RODM Defaults System Automation GMFHS System Automation Netview Interface RODM automation policy
Action
Entry Name LLA NETVIEW_CLASS NETVSA NETWORK_GMFHS NETWORK_NETVIEW NETWORK_NETVIEW_SSI NETWORK_RODM PROCESSOR_OPERATIONS RODM_CLASS SAOS390_GMFHS SAOS390_NETVIEW_SSI SAOS390_RODM
On the Define New Entry panel for applications, the following values and symbols were entered in our scenario: 1. Subsystem Name: NETVSA 2. Clone Job Name (Instance): YES 3. Job Name: NETV&AOCCLONE.A Using this clone variable will allow that this definition can be shared for all the systems that will run the System Automation Netview. To use this variable it is necessary to change the field Clone Job Name for the instance to YES. In the ITSO environment, the System Automation NetView Job Names were NETV66A, NETV69A, and NETV42A, and the &AOCCLONE. variable was set to contain the two digit of the OS/390 system identifier.
74
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type. . . . . . . . . . Application Application Name. . . . OS390_NETVIEW Subsystem Name. . . . . NETVSA -----------------------------------------------------------------------------More: + Object Type . . . . . . INSTANCE CLASS INSTANCE Application Type . . . STANDARD STANDARD JES2 JES3 (These values cannot be changed after) (the application has been created )
INFOBridge Resource . . Application Mode. . . . BATCH BATCH ONLINE Clone Job Name. . . . . YES YES NO Job Name. . . . . . . . NETV&AOCCLONE.A Scheduling Subsystem. . MSTR, JES Subsystem or blank -----------------------------------------------------------------------------Figure 20. SA OS/390 define new entry panel for applications
End defining the new application instance with PF3 and select the Automation Info option to define the parent subsystem.
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW Action Policy Name DESCRIPTION LINK TO CLASS APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES SYSTEM ASSOCIATION
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Policy Description Enter description Link instance to class Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags Define primary and secondary associations
Enter the System Automation SSI subsystem name, SSISA, in the Application Automation Definition panel as the Parent subsystem and return with PF3.
75
SA OS/390 Application Automation Definition Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Subsystem : NETVSA Description : System Automation Netview Job Name : NETVSA&AOCCLONE. More: (MVS NONMVS TRANSIENT) Transient Jobtype can be rerun (YES or NO) Console command character(s) JES Sysname Enter one or more parents (above) Start on IPL . . . . Started after IPL (YES NO NONE blank) +
The last step is to link this application instance to the application class previously defined. Select the Link To Class option on the Policy Selection panel for the application and select the appropriate application class.
SA OS/390 Link Instance to Class Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW Action Status
Entry Name GENERIC_CLASS GMFHS_CLASS SELECTED NETVIEW_CLASS RODM_CLASS ******************************* Bottom of data ********************************
The definition process for the System Automation NetView is completed. All the others definitions will be inherited from the application class NETVIEW_CLASS. The same application instance definition process has to be executed to define the networking NetViews to the System Automation policy database.
76
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
5.3.3.2 Creating an application group An application group is a set of applications to which a name is assigned. There are two types of application groups: 1. System application groups Set of applications that reside on only one OS/390 system image. 2. Sysplex application groups Set of applications that reside on multiple OS/390 system images within a sysplex configuration. When defining an application group as a sysplex application group, specify the sysplex group name to which it belongs. A sysplex application group can be associated with only one sysplex group.
Note
A sysplex application group can not be associated with a system group. From the main System Automation Entry Type Selection panel, as shown in Figure 9 on page 64, select 5 or APG for ApplicationGroup. The Entry Selection panel for application groups displayed in Figure 24 will appear.
Action
Entry Name C Short Description APPLL_GROUP_01 Application group 01 DEFAULTS ApplicationGroup default policy OPERATIONS Operations components SAG_APPL Real APG to mirror the Sysplex APG SYSPLEX_APPLGROUP Sysplex application group SYSTEM Special system ApplicationGroup ******************************* Bottom of data ****************************** Figure 24. SA OS/390 Application Group Entry Selection panel
Default application groups are available, but in the ITSO project scenario, it was decided to create one generic system application group for each of the three systems, regardless of its function as focal point or target system. In addition to these generic system application groups, one specific system application group for the focal point system was created.
77
The following system application groups were defined in the sample ITSO System Automation policy database: Network Operations SA_OS390 SC42_Generic SC66_Generic SC69_Generic Entering the NEW command in the command line of the Entry Selection panel for application groups brings up the Define New Entry panel for application groups as shown in Figure 25.
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type . . . . . . . . . . ApplicationGroup Name . . . . . . . . . . OPERATIONS Application Group Type . SYSTEM SYSTEM SYSPLEX
Since the set of applications for each particular application group resides on the same OS/390 system in the ITSO environment, select SYSTEM on the Application Group Type field and name the individual application group using the Name field. Complete the operation by pressing PF3. It appears the Policy Selection panel for application groups as shown in Figure 26 on page 79.
78
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
If the applications of the particular application group reside on the multiple OS/390 systems within the sysplex configuration, use SYSPLEX in the Application Group Type field.
SA OS/390 Policy Selection Command ===> Entry Type : ApplicationGroup Entry Name : OPERATIONS Action
Policy Name Policy Description DESCRIPTION Enter description APPLGROUP INFO Display ApplicationGroup information S APPLICATIONS Select Applications for ApplicationGroup -------------------- --------------------------------------------WHERE USED List Systems linked to this entry USED IN VIEWS List OperatorViews linked to this entry COPY Copy data from existing entry -------------------- --------------------------------------------PROPAGATION THRESH Define thresholds for propagation of status ******************************* Bottom of data ********************************
Select the option Applications, and the Applications for ApplicationGroup panel is displayed as shown in Figure 27 on page 80. Add or remove applications from the selection screen. APPC, ASCH, JES2, LLA, TCPIP, VLF, TSO, and VTAM were added into the system application group OPERATIONS. Other applications may be selected in other application groups.
79
Command ===>
SA OS/390 Applications for Applica Row 1 to 13 of 25 SCROLL===> PAGE PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Application *SYSTEM SELECTED APPC SELECTED ASCH GMFHS IO_OPERATIONS SELECTED JES2 SELECTED LLA SAOS390_GMFHS SAOS390_NETVIEW SAOS390_NETVIEW_SSI SAOS390_RODM SAOS390_RODM_DM SELECTED TCPIP TEST TESTJOB1 SELECTED TSO SELECTED VLF SELECTED VTAM ******************************* Bottom of data ******************************** Figure 27. SA OS/390 Applications for Application Group panel
5.3.3.3 Creating a system A system is any host system in the System Automation enterprise, and its definition includes: Description of the system, including physical location Type of Operating System Processor operations information Details of which IBM automation products are operating on the system Member application groups NetView and OS/390-related information Automation policy for the system From the main System Automation Entry Type Selection panel, as shown in Figure 9 on page 64, select 4 or SYS for System. The Entry Selection panel for systems, displayed in Figure 28 on page 81, will appear.
80
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Action
Entry Name C Short Description DEFAULTS System default policy SAMPLE_SYSTEM_01 Main focal point system definition SAMPLE_SYSTEM_02 Backup focal point system SAMPLE_SYSTEM_03 Target system 1 SAMPLE_SYSTEM_04 Target system 2 SAMPLE_SYSTEM_05 Sample Coupling Facility ******************************* Bottom of data ******************************* Figure 28. SA OS/390 System Entry Selection panel
As a sysplex policy database model, five system image objects have already been created. The system, SAMPLE_SYSTEM_01, is the system object of the main focal point system, and the others are backup focal point or target systems. This is a sample sysplex architecture. In the ITSO project, three system objects were created for the System Automation environment. System SC66 will act as the focal point system, and the systems SC42 and SC69 are the target systems. To create new system entries, enter the NEW command on the command line of the Entry Selection panel. The Define New Entry panel, as shown in Figure 29 on page 82, will appear.
81
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type. . . . . . . . . . System Name. . . . . . . . . . SC66
Top of data
For MVS systems, you must specify at least the following information: MVS SYSNAME . . . . . . SC66 MVS system name Sys-Ops NetView Domain. SC66A Name of the NetView domain under which SA OS/390 Sys-Ops functions run For non-MVS systems, you must specify at least the following information if Enterprise Monitoring is to be used: Unique 5-character ID . Unique ID, different from any existing NetView domain name For SNMP systems, you must specify the following information: TCP/IP address. . . . . TCP/IP address of the system, in dotted notation Define system clone information (MVS systems only): Clone Id. . . . . . . . 66 &AOCCLONE. Clone Id 1. . . . . . . SC66 &AOCCLONE1. Clone Id 2. . . . . . . SC66A &AOCCLONE2. Clone Id 3. . . . . . . &AOCCLONE3. Clone Id 4. . . . . . . &AOCCLONE4. Clone Id 5. . . . . . . &AOCCLONE5. Clone Id 6. . . . . . . &AOCCLONE6. Clone Id 7. . . . . . . &AOCCLONE7. Clone Id 8. . . . . . . &AOCCLONE8. Clone Id 9. . . . . . . &AOCCLONE9. Enter the following NetView and Enterprise Monitoring information: Sys-Ops NetView Network Name. . . . . . . . . Network name for System Operations NetView domain (MVS systems only) INFOBridge Resource . . System name as known to INFOBridge System use. . . . . . . FOCALPOINT FOCALPOINT TARGET The following fields are for Heartbeat processing (MVS systems only): SA OS/390 or AOC/MVS Version and Release . SA13 SA13 (for SA OS/390 Rel.3), SV01 (for SA OS/390 Rel.2) or V1R4 (for AOC/MVS Rel.4) Heartbeat Interval. . . 5 1 - 60 (minutes) Missing Heartbeat Delay 30 1 - 3600 (seconds) The following field is for Processor Operations functions: ProcOps name. . . . . . SC66 Processor Operations name (non-SNMP systems only)
82
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
This example screen shows the definitions for the automation focal point system: SC66 as the System Object name SC66A as System Automation NetView domain name System Automation clone symbolics must be defined in system objects to support the cloned application. Therefore, three clone symbolics were defined for each of the systems within the sysplex environment. In the example for the automation focal point system: 1. Clone Id: 66 1. Clone Id 1: SC66 1. Clone Id 2: SC66A Continue with PF8 to the second system definition and enter the ProcOps Name, which specifies the name of the system as known to processor operation functions. For the automation focal point system, the ProcOps Name, SC66, was used. When all system definitions are completed, continue with PF3 to enter the Policy Selection panel for system SC66 as shown in Figure 30 on page 84. The following list specifies the policy items for a system object: System Info: Specifies operating system type and system name for this system object. Application Groups: Specifies application groups, which are related to this system object. NetView: Specifies NetView-related details for this system object. Automation: Specifies automation products (RMF, OPC, SDSF) used with this system. Automation Console: Defines the MVS route codes and MCSFLAGS for this system. WTO messages are sent to the Automation Console. Automation Setup: Specifies details about the system environment for automation. Automation Timer: Displays a list of defined automation timer sets, thus, allowing the user to choose which set is to be associated with this system.
83
Auto Operators: Display a list of defined auto operators sets, thus, allowing the user to choose which set is to be associated with the system. Notify Operators: Specifies human NetView operators who receive a System Automation notification message. Processor Operations: Specifies information needed by System Automation processor operations.
SA OS/390 Policy Selection Command ===> Entry Type : System Entry Name : SC66 Action
F1=HELP F7=UP
Policy Name Policy Description DESCRIPTION Enter description LOCATION Enter System location SYSTEM INFO Enter and display system information INFO BRIDGE Enter INFO Bridge resource name APPLICATION GROUPS Select ApplicationGroups for System VOLUME GROUPS Select VolumeGroups for System NETVIEW Enter NetView-related information AUTOMATION Enter automation-related installed products AUTOMATION CONSOLE Enter MVS route codes for notifications AUTOMATION SETUP Define system environment for automation MINOR RESOURCES Define sub-component flags AUTOMATION TIMERS Select Timers for System NNT SESSIONS Select NNT Sessions for System F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE
System Info Select the SYSTEM INFO function to enter the System Information panel as shown in Figure 31 on page 85.
84
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 System Information Command ===> Entry Type : System Entry Name : SC66 Update the following information: Operating system . . . . . MVS PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE More: MVS VM TPF VSE CF SNMP
Update the following MVS SYSNAME information (MVS systems only): MVS SYSNAME. . . . . . . . SC66 MVS system name Enter or Clone Clone Clone Clone Clone Clone Clone update Id . . Id 1 . Id 2 . Id 3 . Id 4 . Id 5 . Id 6 . the . . . . . . . . . . . . . . following . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . system clone information (MVS systems only): 66 &AOCCLONE. SC66 &AOCCLONE1. SC66A &AOCCLONE2. &AOCCLONE3. &AOCCLONE4. &AOCCLONE5. &AOCCLONE6.
Within the System Information panel, it is possible to define additional clone symbolics as already previously done at the System Definition panel. If System Automation is used to automate an application that runs on more than one OS/390 system in the sysplex environment, up to 10 Clone IDs can be defined for each system. These Clone ID values are automatically appended to the job name of a replicated application. Again, in the ITSO environment, there were three clone symbolics defined for each of the systems. For example, the following definitions were used for SC66:
AOCCLONE = 66 AOCCLONE1 = SC66 AOCCLONE2 = SC66A
Having defined these Clone IDs, all applications defined with the policy setting CLONE=YES are set to be cloned at load time of the Automation Control File (ACF). Continue with PF8 for the second System Information panel.
85
SA OS/390 System Information Command ===> Entry Type : System Entry Name : SC66 Version and Release. . . PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE More: SA13 SA13 (for SA OS/390 Rel.3), SV01 (for SA OS/390 Rel.2) or V1R4 (for AOC/MVS Rel.4) 5 1 - 60 (minutes) 30 1 - 3600 (seconds) FOCALPOINT FOCALPOINT TARGET
- +
Update the following Enterprise Monitoring information for non-MVS systems: Unique 5-character ID. . . Unique ID, different from any existing NetView domain name Enter or update the following target system information for Processor Operations functions (non-SNMP systems only): ProcOps name . . . . . . . SC66 Processor Operations name F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE Figure 32. SA OS/390 System Information panel (2/2)
The second System Information panel provides the following options to be set: Heartbeat interval Specifies the time interval after which the SA system operations function sends a generic alert from this system to the automation focal point system. This parameter is used to verify the status forwarding path on the multiple systems within the sysplex environment. The default value is five minutes. Missing heartbeat delay Specifies the time that the automation focal point system will wait after a heartbeat was expected. If this time expires without receiving the heartbeat, the automation focal point system will begin the missing heartbeat process for the target system. The default value is 30 seconds. System use Specifies whether this system functions as focal point or target system. In the ITSO environment, the system object, SC66, is the automation focal point system, and the system objects, SC42 and SC69, are target systems.
86
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
These system information settings are allowed to be tailored based according to individual environment requirements. Application Groups Select the Application Groups option on the main System Selection panel, which is shown in Figure 31 on page 85, to enter the following Application Groups Selection panel.
SA OS/390 ApplicationGroups for Systems Command ===> Entry Type : System Entry Name : SC66 Action Status SELECTED SELECTED SELECTED SELECTED
ApplicationGroup DBDC NETWORK OPERATIONS SA_OS390 SC42_GENERIC SELECTED SC66_GENERIC SC69_GENERIC SELECTED SYSTEM ******************************* Bottom of data *******************************
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
This Application Groups Selection panel allows specifying the required Application Groups, as defined in Section 5.3.3.2, Creating an application group on page 77, for the particular system. NetView Select the NetView option on the main System Selection panel, which is shown in Figure 31 on page 85, to enter the following NetView Information panel.
87
SA OS/390 NetView Information Command ===> Entry Type : System Entry Name : SC66 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
You can specify the following NetView-related information about this system. Sys-Ops NetView Domain.. SC66A Name of the NetView domain under which SA OS/390 System Operations functions run Network name for System Operations NetView domain Name of the NetView domain under which network automation runs
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
This NetView Information panel allows specifying the required System Automation NetView domain name. In the ITSO environment, the field Sys-Ops NetView Domain for system SC66 was set to SC66A. Automation Console Select the Automation Console option on the main System Selection panel, which is shown in Figure 31 on page 85, to enter the following Console Definition panel illustrated in Figure 35 on page 89. The automation console defines how the Write To Operator (WTO) messages issued by System Automation should look. The logical MVS Console IDs can be identified by issuing the MVS command D C on the SDSF Log screen.
88
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Environment Definition: CONSOLE (Route Codes) Command ===> Entry Type : System Entry Name : SC66 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Enter information and select S the route codes for SA OS/390 notifications. Console ID ==> 01 A Code Definition More: All Display ALL messages S 1 Master console action 2 Master console information 3 Tape pool 4 Direct access pool 5 Tape library 6 Disk library 7 Unit record pool 8 Teleprocessing control F1=HELP F2=SPLIT F3=END F7=UP F8=DOWN F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
The default logical MVS Console ID is 01, which was used within the ITSO environment. Select any route codes by selecting S on the list for Master console action and press Enter.
SA OS/390 Environment Definition: CONSOLE (MCSFLAGS) Command ===> Entry Type : System Entry Name : SC66 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Select S the appropriate MCSFLAGS. A Flag Definition Number S 1 Send message conditionally to console 2 Send message unconditionally to console 3 Immediate command response (RESP) S 4 Reply to a WTOR (REPLY) S 5 Broadcast to all active consoles (BRDCST) 6 Queue for hard copy only (HDRCPY)
The MCSFLAGS panel will be displayed for further specifications. The chosen settings in the ITSO environment shown in Figure 36 are:
89
1. Send messages conditionally to console 2. Reply to a WTOR 3. Broadcast to all active consoles Automation Timer Automation Timers are sets of scheduled timers that run commands or automation procedures at scheduled times. Create a new set of timers based on specific needs. For creation of new timer settings, enter option 30 or TMR on the System Automation main entry selection panel illustrated in Figure 9 on page 64. Refer to the System Automation for OS/390 V1R3 Customization, GC28-1566, for a detailed description. Select the Automation Timers option on the main System Selection panel, which is shown in Figure 31 on page 85, to enter the Timers for Systems panel shown below.
SA OS/390 Timers for System Command ===> Entry Type : System Entry Name : SC66 Action Status
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
On this selection panel, select SCHEDULED_AUTOMATION. MVS Component The MVS Component selection allows the user to apply automation to various OS/390 datasets, resources, and facilities. After defining a new MVS component, or using defaults, associate them with the specific system object. For creation of new MVS components, enter option 33 or MVS on the System Automation main entry selection panel illustrated in Figure 9 on page 64.
90
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Refer to the System Automation for OS/390 V1R3 Customization, GC28-1566, for a detailed description. Select the MVS Component option on the main System Selection panel, which is shown in Figure 31 on page 85, to enter the MVS Component for Systems panel.
SA OS/390 MVS Component for System Command ===> Entry Type : System Entry Name : SC66 Action
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
For the ITSO environment, the default MVS_COMPONENT was selected. Network When multiple OS/390 systems are integrated and require consolidated operations at one focal point system, use the focal point services to monitor and control the systems. The Network policy object enables you to: Define paths for sending messages, commands, or responses Define primary and backup focal point systems Define Gateway sessions connecting systems Define user Terminal Access Facility (TAF) Define user NNT sessions For creation of the new Network policy objects, enter option 39 or NTW on the System Automation main entry selection panel illustrated in Figure 9 on page 64. Refer to the System Automation for OS/390 V1R3 Customization, GC28-1566, for a detailed description. Select the Network option on the main System Selection panel, which is shown in Figure 31 on page 85, to enter the following Network for Systems panel.
91
SA OS/390 Network for System Command ===> Entry Type : System Entry Name : SC66 Action Status SELECTED
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
For the ITSO environment, the Network policy objects FOCAL_NETWORK and TARGET_NETWORK have been created. For this particular focal point system SC66, select the FOCAL_NETWORK option, and for the target systems SC42 and SC69, select the option TARGET_NETWORK. Auto Operators Automation operators are automated operator tasks that can respond to messages from the operating system, applications, and the network environment without requiring a human interaction. This is necessary for system automation. Automation operators are assigned specific messages on which to react. During automated operations, the messages are routed to the appropriate operator by using the ASSIGN command. Create a new set of automation operators, or use the provided default set of automation operators, and link to the particular system object. Select the Auto Operator option on the main System Selection panel, which is shown in Figure 30 on page 84, to enter the following Auto Operators for Systems panel.
92
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Command ===> Entry Type : System Entry Name : SC66 Action Status
SA OS/390 Auto Operators for System Row 1 to 6 of 6 SCROLL===> PAGE PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Auto Operators BACKUP_OPERS SELECTED BASE_AUTOOPS BASE_AUTOOPS_IO SELECTED FOCAL_OPERS TARGET1_OPERS TARGET2_OPERS ******************************* Bottom of data *******************************
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
In the ITSO environment, the Auto Operators BASE_AUTOOPS and FOCAL_OPERS were selected for the focal point system SC66. Select the appropriate Auto Operators options on other system objects as needed. Notify Operators The Notify Operators option specifies which message types should be highlighted (held) on specific operator screens. The options are: Which operator should receive highlighted (held) notifications What kind of messages are to be highlighted (held) for the operator: - Information - Eventual action - Immediate decision - System wait - Immediate action Select the Notify Operators option on the main System Selection panel, which is shown in Figure 30 on page 84, to enter the following Operator Notification panel.
93
SA OS/390 Operator Notification Command ===> Entry Type : System Entry Name : SC66
Enter operator information and select message type(s) to be held on screen. Action : S = Select for message class assignment Messages: S = Select messages to be held A Operator ID Operator Description Notify Notify: Yes or No
S ITSO1
YES
---------- Messages -----------Information Eventual Action Immediate Decision System Wait Immediate Action S S S S S
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
Assuming the NetView operator, ITSO1, is the responsible operator, specify the Notify option for ITSO1 to YES and select the appropriate message type to be highlighted (held) with S in the specific message column. After completion of this Operator Notification panel, the user will be prompted to specify a Message Class option. Set the response to ALL console automation messages. 5.3.3.4 Creating a subgroup A subgroup is an intermediary grouping of systems within a larger group. Define a subgroup to a system object by selecting a member system and assigning the name of the subgroup. Subgroups do not need to be defined, but it may be useful in large enterprise environments. Assuming the ITSOs focal point system is located in Dallas, and target systems are located in Austin, then two geographical subgroups are going to be created: One subgroup for the focal point system and one subgroup for the target systems. For creation of new subgroup objects, enter option 3 or SBG on the System Automation main entry selection panel, illustrated in Figure 9 on page 64, to enter the following SubGroup policy panel.
94
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Entry Selection Command ===> NEW DALLAS_MVS Entry Type : SubGroup
Action
Entry Name C Short Description AUSTIN_MVS Austin MVS Images Geographic SubGroup DEFAULTS SubGroup default policy ******************************* Bottom of data ********************************
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
Creating a new Subgroup Enter the NEW DALLAS_MVS command to create a subgroup named DALLAS_MVS. A SubGroup Policy Selection panel for the new subgroup is displayed as illustrated in Figure 43.
SA OS/390 Policy Selection Command ===> Entry Type : SubGroup Entry Name : DALLAS_MVS Action
Policy Name Policy Description DESCRIPTION Enter description SUBGROUP INFO Display Subgroup information LOCATION Enter SubGroup location S SYSTEMS Select Systems for SubGroup -------------------- --------------------------------------------WHERE USED List Groups linked to this entry USED IN VIEWS List OperatorViews linked to this entry COPY Copy data from an existing entry -------------------- --------------------------------------------PROPAGATION THRESH Define thresholds for propagation of status ******************************* Bottom of data *******************************
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
As the focal point location, DALLAS_MVS must include the designated focal point system SC66. Select the SYSTEMS option and enter the appropriate systems to the specific subgroup as shown in Figure 44 on page 96.
95
SA OS/390 Systems for SubGroup Command ===> Entry Type : SubGroup Entry Name : DALLAS_MVS Action Status
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
When the subgroup has been created, it needs to be linked to the sysplex group. 5.3.3.5 Creating a group A group is the largest subdivision of a System Automation enterprise environment. It is a set of systems, and/or subgroups, that can be associated with one another for the purpose of monitoring with the System Automation graphic interface or for System Automation processor operation functions. An System Automation enterprise may consist of many groups, each consisting of one or more systems and subgroups. Define a group by selecting the member systems and subgroups and assigning a name to the group. The status of a group depends on the status of the systems and applications it is comprised of. For creation of new group objects, enter option 2 or GRP on the System Automation main entry selection panel, illustrated in Figure 9 on page 64, to enter the following Group Entry Selection panel.
96
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Entry Selection Command ===> NEW USSOUTH_SINGLE Entry Type : Group
Action
Entry Name C Short Description DEFAULTS Group default policy USNORTH_SINGLE USNORTH Group of Single MVS Images USNORTH_SYSPLEX_001 USNORTH Group of Sysplex MVS Images ******************************* Bottom of data *******************************
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
Enter the NEW USSOUTH_SINGLE command to create a new group named USSOUTH_SINGLE. A Group Definition Entry panel for the new group is displayed as illustrated in Figure 46.
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type. . . . . . . . . . Group Name. . . . . . . . . . USSOUTH_SINGLE Group Type . . . . . . . STANDARD ProcOps Commands . . . . NO STANDARD SYSPLEX Group is valid for Processor Operations commands (YES/NO)
. . . . . .
F1=HELP F7=UP
F2=SPLIT F8=DOWN
F3=END F9=SWAP
F4=RETURN F10=LEFT
F5=RFIND F11=RIGHT
F6=RCHANGE F12=RETRIEVE
For the ITSO environment, the following three groups were created: USNORTH_SYSPLEX_001 Defined as a sysplex group type
97
USNORTH_SINGLE Defined as a standard group type USSOUTH_SINGLE Defined as a standard group type After creation of all three groups, the following Group Entry Selection panel, shown in Figure 47, shows the complete list of all defined System Automation groups.
Entry Name C Short Description DEFAULTS Group default policy USNORTH_SINGLE USNORTH Group of Single MVS Images USNORTH_SYSPLEX_001 USNORTH Group of Sysplex MVS Images USSOUTH_SINGLE ******************************* Bottom of data ********************************
Action
98
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Build Functions Menu panel, shown in Figure 48 on page 99, enter the BUILD command on the command line. If several SA policy databases are defined, the BUILD command must be followed by the specific SA policy database name. The following Build Functions Menu will appear when entering the command:
BUILD ITSO_ENTERPRISE
SA OS/390 Build Functions Menu Command ===> 4 1 2 3 4 5 6 ALL RODM Proc-Ops ACF NetView/VTAM PS/2 Profiles PS/2 profile data set. . Build Build Build Build Build Build all files RODM loader input files Processor Control File automation control file NetView and VTAM information PS/2 profile information
From this Build Functions Menu, it is possible to build every SA automation object file. For this example, building the SA automation control file, select the 4 - ACF option to enter the specific BUILDF Parameters panel as illustrated in Figure 49.
99
SA OS/390 BUILDF Parameters Command ===> PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Specify Build Build Build Specify Entry More: + the BUILD request: 'NETVUSER.SYSTEM.ACF1' ONLINE ONLINE BATCH ALL MODIFIED ALL the entry(s) that are to be processed: APL Enter three character entry type or * to process all entry types or ? to display list of entry types Entry Name. . . . . . . GMFHS Enter entry name or * to process all entries or ? to display list of entry names Re-build ACF. . . . . . YES YES NO Flag ICL's. . . . . . . YES YES NO Specify JOB statement to be used for BATCH builds: F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE information about Output Dataset. . Mode. . . . . . . Type. . . . . . . information about Type. . . . . . .
The BUILDF Parameters panel provides several choices for the specific build method and entry ranges. The following selection fields are to be determined based on the automation environment: Build Mode Select ONLINE for foreground, or BATCH for background job processing. Build Type Select MODIFIED for only those entries that have been changed since last build request, or ALL for all eligible entries that will be processed. Entry Type * For all entry types, or specify a specific entry type (for example, APL). Entry Name * For all entries, or specify a specific entry name (for example, GMFHS). 5.3.3.7 Build from the Entry Type Selection panel To enter the Build Functions Menu panel, shown in Figure 48 on page 99, from the SA OS/390 Entry Type Selection panel, enter the BUILD command on the command line. For immediate invocation of the ACF BUILDF Parameters panels, use the BUILDF command on the command line. It is necessary to specify, as a
100
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
parameter to the BUILDF command, the three letter identifier for the policy object that is to be build. For example, enter:
BUILDF SYS
to build all defined system objects defined to the SA policy database. 5.3.3.8 Build from the Entry Selection panel When entering any Entry Selection panel, for example, for applications or systems, it is possible to enter the BUILDF Parameters panel for that particular object by selecting the action keyword F in front of the individual object. For example, when selecting 6 - APL (Applications) from the Entry Type Selection panel to enter the Entry Selection panel for applications as shown in Figure 53 on page 105, it is possible to start the BUILD process for JES2 by typing F in front of JES2 and pressing ENTER.
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE C Short Description Special system job APPC/MVS automation policy ASCH automation policy Application default policy * Generic MVS Tasks Definition Graphical Monitoring Facility definition * GMFHS Defaults I/O Operations functions main component JES2 policy definition LLA automation policy * Netview Defaults Automation NetView definition Network GMFHS
Action
Entry Name *SYSTEM APPC ASCH DEFAULTS GENERIC_CLASS GMFHS GMFHS_CLASS IO_OPERATIONS JES2 LLA NETVIEW_CLASS NETVSA NETWORK_GMFHS
101
SA OS/390 Build Functions Menu Command ===> 2 1 2 3 4 5 6 ALL RODM Proc-Ops ACF NetView/VTAM PS/2 Profiles PS/2 profile data set. . Build Build Build Build Build Build all files RODM loader input files Processor Control File automation control file NetView and VTAM information PS/2 profile information
Select the 2 - RODM option from Build Functions Menu, and the RODM Load Function panel will be displayed as illustrated in Figure 52 on page 102.
SA OS/390 Build Menu Command ===> 1 BUILDR - Build RODM loader input files Enterprise . . . . . . ITSO_ENTERPRISE Output data set. . . . 'NETVUSER.SYSTEM.LOADRODM' 2 SUBMIT - Submit job to process BUILD output through RODM loader B BROWSE E EDIT - Browse output data set - Edit output data set All the "LOADxxxx" members are output
On this RODM Build Menu, it is possible to specify the output dataset for the RODM Build function. This dataset name should match the input dataset name specified in the RODM start-up procedure and RODM load job INGELOAD of the automation environment. The RODM load job INGELOAD is designed for SA functionality. It is necessary to customize this job accordingly before submitting it. The following RODM policy object members will be created after the RODM build function is called. Some important members and their functions are described as follows: LOADINS0 This file contains the instance definitions for all systems. The instance loader file defines all instances of both the System Automation and the NetView GMFHS classes.
102
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
LOADSTR0 This structure loader file contains the class definitions for System Automation for OS/390 object classes. LOADxxxx These files contain instance definitions for the one particular target system only. AOFACFMP This member contains an indication as to how the system is used as a focal point or target system.
103
can be started. Specify only those applications or subsystems upon which the given application has an immediate dependency. For any automated application, the System Automation engine can capture its related messages and set the application status to UP when its start-up process is successfully completed. Once the specific application or subsystem status is UP, System Automation continues to start the dependent children applications. For this purpose, it is necessary to maintain the SA automation table AOFMSG01 or create and include the new (self coded) automation table member for migration purposes. Within AOFMSG01, all key messages for the automated applications need to be defined and maintained according to the specific automation requirements. For example, the message, IST020I, indicates that the VTAM initialization process is complete, and System Automation can set the status for VTAM to UP when it captures this message. After VTAM is set to status UP, System Automation will start up defined children subsystems of VTAM, such as TSO, TCPIP, and so on. The AOFMSG01 is the master automation table that includes several other automation tables specific for applications defined to System Automation. The included automation table members consist of start-up, shutdown, or reply messages for the particular application. The automation table, AOFMSG01, as it is shipped by default with System Automation, already contains most of the OS/390 subsystems or applications. If a fragment for a new application is to be added, include a new automation table member with its basic messages for its start-up and shutdown completion defined into AOFMSG01. The automation table, AOFMSG01, takes over automation from DSITBL01 or AOFMSG00 after the Automation Control File (ACF) is loaded. The policy to define dependencies depends on your system environment and automation requirements. The application dependency is defined when maintaining the Application Policy definitions. For example, when defining the TCPIP application as shown in Figure 53, it is necessary to define its parent subsystem VTAM.
104
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Application Automation Definition Command ===> Entry Type : Application Entry Name : TCPIP Subsystem : TCPIP Description : Job Name : TCPIPMVS More: (MVS NONMVS TRANSIENT) Transient Jobtype can be rerun (YES or NO) Console command character(s) JES Sysname Enter one or more parents (above) Start on IPL . . . . F1=HELP F2=SPLIT F7=UP F8=DOWN Started after IPL F3=END F4=RETURN F9=SWAP F10=LEFT (YES NO NONE blank) F5=RFIND F6=RCHANGE F11=RIGHT F12=RETRIEVE + PolicyDB Name : NEW1 Enterprise Name : ITSO_ENTERPRISE
JobType . . . . . . MVS Transient Rerun . . Command Prefix . . Sysname . . . . . . SC66 Parent(s) . . . . . VTAM
A subsystem or application may have one or more parents and can also have one or more children. This relationship completely depends on the start-up logic and sequence required for the individual OS/390 environment. For the given example of the subsystem, VTAM, the subsystems TCPIP and TSO are only allowed to start after successful completion of VTAM initialization.
Note
Be careful to avoid creating loop dependencies for applications when defining applications within a sysplex environment. In the ITSO environment, dependencies were defined among all automated applications for the focal point system SC66 and the target systems SC42 and SC69. To obtain the dependency relationship among the automated applications, use the System Automation DISPTREE command. The dependency tree, as shown in Figure 54, demonstrate the relationship on the focal point system SC66.
105
System ==>
--+ DEFAULTS --+ SUBSYSTEM --+ VLF --+ LLA --+ SSISA +-- NETVSA +-- JES2 | +-- VTAM | +-- SSIAON | | +-- NETVAON | | +-- RODMAON | | +-- GMFHSAON | +-- TCPIP | +-- APPC | | +-- ASCH | +-- TSO +-- RODMSA +-- GMFHSSA
PF3=Return PF9=Refresh
PF4=Focus
Figure 54. SA OS/390 Application Dependencies for Focal Point System SC66
106
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Application Automation Definition Command ===> Entry Type : Application Entry Name : TCPIP Subsystem : TCPIP Description : Job Name : TCPIPMVS More: Sysname . . . . . . SC66 Parent(s) . . . . . VTAM JES Sysname Enter one or more parents (above) Start on IPL . . . . Started after IPL (YES NO NONE blank) Start on Recycle . . Started after recycle (YES NO NONE blank) Startup . . . . . . MVSSTART Startup control (MVSSTART PARENT CUSTOMER) Edit startup . . . NO Edit startup parameters (YES NO) F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVE Figure 55. SA OS/390 Define Start Behavior for TCPIP - + PolicyDB Name : NEW1 Enterprise Name : ITSO_ENTERPRISE
Considering system dependencies for automated applications, several choices are available to start applications. In the given example of the application TCPIP, select whether TCPIP is to start at system IPL and/or after recycle by System Automation. In addition, specify start-up criteria using the Startup field. Options for this field are: MVSSTART Indicates this application uses the MVS START command. For example, the MVS S <jobname> command is issued for this application subsystem. For editing additional start-up parameters, set the Edit startup field to YES, for example, to add the command string, ,SUB=MSTR. CUSTOMER Indicates this application is to be started by a customized MVS command. Create the start-up parameters by setting the Edit startup field to YES and enter the appropriate start-up command, for example, =STA DB2. PARENT Indicates this application is directly started by its parent, and does not need the start-up command. In the ITSO environment, the application TCPIP has the parent VTAM, but is started using the MVS START command; so, the keyword, MVSSTART, is selected.
107
108
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The panel AOFPSYST represents the SDF main panel, while the other included members represent each of the system objects. The following example SDF panel member, AOFPSYST, shown in Figure 56, represents the main panel definitions for the ITSO environment. It specifies the entry panel that is displayed when issuing the SDF command in the Automation NetView environment.
P(SYSTEM,24,80) TF(01,02,10,WHITE,NORMAL) TT(SYSTEM) TF(01,23,58,WHITE,NORMAL) TT(SA OS/390 - SUPPORT SYSTEMS) TF(03,05,10,T,U) TT(System) SF(SC66,05,05,10,N,,SC66) ST(SC66) SF(SC69,07,05,10,N,,SC69) ST(SC69) SF(SC42,09,05,10,N,,SC42) ST(SC42) TF(03,14,24,T,U) TT(Subsystems) SF(SC66.APPLIC,05,14,24,N,,SC66,Q1) SF(SC69.APPLIC,07,14,24,N,,SC69,Q1) SF(SC42.APPLIC,09,14,24,N,,SC42,Q1) TF(03,27,34,T,U) TT(WTORs) SF(SC66.WTOR,05,27,34,N,,SC66,1) SF(SC69.WTOR,07,27,34,N,,SC69,1) SF(SC42.WTOR,09,27,34,N,,SC42,1) TF(03,37,45,T,U) TT(Gateways) SF(SC66.GATEWAY,05,37,45,N,,SC66,1) SF(SC69.GATEWAY,07,37,45,N,,SC69,1) SF(SC42.GATEWAY,09,37,45,N,,SC42,1) TF(03,48,58,T,U) TT(Spool) SF(SC66.SPOOL,05,48,58,N,,SC66,1) SF(SC69.SPOOL,07,48,58,N,,SC69,1) SF(SC42.SPOOL,09,48,58,N,,SC42,1) TF(03,61,69,T,U) TT(MVS Comps) SF(SC66.MVSCOMP,05,61,69,N,,SC66,1) SF(SC69.MVSCOMP,07,61,69,N,,SC69,1) SF(SC42.MVSCOMP,09,61,69,N,,SC42,1) TF(24,01,47,T,NORMAL) TT(1=HELP 2=DETAIL 3=RETURN 6=ROLL TF(24,48,79,T,NORMAL) TT( 10=LEFT 11=RIGHT 12=TOP) EP
8=NEXT SCR)
109
The following objects were part of the ITSO System Automation environment and defined to the SDF: System Subsystem WTORS Gateways Spool MVS Comps
According to the definitions of ITSO System Automation policy database, the symbolic &AOCCLONE1. is the root node name for each system. A generic set of applications were selected as automated objects so that each system has the same resource types for SDF monitoring. The following list represents the resource hierarchy of the focal point member, AOFTSC66:
1 SC66 2 SYSTEM 3 APPLIC 4 SUBSYS 2 WTOR 2 SPOOL 2 GATEWAY 2 MVSCOMP
110
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
To start the SDF environment, issue the NetView SDF command. The example screen displayed in Figure 57 represents the SDF main panel of the ITSO environment.
111
The SDF main panel shows three lines representing the system objects (SC66, SC69, and SC42). Each system row is divided into subsystems, WTORs, gateways, spool, and MVS components. For detailed information about one system, place the cursor on its row and press PF2. The screen shown in Figure 58 demonstrates the information available for the focal point system SC66.
Figure 58. Detail information about the Focal Point System SC66
This displays all subsystems as defined in the System Automation policy database, the OS/390 spool, and gateways to other systems. All monitored resources are currently active, which is represented by the green color. Further information about specific monitored resources can be obtained by placing the cursor on the particular object and pressing PF2. The following g screen illustrated in Figure 59 on page 113 details the information for the spool object JES2.
112
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
113
114
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
File Name egvread1.me egvread2.me flbread1.me Redbook: An Introduction to Tivoli NetView for OS/390 V1R2, SG24-5224
Description NMC Topology Console from Tivoli NetView CD \readme\enu NMC Topology Server from Tivoli NetView CD \readme\enu NetView 3270 Management Console from Tivoli Netview CD \readme\enu Chpt 6 - MVS TCP/IP Support Chpt 9 - NetView Management Console Chpt 14 - NetView 3270 Java Client Chpt 15 - Web Access to NetView/390 Chpt 6 - Using the Graphical Interface to Manage SA on OS/390 IBM Web site: Systems Automation homepage, download section using SA for OS/390
Redbook: Parallel Sysplex Automation: Using System Automation for OS/390, SG24-5442 nmcpdf.zip
These references have been obtained as of December, 1999. Access at any time to the most up to date references to any of the Tivoli NetView for OS/390 or System Automation for OS/390 related topics may be obtained via the Web at the following URL addresses:
http://www.tivoli.com/nv390 http://www.s390.ibm.com/sa
115
The diagram shown in Figure 60 summarizes the following topics covered by this chapter: NMC Server setup NMC Client setup Web access to NetView OS/390 NetView 3270 Management Console (Java)
Figure 60. Addressed topics about the NMC, Web access, and Java console
116
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The following detailed sections on installation and customization of the NMC Topology Server describes only the platform Windows NT. The NMC Topology Server is also available on the platforms AIX and OS/2. The section is divided into the following categories: 1. Installing NMC Topology Server to run as a Windows NT service - Software installation - Environment setup 2. Setting up NMC Topology Server for Systems Automation - Installing NMC for System Automation for OS/390 - Issuing SA OS/390 commands using the NMC 3. Starting the NMC Topology Server using TCP/IP - Enabling TCP/IP for NetView on OS/390 - Starting the Topology Server 4. Uninstalling the NMC Topology Server 5. Hints and tips for the NMC Topology Server
117
Readme file EGVREAD2.ME on the NMC installation CD along with several situations derived from the actual install at the ITSO environment. 6.2.1.1 Selecting the correct files To install the NMC Topology Server on Windows NT, the correct files to install are located in the Tivoli NetView for OS/390 CD distribution media under the directory \WIN32 for the Windows NT NMC Topology Server. The English version of NMC Topology Console will be in \ENU (or /ENU), and the Japanese version will be in \JPN (or /JPN). The following file is distributed as part of the NetView Management Console Server: - This package, DUINMCSW.EXE, contains the NMC Topology Server in a self-extracting unzip file for Windows NT.
Note
To install the NMC Topology Server on OS/2 or AIX from the NetView host (mainframe) or CD via the Tivoli Software Installation Service, refer to the EGVREAD5.ME file located under /usr/lpp/netview/install on your OS/390 Unix System Services if Tivoli NetView for OS/390 FMID JPZ8454 is installed, or under README/ENU on the Tivoli NetView for OS/390 CD. 6.2.1.2 Software installation To install the NMC Topology Server for the networking environment on Windows NT, follow these steps: 1. To install the NMC Topology Server from CD: - Insert the Tivoli NetView for OS/390 CD distribution media into the CD drive of the workstation. - Find the correct drive and directory that the NetView Management Console Server for Windows resides on. The directory is \win32\enu or \win32\jpn, and the file name is DUINMCSW.EXE. Running this file from the CD will start the unpacking process. ---OR--1. To install the NMC Topology Server by HTTP download: - With any Web browser, go to the following URL:
http://www.tivoli.com/nv390/downloads
- Download the Windows version of the NetView Management Console Server into a temporary directory as DUINMCSW.EXE.
118
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
---OR--1. To install the NMC Topology Server via a download from mainframe DASD: - Use either a receive from an emulator session or ftp to do a binary download of member duinmcsw from the SEGVPS21 target library into a temporary directory as DUINMCSW.EXE. 2. Running the DUINMCSW.EXE file will unpack the files and invoke the installshield setup application. To perform the install, follow these steps after starting DUINMCSW.EXE from the command line or by double clicking on the file icon. 3. The following dialog will ask the user to "Select Yes to continue with the installation, on Select No to exit the installation process". If No is selected, the process ends here. Select Yes to continue to the next step.
4. Displayed next will be a welcome dialog titled "NMC Topology Server Welcome". Selecting the Next button will display a "NMC Topology Server - Installation Directory" dialog where the user selects the directory into which the installation files are unpacked. The default directory is x:\TEMP\NMCServer, where x: is the drive on which windows is installed. Selecting the Finish button will unpack the files and start the installation process. The user is then prompted to create the output directory if it does not already exist. 5. The following dialog named "Welcome" is the beginning of the NetView Management Console Server setup program. Selecting Next will display
119
the next "Information" dialog, which contains the read.me file for the user to review. 6. Selecting the Next button from the "Information" dialog will display the "Choose Destination Location" dialog. The drive may be changed, but changing the path information is NOT recommended. The path is a standard used by Tivoli, and unpredictable results in the program can occur if this is modified.
Note
If the Tivoli Framework is installed on the workstation, make sure to install the NMC Server onto the same drive as the Tivoli Framework. This is because the setup_env.cmd file installed by the Tivoli Framework will be used to set the %BINDIR% environment variable, which is needed for the NMC Server to start correctly. 7. Selecting the Next button will display the "Setup Type" dialog. The default selection will have the Typical radio button already selected. This will install all of the files available for the server and is the recommended selection. - Choosing the Compact radio button will install all of the binaries except for the tools files. - Choosing the Custom button, a "Select Components" dialog is displayed. Use the check boxes to manually select the components desired. The choices are "Program Files" or "Tools Files". 8. Selecting the Next button will display the "Start Copying Files" dialog. This shows the setup type that has been selected for the NetView Management Console Server and the path it will be installed into. 9. Selecting the Next button will cause the binaries to be installed. 10.When the binaries are installed, a "Setup Complete" dialog will be displayed. Click on Finish to end the installation process. 6.2.1.3 Information on copy problems with setup_env.cmd By default installation, a file, SETUP_ENV.CMD, is copied to the %WINDIR%\system32\drivers\etc\Tivoli directory and updated for the NMC Server to start. However, if, for example, the Tivoli Framework has been installed on the system, the copy and update of SETUP_ENV.CMD might be unsuccessful. If it fails, several warning messages, prior to the display of the "Setup Complete" dialog, will indicate this problem.
120
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The first message will inform the user "Could not copy the setup_env.cmd file to the (drive:)\Winnt\system32\drivers\etc\Tivoli directory. Subsequent messages will describe reasons for the failure and instruct the user to copy it manually and update it. It is necessary to check and update the following two variables within the SETUP_ENV.CMD file: BINDIR Specifies the directory of the server binaries, which is, in most cases, one of the following directories, depending on what directory structure is used: - (drive:)\Tivoli\bin\w32-ix86 - (drive:)\usr\local\Tivoli\bin\w32-ix86 - (drive:)\usr\Tivoli\bin\w32-ix86 INTERP Specifies the platform-dependent last directory string, which is for Windows NT on Intel-based processors W32-IX86. A possible combination of both variables, for example, could be: set BINDIR=C:\Tivoli\bin\w32-ix86 set INTERP=w32-ix86 6.2.1.4 Windows NT user rights for NMC execution The user rights on for the NetView Management Console Server to run on Windows NT must be defined if this has not already been done. The following user rights need to be added to the userid under which the NetView Management Console Server will be executed:
Act as part of the operating system.
The following steps will add the appropriate user rights under Windows NT: 1. Log on to Windows NT with Administrator authority. 2. Select Start->Programs->Administrative Tools->User Manager or Start->Programs->Administrative Tools->User Manager for Domains for NT Server machines. 3. Select Policies->User Rights. 4. Check the Show Advanced User Rights check box. 5. Scroll through the "Right:" selection list and choose the Act as part of the operating system right.
121
6. The "Grant To:" display area will list all the groups and users currently granted this right. If the target userid is already listed, go to step 11, otherwise, continue. 7. Click on Add. 8. Click on Show Users. 9. Select the target userid (the one under which the NetView Management Console Server will be executed) and click on Add. 10.Click on OK. 11.Log off from Windows NT and log on to Windows NT again using the target userid so that the rights can take effect. 6.2.1.5 Add NMC Server as Windows NT service To define the NMC Server as an Windows NT service, follow these steps: 1. On the NMC Server machine, open a command window 2. Change to the following NT directory, %BINDIR%\TDS\server\bin, where the variable %BINDIR% could be (drive:)\usr\local\Tivoli\bin\w32-ix86, (drive:)\local\Tivoli\bin\w32-ix86, or (drive:)\Tivoli\bin\w32-ix86 3. Issue the following command to install the NMC Server as a Windows NT service:
service account_name password
where account_name represents an account name in the form DomainName\Userid, and password represents the corresponding password for the specified account. If the account belongs only known and specified on the local workstation, then specify .\Userid. 4. The NMC Server will be installed as two NT services: - NMC topology communications server - NMC topology server The illustration in Figure 62 shows the successful registration example within the ITSO environment.
122
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
C:\Tivoli\nmc\TDS\server\bin>service .\NMCAdm testpw Tivoli environment variables configured. BINDIR..... c:\tivoli\nmc C:\Tivoli\nmc\TDS\server\bin>ihsxsrv install manual .\NMCAdm testpw c:\tivoli\nmc\TDS\server\bin IHS5977I: Topology communications server service installed successfully IHS5977I: Topology server service installed successfully C:\Tivoli\nmc\TDS\server\bin> Figure 62. NMC Server Registration as NT service
The NT service startup option will be set, by default, to manual. To change the NT service startup option to automatic, go to the Start->Settings-> Control Panel and double-click on the Services icon. Select the NMC services and change the startup option to automatic. 6.2.1.6 Remove NMC Server as Windows NT service To remove the NMC Server as a Windows NT service, follow these steps: 1. On the NMC Server machine, open a command window. 2. Change to the following NT directory, %BINDIR%\TDS\server\bin, where the variable %BINDIR% could be (drive:)\usr\local\Tivoli\bin\w32-ix86, (drive:)\local\Tivoli\bin\w32-ix86, or (drive:)\Tivoli\bin\w32-ix86 3. Issue the following command to remove the NMC Server as a Windows NT service:
ihsxsrv delete
The illustration in Figure 63 shows the successful registration remove example within the ITSO environment.
C:\Tivoli\nmc\TDS\server\bin>ihsxsrv delete IHS5975I: Topology server service deleted successfully. IHS5975I: Topology communications server service deleted successfully. Figure 63. NMC Server Registration removal as NT service
123
Management Console, thus, enabling the use of the NetView Management Console as a front-end interface for managing the OS/390 host environment. The sets of available commands are provided in these corresponding response files.
Table 25. System Automation response files for NMC exploitation
Description The README directory with installation and user information Subdirectory including the online help files for the system operations commands Subdirectory including data definition files for the provided system operations commands Subdirectory including the online help files for the provided processor operations commands Subdirectory including data definition files for the provided processor operations commands Response file for system operations commands Response file for processor operations commands
ISQ_NMCCCHLP_HELPFILES
ISQ_NMCS_DDF
ING_NMCS_CMD.RSP ISQ_NMCS_CMD.RSP
Related Topics:
If you want to add or remove commands to or from the delivered sets, you can use the provided Command Profile Editor (CPE) from the NMC. For detailed information on how to use this editor, refer to the Tivoli NetView for OS/390 NetView Management Console User's Guide, SC31-8665. 6.2.2.1 Installing NMC enhancements for System Automation After applying the PTF UW90546, install the System Automation for OS/390 NMC enhancement. This will enable the user to issue the most important System Automation for OS/390 processor operations and system operations commands from all NMC workstations.
124
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
The installation, as described in this section, is performed on the NMC Server only. Restart the individual NMC clients to take advantage of this enhancement. After performing the steps described in the remainder of this section, it is now possible to use the System Automation for OS/390 NMC exploitation as described in the readme documentation of the packed file INGNMCZP, How to Issue System Automation for OS/390 Commands Using the NetView Management Console. Applying the above PTF will provide two packed files for the NetView Management Console Server: ING.SINGPWS1(INGNMCZP) Packed file for Windows NT or OS/2 workstations. Download this file with the extension ZIP and unpack it using common tools, such as WINZIP or PKZIP. ING.SINGPWS1(INGNMCTZ) Packed file for Unix workstations. Download this file with extension the TAR.Z and unpack or uncompress it using common tools, such as uncompress and tar. The content of each packed file is divided into support files for system operations commands and for processor operations commands. Each support file structure contains NMC response files for system operations commands and for processor operations commands. The response files include the definitions and profiles for the following NMC extensions: ING_SO_OPER SystemOperation Operator ING_PO_OPER ProcessorOperation Operator ING_SA_OPER SystemAutomation Operator ING_SA_OPER includes a definition for both the system operations and the processor operations commands Furthermore, there are two subdirectories for the related data definition files, two subdirectories with the online help in HTML format, as well as a PostScript file to print the documentation. With this separation of system operations and processor operations commands, the user may install either the system operations commands or
125
the processor operations commands, or both, depending on specific requirements. The installation has to be done manually, as there is no common installation tool for the several supported platforms. This requires the user be familiar with the common commands of the workstation operating system. To perform the installation of the System Automation for OS/390 NMC enhancements on Windows NT, follow these steps: 1. Download the appropriate packed file in binary format to the NMC Server. 2. Unpack the file into a temporary directory of the NMC Server using an appropriate tool for the NMC Server operating system. 3. Copy the required help files for Windows NT from tmp\INGNMCEX\ING_NMCCCHLP_HELPFILES and/or tmp\INGNMCEX\ISQ_NMCCCHLP_HELPFILES to the %BINDIR%\TDS\server\db\current\help directory 4. Copy the required data definition files for Windows NT from tmp\INGNMCEX\ING_NMCS_DDF and/or tmp\INGNMCEX\ISQ_NMCS_DDF to the %BINDIR%\TDS\server\config\ddf directory 5. Copy the required response files for Windows NT from INGNMCEX to the %BINDIR%\TDS\server\sample directory 6. Verify the following: a. To operate the NMC Server, the user must be logged on to NetView via a 3270 host session. b. The NetView userid must have NGMF or NMC administrator rights. c. The NMC Server must be started and active. d. The connection to the NMC Server must be established by issuing the NETCONV command on the NetView console. 7. Start the Command Profile Editor Batch Utility (CPEBATCH) by either double clicking on the CPE.CMD file in the %BINDIR%\TDS\server\bin or issue one of the following commands for Windows NT: - %BINDIR%\TDS\server\sample\ CPEBATCH ING_NMCS_CMD.RSP and/or - %BINDIR%\TDS\server\sample\CPEBATCH ISQ_NMCS_CMD.RSP Both commands have to be issued followed by the -i and -g parameters.
126
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
For information on how to use this batch utility or the list of the various parameters, refer to Chapter 6 of the ITSO redbook Parallel Sysplex Automation: Using System Automation for OS/390, SG24-5442. 8. Start the CPE online utility, logon with a valid userid and password, and apply the new profiles to the individual operators. Profiles can also be edited from the CPE utility. For example, right clicking on object within the NMC interface displays the context menu with commands that can be issued to the object. To add or delete commands, edit the specific profile and either select an existing command or create a new command. This step loads the provided NMC enhancements into the NMC database. It is important to save the changes before leaving the CPEBATCH utility, which is not prompted, by default, to the user.
Note
The CPE online utility is only available for Intel based platforms. For other platforms, edit the files with a text editor. 9. On the individual NMC Clients, restart the NetView Management Console to reflect the NMC enhancements to the NMC Server database.
Note
For further information about the delivered commands refer to the online help or the System Automation for OS/390 V1R3 Technical Reference, GC28-1593.
127
--------------------------------------------------------------------IHS0248I: Topology communications server 1.3.0.0 is initialized. IHS0252I: Issue the 'tserver stop' command to end this process. IHS0208E: The SNA communications server APPC subsystem is not loaded
For the NMC topology server, the following screen messages indicate a successful start-up of the NMC topology server:
Tivoli NetView Management Console 1.3.0.0 Topology Server 5697-B82 (C) Copyright Tivoli Systems, an IBM Company 1997, 1999. All Rights Reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Portions copyright (c) 1992 by Free Software Foundation, Inc. All rights reserved. --------------------------------------------------------------------IHS2150I: Topology server 1.3.0.0 starting. IHS2200I: Topology server 1.3.0.0 is initialized. IHS0252I: Issue the 'tserver stop' command to end this process.
System messages during NMC server operations will be displayed in the log file ihsmessage.log located in the directory: %BINDIR%\TDS\SERVER\LOG If the NMC topology server and NMC topology communications server start successfully, it is possible to connect to Tivoli NetView for OS/390 using the NetView NETCONV command. For connecting NetView for OS/390 to the specific NMC server, issue the following command on the NCCF command line, or preferred by an autotask at NetView start-up:
NETCONV ACTION=START IP=<IPAddr NMC Server> Note
Issuing the NETCONV command by EXCMD <autotask> NETCONV... will execute NETCONV from an autotask and will assure that connectivity between NetView and the NMC topology server will continue even if the operator logs off.
128
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
1. Select Start -> Control Panel to open the control panel options for Windows NT. 2. Select the Add/Remove Programs icon in the control panel. 3. Select NetView Management Console Server in the list of programs available under the Install/Uninstall tab, and press the Add/Remove button. 4. The user will be prompted to see if they desire to completely remove the NetView Management Console Server and all its components. Selecting Yes will remove it. Selecting No will leave the program on the computer. 5. Selecting Yes will result in a "Remove Programs From Your Computer" dialog, which shows the status of the uninstall. A message saying "Uninstall Successfully Completed" will be displayed when the uninstall is done. Click OK to finish.
129
To resolve this, it may be necessary to reinstall the server. First, try to copy the setup_env.cmd file from the /BIN directory to its correct place. This would typically be the directory %WINDIR%\system32\drivers\etc\Tivoli for Windows NT. Then, edit the file to ensure that the correct information is in place for the %BINDIR% environment variable as per the above section. If the setup_env file is found, but the bindir is not set If the setup_env.cmd file is found, but the %BINDIR% variable is not set, the following messages are issued, and neither of the DOS or AIX command windows will come up. Also, note that no updates are placed into ihsmessage.log. The messages are: "Tivoli environment variables configured." "The system cannot find the path specified." To resolve this problem, make sure the path of the %BINDIR% environment variable is correct. In Windows NT the NMC topology server starts, but then closes If the user right "Act as part of the operating system" is not set correctly to the appropriate userid, the NMC topology communication server will start, but the NMC topology server will start and immediately end. A error message "IHS2133I: The server must be run under a userid that has 'Act as part of the operating system' user right. The server is ending." is placed in the log file ihsmessage.log. To resolve this problem, set the appropriate user rights under Windows NT to the correct userid. Cannot start the NT services of NMC Server at start-up Ensure that the used userid to execute the automatic NT service start-up and Windows NT machine or domain name are not the same. For example, logging locally on to a workstation with the machine name NMCSRV, and the same userid, NMCSRV, is used, an error will occur at Windows NT startup indicating that the userid is not recognized as a valid userid, and the services will not start even though that same userid has administrative privileges allowing them to start the NMC topology server or NMC communications server manually from the NT Services. To resolve this problem, change the userid or machine name to be different.
130
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
b. Download the Windows version of the NMC Topology Console into a temporary directory as DUINMCCW.EXE. ---- or ---1. To install the NMC Topology Console via a download from mainframe DASD:
131
a. To install the NMC Topology Console from your NetView host (mainframe), please read the EGVREAD5.ME file located under /usr/lpp/netview/install on your OS/390 Unix System Services if the optional Tivoli NetView for OS/390 FMID JPZ8454 has been installed. This install is done using the Tivoli Software Installation Service software. 2. Running the DUINMCCW.EXE file will unpack the files and invoke the Installshield setup application. 3. To perform the install, follow these steps after entering DUINMCCW from the command line. a. The following dialog will be displayed asking the user to "Select Yes to continue with the installation. Select No to exit the installation process". If No is selected, the process ends here. If Yes is selected, the following actions will occur:
b. A Welcome dialog titled "NetView Management Console Topology Console 1.3.0.0 - Welcome" will be displayed as shown above. Selecting the Next button will display a "NetView Management Console Topology Console 1.3.0.0 - Installation Directory" dialog on which the user selects the directory into which the installation files are unpacked. The default directory is x:\TEMP\NMCClient, where x: is the drive on which Windows is installed. Selecting the Finish button will unpack the files and start the installation process. The user will be prompted to create the output directory if it does not already exist.
132
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
c. The following dialog named "Welcome" is the beginning of the NMC Topology Console setup program. Selecting Next will display the next "Information" dialog which contains the read.me file that is available for review. d. Selecting the Next button from the "Information" dialog will display the "Choose Destination Location" dialog. The drive may be changed but it is not recommended that the path information be modified. The path is a standard used by Tivoli, and by the statement within the original Readme file, unpredictable results in the program can occur if it is changed. e. Selecting the Next button will display the "Setup Type" dialog. The default selection will have the "Typical" radio button already selected. This will install the files available for the NMC Topology Console, but not the "NMC Productivity Kit". This option is equivalent to the Compact option. The Compact radio button may also be selected. This will install all of the binaries except for the "NMC Productivity Kit". If the Custom button is selected, a "Select Components" dialog is displayed. Use the check boxes to manually select the components desired. The choices are NMC Program Files and NMC Productivity Kit. The NMC Program Files are all the files that enable the functionality of the NMC Topology Console. The NMC Productivity Kit consists of an NMC Topology Console Demo and example Java applications and plug-ins. f. Selecting the Next button will display to the "Start Copying Files" dialog. This shows the setup type selected for the NMC Topology Console and the path it will be installed into. g. Selecting the Next button will start to install the binaries. h. When the binaries are installed, a "Setup Complete" dialog will be displayed. Unlike previous the NMC Version 1.2, there is no need to update the PATH and CLASSPATH environment variables to define Java.
133
the Windows 95/98/NT desktop or in the programs group under the Start button. This will display the following NetView Sign On dialog box.
3. Sign on to the NMC Server and NetView by entering a valid RACF userid and password. In the field labeled Host Machine, enter the IP address or IP host name of the NMC topology server. 4. Click OK to complete the logon process.
134
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
4. The user will be prompted to see if they desire to completely remove the NMC Topology Console and all its components. Selecting Yes will remove it. Selecting No will leave the program on the computer. 5. Selecting Yes will result in a Remove Programs From Your Computer dialog, which shows the status of the uninstall. A message saying Uninstall Successfully Completed will be displayed when the uninstall is done. Click OK to finish.
135
1. Define the automated resources, for example, Application Groups or Systems, using the System Automation for OS/390 customization dialog described in Section 5.3, Defining all systems and objects to System Automation on page 60. 2. Group the automated resources into logical Operator View using the SA OS/390 customization dialog as described in Section 5.3.3, Entering all systems and objects on page 64. 3. Use the BUILD function of the System Automation for OS/390 customization dialog to build the RODM load files from the object information in the stored in the SA OS/390 policy database. 4. When the created RODM load files are loaded to RODM, the NetView Management Console retrieves the information through GMFHS from RODM and displays the defined OperatorView on its graphical interface. In order to start the NetView Management Console, follow these steps: 1. Make sure that the NMC Server is started and connected to the NetView host using the NETCONV ACTION=START IP=<ipaddress> command on the NetView NCCF interface, where <ipaddress> represents the real IP address of the NMC Server. 2. On the workstation, start the NetView Management Console application. From the NetView Sign On panel, shown in Figure 66, log on to NetView using the correct RACF user ID and password.
136
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
3. The Tivoli NetView for OS/390 Management Console is displayed. Expand the SA_OS/390 selection under Networking Views to get a selection of operator views as defined in the customization dialog.
137
Figure 67. NMC Console View of the Focal Point System SC66
4. Select one of the view objects, as in this example, the focal point system SC66, to the display the contained objects and their status information. Use the Resource Properties selection of an object context menu for detailed object information. Depending on the type of objects displayed in the target view, the corresponding context menus for this object type may vary: - For aggregate objects, such as Operator Views, Groups, Application Groups, and Volume Groups, the context menu displays processor operations commands only. For example, it is possible to issue a processor operations START command to an aggregate object, which will start processor operations on the real objects belonging to this aggregate object. To start a processor operations command on a single system object from this aggregate view, navigate to that specific system object.
138
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
- For real objects like Applications and Systems, the context menu displays processor operations commands and system operations commands (assuming both NMC enhancements are installed). The screen shown in Figure 68 illustrates the SA OS/390 context menu for a real object, the focal point system SC66.
Figure 68. NMC Context Menu of the Focal Point System SC66
5. By selecting one of the applicable commands, a corresponding dialog box may be displayed to specify additional parameter for the specific command. An example is illustrated in Figure 69 of the dialog box for the DISPSTAT command. At the bottom of this dialog box, the appropriate command syntax is displayed.
Note
NetView for OS/390 allows a maximum length of 255 characters per command. If the parameter specifications exceed this limit, a message will be displayed that the command cannot be executed.
139
6. When finished, press the Send or Send and close button to submit the command to NetView OS/390. The command output is displayed in the NMC Response Log. View the NMC Response Log by selecting the Tear Away Log item from the Options menu.
140
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Fullscreen commands are generally not supported, although the common BROWSE is supported. You can browse members of concatenated datasets as well as the Netview log.
Note
The most up-to-date references to any of the Tivoli NetView for OS/390 related information may be obtained from the Web at:
http://www.tivoli.com/nv390
6.4.0.1 Enabling NetView OS/390 Web access Ensure that the following NetView DSIPARM members are customized during NetView setup to enable Web access and TCP/IP connectivity. For a detailed description on how to customize NetView for OS/390, see Section 4.3, Network management environment on page 33 and Section 4.4, Automation environment on page 39. DSIDMNB - DSIWBTSK task definition:
*************************************************************** * NOTE: THE FOLLOWING TASK STATEMENT IS NECESSARY FOR * * NETVIEW WEB SERVER. * *************************************************************** TASK MOD=DSIZDST,TSKID=DSIWBTSK,MEM=DSIWBMEM,PRI=5,INIT=Y
It is important to specify a unique port in the DSIWBMEM member. NetView V1R3 for OS/390 is shipped with a default port of 80. If other Web servers are running, port 80 is allocated to them, and another port has to be allocated for the NetView Web server.
Note
If there is a problem with the TCP/IP definitions, a BNH1671 message is returned with an error code of 48.
141
142
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
6.5.1.2 Workstation component The supported client environments are OS/2, Windows NT, Windows 95 and 98, AIX, Solaris, and HP-UX. This section will describe the installation for Windows only. Additional specifics for the different client platforms are: OS2: The NetView Java Client requires OS/2 Version 4.0 or higher as well as OS/2 TCP/IP Version 2.0 with UN64092 or a later version. The NetView Java Client must be installed in an HPFS partition. Windows 95, 98, and NT: The NetView Java Client requires Windows 95, 98, or NT 4.0 with TCP/IP support installed. AIX: The NetView Java Client requires IBM AIX Version 4.2.0 or higher.
Note
The previous NetView release, V1R2, required that a Java Development Kit (JDK) be downloaded and defined. Since NetView release V1R3, the Java support is integrated into the binaries so that there is no need to obtain Java support separately.
143
The following file is distributed as part of the NetView 3270 Management Console: FLB4WIN.EXE - This package contains the NetView 3270 Management Console in a self-extracting unzip file for Windows 95, 98, and NT, which is found on the CD and the Web.
144
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
- SOCKETS defines how many users can log on to NetView using TCP/IP. TCP/IP reserves a minimum of 50 sockets; so, numbers less than 50 are not used. Valid values are 50-1000. The default is 50. For example: SOCKETS=50 - TIMEOUT defines how many seconds elapse before a request times out. The default value is 3,600. For example: TIMEOUT=60 - DIAGNOSE creates additional debugging messages in the log. Specify NO unless otherwise instructed by the Tivoli Support Center for problem diagnosis. For example: DIAGNOSE=NO 6.5.4.2 Setting up DSITCPRF Member DSITCPRF in DSIPRF defines encryption keys for each operator. The operator ID is followed by a colon and any number of blanks. The first non-blank field is the encryption key for the data flowing from the NetView 3270 Management Console to NetView (command flow). The second non-blank field is the encryption key from NetView to the NetView 3270 Management Console. The length of the keys can be in the range of 1-8 characters. Using an 8-character key is recommended. Use the same keys to define the NetView 3270 Management Console. It does not send the keys on any session. Place DSITCPRF in a secure (DSIPRF DD) library. If both keys are "default", in lowercase, NetView uses a default encryption key. The default key is the same for any session but is not a published value. The default key provides encryption protection. Do not use "default" for only one of the encryption keys because NetView interprets this as a definition error. If both keys are "disabled", in lowercase, encryption is not used. Specify "disabled" for debugging session problems in low-risk networks. Do not use "disabled" for only one of the encryption keys because NetView interprets this as a definition error. Define a NetView operator ID the same as existing IDs. As a security benefit, only operators defined in this file can log on to NetView using a NetView 3270 Management Console. For example, if DSITCPRF only contains the following statement, a logon attempt from a NetView 3270 Management Console using OPERX results in the message, "DSI029I: INVALID LOGON ATTEMPT FROM TERMINAL terminal, ERROR IN THE 'n' FIELD":
145
OPER1: default default The following statement enables a NetView 3270 Management Console to log on as OPERX with no encryption: OPERX: disabled disabled Encryption keys can be mixed case. Choose random, printable, non-blank characters, such as: OPER4: a1s2d3f4 lpmonibu Specify the keyword ANY_OTHER to define a single set of keys that is used by operators who are not defined in the DSITCPRF member. For example, to set up universal access with a single statement, specify: ANY_OTHER: default default 6.5.4.3 DSIDMNK sample member Member DSIDMNK in DSIPARM should include the following task definition:
TASK TSKID=DSITCPIP,MEM=DSITCPCF,MOD=DSITCPIP,PRI=6
6.5.4.4 Required host environment The following conditions must exist at the host environment to enable the NetView 3270 Management Console: 1. The host TCP/IP must be started each time the system is IPLed. To start TCP/IP after you IPL the system, issue an MVS command similar to:
S TCPIP32.TCP32
For further information, refer to the OS/390 TCP/IP OpenEdition Users Guide, GC31-8305. The start-up profile is in TCP32.PROFILE.TCPIP. 2. NetView for OS/390 and the DSITCPIP optional task must be running. The following command can be used to start the optional task:
START TASK=DSITCPIP START TASK=DSITCPIP,MOD=DSITCPIP,MEM=DSITCPCF,PRI=6
The second form is used if the TASK statement is not in the DSIDMN member(s) and if the operator has security authorization for the START command keywords used above.
146
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
along with several situations derived from the actual install at the ITSO environment. To install the NetView 3270 Management Console on Windows 95, 98, or NT, follow these steps: 1.To install the NetView 3270 Management Console from CD: a. Insert the Tivoli NetView for OS/390 CD distribution media into the CD drive of your workstation. b. Find the correct drive and directory that the NetView 3270 Management Console for Windows resides on. The directory is \win32\enu or \win32\jpn and the file name is FLB4WIN.EXE. Running this file from the CD will start the unpacking process. ---- Or ---1. To install the NetView 3270 Management Console by HTTP download: a. With any Web browser, go to the following URL:
http://www.tivoli.com/nv390/downloads
b. Download the Windows version of the NetView 3270 Management Console into a temporary directory as FLB4WIN.EXE. ---- Or ---1. To install the NetView 3270 Management Console via a download from mainframe DASD: a. To install the NetView 3270 Management console from the NetView host (mainframe), please read the EGVREAD5.ME file located under /usr/lpp/netview/install on your OS/390 Unix System Services if the optional Tivoli NetView for OS/390 FMID JPZ8454 has been installed. This install is done using the Tivoli Software Installation Service software. 2. Select the directory that will be the root directory for the console program directory tree as the current directory. For example, if directory E:\ is the current directory, the NetView 3270 Management Console program will expand into a directory structure with the directory tree of E:\usr\local\Tivoli\bin\generic_unix\TDS\ibmflb. This can be on a LAN drive so that many users share a common copy of the program. Individual settings files are created later in the installation on local disks for each user. 3. Unpack the files by running the FLB4WIN.EXE self-extracting EXE file. It will prompt the user for the directory to unpack the files into with the
147
default being x:\TEMP\NMC3270, where x: is the system drive, and invoke the Installshield setup wizard. Erase the FLB4WIN.EXE file when satisfied that the installation has been successful. This file is not used by the rest of the installation process or the NetView 3270 Management Console program. 4. FLB4WIN.EXE will automatically invoke the Installshield program, which will install all of the files for the NetView 3270 Management Console and create a desktop entry to configure NetView 3270 Management Console .bat files. Simply follow the dialogs presented by the Installshield program (SETUP.EXE) to perform the install, click on the desktop icon, and select Configure the NetView 3270 Management Console. This will bring up the console installation screen shown in Figure 70.
5. The FLBINST.BAT command file will ask for information, which must be entered in order to successfully connect NetView 3270 Management Console to NetView OS/390. Explaining information is provided to guide in the entering of information. The following list is a brief summary: a. A unique name, such as an operator ID, that will be used as the batch file name. The batch file, for example, oper1.bat, is created in the data directory you specify for the settings files.
148
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
b. The IP host name for the mainframe TCP/IP stack. c. The IP port number for the mainframe TCP/IP stack.
Note
To find the IP port number and IP host name being used by the mainframe TCP/IP stack, log on to NetView and type the following command:
LIST DSITCPIP
d. The inbound and outbound encryption keys for the session. e. The directory path for the user settings data and batch command files, for example, E:\MYDATA. Special Cases: 1. If the path specified is already being used by your other sessions, the settings are shared among all sessions. 2. To separate settings for some of the sessions, use a separate directory for each case. 3. The installation process will create the data directories if they do not already exist. 4. Since the batch files created in this directory contain encryption keys, ensure security protection of the disk, directory, and files. Typically, a local directory, not one on the LAN accessed by others, should be used. f. The size of the display area should be equivalent to a 3270 screen. Possible values are (rows x characters): 0 for 24x80 1 for 32x80 2 for 43x80 3 for 32x132
149
6. To set up program shortcuts for the 3270 Management Console: a. Create a shortcut of FLBINST.BAT on the desktop using drag and drop from a view of its containing folder. For example, if installing to E:\, the path and file is: E:\usr\local\Tivoli\bin\generic_unix\TDS\ibmflb\flbinst.bat. b. Create a shortcut for the oper1.bat on the desktop using drag and drop from a view of its containing folder. For example, if the data directory is E:\MYDATA, and the name is oper1, the path and file is: E:\MYDATA\oper1.bat. c. To start the NetView 3270 Management Console or installation program, click on the shortcut. 7. To start the NetView 3270 Management Console from a DOS command window: a. Select the data directory as the current directory, for example
CD E:\MYDATA.
b. Type the filename of the batch file and press Enter. For example:
OPER1.BAT Note
To re-create the files in the data directory, rerun the installation procedure to re-create missing directories or files in the data directory.
150
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
3. Select the NetView 3270 Management Console in the list of programs available under the Install/Uninstall tab and press the Add/Remove button. 4. The user will be prompted to see if they desire to completely remove the NetView 3270 Management Console and all its components. Selecting Yes will remove it. Selecting No will leave the program on the computer. 5. Selecting Yes will result in a Remove Programs From Your Computer dialog, which shows the status of the uninstall. A message saying "Uninstall Successfully Completed" will be displayed when the uninstall is done. Click OK to finish.
The batch file created on the source workstation (for example, OPER1.bat) can then be copied to the target workstation. Modify the copied batch file to ensure the path points to the IBMFLB folder on the target workstation, as in the example below, and that the IP host name, IP port, and encryption keys are set to their correct values, respectively. The following example illustrates how such a batch file looks:
151
@REM NetView 3270 Management Console BAT file @SETLOCAL @C: @CD \usr\local\Tivoli\bin\generic_unix\TDS\ibmflb @SET JAVAPATH=..\..\..\w32-ix86\Tds\java @%JAVAPATH%\bin\jre -mx48M -ms16M -classpath .;.\jars\tivflb13.jar;%JAVAPATH%\lib\rt.jar; ... ... %JAVAPATH%\lib\i18n.jarsrc.ibmflb.FLB_NVClient 9999 tcphost.host.com ... ... BUFR NODIAG DEFAULT DEFAULT C:\MYDATA 3 @ENDLOCAL
Note
It is important to ensure that the values in the batch file are identical in case and character to those in the DSITCPRF member. For example, if the member defines the values as default default, and they are set to DEFAULT DEFAULT in the batch file, the console will start but will produce unreadable text on the screen. 2. Configuration file The data directory specified for the NetView 3270 Management Console contains a file called FLB_CONFIGURATION. This file maintains a list of full-screen sessions available to the console program along with font, color, key remapping, and session option information for each full-screen session. This file should be copied to the data directory of the target machine. It is a binary file and does not contain editable information. Its contents created and modified by the NetView 3270 Management Console program.
152
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
When installing the NetView 3270 Management Console in a UNIX environment, close your terminal window after installing the client and then open another terminal window to run the client. Environment space errors in Windows 95 and 98. It might be possible that the batch files used to set up and launch the NetView 3270 Management Console may require additional environment space. This can be adjusted via the memory properties setting for MSDOS windows or through the shortcut icons. Screen corruption on scrollable panels. Panels with scrollbars may show screen corruption when moving the scrollbar. Manipulating the scrollbars for a few seconds will clear up this condition. Out of memory errors on Windows 95. Opening a large number of full-screen sessions (typically, greater than 15) on Windows 95 may cause out of memory errors. Increasing the amount of memory on the machine may help this problem.
153
154
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
2. DSICLD: Add NETVIEW.V1R3M0.SEZLCLST to CLIST library so that operators can execute AUTOMAN commands from NCCF panel of the Automation Netview environment.
155
//DSICLD // // //
DD DD DD DD
3. DSIPNL1: Add NETVIEW.V1R3M0.SEZLPNLU to PANEL library, so all AUTOMAN panels can be displayed when the AUTMAN command is issued in the Automation NetView environment.
//CNMPNL1 // // // DD DD DD DD DSN=&SQ2..SINGNPNL,DISP=SHR DSN=&SQ1..CNMPNL1,DISP=SHR DSN=NETVIEW.V1R3M0.SEZLPNLU,DISP=SHR DSN=&SQ1..SEKGPNL1,DISP=SHR
7.1.1.2 Update the Automation DSIPARM library Copy the member DSICMDM from the NetView install library, NETVIEW.V1R3M0.DSIPARM, to the common automation NetView DSIPARM library NETVIEW.SYSTEM.DSIPARM, and modify the member DSICMDM by uncommenting the statement %INCLUDE EZLCMDI. After this modification, restart the Automation NetView, and the AUTOMAN functions are enabled and available within the Automation NetView.
Note
Several AON functions such as INFORM, AUTOMAN, TIMER, SMTP email and TCP/IP commands can be run without other AON automation functions being active. The above steps will enable all of these functions. The AON TIMER functions and the SA/390 TIMER functions cannot run simultaneously in the same operating system environment. The default is the AON TIMER function. Refer to Tivoli NetView for OS/390 Automated Operations Network Users Guide, GC31-866, for further details. For further detailed compatibility information and the latest System Automation APAR for NetView V1R3 toleration refer to Chapter A, NetView 1.3 toleration for System Automation 1.3 on page 231.
156
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
automation tables through a full-screen panel interface, also enabling changes to selected tables or changes that have an affect on all automation tables. The AUTOMAN command manages loading of tables, displays BEGIN/END structures, and helps in several other useful ways, but it does not assist in creating automation table statements. Using AUTOMAN is a convenient way to perform actions against the automation tables without having to remember the AUTOTBL command syntax. The AUTOMAN panels may look similar to AON, but are easily accessible from the NetView NCCF interface. For some of the AUTOMAN functions, there are LISTING members produced within the DSILIST dataset. These LISTING files may also be created with native AUTOTBL commands, but it is not necessary to remember a stack of parameters. Using AUTOMAN, this information, and all the parameters, is included. The AUTOMAN command integrates AUTOTBL, AUTOCNT, and other NetView AON functions, which makes it a panel-driven tool of ease and convenience. The key functions AUTOMAN provides include: Display function Insert Function Enable/Disable function Reload/Unload function From the NetView NCCF interface, simply enter the AUTOMAN command. It will start the main menu of the AUTOMAN tool as shown in Figure 71 on page 158.
157
AUTOMATION TABLE MANAGEMENT Enter any character in the selection fields STATUS MARKERS TASK DATE TIME ENABLED AUTO1 12/07/99 16:45:47 ENABLED GAO 12/09/99 12:21:39 ENABLED GAO 12/09/99 12:22:01
Command ===> F1=Help F2=Main Menu F3=Return F4=Commands F5=Refresh F6=Roll F7=Backward F8=Forward F9=Responses F10=Global Commands F12=Cancel Figure 71. Automation Management Tool AUTOMAN
AUTOMAN initially displays all loaded tables in their correct order. Each table on the panel is able to be addressed and edited by moving the cursor. On the main menu of AUTOMAN, the predefined PF keys displayed at the bottom of the panel are used for the desired functions. Select an automation table to work with and press PF4 for commands to that automation table, or select PF10 to act on all automation tables to make global changes. In the ITSO project example, the automation table, AOFMSG01, is selected, and by pressing PF4, the specific command menu is displayed as shown in Figure 72.
158
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
AUTOMATION TABLE MANAGEMENT Enter any character in the selection fields ................................................... : COMMANDS (Choose a highlighted command option) : : : : 8 1 -ENABLE the selected tables : : 2 -DISABLE the selected tables : : 3 -RELOAD the selected tables : : 4 -TEST the selected tables : : 5 -ENABLE/DISABLE parts of the : : selected tables : : 6 -UNLOAD selected tables : : 7 -INSERT a table : : 8 -DISPLAY options : : : : Enter=Execute Command F3 or F12=Cancel : :.................................................:
Command ===> F1=Help F2=Main Menu Figure 72. Commands Menu of AUTOMAN
F6=Roll
The available command actions are as follows: DISABLE automation table ENABLE automation table RELOAD automation table TEST statement syntax of automation table INSERT a new automation table in active list DISPLAY every information about automation table AUTOMAN is very beneficial for easily reloading a table that has been changed without having to remember the exact AUTOTBL command syntax. 7.1.2.1 AUTOMAN display function AUTOMAN provides very strong display functionality on automation tables, including: Simple automation table without INLCUDEs Detail automation table with all INLCUDEs Synonyms of automation table Automation table utilization report Listing file on DSILIST
159
To display information about automation table AOFMSG01, select the DISPLAY option by entering 8 from commands menu. This option will display the following DISPLAY menu as shown in Figure 73.
EZLKATLD
AUTOMATION TABLE Enter any character in the selection fields SEL POS NAME ................................................... / 1 AOFMSG01 : COMMANDS (Choose a highlighted command option) : _ 2 AOFTST01 : : _ 3 DSITBL99 : 8 1 -ENABLE the selected tables : ............................................................. : DISPLAY OPTIONS (select option and press ENTER) : : : : 3 1 - Browse table with includes 8 - Browse listing : : 2 - Browse table without includes : : 3 - Display INCLUDE structure : : 4 - Display synonyms : : 5 - Display labels/blocks/groups : : 6 - Display disabled statements : : 7 - Display AUTOCNT statistics : :...........................................................:
F3=Return
F6=Roll F12=Cancel
Using AUTOMANs DISPLAY function, any information about the automation table can be selected and browsed. For example, to review the INCLUDE structure of AOFMSG01, select 3 from DISPLAY menu, and the INCLUDE structure list of AOFMSG01 will be displayed as shown in Figure 74 on page 161.
160
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
CNMKWIND OUTPUT FROM %INCLUDE STRUCTURE DISPLAY LINE 0 OF 22 *------------------------------- Top of Data --------------------------------* AOFMSG01 PRIMARY TABLE AOFMSGSY AOFMSGGW AOFMSGST AOFMSGTS AOFMSGMS AOFMSGHI AOFMSGBL AOFMIO AOFMNETV AOFMSGGN AOFMVTAM AOFMAPPC AOFMMVS AOFMJES2 AOFMJES3 AOFMTSO TO SEE YOUR KEY SETTINGS, ENTER 'DISPFK' CMD==> Figure 74. %INCLUDE structure for automation table AOFMSG01
In addition to automation table structure information, the ability to collect utilization or statistics information about automation tables by using the AUTOCNT function is included in the AUTOMAN commend menu. In the ITSO example, to display the automation table utilization of AOFMSG01, option 7 from the DISPLAY menu was selected.
EZLKATLD
AUTOMATION TABLE Enter any character in the selection fields SEL POS NAME ................................................... / 1 AOFMSG01 : COMMANDS (Choose a highlighted command option) : _ 2 AOFTST01 : : _ 3 DSITBL99 : 8 1 -ENABLE the selected tables : ............................................................. : DISPLAY OPTIONS (select option and press ENTER) : : : : 7 1 - Browse table with includes 8 - Browse listing : : 2 - Browse table without includes : : 3 - Display INCLUDE structure : : 4 - Display synonyms : : 5 - Display labels/blocks/groups : : 6 - Display disabled statements : : 7 - Display AUTOCNT statistics : :...........................................................: Command ===> Figure 75. Display menu for AUTOCNT
161
CNMKWIND OUTPUT FROM AUTOCNT STATISTICS LINE 0 OF 374 *------------------------------- Top of Data --------------------------------* DWO800I AUTOMATION TABLE MSG DETAIL REPORT BY GAO -----------( AOFMSG01/AOFMS292 MESSAGE DETAILS 12/03/99 00:00:20 )-----------GAO COMPLETED INSERT FOR TABLE #1: AOFMSG01 AT 12/02/99 23:41:14 |-- PERCENTAGES --| STMT L SEQUENCE NUMBER/ MEMBER COMPARE MATCH E C A D MATCH/ COMP/ MATCH/ NUMB I LABEL NAME NAME COUNT COUNT C I I I COMP TOTAL TOTAL ------------------------------------------------------------------------------MEMB AOFMSG01 MEMB AOFMSGSY 0051 S 00087000 AOFMSG01 110 110 0 X X 100.0 100.0 100.0 0052 S 00105000 AOFMSG01 110 0 0 0.0 100.0 0.0 0053 S 00113000 AOFMSG01 0 0 0 -.0.0 0.0 0054 S 00121000 AOFMSG01 0 0 0 -.0.0 0.0 0055 S 00129000 AOFMSG01 0 0 0 -.0.0 0.0 0056 S 00137000 AOFMSG01 0 0 0 -.0.0 0.0 0057 S 00145000 AOFMSG01 0 0 0 -.0.0 0.0 MEMB AOFMSGGW 0059 S 00037630 AOFMSGGW 110 0 0 0.0 100.0 0.0 0060 S 00041590 AOFMSGGW 110 0 0 0.0 100.0 0.0 0061 S 00051490 AOFMSGGW 110 95 0 86.4 100.0 86.4 TO SEE YOUR KEY SETTINGS, ENTER 'DISPFK' CMD==> Figure 76. AUTOCNT statistics report of AOFMSG01
The AUTOCNT report will be described in more detail in Section 7.2, Netview and automation table optimization for performance on page 166. More information about automation tables may be obtained by selecting other items from the DISPLAY menu of AUTOMAN. 7.1.2.2 AUTOMAN Insert Function An automation table is easily inserted into the list of active automation tables and is put in the correct position by using the AUTOMAN menu. The following example shows how to insert the new automation table, AOFTST02, into AUTOMANs active tables list. Continue to select the main automation table, AOFMSG01, and choose option 7 from the commands menu as shown in Figure 77 on page 163.
162
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
AUTOMATION TABLE MANAGEMENT Enter any character in the selection fields ................................................... : COMMANDS (Choose a highlighted command option) : : : : 7 1 -ENABLE the selected tables : : 2 -DISABLE the selected tables : : 3 -RELOAD the selected tables : : 4 -TEST the selected tables : : 5 -ENABLE/DISABLE parts of the : : selected tables : : 6 -UNLOAD selected tables : : 7 -INSERT a table : : 8 -DISPLAY options : : : : Enter=Execute Command F3 or F12=Cancel : :.................................................:
F6=Roll F12=Cancel
The INSERT function is called, and the following Table Insert panel is displayed.
EZLKATBI
AUTOMATION TABLE INSERT PANEL (Press Enter to process INSERT request) Preceding Table Focus Table AT= 1 Next Table ---------------------- ---------------------- ---------------------N/A AOFMSG01 AOFTST01 SELECT INSERT OR TEST OPTION 2 1 2 3 4 5 6 OR 7 AT(DEFAULT) AFTER BEFORE REPLACE FIRST LAST Table Name AOFTST02 (Required) Listing Name AUTOM876 Default listing name (names can be reused, but cannot be in use by another table) SELECT A MARKER OPTION Enter your own marker
- AUTOTBL TEST
F6=Roll F12=Cancel
163
The exact automation table position can be controlled by key parameter as shown in Figure 78 on page 163. Several options to determine where the new automation table is to be inserted are available. In this example, the AFTER option 2 is chosen, and the new AOFTST02 will be inserted after AOFMSG01 and before AOFTST01. In addition, it would be possible to test the new automation table and its results of insertion by selecting the AUTOTBL TEST option 7. After the new automation table, AOFTST02, is inserted into the active automation table list, this list in displayed to the user as demonstrated in Figure 79.
EZLK8500 AUTOMATION TABLE SEL POS NAME _ 1 AOFMSG01 _ 2 AOFTST02 _ 3 AOFTST01 _ 4 DSITBL99
AUTOMATION TABLE MANAGEMENT Enter any character in the selection fields STATUS MARKERS TASK DATE TIME ENABLED AUTO1 12/07/99 16:45:47 ENABLED GAO 12/09/99 12:27:44 ENABLED GAO 12/09/99 12:21:39 ENABLED GAO 12/09/99 12:22:01
Command ===> F1=Help F2=Main Menu F3=Return F4=Commands F5=Refresh F6=Roll F7=Backward F8=Forward F9=Responses F10=Global Commands F12=Cancel Figure 79. Updated automation table list of AUTOMAN
7.1.2.3 AUTOMAN Enable/Disable function The AUTOMAN function of enabling or disabling is not limited to the automation table as a whole member but, instead, can operate on various range levels of the automation table. Based on its structure, AUTOMAN can perform Enable/Disable action on statements, blocks, labels, groups, or entire automation tables. As an example, the following scenario details the Enable/Disable function for only a part of the AOFMSG01 automation table. By selecting the specific automation table, AOFMSG01, and option 5 from the commands menu, as shown in Figure 80 on page 165, the automation table statement selection panel will be displayed as illustrated in Figure 81 on page 165.
164
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
EZLKATBC AUTOMATION TABLE SEL POS NAME / 1 AOFMSG01 _ 2 AOFTST02 _ 3 AOFTST01 _ 4 DSITBL99
AUTOMATION TABLE MANAGEMENT Enter any character in the selection fields ................................................... : COMMANDS (Choose a highlighted command option) : : : : 5 1 -ENABLE the selected tables : : 2 -DISABLE the selected tables : : 3 -RELOAD the selected tables : : 4 -TEST the selected tables : : 5 -ENABLE/DISABLE parts of the : : selected tables : : 6 -UNLOAD selected tables : : 7 -INSERT a table : : 8 -DISPLAY options : : : : Enter=Execute Command F3 or F12=Cancel : :.................................................:
F6=Roll F12=Cancel
AUTOMAN defines various function keys for every range, for example, group, block and statement as displayed in Figure 81.
EZLKENDI
More: - +
AUTOMATION TABLE (Place cursor on statement and select action) MEMBER LVL STATEMENT AOFMSG01 001 ALWAYS SYSLOG(N) NETLOG(Y) DISPLAY(Y) CONTINUE(Y); AOFMSG01 001 IF MCSFLAG(6) = '1' THEN BEGIN; AOFMSG01 002 IF SYSID='SC66' & MSGID = 'AOF' . THEN DISPLAY(N) NETLOG(N); AOFMSG01 002 IF TASK='PPT' & MSGID = 'AOF' . THEN DISPLAY(N) NETLOG(N); AOFMSG01 002 IF ATTENDED='1' & DISTAUTO='0' & AUTOTASK='1' THEN DISPLAY(N) AOFMSG01 002 NETLOG(N); AOFMSG01 002 IF MSGID = 'AOF' . & IFRAUSDR = 'SC66ASIR' THEN DISPLAY(Y) AOFMSG01 002 NETLOG(N); AOFMSG01 002 IF IFRAUSDR='SC66ASIR' THEN DISPLAY(Y) NETLOG(Y); AOFMSG01 002 END; ******** 001 START OF AOFMSGGW AOFMSGGW 001 IF MSGID = 'GWREQ' THEN DISPLAY(Y) NETLOG(N) SYSLOG(N); AOFMSGGW 001 IF MSGID = 'ROUTE' THEN DISPLAY(Y) NETLOG(Y) SYSLOG(N); Command ===> F1=Help F2=Main Menu F3=Return F4=Enable F5=Display Group/Block F6=Roll F7=Backward F8=Forward F9=Disable Stmt/Member F10=Disable Block F11=Disable Group F12=Results Figure 81. Enable/Disable Selection panel
165
Select the appropriate group, block, or statement within the automation table, and press the specific function key to enable or disable the selected area. For example, to disable a statement, place the cursor onto the prefix of that statement and press PF9, which will change the color of that statement. The following message will be displayed indicating that the action has completed successfully:
EZL919I ALL ACTIONS SUCCESSFULLY COMPLETED
166
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
than all IF-THEN and ALWAYS statements to be scanned. If each message class has its own unique BEGIN/END section, placing ALWAYS statements as the last ones in a section prevents the automation table from being scanned further if no automation table match was found. The following screen in Figure 82 is a simple example of IF-THEN, BEGIN/END, ALWAYS usage:
IF MSGID = 'AOFDATA:' THEN BEGIN; IF ATF('DSICGLOB AOF.RPC.0DEBUG') = 'Y' THEN DISPLAY(Y) NETLOG(Y); ALWAYS DISPLAY(Y) NETLOG(N); END;
Another design criteria of building the automation table structure is the frequency of use of specific statements or blocks. Order the BEGIN/END sections according to their frequency of use to eliminate frequently appearing messages to pass long lists of statements before final matches occur.
Note
The less criteria statements to be scanned before a match occurs, the better the overall performance of the system and its automation. For example, if a large number of VTAM messages are received, a BEGIN/END section to handle IST messages should be at or near the top of the automation table to decrease the number of statements that must be evaluated before the correct BEGIN/END section is found.
Note
Use the AUTOCNT command to determine the usage of automation table statements and find out what statements are more frequently used than others. Refer to the Tivoli Netview for OS/390 Tuning Guide, SC31-8240, for further information about the AUTOCNT command. The following screen in Figure 83 on page 168 illustrates the summary output result of the AUTOCNT command.
167
NCCF Tivoli NetView SC66A GUIMARA 12/09/99 16:18:42 * SC66A AUTOCNT REPORT=MSG,STATS=SUMMARY,DISPLAY ' SC66A DWO801I AUTOMATION TABLE MSG SUMMARY REPORT BY GUIMARA -----------( AOFMSG01/******** MESSAGE SUMMARY 12/09/99 16:18:42 )-----------AUTO1 COMPLETED INSERT FOR TABLE #1: AOFMSG01 AT 12/07/99 16:45:47 STATISTICS STARTED = 12/07/99 16:45:47 TOTAL MSGS PROCESSED = 17535 MSGS MATCHED = 17535 MSGS RESULTING IN COMMANDS = 176 TOTAL COMMANDS EXECUTED = 194 TOTAL ROUTES EXECUTED = 0 AVERAGE COMPARES/MSG = 34.38 AVERAGE MSGS/MINUTE = 6 MINUTES ELAPSED = 2852 Figure 83. AUTOCNT command summary results
7.2.1.2 Other automation table design guidelines The following considerations for designing the automation table structure help to reduce processing overhead and enhance automation performance: Use IF-THEN statements and ALWAYS statements to specify that no action should be performed, thus eliminating unnecessary processing time. Use the ASSIGN command to split the messages among several autotasks. This will prevent automation performance bottlenecks due to a high number of unsolicited messages queueing for processing on one single autotask. Eliminate simple command procedures (REXX clists) whose function can be processed in the automation table directly. The invocation of the clist and its interpretation takes longer than direct processing from the automation table.
168
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
should be considered for automation or to those that are needed for display purposes. On OS/390 systems, the MPFLSTxx member of SYS1.PARMLIB identifies whether a message is eligible for automation processing. Specify AUTO(YES) or AUTO(NO) to identify whether a message is eligible for automation processing. Optimize the VSAM CISIZE and DSIZVLSR (LSR/DFR) buffer settings. Use the VSAMPOOL command to check the buffer usage, and: - Save main storage by removing buffers that were never used. - Reduce the number/size of infrequently used buffers. - For index buffers that are frequently used, the number of buffer finds (BFRFND) should be at least 10-20 times the number of buffers reads (BUFRDS). It may be necessary to increase the number of buffers to achieve this ratio. - For data buffers that are frequently used, the number of buffer finds should be greater than the number of buffer reads. Use the improved MEMSTORE command to ensure that frequently used clists are loaded in storage for faster access and reduced disk I/O. The MEMSTORE command should be run periodically from the same task, preferably an autotask. The MEMSTORE command obtains a list of members that have been read very often from disk and loads these members into storage specified by the command. If necessary, members with low disk I/O, but previously being loaded into storage by this task, will be unloaded. Use the IDLEOFF command to examines operator idle times and stop them after a defined period of time. Idle time is defined as the time since new input was provided by the task owner. Figure 84 on page 170 shows how to use the MEMSTORE and IDLEOFF commands in the NetView initialization clist CNME1034.
Note
To start automatically the MEMSTORE and IDLEOFF features, uncomment these statements in the CNME1034 NetView initialization clist.
169
/* If you wish to run MEMSTORE to keep high-use PDS members in storage instead of on disk, modify and uncomment the following lines. For more information enter HELP MEMSTORE and/or refer to to the commentary in CNME1054. /* 'PIPE CC AUTOTASK OPID=memstask | CONS' */ /* 'OVERRIDE MAXIO=0,TASK=memstask' */ 'EVERY 00:02:00 ROUTE=AUTO1 EVERYCON=YES MEMSTORE 5% 5' /* If you wish to run IDLEOFF to log off idle operators, modify and uncomment the following line. For more information enter HELP IDLEOFF and/or refer to the commentary in CNME1057. 'IDLEOFF INIT AUTO1 60 10' Figure 84. MEMSTORE and IDLEOFF statements in the CNME1034 Clist
*/
*/
170
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
For example, automate TSO and TCPIP with a generic class, since TSO and TCPIP have very similar common policies, including the unique parent application VTAM, start-up, and shutdown behaviors. Define this generic application class with all the common policies, and associate this application class to TSO and TCPIP. In a sysplex policy database, the usage of clone names and symbolics is very important for the applications to be able to run on the multiple systems within the sysplex environment. A thoughtfully designed and optimized System Automation policy database will tremendously reduce the overall maintenance effort.
171
where <dsname> represents the policy dataset name. Use the PERMIT command to grant userids to alter the policy database:
PERMIT <dsname> ID(<userid>) ACCESS(ALTER)
where <dsname> represents the policy dataset name and <userid> the System Automation administrator.
172
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
7.3.7 ACFPLOAD
The ACFPLOAD command allows changes to be made to the automation configuration policy without reloading the entire ACF or interrupting the automation processing. For ACFPLOAD command usage, the user needs to know the specific member name of the configuration data to be loaded. This can be done from the NetView command interface, NCCF, by browsing the AOFACFMP member to determine the current configuration file. With ACFPLOAD, local modifications can be accomplished without the need to recycle the entire ACF.
173
174
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Refer to the Tivoli NetView for OS/390 Automation Guide, SC31-8225, for full details of automation table statement syntax.
175
* * THIS RESPONSE TO MVS D A,NPM SHOWS IT NEEDS STARTING * *IEE115I 16.38.52 1999.347 ACTIVITY 908 * JOBS M/S TS USERS SYSAS INITS ACTIVE/MAX VTAM *00007 00050 00003 00030 00055 00003/00050 *NPM NOT FOUND * IF MSGID='IEE115I' & ACQUIRE('LINENUM 4 WORD 2.2') = 'NOT FOUND' & ACQUIRE('LINENUM 4 WORD 1') = 'NPM' THEN EXEC(CMD('MVS S NPM'));
OAS 00026
* * Example of substrings in TOKEN * * Output from DIS command if invalid resource is specified : * EG. DIS BILL * IST453I ID PARAMETER VALUE USIBMSC.BILL NOT VALID * IF MSGID='IST453I' & TOKEN(5 3 3) = 'IBM' & TOKEN(5 1 7) = NETWORK & TOKEN(5 9) = RES THEN EXEC(CMD('MSG ALL RESOURCE 'NETWORK'.'RES' IS INVALID') ROUTE(ONE *)); * Figure 86. Automation table IF-THEN substrings
176
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
NCCF Tivoli NetView SC69N NETOP1 12/14/99 14:50:28 C SC69N DISPLAY NET,ID=BILL,SCOPE=ALL SC69N IST453I ID PARAMETER VALUE USIBMSC.BILL NOT VALID - SC69N DSI001I MESSAGE SENT TO ALL M SC69N DSI039I MSG FROM NETOP1 : RESOURCE USIBMSC.BILL IS INVALID ------------------------------------------------------------------------------Figure 87. Output from DIS command exploiting IF-THEN substrings
* * Example of greater and less than numeric comparison and current time * * IF MSGID='DSI123I' THEN BEGIN; IF CURRTIME(1 2) >= '08' & IF CURRTIME(1 2) <= '17' THEN EXEC(CMD('DAYSHFTC')); ALWAYS EXEC(CMD('OFFSHFTC')); END; *
177
* * Example of variable usage * IF MSGID='IST453I' & TOKEN(5 6 2) = NETSUFF & TOKEN(5 1 7) = 'USIBM'VALUE(NETSUFF) & TOKEN(5 1 7) = NTWK & TOKEN(5 9) = RES & ATF('DSICGLOB MYVAR.'VALUE(NTWK)'.'VALUE(RES)'.ADD.TEXT') = 'YES' THEN EDIT('COPY * /REISSUE DIS COMMAND SPECIFYING A VALID RESOURCE'); * Figure 89. Example of variable value function support
the following output is displayed (Figure 90) showing that the condition in the automation table was all true and that the COPY command was issued.
NCCF Tivoli NetView SC69N NETOP1 12/14/99 15:43:09 C SC69N DISPLAY NET,ID=FRED,SCOPE=ALL SC69N IST453I ID PARAMETER VALUE USIBMSC.FRED NOT VALID REISSUE DIS COMMAND SPECIFYING A VALID RESOURCE ------------------------------------------------------------------------------Figure 90. Output from DIS command exploiting automation table variables
178
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
* SC69N - SC69N
Figure 91. Output from REFRESH OPERS command before EDIT action
* * Example of EDIT action * IF MSGID='DSI213I' THEN EDIT('COPY * /CALL USER SUPPORT AT 91-123456/'); * Figure 92. Automation table EDIT action statements
* SC69N REFRESH OPERS - SC69N DSI213I ACCESS TO 'REFRESH' IS NOT AUTHORIZED CALL USER SUPPORT AT 91-123456 Figure 93. Output from REFRESH OPERS command after EDIT action
The BNH370I message is issued to the console. Logic can be included in the automation table to direct it to the NetView log if desired. Do not specify a TRACE action for BNH370I, as this will cause a loop.
An example of an automation table TRACE statement and the console output is shown in Figure 94 and Figure 95 on page 180.
* * Example of automation table tracing * IF MSGID='DSI820I' THEN TRACE('DSI820trace'); * Figure 94. Automation table TRACE statement
179
BNH370I FAIL DSI820Trace BNH370I FAIL DSI820Trace BNH370I FAIL DSI820Trace BNH370I FAIL DSI820Trace
DSITBL01 DSITBL01 01440002 DSITBL01 DSITBL01 01440002 DSITBL01 DSITBL01 01570002 DSITBL01 DSITBL01 01570002
* AUTOMATED function examples: * * This sets the AUTOMATED indicator to N (NO) * IF MSGID='IST' . THEN SYSLOG(Y) NETLOG(Y) AUTOMATED(N) CONTINUE(Y); * * This checks the AUTOMATED indicator * * If a VTAM message has already been automated turn it BLUE, * Unautomated messages turn YELLOW * IF MSGID='IST' . THEN BEGIN; IF AUTOMATED = '1' THEN COLOR(BLU); ALWAYS COLOR(YEL); END; * Figure 96. Examples of AUTOMATED function
180
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Refer to System Automation for OS/390 V1R3M0 Customization, GC28-1566, for further information about triggers, service periods, and events. 8.2.1.1 Sequential start-up of focal point subsystems The following example details the subsequent start-up logic of the RODM and GMFHS on the networking focal point system. It implies the following rules: 1. The NETWORK_RODM job is always cold-started. 2. The NETWORK_RODM_DM job is a transient job that loads the data models into RODM. 3. The NETWORK_GMFHS job will not start until the RODM data model structures are loaded successfully into RODM. To define the subsequent logic and rules for these three start-up actions, it is necessary to define appropriate messages in the NETWORK_RODM subsystem that will be used as a trigger to start the NETWORK_RODM_DM job when the RODM subsystem is started successfully. Enter the System Automation policy database dialog, as shown in Figure 97 on page 182, and select the 6 - Application option.
181
SA OS/390 Entry Entry Selection SA OS/390 Type Type Selection Command ===> 6 Command ===> 6 PolicyDB Name Name : ITSO_ENTERPRISE PolicyDB : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Resource Definitions Enterprise Resource Definitions Resource Policy Definitions Resource Policy Definitions More: More: + 1 Enterprise ( ENT ( ENT ) 30 Timers ) ( TMR ( TMR ) ) 1 Enterprise 30 Timers 2 Group Group ( GRP ( GRP ) 31 Timeout Settings ) ( ) 2 31 Timeout Settings TMO ( TMO ) 3 SubGroup ( SBG ( SBG ) 32 Tape Attendance ) ) 3 SubGroup 32 Tape Attendance ( TPA ( TPA ) 4 System ( SYS ( SYS ) 33 MVS Component ) ) 4 System 33 MVS Component ( MVC ( MVC ) 5 ApplicationGroup ( ) ( ) 5 ApplicationGroup APG ( APG ) 34 MVSCOMP Defaults 34 MVSCOMP Defaults MDF ( MDF ) 6 Application (*) ( APL ( APL ) 35 System Defaults ) 6 Application (*) ) 35 System Defaults ( SDF ( SDF ) 7 VolumeGroup ( VLG ( VLG ) 36 Application Defaults ( ADF ( ADF ) ) 7 VolumeGroup 36 Application Defaults ) 8 Volume ( VOL ( VOL ) 37 Auto Operators ) ) 8 Volume 37 Auto Operators ( AOP ( AOP ) 9 OperatorView ( OPV ( OPV ) 38 Auto Msg Classes ) ( ) 9 OperatorView 38 Auto Msg Classes AMC ( AMC ) 10 Processor ( PRO ( PRO ) 39 Network ) ( NTW ( NTW ) ) 10 Processor 39 Network 11 Communications Path Path ( CMP ) 40 NNT Sessions ( NNT ( NNT ) ) 11 Communications ( CMP ) 40 NNT Sessions 41 Resident CLISTs ) 41 Resident CLISTs ( RES ( RES ) Figure 97. SA OS/390 Entry Type Selection panel
In the Application Entry Selection panel, select the desired application, which, in this example, is NETWORK_RODM as shown in Figure 98.
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE C Short Description * NetView Defaults Automation NetView definition NetView subsystem interface Network GMFHS Network NetView Network NetView Interface Network RODM Processor Operations functions * RODM Defaults System Automation GMFHS System Automation NetView System Automation NetView Interface
Action
Entry Name NETVIEW_CLASS NETVSA NETVSSI NETWORK_GMFHS NETWORK_NETVIEW NETWORK_NETVIEW_SSI NETWORK_RODM PROCESSOR_OPERATIONS RODM_CLASS SAOS390_GMFHS SAOS390_NETVIEW SAOS390_NETVIEW_SSI
This selection will bring up the Application Policy Selection panel for NETWORK_RODM as illustrated in Figure 99 on page 183.
182
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : NETWORK_RODM Action Policy Name DESCRIPTION LINK TO CLASS APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Policy Description Enter description Link instance to class Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags
Select the MESSAGES option and press Enter to create a new message command. On the specific Message Processing panel, show in Figure 100, enter the Action keyword, CMD, and the Message ID, ACTIVE.
SA OS/390 Message Processing Command ===> Entry Type : Application Entry Name : NETWORK_RODM Resource: RODMAON
Enter messages issued by this resource that will result in automated actions. Actions: CMD = Command REP = Reply CODE = CODE Action CMD Message ID ACTIVE Description Cmd Rep Code
For the subsequent start-up of the NETWORK_RODM_DM application every time the NETWORK_RODM is restarted and identified as to be ACTIVE, it is required that you specify the appropriate System Automation action as shown in Figure 101 on page 184.
183
SA OS/390 CMD Processing Command ===> Entry Type : Application Entry Name : NETWORK_RODM Resource: RODMAON Message ID: ACTIVE
Enter commands to be executed when resource issues the selected message. Pass or Automated Selection Function Command Text SETSTATE NETWORK_RODM_DM,RESTART
This step finishes the dependency definition between the start-up of NETWORK_RODM and NETWORK_RODM_DM. The same definition steps have to be processed for the dependency of NETWORK_RODM_DM and the start of NETWORK_GMFHS. After all definition steps have been processed, it is required to rebuild the System Automation control file (ACF file) and recycle the NetView control file to have these changes become effective. 8.2.1.2 Sequential shutdown of focal point subsystems The following example details the subsequent shutdown logic of the Automation NetView. It implies the following rules: 1. The subsystem SAOS390_NETVIEW has the dependency to start and stop after the subsystem interface SAOS390_NETVIEW_SSI. 2. If all subsystems in the system environment are to be terminated, the SHUTSYS ALL command is being issued. The termination of the subsystem, SAOS390_NETVIEW, has to be delayed until all other applications, including SAOS390_NETVIEW_SSI, have successfully terminated. To define the subsequent logic and rules for these shutdown actions it is necessary to define an appropriate event and trigger for the SAOS390_NETVIEW_SSI subsystem that will be used to shutdown the SAOS390_NETVIEW application.
184
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Enter the System Automation policy database dialog and select the EVT or 44 (Events) option as shown in Figure 102 on page 185.
SA OS/390 Entry Type Selection Command ===> 44 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Resource Definitions 8 9 10 11 Volume OperatorView Processor Communications Path ( ( ( ( VOL OPV PRO CMP ) ) ) ) Resource Policy Definitions More: 37 Auto Operators ( AOP ) 38 Auto Msg Classes ( AMC ) 39 Network ( NTW ) 40 NNT Sessions ( NNT ) 41 Resident CLISTs ( RES ) 42 Status Details ( SCR ) 43 Communications Task ( CMT ) 44 Events ( EVT ) 45 Service periods ( SVP ) 46 Triggers ( TRG ) 98 Includes ( ICL )
- +
(*) Multi-User-Capable
In the Event Entry Selection panel, create a new event by entering the NEW command in the command line as shown in Figure 103.
Action
Entry Name C Short Description JES_DOWN JES2 is DOWN ******************************* Bottom of data ******************************** Figure 103. SA OS/390 Event Entry Selection panel
Define the new event by entering the name, SSI_DOWN, and a short description of its content as shown in Figure 104 on page 186.
185
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type. . . . . . . . . . Event Name. . . . . . . . . . SSI_DOWN Unset Condition . . . . NONE Short Description . . Extended Description. . . . . DOWN NONE START UP
Having defined this new event, it is required to define the corresponding trigger that is driven by the new event. This trigger will then initiate the shutdown of the SAOS390_NETVIEW application. Return to the System Automation policy database dialog and select the TRG or 46 (Triggers) option as shown in Figure 105.
SA OS/390 Entry Type Selection Command ===> 46 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Resource Definitions 9 OperatorView ( OPV ) 10 Processor ( PRO ) 11 Communications Path ( CMP ) (*) Multi-User-Capable Resource Policy Definitions More: 38 Auto Msg Classes ( AMC ) 39 Network ( NTW ) 40 NNT Sessions ( NNT ) 41 Resident CLISTs ( RES ) 42 Status Details ( SCR ) 43 Communications Task ( CMT ) 44 Events ( EVT ) 45 Service periods ( SVP ) 46 Triggers ( TRG ) 98 Includes ( ICL ) 99 User E-T Pairs ( UET )
- +
In the Trigger Entry Selection panel, create a new trigger by entering the NEW command in the command line as shown in Figure 106 on page 187.
186
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Define the new trigger by entering the name, SHUT_NV, and a short description of its content as shown in Figure 107.
SA OS/390 Define New Entry Command ===> To define a new entry, specify the following information: Type. . . . . . . . . . Trigger Name. . . . . . . . . . SHUT_NV Short Description . . Extended Description. . . . . . Shut down SA OS/390 NetView . . . . .
Having defined the new trigger, it is required to define the condition that will drive this new trigger. Select the CONDITION option as shown in Figure 108 on page 188, and continue with the trigger settings.
187
SA OS/390 Policy Selection Command ===> Entry Type : Trigger Entry Name : SHUT_NV Action
Policy Name Policy Description DESCRIPTION Enter description S CONDITION Define the trigger condition -------------------- --------------------------------------------WHERE USED List Applications using this entry COPY Copy data from existing entry ******************************* Bottom of data ********************************
From the Trigger Selection panel, shown in Figure 109, select one of the SHUTDOWN conditions available.
SA OS/390 Trigger Conditions Command ===> Entry Type : Trigger Entry Name : SHUT_NV
Note: You have to define the service period before you can use it in a STARTUP/SHUTDOWN condition. Action S Condition STARTUP 10 SHUTDOWN 1 SHUTDOWN 2 SHUTDOWN 3 SHUTDOWN 4 SHUTDOWN 5 SHUTDOWN 6 SHUTDOWN 7 SHUTDOWN 8 SHUTDOWN 9 Names
The next step is to associate the SHUTDOWN trigger condition with the appropriate event that will drive this trigger.
188
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 SHUTDOWN Condition for Trigger Command ===> Entry Type : Trigger Entry Name : SHUT_NV Description. . . . Service Period . . NO Action Status YES NO
Event Short Description JES_DOWN JES2 is DOWN S SSI_DOWN SA OS390 NetView SSI is DOWN ******************************* Bottom of data ********************************
On the SHUTDOWN Condition for Trigger panel in Figure 110 on page 189, select the previously defined event, SSI_DOWN. The next step is to associate the SHUTDOWN trigger to an application, which, in this example, will be the Automation NetView SAOS390_NETVIEW. Return to the SA OS/390 Entry Selection Main panel and select APL or 6 (Applications) to enter the Application Selection panel as shown in Figure 111.
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE C Short Description JES2 policy definition LLA automation policy * NetView Defaults Network GMFHS Network NetView Network NetView Interface Network RODM Processor Operations functions * RODM Defaults System Automation GMFHS System Automation NetView System Automation NetView Interface RODM automation policy
Action
Entry Name JES2 LLA NETVIEW_CLASS NETWORK_GMFHS NETWORK_NETVIEW NETWORK_NETVIEW_SSI NETWORK_RODM PROCESSOR_OPERATIONS RODM_CLASS SAOS390_GMFHS SAOS390_NETVIEW SAOS390_NETVIEW_SSI SAOS390_RODM
189
From the Application Selection panel, select the SAOS390_NETVIEW application and enter the TRIGGER option as demonstrated in Figure 112.
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW Action Policy Name APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES SYSTEM ASSOCIATION TRIGGER --------------------
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Policy Description Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags Define primary and secondary associations Select Application trigger ---------------------------------------------
SA OS/390 Trigger for Application Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW
These steps complete the definition of the SAOS390_NETVIEW application and the SHUT_NV trigger. The last steps of this example will be to associate the termination of the SAOS390_NETVIEW_SSI subsystem with the SSI_DOWN event. This association will set this event every time the NetView subsystem interface is set to the AUTODOWN status for termination.
190
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
To apply the association of the SSI_DOWN event to the SAOS390_NETVIEW_SSI application, enter the Application Selection panel as shown in Figure 114.
SA OS/390 Entry Selection Command ===> Entry Type : Application Row 9 to 21 of 26 SCROLL===> CSR
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE C Short Description JES2 policy definition LLA automation policy * NetView Defaults Network GMFHS Network NetView Network NetView Interface Network RODM Processor Operations functions * RODM Defaults System Automation GMFHS System Automation NetView System Automation NetView Interface RODM automation policy
Action
Entry Name JES2 LLA NETVIEW_CLASS NETWORK_GMFHS NETWORK_NETVIEW NETWORK_NETVIEW_SSI NETWORK_RODM PROCESSOR_OPERATIONS RODM_CLASS SAOS390_GMFHS SAOS390_NETVIEW SAOS390_NETVIEW_SSI SAOS390_RODM
Select SAOS390_NETVIEW_SSI to enter the Application Policy Selection panel as displayed in Figure 115.
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW_SSI Action Policy Name DESCRIPTION LINK TO CLASS APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES SYSTEM ASSOCIATION
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Policy Description Enter description Link instance to class Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags Define primary and secondary associations
191
In order to set or reset the SSI_DOWN event, first, select the MESSAGES option to create a new definition to set the event, and then select the RESTART option to reset this event when the subsystem is restarted. First, on the Message Processing panel, as shown in Figure 116, enter the Action keyword, CMD, and the Message ID keyword, AUTODOWN.
SA OS/390 Message Processing Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW_SSI Resource: SSISA
Enter messages issued by this resource that will result in automated actions. Actions: CMD = Command REP = Reply CODE = CODE Action CMD Message ID AUTODOWN Description Cmd Rep Code
that will set the SSI_DOWN event every time the SAOS390_NETVIEW_SSI application reaches the AUTODOWN status. This event, SSI_DOWN, will kick off the SHUT_NV trigger which was previously defined, that will be responsible shutdown the SAOS390_NETVIEW application.
SA OS/390 CMD Processing Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW_SSI Resource: SSISA Message ID: AUTODOWN
Enter commands to be executed when resource issues the selected message. Pass or Automated Selection Function Command Text _________ ________ SETEVENT ID=SSI_DOWN,FUNCTIN=SET,SCOPE=TARGET
192
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Now, return to the Application Policy Selection panel, as displayed in Figure 115 on page 191, and enter the RESTART option to enter the Restart Processing panel shown in Figure 118.
SA OS/390 RESTART Processing Command ===> Entry Type : Application Entry Name : SAOS390_NETVIEW_SSI
Subsystem : SSISA Description : System Automation NetView Interface Enter commands to be executed when NetView is started or recycled with this subsystem already active. Automated Function Command Text SETEVENT ID=SSI_DOWN,FUNCTION=UNSET,SCOPE=TARGET
that will reset the SSI_DOWN event every time the SAOS390_NETVIEW_SSI application is successfully restarted.
To automate a message using the System Automation framework, this message needs to be issued by an application previously defined to SA OS/390. The routine actions that a system operator performs when a particular message is generated can be automated by the NetView automation table and the System Automation. With automation enabled, the automation focal point system responds quickly and accurately to messages from any active target systems.
193
8.2.2.1 Automating the response to the message The first step is to define the type of response that will be performed when messages appear. This can be to issue a reply, a command, or define a match code to be tested in the message. To get one application class, NETVIEW_CLASS, defined for both the Automation and Network NetView, it is necessary to define a identification code in all issued messages to identify the corresponding application associated to this class. If matches occur, an action keyword will be returned to the invoking automation system.
Note
For detailed information about System Automation class definitions refer to Chapter 5, Customization of System Automation for OS/390 on page 53. Defining this message in an application class ensures that this automation definition will be inherited by all the application instances associated with this application class. From the System Automation Main Entry Selection panel, select the APL or 6 (Application) option to enter the Application Selection panel. Select the application class, NETVIEW_CLASS, and the Application Policy Selection panel for NETVIEW_CLASS will be shown as in Figure 119 on page 195.
194
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Action Policy Name DESCRIPTION LINK TO INSTANCES APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES TRIGGER
PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Policy Description Enter description Link class to instances Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags Select Application trigger
From the Application Policy Selection panel, select the MESSAGES option to specify message types for this application class. On the Message Processing panel, displayed in Figure 120, specify the Action keyword, CODE, the Message ID keyword, WTORS, and a short description of the action the response performs.
SA OS/390 Message Processing Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Resource: NETVIEW_CL
Enter messages issued by this resource that will result in automated actions. Actions: CMD = Command REP = Reply CODE = CODE Action CODE Message ID WTORS Description WTOR Classification Cmd Rep Code 3
The following panel defines how messages DSI802A and DSI803A (NetView replies) will be handled when they are received from the subsystems associated with this class.
195
When the DSI802A message appears with any code, a value of NORMAL PRI is returned to the calling automation procedure. In addition, this message will be displayed like a normal status message, for example, in the SDF panels. Any other replies issued for these subsystems will be displayed in the SDF panels as an unusual message.
SA OS/390 Code Processing Command ===> Entry Type : Application Entry Name : NETVIEW_CLASS Resource: NETVIEW_CL Message ID: WTORS
Enter the value to be passed to the calling CLIST when this resource issues the selected message and the following codes are contained in the message. Code 1 DSI802A DSI803A * Code 2 * * Code 3 Value Returned NORMAL PRI UNUSUAL PRI UNUSUAL SEC
After these definitions, verify the message processing facility (MPF) table to assure that the default for this message is AUTO(YES). If required, add a message processing facility list entry specifying the message ID and the AUTO(YES) parameter value. When definitions to add message response and automation operator information to the automation policy database are completed, return to the SA OS/390 Application Selection panel and enter the action command F (BUILDF) in the action column in front of the application that has been edited. This will initiate a rebuild for the application definitions. System Automation for OS/390 builds the new automation definitions for the application, and after completion of this application rebuild, the System Automation customization dialog can be exited. The System Automation for OS/390 build function will place the new automation definitions in the data set defined in the BUILDF Parameters panel.
196
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Copy the new automation definitions into the common Automation NetView DSIPARM library specified in the Automation NetView start-up procedure and reload the NetView Control File. Refer to System Automation for OS/390 V1R3M0 Customization, GC28-1566, for detailed information on how to add messages to the automation.
This notice is a reminder that the CNME1035 clist is no longer used by Tivoli NetView for OS/390 V1R3 as the initial NetView PPT start-up clist. Please check for any self-written customizations and move appropriate modifications to the new NetView PPT start-up CNME1034 clist. The main guidelines for keeping the automation environment reliable and simple are as follows: Automate close to the source In a multi-system environment, automate as many tasks as possible on the distributed systems and forward only those events that cannot be handled at the distributed systems to the focal point system. At the distributed system, if the function of the operating system facility (the message processing facility - MPF) enables the goals for the system to be met without using the automation table, use the appropriate operating system function. Otherwise, use NetView and System Automation facilities. Define autotasks consistently
197
Operator definitions for autotasks in DSIOPF or an SAF product, profiles, and operator passwords should be consistent across systems. Consistent definitions reduce the effort required to make changes among systems. Develop generic automation command procedures To minimize the work required for development, maintenance, and synchronization of automation procedures for multiple systems, write generic procedures to function the same in all applicable systems. These procedures should also function on the focal point system when the system is not performing focal point functions. To simplify migration, use global variables for system and resource names rather than hard-coded resource names in command procedures. By keeping the definition setup for the global variable in only a few procedures, it is then possible to migrate the same set of automated procedures to multiple systems and customize only a few procedures on each system. Automation table usage For individual automation it is advised to never code statements directly in main automation table members, and either concatenate a new automation table member or use %INCLUDE in the existing automation table structure to allow easier release migration as well as LPAR to LPAR migration. Log intrasystem automation Intrasystem automation that occurs in each system should be logged in the local automation log. Messages and alerts that are forwarded to a focal point should be logged at both the distributed system and the focal point. It is a good practice to have all procedures driven by automation identifiable, for example, by name, within the log. The sample set for automation has each command list write a message to the log that is preceded by a less-than sign (<). A quick glance at the log enables the operator to know whether automation has performed some action. These indicators provide an audit trail for automation and can also assist in problem determination in the event of an automation failure.
198
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Note
If you plan to use SMTP for sending e-mails from a NetView operator console, SMTP must be active, and the EZLJSMTP sample must be installed and customized. EZLJSMTP provides sample JCL used to issue SMTP commands and must be customized to specify your SMTP address space name. The sample EZLJSMTP should be copied from the CNMSAMP data set into your NetView DSIPARM library.
199
The clist reads operator entered text, builds SMTP e-mail commands, puts the complete data stream in a PIPE safe, and calls the provided clist module, EZLESSMT, to send the e-mail. EZLKMAIL - A full screen panel used by EZLEMAIL. EZLESSMT - A REXX clist that builds and submits a job to send the e-mail. EZLJSMTP - Sample JCL job that sends the e-mail. This job needs to be customized for the SMTP job name (Figure 122). EZLESMTP - A REXX clist that sends e-mail based on the Inform policy. This sample clist allows one line e-mails to be sent.
//EZLJSMTP JOB (999,AUS),'NVSMTP',CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1), // REGION=0M,TIME=1440 //*************************************************************** //* * //* Licensed Materials - Property of Tivoli Systems * //* 5697-B82 (C) Copyright Tivoli Systems 1999 * //* All rights reserved. * //* * //* DISTRIBUTED AS MEMBER: EZLJSMTP * //* DESCRIPTION: Sample JCL to allow E-mail to be issued via * //* SMTP. This code will be read by command lists* //* in NetView which will insert the commands to * //* be passed to SMTP. * //*************************************************************** //IEBGENER EXEC PGM=IEBGENER //SYSIN DD DUMMY //SYSUT1 DD * /* //*************************************************************** //* Change smtp below to the SMTP address space name. * //* Change B to the desired SYSOUT class * //*************************************************************** //SYSUT2 DD SYSOUT=(B,SMTP), // DCB=(LRECL=80,BLKSIZE=80,RECFM=F,DSORG=PS) //SYSOUT DD SYSOUT=A //SYSPRINT DD SYSOUT=A Figure 122. Sample JCL Job EZLJSMTP
200
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
on the NetView NCCF interface. A skeleton email form will be displayed, which is then completed as shown in Figure 123:
After the e-mail text is complete, pressing PF9 or PF5 will submit an EZLJSMTP batch job to send the e-mail. The e-mail, for example, received in Lotus Notes, will appear as illustrated in Figure 124.
201
SMTP can only send e-mail. It does not provide pager support. The AON Inform policy requires little customization to send SMTP e-mail. An example of a customized AON Inform policy item is shown in Figure 125 on page 203.
202
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
* * POLICY for CHIEF * * The Chief is available weekdays 9 - 5 * INFORM CHIEF; CONTACT TO 17:00, SP=DUMMY, CONNECTION=EMAIL, ROUTE=CLINTONB@US.IBM.COM, INTERFACE=EZLESMTP, NAME=BILL CLINTON; * Figure 125. AON Inform policy item customized for SMTP e-mail
* * * * *
An example of a REXX clist using the provided clist module EZLESSMT is shown in Figure 126.
203
/* REXX /* -----------------------------------------------------------------/* /* REXX TO SEND AN EMAIL USING EZLESSMT /* /* ARGS PASSED : /* EMADDR - THE EMAIL ADDRESS /* /* -----------------------------------------------------------------Trace r ARG emaddr
*/ */ */ */ */ */ */ */ */
mail.1 = "Hello SMTP" mail.2 = "Mail from: <"opid()"@"cursys()">" mail.3 = "Rcpt to:<"emaddr">" mail.4 = "Data" mail.5 = "Date: "date('n')" "time() mail.6 = "From: "opid()" - NetView Domain "domain()" - "cursys() mail.7 = "To: "emaddr mail.8 = "Subject: Email using EZLESSMT" mail.9 = "This email was sent from NetView V1R3 using the SMTP email" mail.10 = "gateway. It called EZLESSMT - a supplied sample REXX exec" mail.11 = "." mail.12 = "QUIT" mail.0 = 12 'PIPE STEM MAIL. | SAFE MAILSAFE' 'EZLESSMT MAILSAFE RTRNSAFE' r_code = rc If r_code = 0 then text= 'EMAIL sent ok' else text= 'EMAIL failed with rc = 'r_code 'PIPE LIT /'text'/ | CONS' Exit
204
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The focal point root name must match the SYSNAME value defined in the automation policy. This value is specified in the customization dialog.
Note
The SYSNAME for each system under System Automation for OS/390 control must be the same as the system name under which the system was IPLed. For a target system SDF status update to occur on a focal point SDF, System Automation for OS/390 focal point services must already be implemented. Because each root name must be unique in a multi system environment, any status component on any system defined to the focal point SDF can be uniquely addressed by prefixing the status component with the root component name:
ROOT_COMPONENT.STATUS_COMPONENT
For example:
SC66.JES2
Similarly, any SDF status descriptors forwarded from the target system to the focal point SDF are prefixed with the root name of the target system by System Automation for OS/390 routines. To define message forwarding paths between different systems, the following features should be defined in System Automation: Primary focal point Backup focal-point (if required) Target systems Gateway sessions (between connected systems) In addition to these definitions, it is necessary to modify some definitions in the DSIOPF and DSIDMN members in the DSIPARM library.
205
The following steps will describe the process to customize the focal point services in the System Automation process. For further information, refer to Chapter 9, "Automating Networks" of System Automation for OS/390 V1R3 Customization, GC28-1566. The first step is to define the outbound gateway autotasks that will be responsible in establishing and maintaining all connections to other systems. It is their function to send messages, commands, and responses to one or more systems. 9.2.1.1 Defining the outbound gateway autotasks From the System Automation Entry Type Selection, shown in Figure 127 on page 206, select the AOP or 37 (Auto Operators) option to enter the Auto Operator Entry Selection panel displayed in Figure 128 on page 207.
SA OS/390 Entry Type Selection Command ===> 37 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Resource Definitions 1 2 3 4 5 6 7 8 9 10 11 Enterprise Group SubGroup System ApplicationGroup Application (*) VolumeGroup Volume OperatorView Processor Communications Path ( ( ( ( ( ( ( ( ( ( ( ENT GRP SBG SYS APG APL VLG VOL OPV PRO CMP ) ) ) ) ) ) ) ) ) ) ) Resource Policy Definitions More: 30 Timers ( TMR ) 31 Timeout Settings ( TMO ) 32 Tape Attendance ( TPA ) 33 MVS Component ( MVC ) 34 MVSCOMP Defaults ( MDF ) 35 System Defaults ( SDF ) 36 Application Defaults ( ADF ) 37 Auto Operators ( AOP ) 38 Auto Msg Classes ( AMC ) 39 Network ( NTW ) 40 NNT Sessions ( NNT ) 41 Resident CLISTs ( RES )
Select, one after another, the focal system and the target systems auto operators that will be used in the automation environment.
206
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Entry Name C Short Description BACKUP_OPERS Backup FP specific auto opers BASE_AUTOOPS Default automation operators BASE_AUTOOPS_IO Automation operators with I/O monitoring S FOCAL_OPERS Focal point specific auto operators S TARGET1_OPERS Target1 specific auto opers S TARGET2_OPERS Target2 specific auto opers ******************************* Bottom of data ********************************
Action
F7=UP
F8=DOWN
F9=SWAP
F10=LEFT
F11=RIGHT
F12=RETRIEVE
First, start with the focal point system and select the FOCAL_OPERS option to enter the Auto Operator Policy Selection panel as shown in Figure 129.
SA OS/390 Policy Selection Command ===> Entry Type : Auto Operators Entry Name : FOCAL_OPERS Action
Policy Name Policy Description DESCRIPTION Enter description S OPERATORS Define automation operators -------------------- --------------------------------------------WHERE USED List Systems linked to this entry COPY Copy data from an existing entry ******************************* Bottom of data ********************************
From the Auto Operators Policy Selection panel, select the OPERATORS option to display the Automation Operator Definitions panel shown in Figure 130.
207
Automation Operator Definitions Command ===> Entry Type : Auto Operators Entry Name : FOCAL_OPERS
Actions: S = Select M = Move B = Before A = After I = Insert Automated Function Messages for this Operator (* notation ok) GATOPER
Action S
If GATOPER has not previously been defined, type the automation operator name, GATOPER, in the Automated Function field. It is not necessary to specify any messages for GATOPER. The Automation Operator NetView Userids panel is displayed automatically as illustrated in Figure 131. If GATOPER has previously been defined, then select it by entering an S in the ACTION column.
Automation Operator NetView Userids Command ===> Entry Type : Auto Operators Entry Name : FOCAL_OPERS Automated Function: GATOPER Messages assigned: Enter automation operators and NetView operator(s) to receive messages. Automation Operators Primary ==> GATSC66A Backup ==> NetView Operators ==> ==> ==> ==> ==> ==> PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
In the Automation Operator NetView Userids panel, enter the value for the autotask, which is in the ITSO project environment, the name GATSC66A, to define the outbound gateway autotask for system SC66.
208
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
To define the target outbound gateways autotasks, repeat the previous steps for all of the target systems. 9.2.1.2 Defining gateway sessions with other systems From the System Automation Entry Type Selection shown in Figure 132, select the NTW or 39 (Network) option to enter the Network Entry Selection panel displayed in Figure 133 on page 210.
SA OS/390 Entry Type Selection Command ===> 39 PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE Enterprise Resource Definitions 1 2 3 4 5 6 7 8 9 10 11 Enterprise Group SubGroup System ApplicationGroup Application (*) VolumeGroup Volume OperatorView Processor Communications Path ( ( ( ( ( ( ( ( ( ( ( ENT GRP SBG SYS APG APL VLG VOL OPV PRO CMP ) ) ) ) ) ) ) ) ) ) ) Resource Policy Definitions More: 30 Timers ( TMR ) 31 Timeout Settings ( TMO ) 32 Tape Attendance ( TPA ) 33 MVS Component ( MVC ) 34 MVSCOMP Defaults ( MDF ) 35 System Defaults ( SDF ) 36 Application Defaults ( ADF ) 37 Auto Operators ( AOP ) 38 Auto Msg Classes ( AMC ) 39 Network ( NTW ) 40 NNT Sessions ( NNT ) 41 Resident CLISTs ( RES )
The following steps will also be necessary for each of the target system after definitions for the focal point system are completed. From the Network Entry Selection panel, select the FOCAL_NETWORK option to enter the Network Policy Selection panel. On this Network Policy Selection panel, select the FORWARD option to display the Notification Forwarding panel shown in Figure 134 on page 210.
209
Action s
Entry Name C Short Description FOCAL_NETWORK Focal point network structure TARGET_NETWORK Target network structure ******************************* Bottom of data ********************************
SA OS/390 Notification Forwarding Command ===> Entry Type : Network Entry Name : FOCAL_NETWORK PolicyDB Name : ITSO_ENTERPRISE Enterprise Name : ITSO_ENTERPRISE
Enter the NetView domains for automation notification forwarding. Primary Domain ==> SC66A Backup Domain ==> Current Domain ID Backup Domain ID
Define the focal point domain and backup focal point domain. In the ITSO environment, only a primary focal point system was defined; however, it is recommended to define both primary focal point and backup focal point. The backup will be always used when the primary focal point becomes unavailable. This step is optional for the focal point definition because System Automation for OS/390 considers the current system as the primary focal point and displays messages without forwarding them. This will occur if the forward focal point is not defined in the automation policy for the system, or the system specified in a forward focal point definition is the current system. After completion of this step, continue to define the gateway sessions between the systems.
210
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Return to the Network Policy Selection panel, shown in Figure 135, and select the GATEWAY option.
SA OS/390 Policy Selection Command ===> Entry Type : Network Entry Name : FOCAL_NETWORK Action
Policy Name Policy Description DESCRIPTION Enter description ADJACENT NETVIEW Define adjacent NetView FORWARD Define forward focal point FULL SESSIONS Define TAF sessions (Applications) S GATEWAY Define gateways SAF ENVIRONMENT Define System Authorization Facility (SAF) -------------------- --------------------------------------------WHERE USED List Systems linked to this entry COPY Copy data from an existing entry ******************************* Bottom of data ********************************
The GATEWAY option will display the Gateway Definition panel illustrated in Figure 136.
SA OS/390 GATEWAY Definitions Command ===> Entry Type : Network Entry Name : FOCAL_NETWORK
Enter the following information for each NetView domain that commands or responses are forwarded to. Use RACFNNT as the password if SA OS/390 is to retrieve the password from RACF. Domain Password SC42A GATEWAY SC69A GATEWAY Logmode Description Gateway to target SC42 Gateway to target SC69
On the Gateway Definition panel for the focal point and the backup focal point systems, enter the target domains to which the gateways sessions will be established.
211
On the Gateway Definition panel for the target systems, enter the focal point domain and backup focal point domain. Put either a password for the gateway operator or the value, RACFNNT, in the password field. If RACFNNT is entered, it will enable the use of the SA OS/390 password facility (see Section 9.2.1.3, Considerations for the SA password protection feature on page 213). In the ITSO project, the password, GATEWAY, was chosen. After completion of this step, continue to define where the focal point and target definitions will be used. Return to the Network Policy Selection panel, shown in Figure 137, and select the WHERE USED option.
SA OS/390 Policy Selection Command ===> Entry Type : Network Entry Name : FOCAL_NETWORK Action
Policy Name Policy Description DESCRIPTION Enter description ADJACENT NETVIEW Define adjacent NetView FORWARD Define forward focal point FULL SESSIONS Define TAF sessions (Applications) GATEWAY Define gateways SAF ENVIRONMENT Define System Authorization Facility (SAF) -------------------- --------------------------------------------S WHERE USED List Systems linked to this entry COPY Copy data from an existing entry ******************************* Bottom of data ********************************
The following Where Used panel will be displayed for selection of the particular focal point system. In this example, SC66 is selected.
212
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 Where Used Command ===> Entry Type : Network Entry Name : FOCAL_NETWORK Action Status
Entry Name Entry Type SC42 SYS SELECTED SC66 SYS SC69 SYS ******************************* Bottom of data ********************************
After completion of these definition steps for the focal point, backup focal point, and all target systems, rebuild the SA Automation Control File (ACF) and modify the DSIOPF and DSIDMN members to include the correct gateway userids (autotasks) and RRD definitions. Refer the Appendix B, System Automation V1R3 members and jobs on page 233 for further information about the statements changed in these members. The last step is to recycle the NetView applications to reflect the new definitions and establish the gateways sessions. 9.2.1.3 Considerations for the SA password protection feature The System Automation password protection is an optional feature that allows System Automation to use a Security Authorization Facility (SAF) program, such as RACF or a functionally equivalent product, to manage gateway operator IDs and passwords. This feature is intended for systems that establish gateway sessions with two or more systems. System Automation password protection feature involves the System Automation password data set and the SAF program. The System Automation password data set contains only gateway operator ID and password entries. The SAF program manages all user IDs and their passwords, including gateway operator IDs and their passwords. Consider the following issues if planning to install the System Automation password protection feature: For an automation environment to use the System Automation password protection feature, all systems in the automation environment must install this feature.
213
A SAF program must be installed on all systems in the automation environment that are using the System Automation password protection feature. The number of gateway sessions each system in the automation environment establishes with other systems. Decide whether each system in the automation environment will have its own SAF product data set, or whether several systems will share one password data set. Refer to System Automation for OS/390 V1R3 Customization, GC28-1566, for more information about shared SAF data sets. For a detailed description of how to define the System Automation password protection feature, refer to Appendix 1.1.3 Installing the SA/MVS Password Protection Feature in System Automation for OS/390 V1R3 Planning and Installation, GC28-1549.
214
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
1. In the Automation NetView start-up procedure, check that the following dataset concatenations are uncommented:
-STEPLIB: // -DSICLD: // -CNMPNL1: // // DD DD DSN=&Q1..&DOMAIN..SEZLPNLU,DISP=SHR DSN=&SQ1..SEZLPNLU,DISP=SHR DD DSN=&SQ1..SEZLCLST,DISP=SHR DD DSN=&SQ1..SEZLLINK,DISP=SHR
2. Check that the following INCLUDE statement is uncommented in the DSICMDM member of DSIPARM library:
%INCLUDE EZLCMDI Note
Several AON functions, such as INFORM, AUTOMAN, TIMER, SMTP e-mail, and TCP/IP commands, can be run without other AON automation functions being active. The above steps will enable all of these functions. The AON TIMER functions and the SA/390 TIMER functions cannot run simultaneously in the same operating system environment. The default is the AON TIMER function. Refer to the Tivoli NetView for OS/390 Automated Operations Network Users Guide, GC31-8661, for further details. For further detailed compatibility information and the latest System Automation APAR for NetView V1R3 toleration refer to Appendix A, NetView 1.3 toleration for System Automation 1.3 on page 231.
215
Defines connection types and enables logging. INFORM Gives a label to an inform policy that consists of a contact or list of contacts. CONTACT Defines the criteria used to determine who is contacted and how. GROUP Specifies a list of policies that form a logical group. Refer to Chapter 4 in the Tivoli NetView for OS/390 Administration Reference, SC31-8222, for further coding and parameter details for the Inform policy statements. An example of AON Inform policy statements is shown in Figure 139 on page 217.
216
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
* Add a setup statement, to define other connection types and * enable logging. Specify log member name INFLOG, by default EZLIFLOG * would be used. * SETUP CONNECTIONS=FAX,LOG=YES,MEMBER=INFLOG; * GROUP NITEOPS,LIST=PERSONC; GROUP WEEKENDS,LIST=PERSONC,PERSOND; * * * POLICY for PERSONC * * PersonC is available every evening by EMAIL and additionally by * Pager on the weekends. * INFORM PERSONC,SP=SP000002; CONTACT TO 24:00, CONNECTION=EMAIL, INTERFACE=EZLESMTP, ROUTE=IBPERSC@VNET.IBM.COM, NAME=C. PERSON; CONTACT TO 24:00, CONNECTION=ALPHAPAGE,ROUTE=6127555,NAME=C. PERSON, INTERFACE=EZLENETF,TAPACCESS=918007596366; * * POLICY for PERSOND * * PersonD is always available on Weekends by Pager. * INFORM PERSOND,SP=SP000002; CONTACT CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=1231111, NAME=D. PERSON; Figure 139. Example of AON Inform policy statements
* * * * *
* * * * * *
* * * * *
(where EZLINSMP is the Inform policy member name) 2. From any NetView (running AON or SA), by issuing the following command at the NetView NCCF interface:
217
INFORMTB EZLINSMP
In a System Automation NetView, the AON control file will not be loaded, so method 2 must be used. This command could be issued from an AUTOTASK at System Automation control file load. The actual Inform policy is called by issuing the following INFORM command:
INFORM Policy_name Message
where - Policy_name: Either an Inform policy name or Inform group name - Message: The message to be sent The command can be issued from a NetView NCCF screen, a REXX clist, or called from the AON and System Automation control files.
218
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
- The Customer Service Manager via email 9.3.4.2 Definition and implementation process To implement the above scenario, the following steps need to be performed: a. Add the correct definitions to the System Automation control file and rebuild it. b. Reload the automation control file (ACF) within the System Automation NetView. c. Add the correct definitions to the Inform policy member. d. Load the Inform policy member into the System Automation NetView. 9.3.4.3 System Automation definitions DB2AMSTR is defined to the System Automation policy database as a regular application running on system SC42. To trigger the automatic inform processing, some additional definitions have to be performed in order to call the Inform policy when DB2AMSTR goes to BROKEN status. This is achieved by using the System Automation facility to trigger commands on status change. For detailed information, refer to Chapter 10, How Automation Routines Can Be Triggered in System Automation for OS/390 Customization, GC28-1566. For this example using Inform policies, return to the System Automation Entry Type Selection panel and select option APL or 6 (Application). On the Application Entry Type Selection panel, select the defined application, DB2AMSTR, to enter the Application Policy Selection panel as shown in Figure 140 on page 220.
219
SA OS/390 Policy Selection Command ===> Entry Type : Application Entry Name : DB2AMSTR Action Policy Name DESCRIPTION LINK TO CLASS APPLICATION INFO INFO BRIDGE RMF AUTOMATION INFO AUTOMATION FLAGS MESSAGES SHUTDOWN THRESHOLDS RESTART MINOR RESOURCES
PolicyDB Name : POLICY_DB Enterprise Name : ITSO_ENTERPRISE Policy Description Enter description Link instance to class Enter and display Application information Enter INFO Bridge resource name Enter RMF objectives and reporting criteria Define Application automation information Define Application automation flags Define Application messages Define shutdown procedures Define error thresholds Define commands executed at restart Define Application sub-component flags
Select the MESSAGES option to define specific message handling for DB2AMSTR. The Message Policy panel will be displayed as illustrated in Figure 141.
SA OS/390 Message Processing Command ===> Entry Type : Application Entry Name : DB2AMSTR Resource: DB2AMSTR
Enter messages issued by this resource that will result in automated actions. Actions: CMD = Command REP = Reply CODE = CODE Action CMD Message ID BROKEN Description Invoke callout Cmd Rep Code
In the Message Policy panel, enter the Action keyword CMD, the Message ID keyword BROKEN, and a short description.
220
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SA OS/390 CMD Processing Command ===> Entry Type : Application Entry Name : DB2AMSTR Resource: DB2AMSTR Message ID: BROKEN
Enter commands to be executed when resource issues the selected message. Pass or Automated Selection Function Command Text 1 INFORM DB2PROB DB2AMSTR IS BROKEN
In the following CMD Processing panel, shown in Figure 142, enter the INFORM command and the specific parameter that need to be passed to the Inform policy for this example. After completion of this definition to the System Automation policy database, rebuild the automation control file (ACF) and reload it in the Automation NetView. 9.3.4.4 Inform policy definitions For the example of Inform policy notifications when DB2AMSTR goes to status BROKEN, the following Inform policy INFORM/CONTACT definitions for the DB2 systems programmers have to be performed as shown in Figure 143 on page 222.
221
* * POLICY for DB2SP (DB2 Systems Programmers) * * The inform policy for DB2SP indicates that there are 2 separate * contacts depending on the day/time. * * The prime time contact is John Smith who is on pager# 0123456789 * The out of hours contact is Fred Bloggs who is on pager# 9876543210 * INFORM DB2SP,SP=SP000002; CONTACT to 17:00, CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=0123456789, NAME=JOHN SMITH; CONTACT to 24:00, CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=9876543210, NAME=FRED BLOGGS; CONTACT to 09:00, CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=9876543210, NAME=FRED BLOGGS; CONTACT CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=9876543210, NAME=FRED BLOGGS; Figure 143. INFORM/CONTACT definitions for DB2 Systems Programmers
* * * * * * * * *
As second action, the following Inform policy INFORM/CONTACT definitions for the Help Desk have to be performed as shown in Figure 144 on page 223.
222
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
* POLICY for HDESK (Help Desk) * * HDESK is available during the prime time via pager# 1122334455 and * * email, and out of hours via email only. * * * INFORM HDESK,SP=SP000002; CONTACT to 17:00, CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=1122334455, NAME=HELP DESK; CONTACT CONNECTION=EMAIL, INTERFACE=EZLESMTP, ROUTE=HDESK@SOMEWHERE.COM, NAME=HELP DESK; * * Figure 144. INFORM/CONTACT definitions for Help Desk
As third action, the Inform policy INFORM/CONTACT definitions for the Customer Service Manager have to be performed as shown in Figure 145:
* POLICY for CSMGR (Customer Service Manager) * CSMGR is available in prime time via pager# 66778899, and out of * hours via email. * INFORM CSMGR,SP=SP000002; CONTACT to 17:00, CONNECTION=ALPHAPAGE, INTERFACE=EZLENETF, TAPACCESS=9-1-800-555-5555, ROUTE=66778899, NAME=CS MANAGER; CONTACT to 24:00, CONNECTION=EMAIL, INTERFACE=EZLESMTP, ROUTE=CSMGR@VNET.IBM.COM, NAME=CS MANAGER; CONTACT to 09:00, CONNECTION=EMAIL, INTERFACE=EZLESMTP, ROUTE=CSMGR@VNET.IBM.COM, NAME=CS MANAGER; CONTACT CONNECTION=EMAIL, INTERFACE=EZLESMTP, ROUTE=CSMGR@VNET.IBM.COM, NAME=CS MANAGER; Figure 145. INFORM/CONTACT definitions for Customer Service Manager * * * *
223
The last action is to specify the Inform policy GROUP definition, which logically groups the contacts to the group DB2PROB:
* * * *
Note
Grouping simplifies the need to duplicate CONTACT entries under more than one INFORM group. When all of the above definitions have been performed, load the Inform policy member into the System Automation NetView using the NetView command
INFORMTB <Inform policy member>
where <Inform policy member> represents the customized Inform policy member for this example. 9.3.4.5 System Automation processing If the application DB2AMSTR goes to status BROKEN, System Automation will execute the INFORM command to call the Inform policy. The Inform policy will ensure that a notification will automatically be sent to the correct people. The text of the notification in e-mail and on the pager will be: DB2AMSTR IS BROKEN
224
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
The Status Display Facility (SDF) is a System Automation function residing within the Automation NetView, that is used to monitor system resources on the current system as well as on other target systems in 3270 session screens. The resources are monitored by noting different colors to reflect their current status. When monitoring system resources, resource status changes are updated dynamically in the SDF 3270 screens. Comparing the SDF with the NMC implementation, SDF is easy and quicker to setup and maintain. SDF does not need RODM or GMFHS to provide its resource information, just the base Automation (SA) NetView. It only provides information about system resources managed by the Automation (SA) NetViews. On the other hand does the NMC provide by far more powerful display and command functions, including online status refresh for all managed network and system objects, as well as Network and System Automation command support directly from NMC topology console.
225
The following collection of screen shots from Figure 148 to Figure 153 on page 229 demonstrate how the actual NMC System Automation views look like. The background pictures were added for demonstration purpose.
226
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
227
228
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
229
230
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
231
into the NetView Clist, CNME1034, the following changes need to be done. DOC / ++HOLD ACTION: Remove or remark ( /* ... */ ) the invocation of CNME1035 in member AOFMSG00.
Note
This notice is a reminder that the clist, CNME1035, is no longer used by Tivoli NetView for OS/390 V1R3 as the initial NetView PPT startup clist. Please check for any self-written customizations and move appropriate modifications to the new NetView PPT start-up clist CNME1034.
232
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
APPLICATION ASCH APPC IO_OPERATIONS JES2 LLA NETWORK_GMFHS NETWORK_NETVIEW NETWORK_NETVIEW_SSI NETWORK_RODM PROCESSOR_OPERATIONS SAOS390_GMFHS SAOS390_NETVIEW SAOS390_NETVIEW_SSI SAOS390_RODM SAOS390_RODM_DM TSO VLF VTAM TSO
APPLICATION GROUP OPERATIONS OPERATIONS OPERATIONS OPERATIONS OPERATIONS NETWORK NETWORK NETWORK NETWORK OPERATIONS SC66_GENERIC SA_OS390 SA_OS390 SA_OS390 SA_OS390 OPERATIONS OPERATIONS NETWORK OPERATIONS
233
CLASS GENERIC_CLASS
APPLICATIONS RELATED This is a generic class application. It should be used with generic and local applications that will share the same definitions like shutdown commands, restart thresholds and others. SAOS390_GMFHS and NETWORK_GMFHS SAOS390_NETVIEW and NETWORK_NETVIEW SAOS390_RODM and NETWORK_RODM
234
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
235
//******************************************************************* //* SYSOPS AUTOMATION STATUS FILE //******************************************************************* //AOFSTAT DD DSN=&VQ2..&DOMAIN..STATS,DISP=SHR //******************************************************************* //* SYSOPS SAF PASSWORD DATASET FOR GATEWAY OPERATORS //******************************************************************* //*AOFPSWD DD DSN=&VQ2..&DOMAIN..PASSWORD,DISP=SHR,AMP=AMORG //******************************************************************* //* NETVIEW LOG DATASETS //******************************************************************* //DSILOGP DD DSN=&VQ1..&DOMAIN..DSILOGP, // DISP=SHR,AMP='AMORG,BUFNI=10,BUFND=5' //DSILOGS DD DSN=&VQ1..&DOMAIN..DSILOGS, // DISP=SHR,AMP='AMORG,BUFNI=10,BUFND=5' //******************************************************************* //* TRACE LOG DATASETS //******************************************************************* //DSITRCP DD DSN=&VQ1..&DOMAIN..DSITRCP, // DISP=SHR,AMP=AMORG //DSITRCS DD DSN=&VQ1..&DOMAIN..DSITRCS, // DISP=SHR,AMP=AMORG //******************************************************************* //* SESSION MONITOR VSAM DATA BASES //******************************************************************* //AAUVSPL DD DSN=&VQ1..&DOMAIN..AAUVSPL,DISP=SHR,AMP='AMORG' //AAUVSSL DD DSN=&VQ1..&DOMAIN..AAUVSSL,DISP=SHR,AMP='AMORG' //******************************************************************** //* HARDWARE MONITOR VSAM DATA BASES //******************************************************************** //BNJLGPR DD DSN=&VQ1..&DOMAIN..BNJLGPR,DISP=SHR,AMP=AMORG //BNJLGSE DD DSN=&VQ1..&DOMAIN..BNJLGSE,DISP=SHR,AMP=AMORG //******************************************************************** //* 4700 SUPPORT FACILITY VSAM DATA BASES //******************************************************************** //BNJ36PR DD DSN=&VQ1..&DOMAIN..BNJ36PR,DISP=SHR,AMP=AMORG //BNJ36SE DD DSN=&VQ1..&DOMAIN..BNJ36SE,DISP=SHR,AMP=AMORG //******************************************************************** //* CENTRAL SITE CONTROL FACILITY VSAM DATA BASE //******************************************************************** //DSIKPNL DD DSN=&VQ1..&DOMAIN..DSIKPNL,DISP=SHR,AMP=AMORG //******************************************************************** //* SAVE/RESTORE FACILITY VSAM DATA BASE //******************************************************************** //DSISVRT DD DSN=&VQ1..&DOMAIN..DSISVRT,DISP=SHR,AMP=AMORG //******************************************************************** //CNMMSGF DD DUMMY //CNMCMDF DD DUMMY //SYSPRINT DD SYSOUT=&SOUTA Figure 154. Common SA OS/390 start-up procedure
236
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
237
238
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
239
240
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Prior to perform the check list tasks below, ensure to perform the System Automation work steps to load the one (networking) RODM application with the data model for all System Automation objects.
Table 28. Check list of tasks to enable one RODM/GMFHS configuration
Networking NetView RODM Update EKGINMTB to include EKGSPPI Build LOADER files (See Appendix Loading EKGSPPI into RODM in System Automation OS/390 V1R3 Planning and Installation, GC28-1549) Automation Table Modify the member AOFMSGSY to enable the statement %INCLUDE AOFMSG03 Add the RODM and NetView domain name NPDA
241
Networking NetView Be sure filters are set to pass alerts (See Chapter Customize NetView Alert Information in System Automation OS/390 V1R3 Planning and Installation, GC28-1549)
System Automation NetView NPDA is not required. However, it is possible to include the same VSAM in the Automation NetView procedure as it is done in the Networking NetView procedure. (See Appendix Running Two Graphical NetView Releases on the Same System in Tivoli NetView OS/390 V1R3 Installation and Administration Guide, SC31-8236) especially: BNJMBDST -- BNJDSERV initialization member: Change FUNCT=BOTH to FUNCT=VSAM
Tasks (DSIDMN) Modify DSIPARM member DSIDMNB to: MOD=CNMCALRT,TSKID=AOFALRT, PRI=6,INIT=Y Check member AOFDMN to ensure the init member of task AOFRDST has not changed from the default (MEM=AOFRINIT) Modify the init member AOFRINIT to reflect the same PPI receiver task as in DSIQTSKI DEFAOF PPIRCVR=AOFQTSK Modify the init member DSIQTSKI of task DSIQTSK to reflect a different PPI receiver task (for example): CMDRCVR ID=AONQTSK Modify the init member DSIQTSKI of task DSIQTSK to reflect the same PPI receiver task as in AOFRINIT: CMDRCVR ID=AOFQTSK Include a statement for the focal point RODM: REP RODM=<RODM name of networking focal point system, e.g. EKGN66>, CONN=Y,AO=Y,ID=<Name of CMDRCVR ID task, e.g. AOFQTSK> Modify the init member DSI6INIT of task DSI6DST to reflect the correct networking focal point NetView: DEFFOCPT TYPE=ALERT, PRIMARY=<NetId>.<Networking NetView Domain-Name, e.g. USIBMSC.SC66N>
242
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Networking NetView Commands (DSICMD) Modify the member DSICMD to enable the statement %INCLUDE AOFCMDST Additional members to check
Ensure the clist AOFRODIN and the init member AOFRODM reflect the correct RODM userid and networking focal point RODM name (Dont forget security !) Modify the member AOFSFMAP to reflect a correct autotask name (e.g. AUTO1) and the networking focal point RODM name (e.g. EKGN66)
RODM name of focal point system Must be specified in member: AOFRODM AOFSFMAP DSIQTSKI (REP statement)
243
244
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
245
reviewed by IBM for accuracy in a specific situation, there is no guarantee that the same or similar results will be obtained elsewhere. Customers attempting to adapt these techniques to their own environments do so at their own risk. Any pointers in this publication to external Web sites are provided for convenience only and do not in any manner serve as an endorsement of these Web sites. This document contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples contain the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. The following terms are trademarks of the International Business Machines Corporation in the United States and/or other countries:
AIX DB2 IBM MVS NWAYS OS/2 RACF S/390 System/390 Tivoli CICS DFSMS IMS NetView OpenEdition OS/390 REXX System/370 System Automation TSO
The following terms are trademarks of other companies: Tivoli, Manage. Anything. Anywhere.,The Power To Manage., Anything. Anywhere.,TME, NetView, Cross-Site, Tivoli Ready, Tivoli Certified, Planet Tivoli, and Tivoli Enterprise are trademarks or registered trademarks of Tivoli Systems Inc., an IBM company, in the United States, other countries, or both. In Denmark, Tivoli is a trademark licensed from Kjbenhavns Sommer - Tivoli A/S. C-bus is a trademark of Corollary, Inc. in the United States and/or other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and/or other countries. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
246
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Microsoft Corporation in the United States and/or other countries. PC Direct is a trademark of Ziff Communications Company in the United States and/or other countries and is used by IBM Corporation under license. ActionMedia, LANDesk, MMX, Pentium and ProShare are trademarks of Intel Corporation in the United States and/or other countries. UNIX is a registered trademark in the United States and other countries licensed exclusively through The Open Group. SET, SET Secure Electronic Transaction, and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC. Other company, product, and service names may be trademarks or service marks of others.
247
248
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
249
Tivoli NetView for OS/390 AON Customization Guide, SC31-8662 Tivoli NetView for OS/390 Automated Operations Network Users Guide, GC31-8661 Tivoli NetView for OS/390 Automation Guide, SC31-8225 Tivoli NetView for OS/390 Customization Guide, SC31-8228 Tivoli NetView for OS/390 Messages and Codes, SC31-8237 Tivoli NetView for OS/390 Installation and Administration Guide, SC31-8236 Tivoli NetView for OS/390 Administration Reference, SC31-8222 Tivoli NetView for OS/390 NetView Management Console Users Guide, GC31-8665 Tivoli NetView for OS/390 V1R3 Planning Guide, GC31-8226 Tivoli Netview for OS/390 Tuning Guide, SC31-8240 System Automation for OS/390 V1R3 Planning and Installation, GC28-1549 System Automation for OS/390 V1R3 Customization, GC28-1566 System Automation for OS/390 V1R3 Operations, GC28-1550 System Automation for OS/390 V1R3 Messages and Codes, GC28-1569 System Automation for OS/390 V1R3 Technical Reference, GC28-1593 SNA Management Services Reference, SC30-3346 OS/390 TCP/IP OpenEdition Users Guide, GC31-8305
250
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Fax Orders United States (toll free) Canada Outside North America 1-800-445-9269 1-403-267-4455 Fax phone number is in the How to Order section at this site: http://www.elink.ibmlink.ibm.com/pbl/pbl
This information was current at the time of publication, but is continually subject to change. The latest information may be found at the redbooks Web site. IBM Intranet for Employees IBM employees may register for information on workshops, residencies, and redbooks by accessing the IBM Intranet Web site at http://w3.itso.ibm.com/ and clicking the ITSO Mailing List button. Look in the Materials repository for workshops, presentations, papers, and Web pages developed and written by the ITSO technical professionals; click the Additional Materials button. Employees may access MyNews at http://w3.ibm.com/ for redbook, residency, and workshop announcements.
251
First name Company Address City Telephone number Invoice to customer number Credit card number
Last name
Card issued to
Signature
We accept American Express, Diners, Eurocard, Master Card, and Visa. Payment by credit card not available in all countries. Signature mandatory for credit card payment.
252
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Glossary
AIX operating system. IBM implementation of the UNIX operating system. The RS/6000 system, among others, runs the AIX operating system. Browse. (1) To look at records in a file. (2) In the NetView Graphic Monitor Facility, to open a view that cannot receive status changes from Tivoli NetView for OS/390. This contrasts with monitor. Central Processing Unit (CPU). The part of a computer that includes the circuits that control the interpretation and execution of instructions. A CPU is the circuitry and storage that executes instructions. Traditionally, the complete processing unit was often regarded as the CPU; whereas, today the CPU is often a microchip. In either case, the centrality of a processor or processing unit depends on the configuration of the system or network in which it is used. Command Line Interface (CLI). A type of computer interface in which the input command is a string of text characters. Contrast with graphical user interface. DB2. An IBM relational database management system that is available as a licensed program on several operating systems. Programmers and users of DB2 can create, access, modify, and delete data in relational tables using a variety of interfaces. Direct Access Storage Device (DASD). A mass storage medium on which a computer stores data. Contrast with random access memory. Distributed Monitoring. See Tivoli Distributed Monitor. Distributed Monitoring Engine. In a Tivoli environment, the client software that is installed on each managed node, gateway, and endpoint that is being monitored by Tivoli Distributed Monitoring. The Distributed Monitoring engine monitors resources, compares data from monitored resources against configured thresholds, and runs automated responses. Extended Architecture (XA). An extension to System/370 architecture that takes advantage of continuing high performance enhancements to computer system hardware. Graphical User Interface (GUI). A type of computer interface consisting of a visual metaphor of a real-world scene, often of a desktop. Within that scene are icons, representing actual objects, that the user can access and manipulate with a pointing device. Contrast with command line interface. Hypertext Markup Language (HTML). A markup language that is specified by an SGML document type definition (DTD) and is understood by all Web servers. Hypertext Transfer Protocol (HTTP). In the Internet suite of protocols, the protocol that is used to transfer and display hypertext documents. Internet Protocol (IP). In the Internet suite of protocols, a connectionless protocol that routes data through a network or interconnected networks and acts as an intermediary between the higher protocol layers and the physical network. Java. An object-oriented programming language for portable interpretive code that supports interaction among remote objects. Java was developed and specified by Sun Microsystems, Incorporated. Monitor. (1) A device that observes and records selected activities within a data processing system for analysis. Possible uses are to indicate significant departure from the norm or to determine levels of utilization of particular functional units. (2) Software or hardware that observes, supervises, controls, or verifies operations of a system. (3) The function required to initiate the
253
transmission of a token on the ring and to provide soft-error recovery in case of lost tokens, circulating frames, or other difficulties. The capability is present in all ring stations. (4) Software that monitors specific applications or the systems on which the applications rely. Monitors typically monitor information, such as available disk space or application errors, and compares the information to defined thresholds. When thresholds are exceeded, either system or network administrators can be notified or an automated response can be performed. (5) In the NetView Graphic Monitor Facility, to open a view that can receive status changes from Tivoli NetView for OS/390. Problem determination and correction can be performed directly from the view. Contrast with browse. MVS. Multiple Virtual Storage. Implies MVS/390, MVS/XA, MVS/ESA, and the MVS element of the OS/390 operating system. NetView. See Tivoli NetView and Tivoli NetView for OS/390. Open Database Connectivity (ODBC). A standard application programming interface (API) for accessing data in both relational and non-relational database management systems. Using this API, database applications can access data stored in database management systems on a variety of computers even if each database management system uses a different data storage format and programming interface. ODBC is based on the call level interface (CLI) specification of the X/Open SQL Access Group and was developed by Digital Equipment Corporation (DEC), Lotus, Microsoft, and Sybase. Contrast with Java Database Connectivity. Policy. In a Tivoli environment, a set of rules that are applied to managed resources. A specific rule in a policy is referred to as a policy method. Policy Region. In a Tivoli environment, a group of managed resources that share one or more common policies. Tivoli administrators use policy regions to model the management and organizational structure of a network computing environment. The administrators can group similar resources, define access to and control
the resources, and associate rules for governing the resources. The policy region contains resource types and the list of resources to be managed. A policy region is represented on the Tivoli desktop by an icon that resembles a capitol building (dome icon). When a Tivoli Management Region (TMR) is created, a policy region with the same name is also created. In this case, the TMR has only one policy region. However, in most cases, a Tivoli administrator creates other policy regions and subregions to represent the organization of the TMR. A TMR addresses the physical connectivity of resources, whereas, a policy region addresses the logical organization of resources. Policy Subregion. In a Tivoli environment, a policy region created or residing in another policy region. When a policy subregion is created, it initially uses the resource and policy properties of the parent policy region. The Tivoli administrator can later change or customize these properties to reflect the specific needs and differences of the subregion. Profile. (1) Data that describes the significant characteristics of a user, a group of users, or one or more computer resources. (2) In a Tivoli environment, a container for application-specific information about a particular type of resource. A Tivoli application specifies the template for its profiles; the template includes information about the resources that can be managed by that Tivoli application. A profile is created in the context of a profile manager; the profile manager links a profile to the Tivoli resource (for example, a managed node) that uses the information contained in the profile. A profile does not have any direct subscribers. Random Access Memory (RAM). A temporary storage location in which the central processing unit (CPU) stores and executes its processes. Contrast with direct access storage device. Scripting Language. The programming language in which a script is written.
254
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Script Stub. A place holder for a particular shell script. For example, the Tivoli Module Builder generates a script stub (using a skeleton file) if a developer does not provide the script for implementing a particular task or monitor when defining the task or monitor. The script stub then displays a message that the script executed successfully and displays any variables that were passed to the script. SMS. See Storage Management Subsystem. Software Distribution. See Tivoli Software Distribution. SQL. A programming language that is used to define and manipulate data in a relational database. Structured Programming Facility (SPF). An IBM product that is a full-screen editor. Structured Query Language. See SQL. System Management Facility (SMF). A standard feature of OS/390 that collects and records a variety of system and job-related information. Storage Management Subsystem (SMS). A DFSMS/MVS facility that is used to automate and centralize the management of storage. Using SMS, a storage administrator describes data allocation characteristics, performance and availability goals, backup and retention requirements, and storage requirements to the system. TCP. See Transmission Control Protocol. TCP/IP. See Transmission Control Protocol/Internet Protocol. Time Sharing Option (TSO). An option of the MVS operating system that provides interactive time sharing from remote terminals. Tivoli Client. A client of a Tivoli server. See TMR client and TMR server. Tivoli Desktop. In a Tivoli environment, the desktop that system administrators use to manage their network computing environment. Tivoli Distributed Monitoring. A Tivoli product that monitors system resources, initiates any
necessary corrective actions, and informs system administrators of potential problems. Tivoli Distributed Monitoring consists of a group of monitors that are installed on each managed node that is to be monitored. It resolves some events on its own and may send others to the Tivoli Enterprise Console. Tivoli Developers Toolkit. A Tivoli tool that enables developers to describe the management characteristics of an application or business system and that generates the application description files and application management packages that the Tivoli management software uses to manage applications and business systems. Tivoli Enterprise Console (TEC). A Tivoli product that collects, processes, and automatically initiates corrective actions for system, application, network, and database events. It is the central control point for events from all sources. The Tivoli Enterprise Console provides a centralized, global view of the network computing environment. It uses distributed event monitors to collect information, a central event server to process information, and distributed event consoles to present information to system administrators. Tivoli Environment. The Tivoli applications, based upon the Tivoli Management Framework, that are installed at a specific customer location and that address network computing management issues across many platforms. In a Tivoli environment, a system administrator can distribute software, manage user configurations, change access privileges, automate operations, monitor resources, and schedule jobs. Tivoli Management Framework. The base software that is required to run the applications in the Tivoli product suite. This software infrastructure enables the integration of systems management applications from Tivoli Systems Inc. and the Tivoli Partners. The Tivoli Management Framework includes the following: -Object request broker (oserv) -Distributed object database -Basic administration functions -Basic application services
255
-Basic desktop services, such as the graphical user interface In a Tivoli environment, the Tivoli Management Framework is installed on every client and server; however, the TMR server is the only server that holds the full object database. Tivoli Management Region (TMR). In a Tivoli environment, a Tivoli server and the set of clients that it serves. An organization can have more than one TMR. A TMR addresses the physical connectivity of resources; whereas, a policy region addresses the logical organization of resources. Tivoli Service Desk. A Tivoli product that is an integrated set of tools including Tivoli Assets Management, Tivoli Change Management and Tivoli Problem Management. The information about the enterprise IT services and support is maintained in a relational data base that can be accessed via users in a 3-tier environment. It provides a structure that supports the gathering, organizing, locating, and reporting of information related to problem, change, and asset management. Tivoli Service Desk for OS/390. A Tivoli product that is an integrated set of tools, services, and interfaces for automating and customizing a organization's IT service and support operation in an OS/390 environment. It provides a structure that supports the gathering, organizing, locating, and reporting of information related to problem, change, and asset management. Tivoli Software Distribution. A Tivoli product that automates software distribution to clients and servers in a network computing environment. An organization can use this product to install and update applications and software in a coordinated, consistent manner across a network. Tivoli Software Distribution creates file packages and distributes them to predefined subscribers. TMR. See Tivoli Management Region. TMR Client. In a Tivoli environment, any computer, except the TMR server, on which the Tivoli Management Framework is installed. The oserv daemon runs on the TMR client, and the
TMR client maintains a local object database. See Tivoli client and Tivoli server. TMR Server. A Tivoli server for a specific Tivoli Management Region (TMR). See Tivoli client and TMR client. TSD. See Tivoli Service Desk. Transmission Control Protocol (TCP). A communications protocol used in the Internet and in any network that follows the Internet Engineering Task Force (IETF) standards for internetwork protocol. TCP provides a reliable host-to-host protocol between hosts in packet-switched communications networks and in interconnected systems of such networks. It uses the Internet Protocol (IP) as the underlying protocol. Transmission Control Protocol/Internet Protocol (TCP/IP). A set of communications protocols that support peer-to-peer connectivity functions for both local and wide area networks. UNIX. An operating system developed by Bell Laboratories that features multi-programming in a multi-user environment. The UNIX operating system was originally developed for use on minicomputers but has been adapted for mainframes and microcomputers. The AIX operating system is IBM implementation of the UNIX operating system.
256
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
MVS/XA
257
Resource Access Control Facility Relational Data Base Management Systems Name of an Interpreted Command List Language Request for Announcement Resource Object Data Manager System Automation Security Authorization Facility System Display Facility Storage Management Subsystem. Simple Mail Transport Protocol System Network Architecture Simple Network Management Protocol System Log Transmission Control Protocol/Internet Protocol Tivoli/Enterprise Console Tivoli Management Agent Tivoli Management Environment Tivoli Management Region Telnet 3270 Time Sharing Option Virtual Transaction Access Method
WLM WTOR
RFA RODM SA SAF SDF SMS SMTP SNA SNMP SYSLOG TCP/IP
258
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
Index A
A01APPLS 47 ACF 60, 98, 104, 172, 184, 213 ACFPLOAD 14, 170, 173 ACQUIRE 175 ADDSD 171 aggregate objects 138 AIFR 175 AIX 253 Alert Forwarding 19 ALWAYS 168 AOC/MVS 172 AOCCLONE 74 AOCCLONE1 110 AOCQRES 14 AOFACFMP 173 AOFINIT 108 AOFMSG00 41, 42, 104 AOFMSG01 41, 43, 44, 104, 158, 164 AOFMSGSY 41, 42, 60 AOFPNLS 50, 108 AOFPSYST 109 AOFRINIT 41 AOFRODM 48, 50 AOFSFMAP 48 AOFSMAP 50 AOFTDDF 108, 111 AOFTREE 50, 108 AOFTSC42 110 AOFTSC66 110 AOFTSC69 110 AOFTST02 162 AON 37, 66 AON Inform policy 199, 202, 214, 217, 218 APL 65 APPC 79 Application 64 ApplicationGroup 64 APPN 8 ASCH 79 ASSIGN 92 ATF DSICGLOB 177 Auto Operators 92 AUTOCNT 157, 162 AUTOMAN 6, 156, 157, 159, 161, 215 AUTOMATED function 175, 180 Automated Operation Network 37 Automation Console 88 Automation Control File 104 Automation control file 60 Automation Flags 72 Automation policy database 60 Automation table 155 Automation Table Management tool 157 Automation Timer 90 AUTOTBL 157 , 166 Available Documentation and Technical Information 144
B
BASE_AUTOOPS 93 Batch or shell files 151 BEGIN/END 157, 166 BINDIR 120, 121, 129, 130 BNH370I 179 BNJMBDST 41, 43
C
Cannot start the NT services 130 child 103 CHRON 2, 6 CLASS 66 CLPA 56 CNME1015 45 , 46 CNME1034 36 , 45, 46 Command line interface 253 Command Profile Editor 124, 126 Common automation CLIST library 45 Common automation CLIST library (Enterprise feature) 46 Common automation DSIPARM library 40 Common automation DSIPARM library (Enterprise feature) 44 common automation NetView libraries 40 Common automation VTAMLST library 47 common networking NetView libraries 34 CPE online utility 127 CPEBATCH 126, 127 CURRDATE 177 current date 175, 177 current time 175, 177 CURRTIME 177
259
D
DALLAS_MVS 95 DB2 8, 253 DDF 38 default directory 119 default encryption key 145 default por 141 Define a NetView operator ID 145 depedency relationship 105 dependencies 103 dependency 104 DIAGNOSE 145 dialog 53 Disable 157, 164 disabling 164 Display 157 DISPTREE 105 Distributred Monitoring 253 domain specific 37, 50 DSI6DST task 19 DSICGLOB 177 DSICMD 41, 43, 44 DSICNM 41, 43 DSICRTR task 20 DSICRTTD 41, 43, 44, 45 DSIDMN 41, 43, 44 DSIDMNB 35, 36, 42, 43, 44, 45, 141 DSIDMNK 35, 42, 43, 144 DSIDMNK Sample member 146 DSILIST 157, 159 DSIOPF 42, 44 DSIOPFU 42 DSIPARM 37, 108 DSIPARM and DSIPRF members 144 DSIPARM members 141 DSIQTSKI 48, 50 DSITBL01 35, 104 DSITCPCF 144 DSITCPIP 146 DSITCPRF 144 DSIVPARM 35 DSIWBMEM 141 DUIFPMEM 35, 37, 49 DUIGINIT 35, 49
E
EDIT 178 EDIT action 175, 178 egvread1.me 115 egvread2.me 115 EGVREAD5.ME 118, 132, 143, 147 Enable 157, 164 Enable/Disable 164 Enabling TCP/IP for NetView 141 encryption is not used 145 encryption key 145 enhancement 126 Environment setup 121, 122, 123 Environment space errors 153 Events 13 events 181 EXECIO 8 EZLCFG01 35, 37, 38 EZLTREE 37, 38
F
FLB4WIN.EXE 147 flb4win.exe 144, 147 FLBDPD.HTM 144 FLBHLP.HTM 144 flbinst.bat 148, 150 flbread1.me 115 FLBSYSD 35 FLBSYSDA 35 Focal Point 37 focal point system 105 FOCAL_NETWORK 92 FOCAL_OPERS 93 FORCE 69 FTP 4
G
GAT&AOCCLONE2 111 Gateway 91, 112 gateway 22 Gateway Sessions 209 GATOPER 208 GMFHS 21, 37 Graphical user interface 253
260
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
H
HDRMTYPE 8 Heartbeat 86 Heartbeat Interval 86 Hints and Tips for the Tivoli NMC Topology Console 135 Hints and Tips for the Tivoli NMC Topology Server 117, 129 host TCP/IP 146 How to Issue SA OS/390 Commands Using the NetView Management Console 125 HTTP 253
IP 253 IP Management 3 IPL 107 IPSTAT 4 ISQ_NMCCCHLP_HELPFILES 124 ISQ_NMCS_CMD.RSP 124 ISQ_NMCS_DDF 124 Issuing SA OS/390 commands 135
J
JAVA 253 Java Development Kit 143 Java interface 115 Java set up 135 JDK 143 JES2 65, 112, 113 JES3 65
I
ibmflb folder 151 IDLEOFF 8, 169 IEASYMxx 33 IF-THEN 168 IF-THEN condition item 175, 176 ihsmessage.log 128, 129, 130 IMMED 69 inbound and outbound encryption keys 149 ING.SINGPWS1(INGNMCTZ) 125 ING.SINGPWS1(INGNMCZP) 125 ING_NMCCHLP_HELPFILES 124 ING_NMCS_CMD.RSP 124 ING_NMCS_DDF 124 INGDLG 62 INGELOAD 55 INGNMCTZ 125 INGNMCZP 125 INIT 69 Insert 157 Installing NetView 3270 Console on Windows 95, 98, and NT 146 Installing NMC for SA OS/390 124 Installing NMC Topology Server 117 Installing the NMC Topology Console for Windows NT 131 INTERP 121, 129 ints and Tips for the Tivoli NMC Topology Console 131
K
keyword "ANY_OTHER" 146
L
less-than 175, 177 Link to Instances 73 LLA 79 local (domain specific) NetView libraries 37, 50 Local install process for the networking NetView domains 38 LPAR 37 LU 6.2 session 19 LUC session 19
M
Mainframe Component 142 MCSFLAGS 89 MEMSTORE 8, 169 Message 194 Message Class 94 MIB 2, 4 MIGRATE 172 Missing Heartbeat Delay 86 MLWTO 6 MPF table 196 multi system focal point 204 multi-line messages 175 MVS Component 90 MVS_COMPONENT 91
261
MVSSTART 107
P
PARENT 107 parent 103 partial download of NMC from the server 135 performance 166 PERMIT 172 PING 4 PIPE EDIT 6 policy database 53 policyDB 170 PORT 144 problem with the TCP/IP definitions 141 Procedural 38 Processor operations 80 processor operations 139 processor operations start command 138 ProcessorOperation Operator 125 ProcOps 83 PTF UW90546 124
N
NETCONV 5 NETLOG 8 NETSTAT 4 NETVAPPL 47 NETVIEW 76 NetView 3270 Management Console 115, 142, 143 NetView Management Console 115 NetView ROLL command 152 NetView Sign On panel 136 NETVIEW_CLASS 66, 76 NETVSA42 74 NETVSA66 74 NETVSA69 74 network node 8 NEW 66 NMC 1, 2, 4, 5, 6, 7, 9, 20, 33, 37, 39, 115, 224, 225 NMC communications server 122 NMC server 115, 122 NMC Topology Console setup program 133 NMC Topology Server 118 NMC topology server starts, but then closes 130 NMC-Log 140 nmcpdf.zip 115 NNT 91 Norm 69 Notify 94 Notify Operators 93 nstalling the Tivoli NMC Topology Console 131 NT service 122, 123 NTW 91, 94, 96 numeric 177 Numeric comparison 177 numeric comparison 177 Numeric comparisons 175
R
README 124 READSEC 8 real objects 139 refresh the screen 152 relationship 105 Reload 157 Replicating the NetView 3270 Console Across Multiple Machines 151 REPORT 173 Report 173 Required Host Environment 146 response files 125 RMTCMD 7 RODM 20, 172 RODMNAME 55 RRD 213 Running the duinmcsw.exe 119
O
oper1.bat 150 operator ID 145 OperatorView 136 OST-NNT session 19 Out of memory errors 153 OUTMODE 14
S
SA OS/390 172 SA_OS390 78 SAF 213 SAMPLE_SYSTEM_01 81 SAOS390_NETVIEW 73 SC42 112 SC42_Generic 78 SC66 81, 112
262
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SC66_Generic 78 SC69 112 SC69_Generic 78 SCHEDULED_AUTOMATION 90, 91 Screen corruption 153 SDF 13, 22, 108, 109, 204, 224, 225 SDFPANEL 108 Selecting the correct files 143 Server intallation on system running Tivoli Framework 129 ServerPac 57 service 122, 123 Service periods 13 Service Point Command Line 5 Session Management 4 session management 4 Setting up DSITCPCF 144 Setting up DSITCPRF 145 Setting up NMC Topology Server 117 Setting up the base NetView for OS/390 47 Setting up the Graphic Monitor Facility Host Subsystem 49 Setting up the Host (Mainframe) Environment 144 Setting up the NetView 3270 Management Console 142 Setting up the NMC client workstation 131 Setting up the Resource Object Data Manager 47 Setting up the Web interface to Tivoli NetView OS/390 140 setup 53 setup_env file is found, but the bindir is not set 130 SETUP_ENV.CMD 120, 121 setup_env.cmd 120, 129 setup_env.cmd is not found 129 SEZLPNLU 38 SHUTSYS 14 slow response time 152 SMF 8 SMTP 4, 6, 156, 199, 202, 214, 215 SMTP email 199, 200, 201, 202 SNMP 1, 2, 3, 4, 5 SOCKET 7 socket 2, 4 SOCKETS 145 Software Distribution 255 Software installation 118, 120 Software requirements 142 SQL 255 start the NetView 3270 Management Console from
an MS-DOS prompt 150 start the NetView Management Console 136 Starting the NMC Console 131 Starting the NMC Console using a TCP/IP connection 133 Starting the Tivoli NMC Topology Server 117, 127 Startup 155 Status Display Facilit 108 Status Display Facility 108 step 33, 39 step 1 33, 39 step 2 33, 39 step 3 34 step 4 34 step 5 37, 50 SubGroup 64, 94, 96 SUBMIT 8 SUBSJOB 71 switching screens 152 Synonym 59 SYSCLONE 32 SYSLOG 12 SYSNAME 32 sysplex 59 System 64 system and user defined symbolic 27, 32 System Automation 66 SYSTEM INFO 84, 87, 90, 91, 92, 93 system operations 139 system operations commands 139 system requirements 142 System use 86 SystemAutomation Operator 125 SystemOperation Operator 125
T
TAF 91 TARGET_NETWORK 92 TCP 256 TCP/IP 256 TCPANAME 144 TCPIP 79, 105 TEC 255 telnet 4 Terminal Access Facility 91 TIMEOUT 145 TIMER 6
263
Timer 90 Tivoli Developers Toolkit 255 Tivoli Enterprise Console 255 Tivoli Framework 120 Tivoli Service Desk 256 Tivoli Service Desk for OS/390 256 Tivoli Software Distribution 256 TME 10 NetView for OS/390 Management Console 137 TMR 90, 91, 94, 96 TN3270 2, 4 TopologyServer version 1.3.0 117 TRACE action 175, 179 TRACERTE 4 TRANSIENT 68 traps 3 Triggers 13 triggers 181 TSO 79, 105
U
Uninstalling the NetView 3270 Console on Windows 95, 98, and NT 150 Uninstalling the Tivoli NMC Topology Console 131, 134 Uninstalling the Tivoli NMC Topology Server 117, 128 UNIX 256 Unload 157 user rights 121 UW90546 124
V
VALUE() function 175, 177 Values of variables 175 Variable value function 177 VLF 79 VSAMPOOL 169 VTAM 79, 105
W
Web 115 WINDIR 120 Windows NT service 117 Workstation Component 143 WRITESEC 8 WTOR 66
264
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SG24-5515-00 Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
What other subjects would you like to see IBM Redbooks address?
Please rate your overall satisfaction: Please identify yourself as belonging to one of the following groups: Your email address: The data you provide here may be used to provide you with information from IBM or our business partners about our products, services or activities. Questions about IBMs privacy policy?
O Very Good
O Good
O Average
O Customer O Business Partner O IBM, Lotus or Tivoli Employee O None of the above
O Please do not use the information collected here for future marketing or promotional contacts or other communications beyond the scope of this transaction.
The following link explains how we protect your personal information. http://www.ibm.com/privacy/yourprivacy/
265
Automation Using Tivoli NetView OS/390 V1R3 and System Automation OS/390 V1R3
SG24-5515-00