Network Performance Feature Reference

Transcription

1 Tivoli Decision Support for OS/390 Network Performance Feature Reference Version 1.6 SH

2

3 Tivoli Decision Support for OS/390 Network Performance Feature Reference Version 1.6 SH

4 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 ) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SH Copyright International Business Machines Corporation 1993, All rights reserved. Note to U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.

5 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 Chapter 1. Component tables Naming standard for data tables Table descriptions NW_ALERT_BASIC_H, _D, _W NW_ALERT_GENERIC_H, _D, _W NW_CONFIG_HARDWARE NW_CONFIG_SOFTWARE NW_FRRYL_UTIL_H, _D, _W NW_FRRYLM_UTIL_H, _D, _W NW_FRRYP_UTIL_H, _D, _W NW_FRRYPS_UTIL_H, _D, _W NW_FTP_REQUEST_H, _D, _M NW_FTP_REQUEST_T NW_FTP_TRANSMIT_H, _D, _M NW_LANB_UTIL_H, _D, _W NW_LANS_UTIL_H, _D, _W NW_LINE_UTIL_H, _D, _W NW_NCP_UTIL_H, _D, _W NW_NEO_UTIL_H, _D, _W NW_NPMIP_PERFORM_H, _D NW_NPMIP_PERFVOL_H, _D NW_NPMIP_WRKLOAD_H, _D NW_NPM_TRANSIT_H, _D, _W, _M NW_NPM_TRANS_IP_H, _D, _W, _M NW_NPM_TRANS_SUM_H, _D, _W, _M NW_NPM_UTIL_H, _D, _W NW_NTRIL_UTIL_H, _D, _W NW_NTRIP_UTIL_H, _D, _W NW_ODLCL_UTIL_H, _D, _W NW_ODLCP_UTIL_H, _D, _W NW_PU_UTIL_H, _D, _W NW_ROUT_CISCIP_H, _D, _W NW_ROUT_CISCO_H, _D, _W NW_ROUT_CISPOOL_H, _D, _W NW_ROUT_IBM_H, _D, _W NW_ROUT_INTTRAF_H, _D, _W NW_RTM_RESPONSE_H, _D, _W, _M NW_SESSION_FAIL_H, _D, _W NW_SM_UTIL_H, _D, _W NW_VTAM_ADDSPACE_H, _D, _W NW_VTAM_APPL_H, _D, _W NW_VTAM_BFR_H, _D, _W NW_VTAM_DEV_H, _D, _W NW_VTAM_GLOBAL_H, _D, _W NW_VTAM_VR_H, _D, _W NW_X25LN_UTIL_H, _D, _W NW_X25NI_UTIL_H, _D, _W NW_X25PU_UTIL_H, _D, _W Chapter 2. Lookup tables Naming standard for lookup tables Table descriptions NW_ALERT_DESC Example of table contents NW_ALERT_TYPE Example of table contents NW_FAILURE_CODE Example of table contents NW_GENERAL_CAUSE Example of table contents NW_PROBABLE_CAUSE Example of table contents NW_PRODUCT_ID Example of table contents NW_RESOURCE NW_SPECIFIC_CAUSE Example of table contents NW_THRESHOLD Example of table contents Chapter 3. Supported log records SMF Type SMF Type SMF Type SMF Type SMF Type 252 or user-defined Part 2. Data flow reference Chapter 4. Basic data flows Understanding Network Performance feature data processing NetView, NPM, and NetView FTP capture network data External log collects availability data NetView and NPM write data to the SMF log 138 Tivoli Decision Support for OS/390 collects SMF data Feature adds environment data to tables Looking up period information iii

6 Tivoli Decision Support for OS/390 creates reports How the Network Performance feature records time Chapter 5. Availability component data flows How the Network Performance feature measures availability SNA availability End-user and NCP availability Application availability Cross-connection availability External availability Availability processing Capturing SNA availability data Capturing external availability data Collecting data Looking up resource information Looking up information for APPL, NCP, or PU resource types Looking up information for cross-connection resources Looking up schedule information Looking up the schedule name Looking up schedule data Adding data to the AVAILABILITY_D, _W, and _M tables Looking up resource data for reports Creating reports Measuring resource uptime NetView session monitor restart Measuring resource downtime Unavailable resources when SMF is switched 155 Measuring switched resource availability Chapter 6. Configuration component data flows Configuration Configuration data collection Hardware device configuration data flow Collecting hardware configuration information 158 Collecting SMF data and updating the NW_CONFIG_HARDWARE table Creating reports Software product configuration data flow Collecting software configuration information 162 Collecting SMF data and updating the NW_CONFIG_SOFTWARE table Creating reports Chapter 7. NetView FTP component data flows NetView FTP performance Processing steps for FTP data Capturing NetView FTP data Collecting SMF data Collecting FTP request data Collecting FTP transmit data Looking up period information Creating reports Chapter 8. Problem component data flows Basic and generic alerts Problem categories Basic-alert data flow Capturing basic-alert data Collecting SMF data Looking up product ID information Error conditions Looking up period information Looking up problem cause information Error conditions Creating reports Generic alert data flow Capturing generic alert data Collecting SMF data Looking up resource information Error conditions Looking up period information Looking up probable-cause information Error conditions Looking up alert description information Error conditions Looking up alert type information Error conditions Creating reports Chapter 9. Session failure component data flows Session failures Session failure data flow Capturing session failure data Collecting SMF data Looking up period information Looking up failure descriptions Creating reports Chapter 10. RTM response time component data flow Response-time reporting based on RTM RTM response-time definition RTM response-time data flow Capturing RTM response-time data Collecting SMF data Looking up resource information Error conditions for PU resources Error conditions for application resources 190 Looking up period information Looking up resource description information 191 Creating reports Chapter 11. NPM transit time component data flow Measuring workstation-to-application transactions 193 Transit-time logging NPM transit-time objectives NPM transit-time data flow iv Tivoli Decision Support for OS/390: Network Performance Feature Reference

7 Capturing NPM transit-time data Collecting SMF data Looking up resource information Looking up period information Looking up resource description information 198 Creating reports Chapter 12. Service component data flows Network Performance feature service reports Service data flow Looking up resource information Creating reports Chapter 13. NCP utilization component data flows Utilization Collecting utilization data NCP utilization data flow Capturing NCP utilization data Collecting SMF data Looking up period information Looking up resource information Creating reports Chapter 14. Line utilization component data flows Utilization Collecting utilization data Threshold values Line utilization data flow Capturing line utilization data Collecting SMF data Looking up period information Looking up threshold information Creating reports Chapter 15. PU utilization component data flows Utilization Collecting utilization data PU utilization data flow Capturing PU utilization data Collecting SMF data Looking up period information Creating reports Chapter 16. NPM internal utilization component data flows NPM internal utilization NPM internal utilization data flow Capturing NPM utilization data Collecting SMF data Looking up period information Creating reports Chapter 17. NV/SM internal utilization component data flows Utilization NV/SM internal utilization NV/SM internal utilization data flow Capturing NV/SM utilization data Collecting SMF data Looking up period information Creating reports Chapter 18. NTRI utilization component data flows Utilization Collecting utilization data NTRI utilization data flow Capturing NTRI utilization data Collecting SMF data Looking up period information Looking up resource information Creating reports Chapter 19. NEO utilization component data flows Utilization Collecting utilization data Threshold values NEO utilization data flow Capturing NEO utilization data Collecting SMF data Looking up period information Looking up resource information Looking up threshold information Creating reports Chapter 20. X.25 utilization component data flows Collecting utilization data Threshold values X.25 link utilization data flow Capturing X.25 link utilization data Collecting SMF data Looking up period information Looking up resource information Looking up threshold information Creating reports X.25 PU and VC utilization data flow Capturing X.25 utilization data Collecting SMF data Looking up period information Looking up resource information Creating reports Chapter 21. LAN utilization component data flows Utilization Collecting utilization data Threshold values LAN bridge thresholds LAN segment thresholds LAN utilization data flow Capturing LAN utilization data Contents v

8 Collecting SMF data Looking up period information Creating reports Chapter 22. VTAM utilization component data flows Utilization Collecting utilization data VTAM utilization data flow Capturing VTAM utilization data Collecting SMF data Looking up period information Chapter 23. Frame Relay utilization component data flow Utilization Collecting utilization data Frame Relay utilization data flow Capture Frame Relay data Collect SMF data Looking up period information Looking up resource information Creating reports Chapter 24. ODLC utilization component data flow Utilization Collecting utilization data ODLC utilization data flow Capture ODLC data Collect SMF data Looking up period information Looking up resource information Creating reports Chapter 25. SNMP routers component data flow Utilization Collecting utilization data SNMP routers utilization data flow Capturing SNMP routers utilization data Collecting SMF data Creating reports Chapter 26. NPM/IP Component Data Flows NPM/IP performance and workload Processing steps for NPM/IP data Capturing NPM/IP data Collecting SMF data Creating reports Part 3. Appendixes List of abbreviations Notices Trademarks Glossary Index vi Tivoli Decision Support for OS/390: Network Performance Feature Reference

9 Figures 1. Basic Network Performance feature data flow Collecting SMF data Example of a PERIOD_PLAN table Looking up period information Recording time in the Network Performance feature Example using a long NetView collect period Connection types Availability component data flow Looking up resource data for APPL, NCP, or PU resources Looking up data for cross-domain connection resources Looking up schedule name Looking up schedule information Looking up resource information for reports Calculating uptime NetView session monitor restart Calculating downtime Last event is a session stop Timing of SMF switch and Tivoli Decision Support for OS/390 collect jobs Process for hardware device configuration data NW_CONFIG_HARDWARE table Collecting hardware configuration data Process for software product configuration data NW_CONFIG_SOFTWARE table Collecting software configuration data Process for FTP data Basic-alert data flow Looking up product ID information for basic alerts Looking up problem cause information for basic alerts Generic alert data flow Looking up product ID information for generic alerts Lookup process for probable cause information Lookup process for alert description information Lookup process for alert type information Process for session failure data Lookup process for session failure description information Process for RTM response time Looking up resource information for PU resources Looking up resource information for application resources Looking up resource description information using resource name as key Life cycle of a workstation-to-application transaction Process for NPM transit time Looking up resource information for PU resources Looking up resource information for application resources Looking up resource description information using the resource name as key Creating service reports (1) Creating service reports (2) Looking up resource information for service reports using resource name as key Process for NCP utilization data Looking up resource information for NCP utilization Process for line utilization data Looking up threshold information for line resources Process for PU utilization data NPM internal utilization data flow NV/SM internal utilization data flow Process for NTRI utilization data Looking up resource information for NTRI utilization Process for NEO utilization data Looking up resource information for NEO utilization Looking up threshold information for NEO resources Process for X.25 link utilization data Looking up resource information for X.25 link utilization Looking up threshold information for X.25 link resources Process for X.25 PU and VC utilization data Looking up resource information for X.25 PU and VC utilization Process for LAN utilization data Process for VTAM utilization data Process for frame relay utilization data Looking up resource information for frame relay utilization Process for ODLC utilization data Looking up resource information for ODLC utilization IP Performance Data Collection by NPM Process for SNMP routers utilization data Processing NPM/IP data vii

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

11 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

12 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, SH 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, SH 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

13 Preface v Language Guide and Reference, SH 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, SH Provides information about how use the graphical interface for Tivoli Decision Support for OS/390. v Messages and Problem Determination, SH 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, SH 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, SH 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, SH Provides information for administrators and users about collecting and reporting performance data generated by AS/400 systems. v CICS Performance Feature Guide and Reference, SH 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, SH 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, SH Provides information for administrators and users about collecting and reporting performance data generated byinformation Management System (IMS ). v Network Performance Feature Installation and Administration, SH Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. v Network Performance Feature Reference, SH Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. v Network Performance Feature Reports, SH Provides information for network analysts or programmers who use the Network Performance feature reports. v System Performance Feature Guide, SH 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, SH 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, SH Preface xi

14 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: 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: 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: cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: v In the United States: v In Canada: 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

15 Preface 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: If you want to contact software support, see the IBM Software Support Guide at the following Web site: 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 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

16 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

17 Part 1. Tables and logs Chapter 1. Component tables Naming standard for data tables Table descriptions NW_ALERT_BASIC_H, _D, _W NW_ALERT_GENERIC_H, _D, _W NW_CONFIG_HARDWARE NW_CONFIG_SOFTWARE NW_FRRYL_UTIL_H, _D, _W NW_FRRYLM_UTIL_H, _D, _W NW_FRRYP_UTIL_H, _D, _W NW_FRRYPS_UTIL_H, _D, _W NW_FTP_REQUEST_H, _D, _M NW_FTP_REQUEST_T NW_FTP_TRANSMIT_H, _D, _M NW_LANB_UTIL_H, _D, _W NW_LANS_UTIL_H, _D, _W NW_LINE_UTIL_H, _D, _W NW_NCP_UTIL_H, _D, _W NW_NEO_UTIL_H, _D, _W NW_NPMIP_PERFORM_H, _D NW_NPMIP_PERFVOL_H, _D NW_NPMIP_WRKLOAD_H, _D NW_NPM_TRANSIT_H, _D, _W, _M NW_NPM_TRANS_IP_H, _D, _W, _M NW_NPM_TRANS_SUM_H, _D, _W, _M NW_NPM_UTIL_H, _D, _W NW_NTRIL_UTIL_H, _D, _W NW_NTRIP_UTIL_H, _D, _W NW_ODLCL_UTIL_H, _D, _W NW_ODLCP_UTIL_H, _D, _W NW_PU_UTIL_H, _D, _W NW_ROUT_CISCIP_H, _D, _W NW_ROUT_CISCO_H, _D, _W NW_ROUT_CISPOOL_H, _D, _W NW_ROUT_IBM_H, _D, _W NW_ROUT_INTTRAF_H, _D, _W NW_RTM_RESPONSE_H, _D, _W, _M NW_SESSION_FAIL_H, _D, _W NW_SM_UTIL_H, _D, _W NW_VTAM_ADDSPACE_H, _D, _W NW_VTAM_APPL_H, _D, _W NW_VTAM_BFR_H, _D, _W NW_VTAM_DEV_H, _D, _W NW_VTAM_GLOBAL_H, _D, _W NW_VTAM_VR_H, _D, _W NW_X25LN_UTIL_H, _D, _W NW_X25NI_UTIL_H, _D, _W NW_X25PU_UTIL_H, _D, _W Chapter 2. Lookup tables Naming standard for lookup tables Table descriptions NW_ALERT_DESC Example of table contents NW_ALERT_TYPE Example of table contents NW_FAILURE_CODE Example of table contents NW_GENERAL_CAUSE Example of table contents NW_PROBABLE_CAUSE Example of table contents NW_PRODUCT_ID Example of table contents NW_RESOURCE NW_SPECIFIC_CAUSE Example of table contents NW_THRESHOLD Example of table contents Chapter 3. Supported log records SMF Type SMF Type SMF Type SMF Type SMF Type 252 or user-defined

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

19 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

20 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

21 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

22 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

23 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

24 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

25 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

26 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