IBM Tivoli NetView for z/OS Version 6 Release 2 Modification 1 SNA Topology Manager Implementation Guide IBM SC27-2864-02 IBM Tivoli NetView for z/OS Version 6 Release 2 Modification 1 SNA Topology Manager Implementation Guide IBM SC27-2864-02 Note Before using this information and the product it supports, read the information in “Notices” on page 191. This edition applies to version 6, release 2, modification 1 of IBM Tivoli NetView for z/OS (product number 5697-NV6 ) and to all subsequent versions, releases, and modifications until otherwise indicated in new editions. This edition replaces SC27-2864-01. © Copyright IBM Corporation 1997, 2014. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ................................... vii About this publication ............................. ix Intended audience ................................. ix Publications ................................... ix IBM Tivoli NetView for z/OS library .......................... ix Related publications ............................... xi Accessing terminology online ............................ xi Using NetView for z/OS online help .......................... xii Accessing publications online ............................ xii Ordering publications............................... xiii Accessibility ................................... xiii Service Management Connect ............................. xiii Tivoli technical training ............................... xiii Tivoli user groups ................................. xiv Downloads ................................... xiv Support information ................................ xiv Conventions used in this publication ........................... xv Revision codes ................................. xv Typeface conventions ............................... xv Operating system-dependent variables and paths ..................... xvi Syntax diagrams ................................ xvi Chapter 1. Introduction ............................. 1 SNA Topology Manager Overview ............................ 1 SNA Topology Manager Functions ............................ 2 Functions Provided by the SNA Topology Manager ..................... 2 Functions Used by the SNA Topology Manager....................... 3 SNA Topology Manager Benefits............................. 4 Exception Views ................................. 4 Dynamic Subarea and LU Management ......................... 5 Expanded Management for Advanced Peer-to-Peer Networking Networks.............. 5 Enhanced SNA Topology Automation .......................... 5 Increased User Productivity ............................. 5 Investment Protection ............................... 6 Relating SNA Topology Manager to Networking Software .................... 6 Chapter 2. Planning Considerations........................ 9 Planning for SNA Topology Manager ........................... 9 Software Requirements ............................... 9 Storage Requirements ............................... 9 Resource Naming................................. 9 Security Considerations .............................. 10 Performance and Tuning Considerations......................... 10 SNA Topology Manager Resource Availability ....................... 13 Planning for Topology Monitoring............................ 14 Placing Topology Agents and Managers ......................... 14 Setting Topology Manager Defaults .......................... 16 Using Warm Starts and Cold Starts .......................... 16 Purging RODM ................................. 19 Chapter 3. Customization............................ 21 Automating Startup and Shutdown ........................... 21 Potential Topology Manager Cold Start Items ....................... 21 © Copyright IBM Corp. 1997, 2014 iii Potential Topology Manager Shutdown Items ....................... 22 User-Written Command Lists or Automation Routines ..................... 22 Suggested Automation Functions ........................... 22 Built-in Message Suppression ............................ 23 Automating and Customizing Topology Manager Views .................... 23 Customizing Topology Manager Views Using Sample Files .................. 24 Adding Topology Manager Commands to the Menus ..................... 26 RODM Automation................................. 27 Creating RODM Methods.............................. 27 Creating RODM Objects .............................. 28 Creating RODM Fields .............................. 28 Setting the deleteIndicator Field for Deleting Resources..................... 29 Standard Operation of the deleteIndicator Field ...................... 29 Changing the deleteIndicator Field for Selected Objects.................... 30 Objects Not Affected by the deleteIndicator Field ...................... 31 Modifying the FLBSYSD Initialization File ......................... 31 RODM Parameters in FLBSYSD ........................... 32 VIEWMGR Parameters in FLBSYSD .......................... 33 Prefixes in FLBSYSD ............................... 36 DisplayResourceOtherData Text in FLBSYSD ....................... 37 Message Suppression Options in FLBSYSD ........................ 38 Common Delimiters in FLBSYSD ........................... 38 Startup Parameters in FLBSYSD ........................... 38 Automatic Topology Parameters in FLBSYSD ....................... 39 NETID List Parameters in FLBSYSD .......................... 39 COMBINE_STATUS Parameters in FLBSYSD ....................... 39 VTAM MIBConnect Parameters in FLBSYSD ....................... 39 Subarea_Number_To_Name Parameter in FLBSYSD ..................... 40 FIELDS Parameters in FLBSYSD ........................... 40 Using Customization Tables and Methods ......................... 40 Customization Table Keywords ............................ 41 Customizing the OSI-to-DisplayStatus Table, FLBOSIDS ................... 47 Customizing the Status Resolution Table, FLBSRT ..................... 53 Customizing the Exception View Table, FLBEXV ...................... 54 Using SNA Topology Manager Methods .......................... 55 FLBTRNMM - Determine Number of Members ...................... 55 FLBTRUM - Override DisplayStatus Values........................ 56 FLBTREU - Override ExceptionViewList Values ...................... 56 Writing Methods, an Overview ............................ 56 Using the individualStatus Field for Multiply-Owned Objects .................. 58 individualStatus Field Processing ........................... 58 individualStatus Field Scenario ............................ 59 Chapter 4. Using the SNA Topology Manager ................... 61 Topology Manager Overview ............................. 61 Network Management with the Topology Manager and NetView Management Console ......... 62 How the Topology Manager and Agents Work Together ................... 66 How the Topology Manager Uses RODM ........................ 66 Summary of Topology Manager Functions ........................ 67 SNA Topology Manager Autotask ............................ 69 Topology Manager Autotask Input Processing ....................... 69 Topology Manager Autotask Initialization ........................ 70 SNA Topology Manager Data Areas .......................... 73 SNA Topology Manager Command Processor ........................ 74 Getting Started with the Topology Manager ........................ 75 Step 1: Start VTAM ................................ 75 Step 2: Start the NetView Subsystem Address Space ..................... 75 Step 3: Start the Resource Object Data Manager ...................... 75 Step 4: Load the Data Models ............................ 75 Step 5: Start the NetView Program........................... 76 Step 6: Start the Graphic Monitor Facility Host Subsystem................... 76 iv SNA Topology Manager Implementation Guide Step 7: Start the NetView Management Console ...................... 77 Step 8: Start the Agents .............................. 77 Operating the Topology Manager ............................ 77 Using the TOPOSNA Host Command ......................... 77 Monitoring Network, Local, and LU Topologies ...................... 78 Monitoring LU Collections from the NetView Management Console ............... 84 Managing Network Resources ............................ 84 Using the Locate Resource Function .......................... 85 Stopping the SNA Topology Manager ......................... 87 TOPOSNA Command Restrictions ............................ 89 Using Menus to Navigate and Manage SNA Views ...................... 89 Bringing Up Views of the Advanced Peer-to-Peer Networking and Subarea Networks ......... 89 Using Menu Functions .............................. 90 Menu Actions the Topology Manager Does Not Support ................... 91 Understanding the Content of the SNA Topology Manager Views ................. 91 Interpreting Object Names ............................. 92 Interpreting Status of Real Resources .......................... 93 Interpreting the Status of Multiply-Owned Resources .................... 106 Interpreting the Status of Aggregate Resources ...................... 107 Status History ................................. 114 Views Available on the NetView Management Console ................... 116 Accessing Additional Resource Information ....................... 134 Understanding Changes to View Content ......................... 134 Differences in Monitoring Network, Local, and LU Topologies ................. 135 How and Why Node Types Can Change