IBM IBM i Systems management Performance reference information 7.1 IBM IBM i Systems management Performance reference information 7.1 Note Before using this information and the product it supports, read the information in “Notices,” on page 267. This edition applies to IBM i 7.1 (product number 5770-SS1) and to all subsequent releases and modifications until otherwise indicated in new editions. This version does not run on all reduced instruction set computer (RISC) models nor does it run on CISC models. © Copyright IBM Corporation 1998, 2010. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Reference information for Performance 1 Disk Watcher data files: QAPYDWSTAT ... 237 Collection Services data files ......... 1 Disk Watcher data files: QAPYDWTDER ... 239 Collection Services data files containing time Disk Watcher data files: QAPYDWTRC .... 240 interval data ............. 1 Data files: File abbreviations ........ 244 Collection Services data files: Field data for CL commands for performance ....... 244 configuration database files........ 221 Intelligent Agents ............ 247 Collection Services database files: Field data for Intelligent Agent concepts ........ 247 trace database files .......... 229 Developing agents........... 250 Collection Services data files: System category Set up your agent environment ...... 252 and file relationships .......... 229 Managing agents ........... 260 Collection Services data files: Task type extender 231 Disk Watcher data files .......... 234 Appendix. Notices ......... 267 Disk Watcher data files: QAPYDWINTI.... 234 Programming Interface Information ...... 268 Disk Watcher data files: QAPYDWOBJR ... 235 Trademarks .............. 269 Disk Watcher data files: QAPYDWPGMR ... 236 Terms and conditions........... 269 Disk Watcher data files: QAPYDWRUNI ... 236 © Copyright IBM Corp. 1998, 2010 iii iv IBM i: Systems management Performance reference information Reference information for Performance Additional reference materials related to performance. Collection Services data files You can generate database files from the collection objects maintained by Collection Services. Use this topic to find the names, descriptions and attributes of these database files. Performance data is a set of information about the operation of a system (or network of systems) that can be used to understand response time and throughput. You can use performance data to make adjustments to programs, system attributes, and operations. These adjustments can improve response times and throughputs. Adjustments can also help you to predict the effects of certain changes to the system, operation, or program. Collection Services collects performance data into a management collection object (*MGTCOL). The Create Performance Data (CRTPFRDTA) command processes data from that collection object and stores the result into performance database files. Additional field information, such as number of bytes and buffer position, is available by using the Display File Field Description (DSPFFD) command. For example, type the following on any command line: DSPFFD file(QSYS/QAPMCONF) Related information: Collection Services Use Collection Services to collect performance data for later analysis. Create Performance Data (CRTPFRDTA) command See the Create Performance Data (CRTPFRDTA) command for information on how to create performance database files. Display File Field Description (DSPFFD) command See the Display File Field Description (DSPFFD) command for information on how to display field information. Collection Services data files containing time interval data These files contain performance data that is collected each interval. Collection Services data files: QAPMAPPN This database file defines the fields in the Advanced Peer-to-Peer Networking (APPN) data file record. Field Name Description Attribute INTNUM Interval number: The nth sample database interval PD (5,0) based on the start time specified in the Create Performance Data (CRTPFRDTA) command DTETIM Interval date (yymmdd) and time (hhmmss): The date C (12) and time of the sample interval INTSEC Elapsed interval seconds: The number of seconds since PD (7,0) the last sample interval ANTGU Total number of transmission group (TG) updates PD(11,0) processed © Copyright IBM Corp. 1998, 2010 1 Field Name Description Attribute ATTGU Cumulative time (in milliseconds) to process the TG PD(11,0) updates ANTGUM Number of TG updates that require one or more PD(11,0) resources to be added to the topology database update (TDU) buffer ANRATG Number of resources added to TDU buffers due to TG PD(11,0) update processing ANTSTG Number of TDUs sent as a result of initially creating a PD(11,0) TDU buffer on behalf of TG updates ANNTTG Number of network nodes that had TDUs sent to them PD(11,0) due to TDUs being created for TG update processing ANNCTC Total number of node congestion transition changes PD(11,0) processed ATNCTC Cumulative elapsed time for processing congestion PD(11,0) transition changes ATRSNC Number of times that topology routing services (TRS) PD (11,0) entered into non-congested state ATRSC Number of times that TRS entered into congested state PD (11,0) ATNCS Cumulative elapsed time (in milliseconds) that the PD(11,0) system was in non-congested state ATCS Cumulative elapsed time (in milliseconds) that the PD (11,0) system was in congested state ATSCP Number of TDUs sent as a result of initially creating a PD (11,0) TDU buffer on behalf of node congestion processing ANTSCP Number of network nodes that had TDUs sent to them PD (11,0) due to TDUs being created for node congestion processing ANTDUP Total number of received TDUs processed by this node PD (11,0) ATTDUP Cumulative elapsed time for processing the received PD (11,0) TDUs ANNRTD Number of new resources received in TDUs that cause PD (11,0) resources to be added to the TDU buffer ANORTN Number of old resources received in TDUs that do not PD (11,0) require a resource to be added to the TDU buffer ANORTA Number of old resources received in TDUs that do PD (11,0) require resources to be added to the TDU buffer ANTSRT Number of TDUs sent as a result of initially creating a PD (11,0) TDU buffer on behalf of processing a received TDU ANNTST Number of network nodes that had TDUs sent to them PD (11,0) due to TDUs being created for processing received TDUs ACNTID Network ID of the node that received the most TDUs C (8) within the interval ACCPNM Control point (CP) name of the node that received the C (8) most TDUs within the interval ANTRFN Number of TDUs received this interval by the node that PD (11,0) received the most TDUs in the interval 2 IBM i: Systems management Performance reference information Field Name Description Attribute ANITEP Total number of initial topology exchanges processed by PD (11,0) this node ATPIE Cumulative elapsed time for processing the initial PD (11,0) exchange ANTECT Number of times the initial topology exchange caused PD (11,0) the complete network node topology to be sent ANTDE Total number of entries in the entire topology database PD (11,0) (this value is not a delta) ANTERS Number of resources (nodes and TGs) added to the PD (11,0) TDU buffer due to initial topology exchange ANTETS Number of TDUs sent as a result of initial topology PD (11,0) exchange ANGCP Number of times that obsolete topology entries were PD (11,0) removed ATGCP Cumulative elapsed time for removing the obsolete PD (11,0) topology entries ANTEDG Number of topology entries that were deleted PD (11,0) ANTGC Number of TDUs that were sent when obsolete topology PD (11,0) entries were deleted ANNTGC Number of network nodes that had TDUs sent to them PD (11,0) when obsolete topology entries were removed ANRRP Total number of registration requests processed PD (11,0) ANNLRR Total number of locations processed with the PD (11,0) registration requests ATPRR Cumulative elapsed time to process registration requests PD (11,0) ANDRP Total number of deletion requests processed PD (11,0) ANLDDR Total number of locations deleted with deletion requests PD (11,0) ATPDR Cumulative elapsed time to process deletion requests PD (11,0) ANCNAP Total number of requests to change network attributes PD (11,0) processed ATCNA Cumulative elapsed time to process requests to change PD (11,0) network attributes ANDDRC Number of times the directory database was deleted and PD (11,0) re-created due to processing the requests to change network attributes ANLRSC Number of location registration requests sent due to PD (11,0) processing the requests to change network attributes ANLDSC Number of location deletion requests sent due to PD (11,0) processing the requests to change network attributes ANTDRC Number of times the topology database was deleted and PD (11,0) re-created due to processing the requests to change network attributes ANCART Number of times the requests to change network PD (11,0) attributes caused a node entry resource to be added to the TDU buffer ANTSTC Number of TDUs sent as a result of initially creating a PD (11,0) TDU buffer on behalf of requests to change network attributes Reference information for Performance 3 Field Name Description Attribute ANNTSC Number of network nodes that had TDUs sent to them PD (11,0) due to TDUs being created for processing requests to change network attributes ANDAII Number of times APPN information was displayed PD (11,0) (DSPAPPNINF command) ANLLUP Total number of local location list updates processed PD (11,0)