Network Performance Feature Reference

Tivoli Decision Support for OS/390 Network Performance Feature Reference Version 1.6 SH19-6822-07

Tivoli Decision Support for OS/390 Network Performance Feature Reference Version 1.6 SH19-6822-07

Note Before using this information and the product it supports, read the information in Notices on page 265. Eighth Edition (June 2003) This edition applies to version 1, release 6 of Tivoli Decision Support for OS/390 (product number 5695-101) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SH19-6822-06. Copyright International Business Machines Corporation 1993, 2003. All rights reserved. Note to U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.

Contents Figures.............. vii Preface............... ix Who Should Read This Book......... ix What This Book Contains.......... ix Publications.............. x IBM Tivoli Decision Support for OS/390 Library. x Using LookAt to look up message explanations xii Accessing publications online....... xii Ordering publications.......... xii Accessibility.............. xiii Contacting software support........ xiii Conventions used in this book........ xiii Typeface conventions.......... xiii Changes in This Edition.......... xiv Part 1. Tables and logs....... 1 Chapter 1. Component tables..... 3 Naming standard for data tables........ 3 Table descriptions............ 3 NW_ALERT_BASIC_H, _D, _W....... 5 NW_ALERT_GENERIC_H, _D, _W...... 6 NW_CONFIG_HARDWARE........ 8 NW_CONFIG_SOFTWARE........ 10 NW_FRRYL_UTIL_H, _D, _W....... 12 NW_FRRYLM_UTIL_H, _D, _W...... 15 NW_FRRYP_UTIL_H, _D, _W....... 17 NW_FRRYPS_UTIL_H, _D, _W....... 20 NW_FTP_REQUEST_H, _D, _M...... 22 NW_FTP_REQUEST_T......... 24 NW_FTP_TRANSMIT_H, _D, _M...... 26 NW_LANB_UTIL_H, _D, _W....... 27 NW_LANS_UTIL_H, _D, _W....... 30 NW_LINE_UTIL_H, _D, _W........ 32 NW_NCP_UTIL_H, _D, _W........ 36 NW_NEO_UTIL_H, _D, _W........ 39 NW_NPMIP_PERFORM_H, _D....... 42 NW_NPMIP_PERFVOL_H, _D....... 43 NW_NPMIP_WRKLOAD_H, _D...... 44 NW_NPM_TRANSIT_H, _D, _W, _M..... 45 NW_NPM_TRANS_IP_H, _D, _W, _M.... 51 NW_NPM_TRANS_SUM_H, _D, _W, _M... 57 NW_NPM_UTIL_H, _D, _W........ 63 NW_NTRIL_UTIL_H, _D, _W....... 66 NW_NTRIP_UTIL_H, _D, _W....... 69 NW_ODLCL_UTIL_H, _D, _W....... 72 NW_ODLCP_UTIL_H, _D, _W....... 74 NW_PU_UTIL_H, _D, _W........ 76 NW_ROUT_CISCIP_H, _D, _W....... 78 NW_ROUT_CISCO_H, _D, _W....... 82 NW_ROUT_CISPOOL_H, _D, _W...... 83 NW_ROUT_IBM_H, _D, _W........ 84 NW_ROUT_INTTRAF_H, _D, _W...... 87 NW_RTM_RESPONSE_H, _D, _W, _M.... 89 NW_SESSION_FAIL_H, _D, _W...... 91 NW_SM_UTIL_H, _D, _W........ 93 NW_VTAM_ADDSPACE_H, _D, _W..... 95 NW_VTAM_APPL_H, _D, _W....... 96 NW_VTAM_BFR_H, _D, _W....... 98 NW_VTAM_DEV_H, _D, _W....... 102 NW_VTAM_GLOBAL_H, _D, _W..... 106 NW_VTAM_VR_H, _D, _W....... 109 NW_X25LN_UTIL_H, _D, _W....... 111 NW_X25NI_UTIL_H, _D, _W....... 115 NW_X25PU_UTIL_H, _D, _W....... 118 Chapter 2. Lookup tables...... 121 Naming standard for lookup tables...... 121 Table descriptions............ 121 NW_ALERT_DESC.......... 122 Example of table contents....... 122 NW_ALERT_TYPE.......... 122 Example of table contents....... 122 NW_FAILURE_CODE......... 122 Example of table contents....... 123 NW_GENERAL_CAUSE........ 123 Example of table contents....... 123 NW_PROBABLE_CAUSE........ 123 Example of table contents....... 124 NW_PRODUCT_ID.......... 124 Example of table contents....... 124 NW_RESOURCE........... 124 NW_SPECIFIC_CAUSE......... 126 Example of table contents....... 126 NW_THRESHOLD.......... 126 Example of table contents....... 126 Chapter 3. Supported log records.. 129 SMF Type 28............. 129 SMF Type 37............. 130 SMF Type 39............. 130 SMF Type 251............. 130 SMF Type 252 or user-defined........ 130 Part 2. Data flow reference.... 133 Chapter 4. Basic data flows..... 137 Understanding Network Performance feature data processing.............. 137 NetView, NPM, and NetView FTP capture network data............ 138 External log collects availability data.... 138 NetView and NPM write data to the SMF log 138 Tivoli Decision Support for OS/390 collects SMF data............... 139 Feature adds environment data to tables... 141 Looking up period information..... 142 iii

Tivoli Decision Support for OS/390 creates reports.............. 143 How the Network Performance feature records time................ 143 Chapter 5. Availability component data flows............. 145 How the Network Performance feature measures availability.............. 145 SNA availability........... 145 End-user and NCP availability..... 145 Application availability........ 146 Cross-connection availability...... 146 External availability.......... 146 Availability processing.......... 147 Capturing SNA availability data...... 148 Capturing external availability data..... 148 Collecting data............ 148 Looking up resource information...... 148 Looking up information for APPL, NCP, or PU resource types.......... 148 Looking up information for cross-connection resources............. 149 Looking up schedule information...... 150 Looking up the schedule name..... 150 Looking up schedule data....... 151 Adding data to the AVAILABILITY_D, _W, and _M tables.............. 152 Looking up resource data for reports.... 152 Creating reports........... 153 Measuring resource uptime......... 153 NetView session monitor restart...... 154 Measuring resource downtime........ 154 Unavailable resources when SMF is switched 155 Measuring switched resource availability.... 156 Chapter 6. Configuration component data flows............. 157 Configuration............. 157 Configuration data collection........ 157 Hardware device configuration data flow.... 157 Collecting hardware configuration information 158 Collecting SMF data and updating the NW_CONFIG_HARDWARE table..... 158 Creating reports........... 162 Software product configuration data flow.... 162 Collecting software configuration information 162 Collecting SMF data and updating the NW_CONFIG_SOFTWARE table...... 163 Creating reports........... 165 Chapter 7. NetView FTP component data flows............. 167 NetView FTP performance......... 167 Processing steps for FTP data........ 167 Capturing NetView FTP data....... 168 Collecting SMF data.......... 168 Collecting FTP request data...... 168 Collecting FTP transmit data...... 168 Looking up period information...... 168 Creating reports........... 169 Chapter 8. Problem component data flows............... 171 Basic and generic alerts.......... 171 Problem categories.......... 171 Basic-alert data flow........... 171 Capturing basic-alert data........ 172 Collecting SMF data.......... 173 Looking up product ID information..... 173 Error conditions.......... 174 Looking up period information...... 174 Looking up problem cause information.... 174 Error conditions.......... 175 Creating reports........... 175 Generic alert data flow.......... 175 Capturing generic alert data....... 177 Collecting SMF data.......... 177 Looking up resource information...... 177 Error conditions.......... 178 Looking up period information...... 179 Looking up probable-cause information... 179 Error conditions.......... 179 Looking up alert description information... 179 Error conditions.......... 180 Looking up alert type information..... 180 Error conditions.......... 181 Creating reports........... 181 Chapter 9. Session failure component data flows............. 183 Session failures............. 183 Session failure data flow.......... 183 Capturing session failure data....... 184 Collecting SMF data.......... 185 Looking up period information...... 185 Looking up failure descriptions...... 185 Creating reports........... 186 Chapter 10. RTM response time component data flow........ 187 Response-time reporting based on RTM.... 187 RTM response-time definition....... 187 RTM response-time data flow........ 188 Capturing RTM response-time data..... 189 Collecting SMF data.......... 189 Looking up resource information...... 189 Error conditions for PU resources.... 190 Error conditions for application resources 190 Looking up period information...... 190 Looking up resource description information 191 Creating reports........... 191 Chapter 11. NPM transit time component data flow........ 193 Measuring workstation-to-application transactions 193 Transit-time logging.......... 194 NPM transit-time objectives....... 195 NPM transit-time data flow........ 195 iv Tivoli Decision Support for OS/390: Network Performance Feature Reference

Capturing NPM transit-time data...... 196 Collecting SMF data.......... 197 Looking up resource information...... 197 Looking up period information...... 198 Looking up resource description information 198 Creating reports........... 199 Chapter 12. Service component data flows............... 201 Network Performance feature service reports... 201 Service data flow............ 201 Looking up resource information...... 202 Creating reports........... 203 Chapter 13. NCP utilization component data flows....... 205 Utilization.............. 205 Collecting utilization data......... 205 NCP utilization data flow......... 205 Capturing NCP utilization data...... 206 Collecting SMF data.......... 206 Looking up period information...... 207 Looking up resource information...... 207 Creating reports........... 207 Chapter 14. Line utilization component data flows....... 209 Utilization.............. 209 Collecting utilization data......... 209 Threshold values........... 209 Line utilization data flow......... 209 Capturing line utilization data....... 210 Collecting SMF data.......... 210 Looking up period information...... 211 Looking up threshold information..... 211 Creating reports........... 211 Chapter 15. PU utilization component data flows............. 213 Utilization.............. 213 Collecting utilization data......... 213 PU utilization data flow.......... 213 Capturing PU utilization data....... 214 Collecting SMF data.......... 214 Looking up period information...... 215 Creating reports........... 215 Chapter 16. NPM internal utilization component data flows....... 217 NPM internal utilization.......... 217 NPM internal utilization data flow...... 218 Capturing NPM utilization data...... 218 Collecting SMF data.......... 218 Looking up period information...... 219 Creating reports........... 219 Chapter 17. NV/SM internal utilization component data flows....... 221 Utilization.............. 221 NV/SM internal utilization......... 221 NV/SM internal utilization data flow..... 221 Capturing NV/SM utilization data..... 222 Collecting SMF data.......... 222 Looking up period information...... 224 Creating reports........... 224 Chapter 18. NTRI utilization component data flows....... 225 Utilization.............. 225 Collecting utilization data......... 225 NTRI utilization data flow......... 225 Capturing NTRI utilization data...... 226 Collecting SMF data.......... 226 Looking up period information...... 226 Looking up resource information...... 226 Creating reports........... 227 Chapter 19. NEO utilization component data flows....... 229 Utilization.............. 229 Collecting utilization data......... 229 Threshold values........... 229 NEO utilization data flow......... 229 Capturing NEO utilization data...... 230 Collecting SMF data.......... 231 Looking up period information...... 231 Looking up resource information...... 231 Looking up threshold information..... 231 Creating reports........... 232 Chapter 20. X.25 utilization component data flows....... 233 Collecting utilization data......... 233 Threshold values........... 233 X.25 link utilization data flow........ 233 Capturing X.25 link utilization data..... 234 Collecting SMF data.......... 234 Looking up period information...... 235 Looking up resource information...... 235 Looking up threshold information..... 235 Creating reports........... 236 X.25 PU and VC utilization data flow..... 236 Capturing X.25 utilization data...... 237 Collecting SMF data.......... 237 Looking up period information...... 238 Looking up resource information...... 238 Creating reports........... 238 Chapter 21. LAN utilization component data flows....... 239 Utilization.............. 239 Collecting utilization data......... 239 Threshold values........... 239 LAN bridge thresholds........ 239 LAN segment thresholds....... 239 LAN utilization data flow........ 240 Capturing LAN utilization data..... 240 Contents v

Collecting SMF data......... 241 Looking up period information...... 241 Creating reports........... 241 Chapter 22. VTAM utilization component data flows....... 243 Utilization.............. 243 Collecting utilization data......... 243 VTAM utilization data flow....... 243 Capturing VTAM utilization data..... 244 Collecting SMF data......... 244 Looking up period information...... 245 Chapter 23. Frame Relay utilization component data flow........ 247 Utilization.............. 247 Collecting utilization data......... 247 Frame Relay utilization data flow...... 247 Capture Frame Relay data........ 248 Collect SMF data........... 248 Looking up period information...... 248 Looking up resource information...... 248 Creating reports........... 249 Chapter 24. ODLC utilization component data flow........ 251 Utilization.............. 251 Collecting utilization data......... 251 ODLC utilization data flow......... 251 Capture ODLC data.......... 252 Collect SMF data........... 252 Looking up period information...... 253 Looking up resource information...... 253 Creating reports........... 253 Chapter 25. SNMP routers component data flow............. 255 Utilization.............. 255 Collecting utilization data......... 255 SNMP routers utilization data flow...... 255 Capturing SNMP routers utilization data... 257 Collecting SMF data.......... 257 Creating reports........... 258 Chapter 26. NPM/IP Component Data Flows............... 259 NPM/IP performance and workload..... 259 Processing steps for NPM/IP data...... 259 Capturing NPM/IP data......... 260 Collecting SMF data.......... 260 Creating reports........... 260 Part 3. Appendixes........ 261 List of abbreviations........ 263 Notices.............. 265 Trademarks.............. 267 Glossary............. 269 Index............... 271 vi Tivoli Decision Support for OS/390: Network Performance Feature Reference

Figures 1. Basic Network Performance feature data flow 137 2. Collecting SMF data......... 140 3. Example of a PERIOD_PLAN table.... 142 4. Looking up period information..... 143 5. Recording time in the Network Performance feature.............. 143 6. Example using a long NetView collect period 144 7. Connection types.......... 145 8. Availability component data flow..... 147 9. Looking up resource data for APPL, NCP, or PU resources............ 149 10. Looking up data for cross-domain connection resources............. 150 11. Looking up schedule name....... 151 12. Looking up schedule information..... 152 13. Looking up resource information for reports 153 14. Calculating uptime.......... 153 15. NetView session monitor restart..... 154 16. Calculating downtime........ 155 17. Last event is a session stop....... 155 18. Timing of SMF switch and Tivoli Decision Support for OS/390 collect jobs..... 156 19. Process for hardware device configuration data............... 158 20. NW_CONFIG_HARDWARE table.... 160 21. Collecting hardware configuration data 161 22. Process for software product configuration data............... 162 23. NW_CONFIG_SOFTWARE table..... 163 24. Collecting software configuration data 164 25. Process for FTP data......... 167 26. Basic-alert data flow......... 172 27. Looking up product ID information for basic alerts.............. 174 28. Looking up problem cause information for basic alerts............ 175 29. Generic alert data flow........ 176 30. Looking up product ID information for generic alerts............ 178 31. Lookup process for probable cause information............ 179 32. Lookup process for alert description information............ 180 33. Lookup process for alert type information 180 34. Process for session failure data...... 184 35. Lookup process for session failure description information............ 186 36. Process for RTM response time..... 188 37. Looking up resource information for PU resources............. 190 38. Looking up resource information for application resources......... 190 39. Looking up resource description information using resource name as key....... 191 40. Life cycle of a workstation-to-application transaction............ 193 41. Process for NPM transit time...... 196 42. Looking up resource information for PU resources............. 197 43. Looking up resource information for application resources......... 198 44. Looking up resource description information using the resource name as key..... 199 45. Creating service reports (1)....... 201 46. Creating service reports (2)....... 202 47. Looking up resource information for service reports using resource name as key.... 203 48. Process for NCP utilization data..... 206 49. Looking up resource information for NCP utilization............. 207 50. Process for line utilization data..... 210 51. Looking up threshold information for line resources............. 211 52. Process for PU utilization data...... 213 53. NPM internal utilization data flow.... 218 54. NV/SM internal utilization data flow 222 55. Process for NTRI utilization data..... 225 56. Looking up resource information for NTRI utilization............. 227 57. Process for NEO utilization data..... 230 58. Looking up resource information for NEO utilization............. 231 59. Looking up threshold information for NEO resources............. 232 60. Process for X.25 link utilization data.... 234 61. Looking up resource information for X.25 link utilization............. 235 62. Looking up threshold information for X.25 link resources........... 236 63. Process for X.25 PU and VC utilization data 237 64. Looking up resource information for X.25 PU and VC utilization.......... 238 65. Process for LAN utilization data..... 240 66. Process for VTAM utilization data.... 244 67. Process for frame relay utilization data 247 68. Looking up resource information for frame relay utilization........... 249 69. Process for ODLC utilization data..... 251 70. Looking up resource information for ODLC utilization............. 253 71. IP Performance Data Collection by NPM 256 72. Process for SNMP routers utilization data 257 73. Processing NPM/IP data........ 259 vii

viii Tivoli Decision Support for OS/390: Network Performance Feature Reference

Preface Who Should Read This Book What This Book Contains This book provides reference information for the Network Performance Feature of IBM Tivoli Decision Support for OS/390 (hereafter referred to as Tivoli Decision Support for OS/390). This book describes the component tables and lookup tables associated with the feature, and provides a detailed explanation of how the feature processes each type of network performance data. Tivoli Decision Support for OS/390 was previously known as Tivoli Performance Reporter for OS/390. The terms MVS and OS/390 are used interchangeably throughout this book. The Network Performance Feature Reference is intended for network analysts or programmers who are responsible for setting up the network reporting environment. Use this book as a reference to understand how the Network Performance feature collects and processes network data. The book contains two parts: Part I contains these chapters: v Chapter 1, Component tables provides detailed information about the tables used by each component. v Chapter 2, Lookup tables provides detailed information about the tables used by all of the Network Performance feature components. v Chapter 3, Supported log records contains information about the SMF record types and subtypes used by the Network Performance feature components. Part II contains these chapters: v Chapter 4, Basic data flows provides an overview of the procedure the feature uses to process data. v Chapter 5, Availability component data flows describes the procedure the feature uses to process network availability data. v Chapter 6, Configuration component data flows describes the procedure the feature uses to process network configuration data. v Chapter 7, NetView FTP component data flows describes the procedure the feature uses to process NetView file transfer program (FTP) data. v Chapter 8, Problem component data flows describes the procedure the feature uses to process network problem data. v Chapter 9, Session failure component data flows describes the procedure the feature uses to process network session failure data. v Chapter 10, RTM response time component data flow describes the procedure the feature uses to process response-time data from the response time monitor (RTM). ix

Preface v v v v v v v v v v v v v v v Chapter 11, NPM transit time component data flow describes the procedure the feature uses to process NPM transit-time data. Chapter 12, Service component data flows describes the procedure the feature uses to process network service data. Chapter 13, NCP utilization component data flows describes the procedure the feature uses to process NCP utilization data. Chapter 14, Line utilization component data flows describes the procedure the feature uses to process line utilization data. Chapter 15, PU utilization component data flows describes the procedure the feature uses to process physical unit (PU) utilization data. Chapter 16, NPM internal utilization component data flows describes the procedure the feature uses to process NPM internal utilization data. Chapter 17, NV/SM internal utilization component data flows describes the procedure the feature uses to process NetView session monitor (NV/SM) internal utilization data. Chapter 18, NTRI utilization component data flows describes the procedure the feature uses to process NCP/Token-Ring interconnection (NTRI) utilization data. Chapter 19, NEO utilization component data flows describes the procedure the feature uses to process network extension option (NEO) utilization data. Chapter 20, X.25 utilization component data flows describes the procedure the feature uses to process X.25 utilization data. Chapter 21, LAN utilization component data flows describes the procedure the feature uses to process LAN utilization data. Chapter 22, VTAM utilization component data flows describes the procedure the feature uses to process VTAM utilization data. Chapter 23, Frame Relay utilization component data flow describes the procedure the feature uses to process frame relay utilization data. Chapter 24, ODLC utilization component data flow describes the procedure the feature uses to process ODLC utilization data. Chapter 25, SNMP routers component data flow describes the procedure the feature uses to process SNMP routers utilization data. A list of abbreviations, a glossary, and index follow these chapters. Publications This section lists publications in the Tivoli Decision Support for OS/390 library and any other related documents. It also describes how to access Tivoli publications online and how to order Tivoli publications. IBM Tivoli Decision Support for OS/390 Library The following documents are available in the Tivoli Decision Support for OS/390: v Administration Guide, SH19-6816 Provides information about initializing the Tivoli Decision Support for OS/390 database and customizing and administering Tivoli Decision Support for OS/390. v Guide to the Reporting Dialog, SH19-6842 Provides information for users who display existing reports, for users who create and modify reports, and for administrators who control reporting dialog default functions and capabilities. x Tivoli Decision Support for OS/390: Network Performance Feature Reference

Preface v Language Guide and Reference, SH19-6817 Provides information for adminstrators, performance analysts, and programmers who are responsible for maintaining system log data and reports. v User s Guide for the Viewer, SH19-4517 Provides information about how use the graphical interface for Tivoli Decision Support for OS/390. v Messages and Problem Determination, SH19-6902 Provides information to help operators and system programmers understand, interpret, and respond to Tivoli Decision Support for OS/390 messages and codes. v Accounting Feature for the Host, SH19-4495 Provides information for users who want to use Tivoli Decision Support for OS/390 to collect and report performance data generated by the Accounting feature. v Accounting Feature for the Workstation, SH19-4516 Provides information for users who want to use the Accounting Workstation Option to manage, process, and analyze financial data on a workstation. v AS/400 System Performance Feature Guide and Reference, SH19-4019 Provides information for administrators and users about collecting and reporting performance data generated by AS/400 systems. v CICS Performance Feature Guide and Reference, SH19-6820 Provides information for administrators and users about collecting and reporting performance data generated by Customer Information and Control System (CICS ). v Distributed Systems Performance Feature Guide and Reference, SH19-4018 Provides information for administrators and users about collecting and reporting performance data generated byoperating systems and applications running on a workstation. v IMS Performance Feature Guide and Reference, SH19-6825 Provides information for administrators and users about collecting and reporting performance data generated byinformation Management System (IMS ). v Network Performance Feature Installation and Administration, SH19-6901 Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. v Network Performance Feature Reference, SH19-6822 Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. v Network Performance Feature Reports, SH19-6821 Provides information for network analysts or programmers who use the Network Performance feature reports. v System Performance Feature Guide, SH19-6818 Provides information for performance analysts and system programmers who are responsible for meeting the service-level objectives established in your organization. v System Performance Feature Reference Vol. I, SH19-6819 Provides information for administrators and users with a variety of backgrounds who want to use Tivoli Decision Support for OS/390 to analyze Multiple Virtual Storage (MVS), or Virtual Machine (VM). v System Performance Feature Reference Vol. II, SH19-4494 Preface xi

Preface v v Provides information for administrators and users with a variety of backgrounds who want to use Tivoli Decision Support for OS/390 to analyze Multiple Virtual Storage (MVS), or Virtual Machine (VM) performance data. IBM Online Library Omnibus Edition OS/390 Collection Kit, SK3T-4270 CD containing all OS/390 documentation. IBM Online Library z/os Software Products Collection Kit, SK2T-6012 CD containing all z/os documentation. Using LookAt to look up message explanations LookAt is an online facility that lets you look up explanations for most messages you encounter, as well as for some system abends and codes. Using LookAt to find information is faster than a conventional search because in most cases LookAt goes directly to the message explanation. You can access LookAt from the Internet at: http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/ or from anywhere in z/os or z/os.e where you can access a TSO/E command line (for example, TSO/E prompt, ISPF, z/os UNIX System Services running OMVS). The LookAt Web site also features a mobile edition of LookAt for devices such as Pocket PCs, Palm OS, or Linux-based handhelds. So, if you have a handheld device with wireless access and an Internet browser, you can now access LookAt message information from almost anywhere. Accessing publications online IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli Software Information Center Web site. The Tivoli Software Information Center is located at the following Web address: http://publib.boulder.ibm.com/tividd/td/tdprodlist.html Click the Tivoli Decision Support for OS/390 link to access the product library. These publications are available in PDF or HTML format, or both. Translated documents are also available for some products. Note: If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog. This option is available when you click File Print. Fit to page ensures that the full dimensions of a letter-sized page print on the paper that you are using. Ordering publications You can order many Tivoli publications online at the following Web site: http://www.elink.ibmlink.ibm.com/public/applications/publications/ cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: v In the United States: 800-879-2755 v In Canada: 800-426-4968 In other countries, see the following Web site for a list of telephone numbers: xii Tivoli Decision Support for OS/390: Network Performance Feature Reference

Preface http://www.ibm.com/software/tivoli/order-lit/ Accessibility Contacting software support Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface.you can also use the keyboard instead of the mouse to operate all features of the graphical user interface. For additional information, see the Accessibility Appendix in the Administration Guide. If you have a problem with any Tivoli product, refer to the following IBM Software Support Web site: http://www.ibm.com/software/sysmgmt/products/support/ If you want to contact software support, see the IBM Software Support Guide at the following Web site: http://techsupport.services.ibm.com/guides/handbook.html The guide provides information about how to contact IBM Software Support, depending on the severity of your problem, and the following information: v Registration and eligibility v v Telephone numbers and e-mail addresses, depending on the country in which you are located Information you must have before contacting IBM Software Support Note: For Tivoli NetView for OS/390 customers only, additional support is available on the NETVIEW CFORUM (Customer Forum) through the IBMLink system. This forum is monitored by NetView developers who answer questions and provide guidance. When a problem with the code is found, you are asked to open an official problem management record (PMR) to obtain resolution. Conventions used in this book This guide uses several conventions for special terms and actions, operating system-dependent commands and paths, and margin graphics. The term z/os is used in this book to mean z/os and OS/390 operating systems. Where the term OS/390 does appear, the related information applies only to OS/390 operating systems. Typeface conventions This guide uses the following typeface conventions: Bold v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Preface xiii

Preface v v v Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Column headings in a table Keywords and parameters in text Italic v Citations (titles of books, diskettes, and CDs) v Words defined in text v Emphasis of words (words as words) v Letters as letters v New terms in text (except in a definition list) v Variables and values you must provide Monospace v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text v Message text and prompts addressed to the user v Text that the user must type v Values for arguments or command options Changes in This Edition The following changes appear in this edition of the Tivoli Decision Support for OS/390 Network Performance Feature Reference: v The name of the base product has been changed to Tivoli Decision Support for OS/390. v New fields and tables have been added to Chapter 1, Component tables to support the NPM for IP 1.4 component. v New information has been added to the existing tables in Chapter 1, Component tables, on page 3, describing the Network name and the Utilization Percent. v Chapter 26, NPM/IP Component Data Flows has been added to support the NPM for IP 1.4 component. Except for editorial changes, changes in this edition are marked with a vertical bar to the left of the change. The terms MVS and OS/390 are used interchangeably throughout this book. xiv Tivoli Decision Support for OS/390: Network Performance Feature Reference

Part 1. Tables and logs Chapter 1. Component tables........ 3 Naming standard for data tables........ 3 Table descriptions............ 3 NW_ALERT_BASIC_H, _D, _W....... 5 NW_ALERT_GENERIC_H, _D, _W...... 6 NW_CONFIG_HARDWARE........ 8 NW_CONFIG_SOFTWARE........ 10 NW_FRRYL_UTIL_H, _D, _W....... 12 NW_FRRYLM_UTIL_H, _D, _W...... 15 NW_FRRYP_UTIL_H, _D, _W....... 17 NW_FRRYPS_UTIL_H, _D, _W....... 20 NW_FTP_REQUEST_H, _D, _M...... 22 NW_FTP_REQUEST_T......... 24 NW_FTP_TRANSMIT_H, _D, _M...... 26 NW_LANB_UTIL_H, _D, _W....... 27 NW_LANS_UTIL_H, _D, _W....... 30 NW_LINE_UTIL_H, _D, _W........ 32 NW_NCP_UTIL_H, _D, _W........ 36 NW_NEO_UTIL_H, _D, _W........ 39 NW_NPMIP_PERFORM_H, _D....... 42 NW_NPMIP_PERFVOL_H, _D....... 43 NW_NPMIP_WRKLOAD_H, _D...... 44 NW_NPM_TRANSIT_H, _D, _W, _M..... 45 NW_NPM_TRANS_IP_H, _D, _W, _M.... 51 NW_NPM_TRANS_SUM_H, _D, _W, _M... 57 NW_NPM_UTIL_H, _D, _W........ 63 NW_NTRIL_UTIL_H, _D, _W....... 66 NW_NTRIP_UTIL_H, _D, _W....... 69 NW_ODLCL_UTIL_H, _D, _W....... 72 NW_ODLCP_UTIL_H, _D, _W....... 74 NW_PU_UTIL_H, _D, _W........ 76 NW_ROUT_CISCIP_H, _D, _W....... 78 NW_ROUT_CISCO_H, _D, _W....... 82 NW_ROUT_CISPOOL_H, _D, _W...... 83 NW_ROUT_IBM_H, _D, _W........ 84 NW_ROUT_INTTRAF_H, _D, _W...... 87 NW_RTM_RESPONSE_H, _D, _W, _M.... 89 NW_SESSION_FAIL_H, _D, _W...... 91 NW_SM_UTIL_H, _D, _W........ 93 NW_VTAM_ADDSPACE_H, _D, _W..... 95 NW_VTAM_APPL_H, _D, _W....... 96 NW_VTAM_BFR_H, _D, _W....... 98 NW_VTAM_DEV_H, _D, _W....... 102 NW_VTAM_GLOBAL_H, _D, _W..... 106 NW_VTAM_VR_H, _D, _W....... 109 NW_X25LN_UTIL_H, _D, _W....... 111 NW_X25NI_UTIL_H, _D, _W....... 115 NW_X25PU_UTIL_H, _D, _W....... 118 Chapter 2. Lookup tables......... 121 Naming standard for lookup tables...... 121 Table descriptions............ 121 NW_ALERT_DESC.......... 122 Example of table contents....... 122 NW_ALERT_TYPE.......... 122 Example of table contents....... 122 NW_FAILURE_CODE......... 122 Example of table contents....... 123 NW_GENERAL_CAUSE........ 123 Example of table contents....... 123 NW_PROBABLE_CAUSE........ 123 Example of table contents....... 124 NW_PRODUCT_ID.......... 124 Example of table contents....... 124 NW_RESOURCE........... 124 NW_SPECIFIC_CAUSE......... 126 Example of table contents....... 126 NW_THRESHOLD.......... 126 Example of table contents....... 126 Chapter 3. Supported log records...... 129 SMF Type 28............. 129 SMF Type 37............. 130 SMF Type 39............. 130 SMF Type 251............. 130 SMF Type 252 or user-defined........ 130 1

2 Tivoli Decision Support for OS/390: Network Performance Feature Reference

Chapter 1. Component tables This chapter describes the data tables for the components of the Network Performance feature of IBM Tivoli Decision Support for OS/390 (hereafter referred to as Tivoli Decision Support for OS/390) and explains their naming standards. For descriptions of common data tables used by the Network Performance feature components and other Tivoli Decision Support for OS/390 features and components, refer to the Administration Guide. Naming standard for data tables Table descriptions Names of the Network Performance feature tables use this format: NW_content_suffix Where: v NW is short for network v content is a description (for example, NW_NEO_UTIL for NEO utilization data) v suffix indicates a summarization level of the data in the table (for example, NW_NEO_UTIL_D for NEO utilization data summarized by day) A table name can have these summarization-level suffixes: T The table holds nonsummarized data (timestamped data). H The table holds data summarized by hour (hourly data). D The table holds data summarized by day (daily data). W The table holds data summarized by week (weekly data). M The table holds data summarized by month (monthly data). Each table description includes information about the table, a description of each of the key columns, and a description of each of the data columns. Key columns are marked with a k. Data columns come after the last key column and are sorted in alphabetic order, with any underscores ignored. The descriptions of most key columns and data columns contain references to the fields from which they are derived in the SMF record, such as From BRFFLRTY. For an explanation of such fields, refer to the applicable IBM NetView Performance Monitor, IBM NetView, or IBM NetView File Transfer Program book. The tables appear in alphabetic order, with any underscores ignored. Note: Tables with similar contents (that is, tables with the same name but different suffixes) are described under one heading. For example, NW_ALERT_BASIC_H, _D, _W on page 5 contains information about these similar tables: NW_ALERT_BASIC_H NW_ALERT_BASIC_D NW_ALERT_BASIC_W 3

Component tables Except for the DATE column and TIME column, the contents of these tables are identical. For _W tables, the DATE column contains the first day of the week (weeks start on Monday). For _M tables, the DATE column contains the first day of the month. Differences in the contents of similar tables are explained in the column descriptions. The DATE and TIME information is stored in the standard SQL format and displayed in the local format. Hexadecimal codes in log records are stored as character data in DB2 tables. For example, a 2-byte field X'FFFF' is stored as a 4-byte character string FFFF. 4 Tivoli Decision Support for OS/390: Network Performance Feature Reference

NW_ALERT_BASIC_H, _D, _W These tables provide hourly, daily, and weekly statistics on basic alerts in the network. They contain basic-alert data from records with event sections written to SMF by the NetView hardware monitor as SMF Type 37 records. These tables are updated by the NW_PRODUCT_ID lookup table. The default retention periods for these tables are: NW_ALERT_BASIC_H 7 days NW_ALERT_BASIC_D 30 days NW_ALERT_BASIC_W 375 days Component tables Column name Data type Description DATE k DATE Date when the record was written to SMF. For the _W table, this is the date of the first day of the week. From BRFRDTE. TIME k TIME Time (rounded down to the nearest hour) when the record was written to SMF. This applies only to the _H table. From BRFRTME. PERIOD_NAME k CHAR(8) Name of the period. This is derived using fields BRFRSID, BRFRDTE, and BRFRTME from the record as parameters in the PERIOD function. PRODUCT_NAME k CHAR(9) Name of the product. This is the product identifier. From PRODUCT_NAME in the NW_PRODUCT_ID lookup table. This is derived using field BRFBLKID from the record as key. If PRODUCT_NAME is blank, this column gets its value from BRFBLKID. RESOURCE_CATEGORY k CHAR(4) Resource category. This can have the default value HOST, COMM, CTRL, or APPL. From RESOURCE_CATEGORY in the NW_PRODUCT_ID lookup table. This is derived using field BRFBLKID from the record as key. If no match is found, this column is set to a question mark (?). OWNING_RESOURCE k CHAR(8) Owner of the failing resource. From BRFHINM2, BRFHINM3, BRFHINM4, or BRFHINM5 if RESOURCE_HIERARCHY in the NW_PRODUCT_ID lookup table (derived using field BRFBLKID as key) equals 2, 3, 4, or 5, respectively; otherwise, from BRFHINM1. RESOURCE_NAME k CHAR(8) Name of the resource. This is the name of the failing resource. From BRFFLRNM. RESOURCE_TYPE k CHAR(4) Type of the resource. This is the type of the failing resource. From BRFFLRTY. ALERT_TYPE_CODE k CHAR(2) Alert type code. From BRFALRTT. If BRFALRTT is blank, this column is set to 40. GENERAL_CAUSE_CODE k CHAR(2) General cause of the alert. From BRFGENCA. If BRFGENCA is blank, this column is set to 40. SPEC_CAUSE_CODE k CHAR(2) Specific-component code. This is the specific cause of the alert. From BRFSPECA. If BRFSPECA is blank, this column is set to 40. EVENTS INTEGER Number of events. This is the count of records represented by BRFRDTE. Chapter 1. Component tables 5

Component tables NW_ALERT_GENERIC_H, _D, _W These tables provide hourly, daily, and weekly statistics on generic alerts in the network. They contain generic-alert data from records with generic-event sections written to SMF by the NetView hardware monitor as SMF Type 37 records. These tables are updated by the NW_PRODUCT_ID, NW_ALERT_DESC, and NW_PROBABLE_CAUSE lookup tables. The default retention periods for these tables are: NW_ALERT_GENERIC_H 7 days NW_ALERT_GENERIC_D 30 days NW_ALERT_GENERIC_W 375 days Column name Data type Description DATE k DATE Date when the record was written to SMF. For the _W table, this is the date of the first day of the week. From BRFRDTE. TIME k TIME Time (rounded down to the nearest hour) when the record was written to SMF. This applies only to the _H table. From BRFRTME. PERIOD_NAME k CHAR(8) Name of the period. This is derived using fields BRFRSID, BRFRDTE, and BRFRTME from the record as parameters in the PERIOD function. PRODUCT_NAME k CHAR(9) Name of the product. This is the product identifier. From PRODUCT_NAME in the NW_PRODUCT_ID lookup table. This is derived using field BRFPROID from the record as key. If PRODUCT_NAME is blank, this column gets its value from BRFPROID. RESOURCE_CATEGORY k CHAR(4) Resource category. This can have the default value HOST, COMM, CTRL, or APPL. From RESOURCE_CATEGORY in the NW_PRODUCT_ID lookup table. This is derived using field BRFPROID from the record as key. If no match is found, this column is set to a question mark (?). OWNING_RESOURCE k CHAR(8) Owner of the failing resource. From BRFHINM2, BRFHINM3, BRFHINM4, or BRFHINM5 if RESOURCE_HIERARCHY in the NW_PRODUCT_ID lookup table (derived using field BRFPROID as key) equals 2, 3, 4, or 5, respectively; otherwise, from BRFHINM1. RESOURCE_NAME k CHAR(8) Name of the resource. This is the name of the failing resource. From BRFFLRNM. RESOURCE_TYPE k CHAR(4) Type of the resource. This is the type of the failing resource. From BRFFLRTY. ALERT_TYPE_CODE k CHAR(2) Alert-type code. From BRFETYPE. If BRFETYPE is blank, this column is set to 40. ALERT_DESC_CODE k CHAR(4) Alert-description code. From ALERT_DESC_CODE in the NW_ALERT_DESC lookup table. This is derived using field BRFDESC from the record as key. If no match is found, this column is set to X'FFFF'. FIRST_CAUSE_CODE k CHAR(4) Code for the first probable cause of the alert. From FIRST_CAUSE_CODE in the NW_PROBABLE_CAUSE lookup table. This is derived using field BRFCAUS1 from the record as key. If no match is found, this column is set to X'FFFF'. ALERT_DESC CHAR(40) Alert description. From BRFDESC. 6 Tivoli Decision Support for OS/390: Network Performance Feature Reference

Component tables Column name Data type Description EVENTS INTEGER Number of events. This is the count of records represented by BRFRDTE. FIRST_CAUSE_DESC CHAR(40) Description of the first probable cause of the alert. From BRFCAUS1. Chapter 1. Component tables 7

Component tables NW_CONFIG_HARDWARE This table provides information about the hardware characteristics of a PU. It contains PU hardware configuration data from records written by the network asset management function of NetView as SMF Type 37, subsystem ID=VPD, subtype P records. The default retention period for this table is 765 days. Column name Data type Description DOMAIN_NAME k CHAR(8) Domain identifier. From VPDPDID. RESOURCE_NAME k CHAR(8) Name of the resource. This is set to the value in the DOMAIN_NAME, VTAM_NCP, PU_NAME, or LU_NAME column. If no valid name is found, this is set to the character string ERROR. CA_LINE CHAR(8) Channel address or line name. From VPDPLKN. CA_LINE_NEW CHAR(8) New channel address or line name. This is not used for reporting. From VPDPLKN. CA_LINE_OLD CHAR(8) Old channel address or line name. This is not used for reporting. From VPDPLKN. DATE DATE Date when the record was written to SMF. From VPDRDTE. DATE_ADDED DATE Date when data about the resource was initially added to this table. DATE_CHANGED DATE Date when data about the resource was last changed in a collect. DATE_REFERENCED DATE Date when data about the resource was collected. EC_LEVEL CHAR(10) Engineering change level. From VPDPECL. EC_LEVEL_NEW CHAR(10) New engineering change level. This is not used for reporting. From VPDPECL. EC_LEVEL_OLD CHAR(10) Old engineering change level. This is not used for reporting. From VPDPECL. LU_NAME CHAR(8) Name of the LU. From VPDPLUN. LU_NAME_NEW CHAR(8) New LU name. This is not used for reporting. From VPDPLUN. LU_NAME_OLD CHAR(8) Old LU name. Not used for reporting. From VPDPLUN. MACHINE_TYPE CHAR(5) Machine type. From VPDPTPE. MACHINE_TYPE_NEW CHAR(5) New machine type. This is not used for reporting. From VPDPTPE. MACHINE_TYPE_OLD CHAR(5) Old machine type. This is not used for reporting. From VPDPTPE. MANUFACTURER CHAR(3) Manufacturer ID. From VPDPMAN. MANUFACTURER_NEW CHAR(3) New manufacturer ID. This is not used for reporting. From VPDPMAN. MANUFACTURER_OLD CHAR(3) Old manufacturer ID. This is not used for reporting. From VPDPMAN. MODEL CHAR(3) Machine model. From VPDPMOD. MODEL_NEW CHAR(3) New machine model. This is not used for reporting. From VPDPMOD. MODEL_OLD CHAR(3) Old machine model. This is not used for reporting. From VPDPMOD. 8 Tivoli Decision Support for OS/390: Network Performance Feature Reference

Component tables Column name Data type Description NEW_IND CHAR(1) Indicates that the resource was referenced in the last collect run. This is set to Y (yes) if it was referenced; otherwise, this is set to blank. PORT_NUMBER CHAR(6) Attached-port number. From VPDPPRTN. PORT_NUMBER_NEW CHAR(6) New attached-port number. This is not used for reporting. From VPDPPRTN. PORT_NUMBER_OLD CHAR(6) Old attached-port number. This is not used for reporting. From VPDPPRTN. PU_NAME CHAR(8) Name of the PU. From VPDPSPUN. PU_NAME_NEW CHAR(8) New PU name. This is not used for reporting. From VPDPSPUN. PU_NAME_OLD CHAR(8) Old PU name. This is not used for reporting. From VPDPSPUN. RESOURCE_TYPE CHAR(8) Depending on the type of resource, this is set to the character string NCP, CA/LINE, PU, or LU. If no valid type is found, this is set to ERROR. RESOURCE_TYPE_NEW CHAR(8) New resource type. Depending on the type of resource, this is set to the character string NCP, CA/LINE, PU, or LU. RESOURCE_TYPE_OLD CHAR(8) Old resource type. This is not used for reporting. SERIAL_NUMBER CHAR(7) Serial number of the device. From VPDPSEQ. SERIAL_NUMBER_NEW CHAR(7) New serial number. This is not used for reporting. From VPDPSEQ. SERIAL_NUMBER_OLD CHAR(7) Old serial number. This is not used for reporting. From VPDPSEQ. TIME TIME Time when the record was written to SMF. From VPDRTME. TIME_ADDED TIME Time when data about the resource was initially added to this table. TIME_CHANGED TIME Time when data about the resource was last changed in a collect. TIME_REFERENCED TIME Time when data about the resource was collected. VTAM_NCP CHAR(8) VTAM or NCP name. From VPDPPPUN. VTAM_NCP_NEW CHAR(8) New VTAM or NCP name. From VPDPPPUN. VTAM_NCP_OLD CHAR(8) Old VTAM or NCP name. This is not used for reporting. From VPDPPPUN. Chapter 1. Component tables 9

Component tables NW_CONFIG_SOFTWARE This table provides information about the software characteristics of a PU. It contains PU software configuration data from records written by the network asset management function of NetView as SMF Type 37, subsystem ID=VPD, subtype F records. The default retention period for this table is 765 days. Column name Data type Description DOMAIN_NAME k CHAR(8) Domain ID. From VPDFDID. RESOURCE_NAME k CHAR(8) Name of the resource. This is set to the value in the DOMAIN_NAME, VTAM_NCP, PU_NAME, or LU_NAME column. If no valid name is found, this is set to the character string ERROR. CA_LINE CHAR(8) Channel address or line name. From VPDFLKN. CA_LINE_NEW CHAR(8) New channel address or line name. This is not used for reporting. From VPDFLKN. CA_LINE_OLD CHAR(8) Old channel address or line name. This is not used for reporting. From VPDFLKN. COMPONENT_ID CHAR(9) Component ID. From VPDFCOMP. COMPONENT_ID_NEW CHAR(9) New component ID. This is not used for reporting. From VPDFCOMP. COMPONENT_ID_OLD CHAR(9) Old component ID. This is not used for reporting. From VPDFCOMP. CUSTOMIZE_DATE CHAR(6) Date when the customization was done, in the format YY/DDD. From VPDFCDTE. CUSTOMIZE_DATE_NEW CHAR(6) New customization date, in the format YY/DDD. This is not used for reporting. From VPDFCDTE. CUSTOMIZE_DATE_OLD CHAR(6) Old customization date, in the format YY/DDD. This is not used for reporting. From VPDFCDTE. CUSTOMIZE_TIME CHAR(5) Time when the customization was done, in the format HH:MM. From VPDFCTME. CUSTOMIZE_TIME_NEW CHAR(5) New customization time, in the format HH:MM. This is not used for reporting. From VPDFCTME. CUSTOMIZE_TIME_OLD CHAR(5) Old customization time, in the format HH:MM. This is not used for reporting. From VPDFCTME. DATE DATE Date when the record was written to SMF. From VPDRDTE. DATE_ADDED DATE Date when data about the resource was initially added to this table. DATE_CHANGED DATE Date when data about the resource was last changed in a collect. DATE_REFERENCED DATE Date when data about the resource was collected. LU_NAME CHAR(8) Name of the LU. From VPDFLUN. LU_NAME_NEW CHAR(8) New LU name. This is not used for reporting. From VPDFLUN. LU_NAME_OLD CHAR(8) Old LU name. This is not used for reporting. From VPDFLUN. NEW_IND CHAR(1) Indicates that the resource was referenced in the last collect run. This is set to Y (yes) if it was referenced; otherwise, this is set to blank. PU_NAME CHAR(8) Name of the PU. From VPDFSPUN. PU_NAME_NEW CHAR(8) New PU name. This is not used for reporting. From VPDFSPUN. 10 Tivoli Decision Support for OS/390: Network Performance Feature Reference