VS System Activity Monitor (SAM) Release 03.20.82 for OS 7.53 and 7.54 Customer Software Release Notice 1st Edition -- January, 2000 Copyright Getronics Co., 2000 DISCLAIMER The staff of Getronics Co. has taken due care in preparing this manual. However, nothing contained herein modifies or alters in any way the standard terms and conditions of the Wang purchase, lease, or license agreement by which the product was acquired, nor increases in any way Wang's liability to the customer. In no event shall Wang or its subsidiaries be liable for incidental or consequential damages in connection with or arising from the use of the product, the accompanying manual, or any related materials. CONTENTS PREFACE CHAPTER 1 INTRODUCTION Overview of SAM ............................................ 1-1 Running SAM in Interactive and Background Modes ............ 1-1 Running SAM in Playback and Data Reduction Modes ........... 1-1 CHAPTER 2 REQUIREMENTS AND ENHANCEMENTS OF RELEASE 03.20.82 Overview ................................................... 2-1 Hardware and Software Prerequisites and Dependencies ....... 2-1 Enhancements With This Release ............................. 2-3 CHAPTER 3 PROBLEMS CORRECTED SINCE LAST RELEASE Overview ................................................... 3-1 Problems Corrected since Release 3.20.78.................... 3-1 Problems Corrected since Release 3.20.75.................... 3-1 Problems Corrected since Release 3.20.56.................... 3-1 Problems Corrected since Release 3.20.00.................... 3-2 CHAPTER 4 SPECIAL CONSIDERATIONS Overview ................................................... 4-1 Special Considerations ..................................... 4-1 Restrictions ............................................... 4-2 Special Conditions ......................................... 4-3 CHAPTER 5 MEDIA CONTENTS AND INSTALLATION OF RELEASE 03.20.82 Overview ................................................... 5-1 Media Contents ............................................. 5-1 Installation Instructions .................................. 5-3 iii CONTENTS (continued) APPENDIX A - CHANGES TO RAW RECORD FORMAT from Release 3.20.00 APPENDIX B - CHANGES TO REDUCED DATA FILES from Release 3.20.00 TABLES Table 2-1 SAM Versions ............................................. 2-2 Table 5-1 SAM32082 Library Contents ................................ 5-1 Table 5-2 Required Files............................................ 5-4 Table 5-3 Optional Files............................................ 5-5 iv PREFACE This customer software release notice provides important information for using Release 3.20.82 of the VS System Activity Monitor (SAM). This notice covers the following details: . Enhancements included in this release of SAM . Hardware and software requirements . Problems corrected since the previous release . Special conditions and restrictions . SAM installation instructions CHAPTER 1 introduces SAM 3.20.82 and describes the modes in which SAM runs. Chapter 2 details the hardware and software requirements, and enhancements specific to this release. CHAPTER 3 lists the problems corrected since the previous release of SAM. Chapter 4 describes special considerations and restrictions and lists special conditions that you may encounter when using this release of SAM. CHAPTER 5 describes the contents of all the files in the SAM media and explains how to install SAM. Use this notice along with the VS System Activity Monitor (SAM III) Reference (800-1324E), which details SAM operation procedures. Other manuals that you may find useful in SAM operation include the following documents: . VS System Activity Monitor (SAM III) Data Sheet (800-2116D) . VS System Activity Monitor (SAM III) Graphics CSRN (715-2633A) . VS System Activity Monitor (SAM III) Graphics Reference (715-2634) . VS System Activity Monitor (SAM III) Graphics Data Sheet (715-2635) . VS SAM/PACE Connection CSRN (715-2764) . VS SAM/PACE Connection Reference (715-3934) . VS System Operator's Reference (800-1102-08) . VS Data Management System Reference Guide (800-1124-01) . VS DMS/TX Reference (800-1128-01) v CHAPTER 1 INTRODUCTION TO RELEASE 3.20.82 OF SAM OVERVIEW OF SAM The Wang System Activity Monitor (SAM) is a utility that monitors the use of resources on a VS system. The SAM utility collects data on the three main system resources: The CPU, physical memory, and disk drives. SAM also collects data on individual tasks and programs. You can use the data collected by SAM to compare workload with capacity, identify bottlenecks, solve performance problems, and tune the system. RUNNING SAM IN INTERACTIVE AND BACKGROUND MODES SAM monitors the system in either Interactive mode or Background mode. In Interactive mode, SAM monitors a selected activity, formulates statistics, and displays these statistics on a screen. In background mode, SAM collects the same types of data as in Interactive mode, but the data is stored in a file rather than being displayed on a screen. In background mode, you can sample all types of data concurrently, at specified sampling rates, over a period of up to seven days. RUNNING SAM IN PLAYBACK AND DATA REDUCTION MODES You can analyze the files created in background mode by using the Playback and Data Reduction modes. Playback mode provides an interactive data reduction program for an input file created using Background mode. Playback reads selected records from the data file, formulates statistics, and displays those statistics on a screen. Using Playback, you can access all the screens available in Interactive mode (except the profiling screens). Data Reduction mode creates temporary files of reduced data from files generated using Background mode. Data Reduction uses these files to generate and print reports. You can save these temporary files and use them to generate specialized reports not available in data reduction mode. Two products which utilize these reduced data files are VS SAM Graphics and the VS SAM/PACE Connection. VS SAM Graphics utilizes the reduced files to create graphical reports of the reduced data. The VS SAM/PACE Connection provides data dictionaries of the reduced data files so that PACE can be utilized to create specialized reports and queries. The VS SAM/PACE Connection also provides a set of predefined reports and queries. 1-1 CHAPTER 2 REQUIREMENTS AND ENHANCEMENTS OF RELEASE 3.20.82 OVERVIEW This chapter describes the hardware and software that your system must have to run SAM. It also lists the enhancements made since the last release, including modifications to the raw and reduced data files enabling compatibility with the new SAM add-on products, SAM Graphics and the SAM/PACE Connection. HARDWARE AND SOFTWARE PREREQUISITES & DEPENDENCIES You need the hardware, software, and documentation listed here to run SAM. Hardware Requirements You can use any VS processor, except a VS50 or VS80. Software Requirements Because SAM is dependent on the operating system, the SAM version number is represented by a 12 digit version number in the format VV.RR.PP/vv.rr.pp, where the double letters represent the following information: VV = SAM version number RR = SAM revision number PP = SAM patch number vv = VSOS version number rr = VSOS revision number pp = VSOS patch number 2-1 Use the following table to determine the correct version of SAM for your operating system. Table 2.1 SAM Versions Operating System Version SAM Version 07.20.xx 03.20.00/07.20.xx 07.21.00 - 7.21.08 03.20.00/07.21.xx 07.21.09+ 03.20.00/07.21.09 07.30.00 - 7.30.03 03.20.00/07.30.xx 07.30.04 03.20.00/07.30.04 07.32.00 - 7.32.01 03.20.00/07.32.xx 07.32.02+ 03.20.00/07.32.02 07.35.xx 03.20.00/07.35.00 07.40.xx 03.20.00/07.40.xx 07.42.xx 03.20.59/07.42.xx 07.50.xx - 7.52.xx 03.20.56/07.50.xx 07.53.xx 03.20.82/07.53.xx 07.54.xx 03.20.82/07.54.xx NOTE THAT only Interactive and Background SAM are operating system version-dependent. Playback and Data Reduction for any OS version of SAM 3.20.00 may be used to reduce any data file created using a version 3.20.00 SAM. Playback and Data Reduction for any OS version of SAM 3.20.56 or greater may be used to reduce any data file from a release 3.20.00 or greater SAM. Playback and Data Reduction for 3.20.82 may be used to reduce any data file from release 3.00 on. Documentation . VS System Activity Monitor (SAM III) data sheet (800-2116D) . VS System Activity Monitor (SAM III) Reference (800-1324E) 2-2 ENHANCEMENTS WITH THIS RELEASE This release of SAM has been modified to handle correctly years beyond 1999 and monitoring across the 1999-2000 change of year. In Interactive and Playback mode within the Memory Utilization screen, available pages appears on a line just above the PFkey information at the bottom of the screen. This line is separated from the individual task data and the PFkey information by solid lines. ENHANCEMENTS WITH PRIOR RELEASES Data Reduction The Detailed Task Statistics report may now be sorted on any field. The default sort remains by Task Number, but you may now press PF8 from the Task Report Selection Screen to change it. Only one field may be selected, and the sort may be specified as Ascending or Descending. ******************************************************************************* SAMDRINT 03.20.82 *** SAM DATA REDUCTION *** (c) Copr. Wang, 1988 (PRNAME=TASKSORT) Task Sort Specifications for SAM Data Reduction Detailed Task Statistics Report Please Specify the Field on which this report will be sorted Enter Any Character to Select the Field on which to sort the Report Task Number TASKID = * User ID USERID = * Workstation No. WSNUMBER = * Initial Program INITPROG * Current Program CURRPROG = X CPU Utilization CPUUTIL = * Total Page Ops PAGEOPS = * Workstation I/O WSIO = * User Page-In UPAGEIN = * Disk I/O DISKIO = * User Page-Out UPAGEOUT = * Other I/O TCIO = * System Page-In SPAGEIN = * Print I/O PRINTIO = * System Page-Out SPAGEOUT = * Select Sort Sequence: (A)scending/(D)escending SORTTYPE = * Press ENTER to Continue (1) Respecify Reports (16) Main Menu ******************************************************************************* The Single Program report and Group Program Report may now select a program using wild-card characters. The "+" or "?" character stands for any string. Thus, QAX+ or QAX? will cause statistics to be accumulated for any program whose first three characters are QAX. +Q or ?Q will cause statistics to be accumulated for any program whose last character is Q. The "-" or "*" character stands for any single character. Thus QAX- or QAX* will cause statistics to be accumulated for any program whose first three characters are QAX and which have only four characters in their name. -Q or *Q will cause statistics to be accumulated for any program whose name contains two characters, the second of which is Q. 2-4 In the Grouped Program Report, statistics will be accumulated in any category which matches the program name. For example, statistics for QA430B will be included in all three categories if the program names were specified as Q+, QA+, and QA430-. ******************************************************************************* SAMDRINT 03.20.82 *** SAM DATA REDUCTION *** (c) Copr. Wang, 1988 (PRNAME=GROUP) Input Program Name Specifications for SAM Data Reduction Grouped Program Reports Please Specify the Three Programs to be Reported On (Use '-' or '*' for any single character, '?' or '+' for any string) PROGRAM1 = ******** PROGRAM2 = ******** PROGRAM3 = ******** Enter Any Character to Select the Four Headers to be Used in the Reports CPU Utilization CPUUTIL = * Total Page Ops PAGEOPS = * Workstation I/O WSIO = * User Page-In UPAGEIN = * Disk I/O DISKIO = * User Page-Out UPAGEOUT = * TC I/O TCIO = * System Page-In SPAGEIN = * Print I/O PRINTIO = * System Page-Out SPAGEOUT = * Tape I/O TAPEIO = * Press ENTER to Continue (1) Respecify Reports (16) Main Menu ******************************************************************************* SAMDRINT 03.20.82 *** SAM DATA REDUCTION *** (c) Copr. Wang, 1988 (PRNAME=PROGRAM) Input Program Name Specifications for SAM Data Reduction Single Program Reports Please Specify the Name of the Program to be Reported On (Use '-' or '*' for any single character, '?' or '+' for any string) PROGRAM = ******** Press ENTER to Continue (1) Respecify Reports (16) Main Menu ******************************************************************************* 2-5 Interactive and Playback Modes Disk Statistics The Disk Screens in Interactive and Playback mode have been revised to incorporate additional information (See Figure 1). For each disk the following new data are shown: o The number of I/Os performed per second during the current update interval o The average number of I/Os performed per second since disk data collection began o The percentage of disk I/Os during the current update interval which were found in the cache of the I/O Controller o The average percentage of Disk I/Os since data collection began which were found in the cache of the I/O Controller o The elapsed time since data collection began. In addition, system total data appears on a line just above the PFkey information at the bottom of the screen. This line is separated from the individual disk data and the PFkey information by solid lines. The following data are shown: o The total number of disk I/Os performed on the system since data collection began. o The number of I/Os performed per second on the system during the current update interval o The average number of I/Os performed per second on the system since data collection began ******************************************************************************* SAMPB 03.20.82 ** System Activity Monitor ** (c) Copr. Wang 1988-1994 11:10:39 12/02/93 11:44:56 Thu 12/02/93 11:45:00 12/02/93 LAST RECORD REDUCED Disk Status Summary Elapsed time - 2057 seconds Total IOs per sec. Queue Depth Ctlr Cache Unit Volume # IOs Curr. Avg. Cur. Avg. Max. Cur. Avg. * 1 0 0.0 0.0 0 0.0 0 0% 0% * 388 0 0.0 0.0 0 0.0 0 0% 0% * 409 0 0.0 0.0 0 0.0 0 0% 0% * 410 WXP106 31867 0.0 15.5 1 0.1 4 61% 62% * 411 WXP107 58158 0.0 28.3 0 0.3 4 60% 63% * 412 WXP101 57927 0.0 28.2 0 0.3 4 46% 52% * 417 SY1001 347 0.0 0.2 0 0.0 1 0% 10% * 418 MCN105 72051 0.0 35.0 0 0.1 3 67% 77% * 419 WXP103 22264 0.0 10.8 0 0.0 4 60% 57% * 420 WXP104 40334 0.0 19.6 0 0.1 3 22% 61% * 421 WXP003 5515 0.0 2.7 0 0.0 3 82% 39% * 422 WXP005 10991 0.0 5.3 0 0.0 2 100% 80% * 423 SYS102 32188 0.0 15.6 0 0.0 3 53% 69% System Totals 576412 0.0 280.2 (1) Return (5) Next (6) Util by Task (3) Last (7) Util by File (15) Print (8) Util by IO kind (16) Main Menu *************************************************************************** Figure 1. Interactive and Playback Disk Screen 2-6 Interactive and Playback Mode (continued) Disk Statistics(continued) Cache statistics in Interactive are shown only for disks on a caching controller. For drives not on a caching controller, the column is labelled "N/A". The sample data file does not contain information about whether a drive is on a caching controller. Therefore, in Playback mode, drives not on a caching controller will show a zero hit rate. When print is requested, the print file location is displayed. Disk Statistics by File, Program, or Type Programs on the selected volume run from another system across the RSF link will now be shown on this screen. Individual programs cannot be identified at this time, but the activity will be shown with a File Name of "RSF Page" and a program Name of "@PAGE". When print is requested, the print file location is displayed. Background tasks are now indicated by a workstation number of "-bg-". Memory Statistics The size of all memory fields on the screen has been increased. Performance of Memory Utilization processing has been improved. Interactive now uses as much as 30% less CPU time, while Playback uses as much as 60% less. When print is requested, the print file location is displayed. Task Statistics Additional sorts have been added to the Task Statistics Screen, and the default sort has been modified slightly. The default sort was approximately by Workstation Number, although it described itself as a sort by "Task". It is now explicitly by Workstation Number. The sort by Task is now explicitly in order by Task number, Workstation Number, User ID, and Initial Program. In addition, it is now possible to sort by each of these fields individually, using the PFkeys specified on the screen, as well as by Current Program. Sorts on the task-identifying fields default to Ascending Order. Sorts on statistical fields default to Descending Order. Another PFkey (PF11) gives you the ability to reverse the order of the sort. In Interactive and Playback mode within the Task Statistics screen, system total data appears on a line just above the PFkey information at the bottom of the screen. This line is separated from the individual disk data and the PFkey information by solid lines. Totals are provided for all statistics. Rapid Data Reduction is now available in Playback Mode. When print is requested, the print file location is displayed. Background tasks are now indicated by a workstation number of "-bg-". 2-7 Interactive and Playback Mode (continued) CPU Utilization The idle percentage is now shown at the bottom of each screen, rather than as a table entry whose location is dependent on the sort. Additional sorts have been added to the Task Statistics Screen, and the default sort has been modified slightly. The default sort was approximately by Workstation Number, although it described itself as a sort by "Task". It is now explicitly by Workstation Number. The sort by Task is now explicitly in order by Task number, Workstation Number, User ID, and Initial Program. In addition, it is now possible to sort by each of these fields individually, using the PFkeys specified on the screen, as well as by Current Program. Sorts on the task-identifying fields default to Ascending Order. Sorts on statistical fields default to Descending Order. Another PFkey (PF11) gives you the ability to reverse the order of the sort. When print is requested, the print file location is displayed. Background tasks are now indicated by a workstation number of "-bg-". RSF Statistics RSF statistics are again available for clusters with four or fewer systems. RSF statistics are not available in Interactive and Playback for clusters with more than four systems. If Interactive SAM is run on a cluster with more than four systems, the PFKey for RSF Statistics will be disabled. If Playback is run on a file from a cluster with more than four systems, the PFKey for RSF Statistics will be shown, but selecting it will produce the RSF screen with the message "More than 4 systems not supported". Playback Mode A message is now displayed when Playback is reading through the file to reach the specified start time. PFKey descriptions are suppressed for categories not included in the data file being processed. Background Mode Sampling Rate Changes Default and maximum sampling times have been modified. All sampling times may now be as large as 9999.99 seconds. The default values have been changed to correspond to the recommended values for normal sampling: all categories are set to 60.00 seconds with the exception of Memory Utilization, which is set to 600.00 seconds. It is highly recommended that these values be used unless a specific need requires altering them. Experiments have shown that using these values provides adequate information while typically utilizing less than 2% of the CPU. 2-8 Background Mode (Continued) New Options for Start and Stop Times In addition to the day of the week or "NOW", you may now enter "TOD" as the Start Day for sampling. This will cause sampling to begin at the specified time on the day SAM is run. If the time entered is not later than the current time, SAM will act as if you had entered "NOW" as the Start Day. In addition to the day of the week, you may now enter "TOD" as the Stop Day for sampling. This will cause sampling to end at the specified time on the day SAM is run. The time entered must be both later than the current time and later than the start time, or SAM will display an error message. You may also specify a stop day of "INT". When you enter "INT" in the Stop Day field, the Stop Hour and Stop Minute fields are treated as an interval rather than a time of day. SAM will calculate the time at which sampling will end by adding that interval of hours and minutes to the start hour and minute. If the interval crosses midnight, SAM will update the Stop Day accordingly. The interval may be as long as 99 hours and 59 minutes. Changing the Sample File allocation When SAM calculates the sample file size, it must do so based on the maximum possible size the file could be if no records could be compressed. Normally, however, records compression causes the final file to be substantially smaller than the allocated file. When SAM displays the size of the allocated file, you now have the option to change that size. If you press PF9 from the screen with the file size, another screen is displayed which gives you the option of modifying the file allocation size. SAM will use the file size you request. Respecifying the Parameter File If you have entered an incorrect file name for the parameter file, SAM assumes that it does not exist and prompts you to create a new file. An option has been added to allow you to return to re-enter the parameter file name at this point. Releasing unused space in the sample file SAM now releases unused space in the sample file at end of run. 2-9 Background Mode (Continued) Saving SAM data after a system crash SAM now periodically updates the disk VTOC with the current file size so that all data will not be lost in the event of a system crash. However, because the number of records written to the file may include records in a buffer, but not yet written to disk, it may be necessary to reorganize the file before you run data reduction. The following procedure has been successful: 1. Run DISPLAY and specify the Sample File as input. If the number of records in the VTOC is not identical to the number in the file, DISPLAY will give you the following error message: "SORRY - Record count of xxxxxx disagrees with expected count of yyyyyy." xxxxxx is the correct number of records in the file. 2. Run COPY and specify the Sample File as input. 3. Specify REORG=YES on the OPTIONS screen. 4. Specify the number of records DISPLAY said were in the file (xxxxxx) in the RECORDS= field of the OUTPUT screen. 5. The output file you specify should be able to be processed by SAM Data Reduction or Playback. Data Reduction All data reduction programs are backward compatible with SAM 3.20.00 versions. It is strongly recommended that users of SAM 3.20.00 use version 3.20.56 or greater for data reduction to take advantage of enhancements and problem fixes. System Name on Reports The System Name of the sampled system is now shown on all reports. Interval Display While data reduction is in progress, the time and data of the interval being processed are displayed on the screen. OS Version on Reports The OS Version number on reports is now the OS version number of the system from which the data came, not necessarily that of the system on which the data reduction is run. Background Task identification Background tasks are now indicated by a workstation number of "-bg-". 2-10 Data Reduction (Continued) Naming Report Files You can now assign filenames to the reports produced by SAM Data Reduction. To do so, you must run SAM from a procedure. Each file has a different PRNAME. For each PRNAME, you may specify FILE=, LIBRARY=, and VOLUME= to assign the filename, library, and volume. If you do not assign filenames, SAM Data Reduction will continue to assign filenames of the form SAMnnnn in your default print library. The PRNAMES of the report files are as follows: Type Report Name PRNAME Configuration System Configuration Report SAMCONCR Disk Disk Utilization by I/O Kind SAMDSKKT Disk Utilization by I/O Kind Summary SAMDSKKM Disk IOP/IOC Utilization SAMDSKUT Disk IOP/IOC Utilization Summary SAMDSKUM Memory Memory Status Time-Line SAMMEMTL Memory Status Summary SAMMEMSM SHARER Sharer Time-Line SAMSHRTL Sharer Time-Line Summary SAMSHRSM Sharer Utilization Time-Line SAMSHRUT Sharer Utilization Summary SAMSHRUM XDMS XDMS Time-Line SAMXMSTL XDMS Summary SAMXDMSM System-Wide System-Wide Time-Line SAMSYSTL System-Wide Summary SAMSYSSM Detailed System-Wide SAMSYSDT TASK Task Statistics Time-Line SAMSYSST Single Program Time-Line SAMSYSPT Grouped Program Time-Line SAMSYSGT Task Status Time-Line SAMSYSTT Task Statistics Summary SAMSYSSM Single Program Summary SAMSYSPM Grouped Program Summary SAMSYSGM Task Status Summary SAMSYSTM Detailed Task Statistics SAMSYSDT RSF RSF Status Time-Line SAMRSFTL Files in Use Time-Line(sorted by node) SAMRSFFN Files in Use Time-Line(sorted by filename) SAMRSFFF RSF Status Summary SAMRSFSM Files in Use Summary SAMRSFFM Disk Reports - Intervals with no samples Disk data reduction will now show intervals in which no samples were taken with dashes in all of the fields. 2-11 Data Reduction (Continued) Disk Utilization of Volume by IOKind - Controller Cache Hits The percentage of disk I/Os during each interval which were found in the cache of the disk controller has been added to the Disk Utilization by Volume report. Disk Utilization of Volume by IOKind - Device Type and Name The Device Type and initial Volume Name now appear for each disk on this report. Disk IOP/IOC Report The initial Volume Name now appears for each disk on this report. Memory Status Time-Line Report The size of all memory fields has been increased to seven digits. The percentage of samples during an interval for which the number of available pages was zero has been added to the Memory Status Time-Line Report. Sharer Utilization Report A new report has been added to Sharer/XDMS statistics. The report shows SHARER hit percent, CPU utilization, and number of disk I/Os per second, messages per second, and misses per second, along with opens and closes, read, writes, rewrites, deletes, starts, advanced sharing requests, and other messages as a percentage of total SHARER messages. Detailed Task Statistics Report - Multiple Lines per Task Prior to version 3.20.56, a single line would appear on this report for each "Initial Program" run at a task. The Current Program name on that line would be the last program run from the Initial Program by the user of that task, but the statistics would be the total of all resources used by all programs run from the Initial Program. In version 3.20.56 and greater, a separate line of statistics is created for each program run by the user of a task, whether it is run by itself or from an Initial Program. Detailed Task data should now more accurately represent the resource usage of individual programs. RSF Files in Use Reports File Utilization Time-Line reports have been modified to show number of I/Os to the file during each interval rather than total number of I/Os since the file was opened. A new field has been added to the RSF Files in Use Report to indicate how the file has been opened. The field is headed "Server". It indicates whether the file is being accessed by FILSRV, SHARER, XDMSSERV, or @PAGE. Note, however, that the operating system does not currently provide information on remote files except for those opened by FILSRV. 2-12 Data Reduction (Continued) RSF Status Timeline Reports The RSF Status Timeline Report now shows the number of remote logons inbound to the system as well as the number outbound from the system. It also shows the number of local programs run by remote users. Changes in the Raw Data File Since the Last Release Environment Record, Subtype 1 - System Data Record E-MEMORYSIZE, The field containing physical memory size, has been renamed to E-OLDMEMORYSIZE. A new field has been added to accomodate larger physical memory sizes. It is defined as: E-MEMORYSIZE PIC S9(7) COMP. Environment Record, Subtype 2 - Device Data Record Two fields were added to the Subtype 2 Environment record. Neither is filled at the moment. They are defined as: E-PERCENTUSED PIC S9(3) COMP. The percent of the disk currently used for files. E-CACHECTLR PIC X. Y" means the device is on a caching controller. Environment Record, Subtype 3 - Counter Data Record A number of fields were added to the Subtype 4 Environment record to provide better diagnostic information. They are defined as: E-PROGRAMCHECKS PIC S9(9) COMP. The number of program checks caused by control block reallocation. E-EMPTYCOUNT PIC S9(9) COMP. The number of times the Transmit queue was empty at transmit time. E-WAITCOUNT PIC S9(9) COMP The number of times Sampler could not send an ITM because File Manager's ITM buffers were full. E-SAMPLERMSGRCVD PIC S9(9) COMP OCCURS 13 TIMES. The number of messages received by SAMPLER, by message type. E-SAMPLESMISSED PIC S9(9) COMP OCCURS 13 TIMES. The number of times a sample was skipped because Sampler was dispatched more than ten percent of the sample interval past its scheduled sample time. 2-13 File Layout Changes in the Reduced Data Files Disk Record A new field was added to the Disk record to indicate the beginning of a new sample. This field is not used at present. It is defined as: D-NEW-SAMPLE PIC X. Sharer Record Three new fields were added to the Sharer record to allow Sharer CPU utilization and disk I/Os per second to be captured. They are defined as: S-CPUSECS PIC S9(9)V99 COMP. The number of CPU seconds used by the SHARER from IPL to present. S-DISKIOS PIC S9(11) COMP. The number of Disk I/Os performed by the SHARER from IPL to present. S-NRCPUS PIC S9(2) COMP The number of CPUs active during the data collection interval. RSF Record Subtype 1 - General Data The following field was added to the Subtype 1 RSF record. It is defined as follows: R-REM-PAGE-FILES BINARY OCCURS 3 TIMES. The number of programs on this system run by users on the nodes specified in an earlier part of this record. RSF Record Subtype 4 - Show Files Data The following field was added to the Subtype 4 RSF record. It is defined as follows: R-OPENED-BY PIC X. The server which opened this file. "F" = FILSRV, "S" = SHARER, "X" = XDMSSERV, "P" = @PAGE. Note, however, that the operating system currently provides information only on files opened by FILSRV. 2-14 REDUCED DATA FILES(CONTINUED) Disk Record Subtype 3 - Detail by Disk Record The following fields were added to the Subtype 3 Disk record. They are defined as follows: DISK-SAMPLES-IN-INTERVAL PIC 9(7) COMP Total number of samples for this device in the interval. DISK-CACHE-INDICATOR PIC X. "Y" means this device is on a caching controller. This field is not filled at the moment. DISK-CACHE-HITS PIC 9(11) COMP. Total number of controller cache hits for this device during the interval DISK-ACCESS-IO PIC 9(11) COMP. Total number of I/Os for this device that were not found in the controller cache during the interval DISK-CACHE-RATIO PIC 9(3). The cache hit ratio for this device during the interval DISK-PERCENT-FULL PIC S9(3) SIGN IS TRAILING. The average percent of the disk filled during the interval Disk Record Subtype 7 - Detail by Volume Record The following fields were added to the Subtype 7 Disk record. They are defined as follows: VOL-SAMPLES-IN-INTERVAL PIC 9(7) COMP Total number of samples for this volume in the interval. VOL-ELAPSED-TIME PIC 9(5)V99 COMP Total elapsed seconds during the interval when this volume was mounted. VOL-CACHE-INDICATOR PIC X. "Y" means this volume is on a caching controller. VOL-CACHE-HITS PIC 9(11) COMP. Total number of controller cache hits for this volume during the interval 2-16 REDUCED DATA FILES(CONTINUED) Disk Record Subtype 7 (Continued) VOL-ACCESS-IO PIC 9(11) COMP. Total number of I/Os to this volume that were not found in the controller cache during the interval VOL-CACHE-RATIO PIC 9(3). The cache hit ratio for this volume during the interval VOL-PERCENT-FULL PIC S9(3) SIGN IS TRAILING. The average percent of the disk filled during the interval Memory Record Subtype 2 - Memory Detail Header Record The following fields were added to the Subtype 2 Memory record. They are defined as follows: OUT-AVAIL-ZERO PIC 9(3). Total number of samples for this interval where the number of memory pages available was zero. Sharer Record Subtype 2 - Sharer Detail Header Record Two new fields were added to the Sharer record to allow Sharer CPU utilization and disk I/Os per second to be reported. They are defined as follows: OUT-CPU-UTIL PIC 9(3) COMP. The percent of the cpu time during the interval used by the SHARER. OUT-DISKIO-PER-SEC PIC S9(3) COMP. The number of Disk I/Os performed by the SHARER per second during the interval. RSF Record Subtype 3 - Detail Summary Record The following fields have been renamed, They contain the correct number of nodes when the total number of nodes in a cluster is four or less. When the total number in the cluster exceeds four, these fields are set to zero. The correct number remains in fields labelled "CONFIG-NODES" and "ACTIVE-NODES", but those labels now refer to larger fields elsewhere in the record. CONFIG-NODES is now "OLD-CONFIG-NODES" ACTIVE-NODES is now "OLD-ACTIVE-NODES" 2-16 REDUCED DATA FILES(CONTINUED) RSF Record Subtype 3 - Detail Summary Record (Continued) The following fields were added to the Subtype 3 RSF record. Each is The number of files open on this system by the node described in the corresponding position in the beginning of this record. They are defined as follows: NEW-REMOTE-DATA OCCURS 3 TIMES. REM-PAGE-FILES PIC 9(5). The fields "CONFIG-NODES" and "ACTIVE-NODES" have been renamed "OLD-CONFIG-NODES" and "OLD-ACTIVE-NODES". They contain the correct number of nodes for clusters with no more than four systems. The old labels are now attached to the following larger fields: CONFIG-NODES PIC 9(3). The number of nodes configured in this cluster. This number is always present. ACTIVE-NODES PIC 9(3). The number of nodes active in this cluster. This number is always present. RSF Record Subtype 4 - Total IRL Record RSF Record Subtype 6 - Total ORL Record The maximum number of nodes in these records has been increased from 3 to 32. RSF Record Subtype 8 - Total Show Files Record The maximum number of nodes in this record has been increased from 3 to 20. RSF Record Subtype 9 - Detail Show Files Record The following fields have been added to this record: ACCESSED-BY PIC X. The server which opened this file. "F" = FILSRV, "S" = SHARER, "X" = XDMSSERV, "P" = @PAGE. However, only FILSRV file information is currently provided by the operating system. NODE-NUMBER PIC 9(3). The position in the node list of the node from which this file was opened. 2-17 CHAPTER 3 PROBLEMS CORRECTED SINCE LAST RELEASE OVERVIEW Problems that existed in earlier releases of SAM have been corrected in Release 3.20.82. This chapter identifies the problems by PTR number, describes how they occurred, and then tells how they have been solved. PROBLEMS CORRECTED SINCE 3.20.80 Data Reduction PTR Number Description An incorrect calculation of work file size in SAMDRSYS has been corrected Interactive PTR Number Description Disk I/O counts greater than 16,777,215 are now handled correctly Background PTR Number Description Disk I/O counts greater than 16,777,215 are now handled correctly PROBLEMS CORRECTED SINCE 3.20.78 The following problems have been corrected since version 3.20.78 of the software: Data Reduction PTR Number Description Data reduction will properly handle files starting and ending on the same day of the week, but on days one week apart. Playback PTR Number Description Playback of Memory Utilization will correctly handle systems with more than 100,000 available pages. Interactive PTR Number Description Memory Utilization will correctly handle systems with more than 100,000 available pages. PROBLEMS CORRECTED SINCE 3.20.75 The following problems have been corrected since version 3.20.75 of the software: Data Reduction PTR Number Description Problems running data reduction in background (encountered with ACM) have been resolved. Incorrect handling of midnight crossing in SAMDRDSK has been corrected. 3-1 PROBLEMS CORRECTED SINCE 3.20.75 (continued) Background PTR Number Description SAMPLER will now run on systems genned as 16000s. Interactive PTR Number Description A condition which caused an occasional erroneous task status has been corrected. PROBLEMS CORRECTED SINCE 3.20.56 The following problems have been corrected since version 3.20.56 of the software: Interactive PTR Number Description The Disk Status Summary Screen no longer crashes if a disk has more than 10 million I/Os. Data from the CPU Utilization Screen no longer prints twice when the screen is sorted by other than Task. Playback PTR Number Description The Disk Status Summary Screen no longer crashes if a disk has more than 10 million I/Os. Data from the CPU Utilization Screen no longer prints twice when the screen is sorted by other than Task. PROBLEMS CORRECTED SINCE 3.20.00 The following problems have been corrected since version 3.20.00 of the software: Interactive PTR Number Description Tasks whose status was "Paging in Progress" are now correctly recorded as such. M500016747 RSF Statistics are again available for clusters with four or fewer systems. Disk by File, Task, or I/O Type correctly handles paging files when OverDrive is enabled to the selected disk. 3-2 G800015984 Memory Utilization takes up to 30% less CPU time Playback PTR Number Description Disk Statistics no longer crashes on the initial sample from a busy system. Tasks whose status was "Paging in Progress" are now correctly recorded as such. Rapid Data Reduction is now available for Task Statistics M500016747 RSF Statistics are again available for clusters with four or fewer systems. PROBLEMS CORRECTED SINCE 3.20.00 Background PTR Number Description M500016747 RSF Statistics may now be collected for clusters with any number of systems. Sampler no longer loops when one of several new I/O commands is used in a disk I/O. Tasks whose status was "Paging in Progress" are now correctly recorded as such. M500016853 The number of blocks calculated for the sample file size now corresponds to the number of blocks allocated. M500017621 File Manager no longer crashes if the parameter file has the same name as the sample file. SAM now releases unused blocks in the Sample File. Data Reduction PTR Number Description The detailed task statistics report will no longer exceed the maximum number of extents 3-3 PROBLEMS CORRECTED SINCE 3.20.00 G410010254 XDMS counters which rolled over will no longer cause very large numbers to be incorrectly reported or data reduction to crash. M410007964 The Idle record in the Task Reduced file now contains the total CPU time not used, rather than the total CPU time used. CPU Utilization in the Task Reduced file is now correctly expressed as a percent rather than a decimal number. This caused it to be understated by a factor of 100. Data reduction will no longer occasionally hang while calculating a standard deviation. Microcode versions for CP types greater than 9 are now reported correctly. Physical Device Addresses for low-end CPUs are now reported correctly. Data Reduction PTR Number Description The average number of tasks waiting for a message buffer was always reported as zero. It is now reported correctly. Sort file extent calculations have been corrected to eliminate sort file overflow in Task and Disk Data Reduction. Reading beyond the end of the file under certain conditions has been corrected in Task, Sharer, and Memory Data Reduction. 3-4 CHAPTER 4 SPECIAL CONSIDERATIONS OVERVIEW Certain special conditions and considerations apply to the use of SAM. For example, special conditions exist that separate running SAM in background from running it interactively. This chapter describes the know special considerations, restrictions, and special conditions pertaining to SAM. SPECIAL CONSIDERATIONS . If you are using SAM to monitor the system for more than two hours, you should use SAM in Background mode rather than Interactive mode. SAM Interactive mode is designed for use over short periods of time. Running extended monitoring sessions may cause table overflows resulting in a program check. . When you use SAM to reduce data from a SAM background data file with a report span greater than two hours, you should use SAM Data Reduction rather than Playback mode. Playback mode is designed as a bottleneck analysis tool (as is SAM Interactive mode). For long-term capacity planning and trend analysis, SAM Data Reduction mode should be used to reduce the data. Playback mode has the same restrictions with respect to data overflow as SAM Interactive mode. A data field on a SAM screen may overflow in Playback mode if data is being reduced for an extended period of time (more than two hours as a general rule). . When monitoring combination fixed/removable disks, only the data for the removable disk is displayed in SAM Interactive and Playback mode. . If you press a PFkey while SAM is calculating a new screen for periodic update, keystrokes can be lost. This problem is due to the workstation protocol, and appears in other contexts as well (such as Logon). The time during which it can occur is a fraction of a second. . Some time may elapse before a task appears on the CPU utilization Screen in Interactive SAM. Interactive SAM uses the dispatch table, which contains information about the last 32 tasks dispatched. SAM must accumulate a number of samples before the percentages become representative of the current jobs on the system. . If you create a large data file (multiple days or several hundred thousand records) and select a report span with a starting time that is late in the file (for instance, the fifth day of a seven-day file), the SAM Data Reduction mode SPAN screen will remain displayed until the starting record in the report span is located, which may take a few minutes. During this time, the message "Reading to Specified Time" will appear on the screen. 4-1 . When using the same parameter file for both clustered and non-clustered systems, always edit the parameter file first. SAM sets RSF to " " in the parameter file on a non-clustered system so that SAMPLER won't sample RSF. Next time through, the user may think that RSF is still selected when in fact it is not. . In the RSF Status and Summary Screen and in RSF reports, the count of local files opened by remote users and the count of remote files opened by local users does not include files that have been opened in shared mode. The same holds true for the RSF Show Files in Use screen. This screen only shows local files opened non-shared by remote users. The reason for this is that files opened shared on a remote system use the remote system's sharer task as the file server task, and there is currently no method for obtaining from the SHARER the number and names of local files that have been opened by remote users. . Background mode of SAM allows the creation of appended raw samples files. However, Playback and Data Reduction modes do not support appended files. User written data reduction programs are required to access the appended data records in such files. . Within SAM, when reporting on TASK statistics within INTERACTIVE, Playback, or hard copy reporting, the term "IOTASK" within operating system 7.30 and greater, refers to both IO and RITA activities. RESTRICTIONS . SAM is dependent on the operating system. It must be packaged using the operating system control block DSECTS for the appropriate operating system. Any operating system control block changes made for an operating system patch, revision, or version change will require that SAM be repackaged in order to run. . SAM Data Reduction and Playback modes can process DISK data from any system as long as that system does not exceed a configuration of 128 Disk devices. . The user task running SAM in the foreground must have an MDA of at least 512 Kb. For Task Data Reduction, a 1 MB MDA is required. . You cannot run Interactive SAM or Playback SAM as a background task. . You can initiate Background SAM interactively or submit it as a background task via a procedure. . To run SAM in Background mode, you must have two available slots for background tasks on your system. These background slots in which SAMF and SAMPLER will run should have their dump option set to either "Y" (Force a DUMP on program abnormal termination) or "P" (Dump option is to be under program control). The background slot for SAMF must have a modifiable data area (MDA) of at least 1024 Kb. The background slot for SAMPLER must have an MDA of at least 512 Kb. 4-2 SPECIAL CONDITIONS Condition: The Memory Utilization status, Curr, will go to zero on all tasks, including SAM, if the maximum table size is exceeded. At present, the table size limit is 2048. No error detection or recovery exists for this problem. Procedure: Be aware of this condition. Condition: When you run a histogram analysis of programs that have been optimized during compilation, line numbers may be incorrect. This condition occurs because the optimizer may rearrange lines of code without updating the listing file. SAM cannot determine that this has occurred. Procedure: Recompile the program with the Optimize option set to NO and profile. Condition: System-wide composite reports will prompt the user for a work VOLume if the user's usage constants are not set. Procedure: Assign a work volume name to the WORKVOL option on the Set Usage Constants screen (PF2 on Command Processor screen). Condition: If SAMDRTSK or SAMDRSYS fails with a TASK ARRAY OVERFLOW message, the probable cause is that the maximum number of unique tasks supported in a single report interval has been exceeded. The internal array limit is for SAMDRSYS and SAMDRTSK is 5120. Procedure: Specify successively shorter report intervals until the program no longer fails. Condition: Cache statistics for VS OverDrive are not reported by SAM. Further, when OverDrive is enabled for a disk, the queue depth statistics for that disk will not exceed 1, no matter what the load on that disk is. Procedure: Use the statistics provided by OverDrive to review disk performance of drives cached through OverDrive. Condition: Task statistics (both Interactive and Playback) and CPU Utilization (Playback) may overstate CPU Utilization when tasks enter Operator or the Command Processor during execution. This may occasionally cause CPU Utilization to show sampled seconds larger than elapsed seconds. Procedure: Be aware of this condition. Condition: Disk Utilization by File, Task, and I/O Kind (Playback) does not advance uniformly through the records of the file. Procedure: Be aware of this condition. 4-3 Condition: If SAMDRDSK fails with a DISK INTERVAL ARRAY OVERFLOW message, the maximum number of reports (i.e.,report spans) that the Disk Report Generator (SAMDRDSK) supports has been exceeded. The internal array limit is 168, or 1 report per hour for 1 week. Procedure: Generate fewer reports per SAMDRDSK execution. You can do this by requesting half the desired reports in one run, then the other half in a separate execution of SAMDRDSK. Alternately, you can lengthen the report span, which will decrease the number of reports to be generated. Condition: If SAMDRRSF fails with an RSF ARRAY OVERFLOW message, the probable cause is that the maximum number of files in use supported in a single report interval has been exceeded. The internal array limit is 4096. Procedure: Specify successively shorter report intervals until the program no longer fails. Condition: In the CPU Utilization screens in Interactive and Playback modes, the CPU percentages do not add up to 100%. This is due to rounding. Procedure: Be aware of this condition. Condition: In Interactive mode, the maximum table size for RSF Outbound Remote Logons is 400, and the maximum table size for RSF Show Files in Use is 1024. In Data Reduction mode, the table size for RSF Show Files in Use is 4096. Any data beyond these limits will not be displayed. Procedure: Be aware of this condition. Condition: The USERCOUNT field in the Memory Page records (RecType = 7) of the raw samples file produced by Background SAM will contain the total number of users having Segment 2 (MDA) pages for a particular program. However, the record will only contain Segment 2 (MDA) user data for the first 140 users of that particular program. Procedure: Be aware of this condition. 4-4 Condition: On an extremely heavily loaded system, it is possible for Background SAM to miss samples because it won't be able to keep up with the system under test. This only becomes an issue if there are no samples for an entire report interval. This situation will affect the following categories of Data Reduction causing them to fail: RSF and SYSTEM WIDE COMPOSITE. This situation will not affect DISK, MEMORY, SHARER, XDMS, or TASK. Procedure: To get around this problem, try specifying a larger REPORT INTERVAL when reducing the affected Raw Data file. Also, give Background SAM (SAMPLER) a higher priority so that it will be less likely to miss samples in the first place. 4-5 CHAPTER 5 MEDIA CONTENTS AND INSTALLATION OF RELEASE 3.20.82 OVERVIEW This chapter describes the media contents of the files in Release 3.20.82 of SAM, and explains how to install the software. MEDIA CONTENTS The following table describes the contents of the files in the most recent release of SAM. Table 5-1. SAM32082 Library Contents Protection Blocks File Name Version Class Allocated Description SAM 03.20.82 Blank 25 The interface module that allows you to select the mode in which SAM will run. SAM$CON 03.20.56 Blank 4 Configuration File Description. SAM$DSK 03.20.56 Blank 18 Disk File Description. SAM$MEM 03.20.56 Blank 3 Memory File Description. SAM$RSF 03.20.56 Blank 5 RSF File Description. SAM$SHR 03.20.56 Blank 4 Sharer File Description. SAM$SYS 03.20.56 Blank 4 System-Wide Composite File Description. SAM$TSK 03.20.56 Blank 8 Task File Description. SAM3$REC 03.20.60 Blank 33 A PL/I record format for the file created by Background SAM. SAM3FD 03.20.60 Blank 38 A COBOL example of the record format. 5-1 Table 5-1. SAM32082 Library Contents (continued) Protection Blocks File Name Version Class Allocated Description SAMBG 03.20.82 Blank 99 The interface module that allows you to select the different options for Background SAM. SAMDRCON 03.20.75 Blank 30 Configuration Report Generator. SAMDRDSK 03.20.78 Blank 65 Disk Report Generator. SAMDRINT 03.20.82 Blank 151 Data Reduction interface. SAMDRMEM 03.20.78 Blank 33 Memory Report Generator. SAMDRRSF 03.20.78 Blank 77 RSF Report Generator. SAMDRSHR 03.20.78 Blank 63 Sharer Report Generator. SAMDRSYS 03.20.78 Blank 53 System-Wide Composite Report Generator. SAMDRTSK 03.20.78 Blank 98 Task Report Generator. SAMF 03.20.75 Blank 70 The background File Manager that processes messages received from the background SAMPLER into records, then writes them to a file. SAMFDCON 03.20.56 Blank 7 Configuration File Description. SAMFDDSK 03.20.56 Blank 21 Disk File Description. SAMFDMEM 03.20.56 Blank 6 Memory File Description. SAMFDRSF 03.20.56 Blank 11 RSF File Description. SAMFDSHR 03.20.56 Blank 9 Sharer File Description. SAMFDSYS 03.20.75 Blank 9 System-Wide Composite File Description. SAMFDTSK 03.20.56 Blank 15 Task File Description. SAMFPROC 03.20.80 Blank 1 The submit procedure for SAMF. 5-2 Table 5-1. SAM32082 Library Contents (continued) Protection Blocks File Name Version Class Allocated Description SAMINT 03.20.82 Blank 245 Interactive/Playback SAM. SAMPB 03.20.82 Blank 245 The interface module that allows you to select the different options for Playback SAM. SAMPLER 03.20.17 Blank 7 The background module that takes sample counts of system resources. SAMSPROC 03.20.80 Blank 1 The submit procedure for SAMPLER. INSTALLATION INSTRUCTIONS Mount the SAM III media. Run the BACKUP utility to restore the files listed below. Enter the following information as response to the backup prompts: OUTPUT screen CLEAR = NO OPTIONS screen DUPFILES = SCRATCH SAM version 3.20.82 may be run out of any library. (Bear in mind that some VS utilities may expect to find SAM in @SYSTEM@ on the system volume). Regardless of the library chosen to contain SAM, the following files are required and must be restored to the same library in order to access all four modes of operation - Interactive, Background, Playback and Data Reduction. 5-3 TABLE 5-2. Required Files File Name Description SAM Interface module SAMF Background File Manager SAMPLER Background Sampler SAMINT Interactive module SAMBG Background module SAMPB Playback module SAMFPROC Submit Procedure for SAMF SAMSPROC Submit Procedure for SAMPLER SAMDRINT Data Reduction Interface module SAMDRCON Configuration Report Generation module SAMDRDSK Disk Report Generation module SAMDRMEM Memory Report Generation module SAMDRRSF Resource Sharing Facility Report Generation module SAMDRSHR Sharer Report Generation Module SAMDRSYS System Wide Composite Report Generation module SAMDRTSK Task Report Generation module 5-4 The following remaining files may be optionally restored into any library on any disk. They are record format descriptions for those users who would like to write their own data reduction programs: TABLE 5-3. Optional Files File Name Description SAMFDCON COBOL record format for the Configuration report SAMFDDSK COBOL record format for the Disk reports SAMFDMEM COBOL record format for the Memory reports SAMFDRSF COBOL record format for the Resource Sharing Facility reports SAMFDSHR COBOL record format for the Sharer and XDMS reports SAMFDSYS COBOL record format for the System Wide Composite reports SAMFDTSK COBOL record format for the Task reports SAM$CON PLI record format for the Configuration report SAM$DSK PLI record format for the Disk reports SAM$MEM PLI record format for the Memory reports SAM$RSF PLI record format for the Resource Sharing Facility reports SAM$SHR PLI record format for the Sharer and XDMS reports SAM$SYS PLI record format for the System Wide Composite reports SAM$TSK PLI record format for the Task reports SAM3FD COBOL record format for the samples file created by Background SAM SAM3$REC PLI record format for the samples file created by Background SAM 5-5 APPENDIX A CHANGES TO RAW DATA FORMAT from Release 3.20.00 01 S-DISK-RECORD. * [ Record type 1 = Disk sample data record ] 05 FILLER PIC X(6). 05 D-PART1. 10 D-DEVICENO BINARY. 10 D-VOLUME PIC X(6). * [ Volume name. ] 10 D-STATUS PIC X. * [ X'00' = idle ] * [ X'01' = paging in ] * [ X'02' = paging out ] * [ X'03' = file read ] * [ X'04' = file write ] * [ X'05' = VOLIO read ] * [ X'06' = VOLIO write ] * [ X'0E' = changed ] * [ X'0F' = not operational ] 10 D-IOCOUNT PIC S9(5) COMP. * [ The sum of all data transfers ] * [ that have occurred since the ] * [ last sample. ] * [ Max IOCount per sample=99,999 ] 10 D-PERCENTUSED PIC S999 COMP. * [ The percentage of disk space ] * [ in use. ] 10 D-DISKCACHEHITS PIC S9(5) COMP. * [ The sum of all disk cache hits] * [ that have occurred since the ] * [ last sample. ] * [ Max per sample=99,999 ] 10 D-NEW-SAMPLE PIC X(1). ADDED * [ Not yet implemented. ] * [ Preceding ends a "short disk sample" record ] * [ Short disk sample records are used when the disk ] * [ status is idle, changed or not operational. ] 05 D-PART2. 10 D-QDEPTH PIC 9. * [ 1 BYTE BINARY * [ The number of users awaiting ] * [ a data transfer at the moment ] * [ of sampling. ] 10 D-BLOCKNO PIC S9(7) COMP. * [ Taken from IOCW, the block ] * [ number on the volume from ] * [ which the read or write will ] * [ be done. ] 10 FILLER PIC X(1). * [ Slack Byte. ] 10 D-TASKNO BINARY. * [ Number of the task using the ] * [ disk at the moment of sampling] A-1 CHANGES TO RAW DATA FORMAT from Release 3.20.00 Disk Record (continued) 10 D-USERID PIC X(8). * [ ID number of user whose I/O ] * [ is queued at the moment of ] * [ sampling. ] 10 D-WSNUM BINARY. * [ Workstation number. ] 10 D-PROGRAMNAME PIC X(8). * [ Name of user program running ] * [ at the moment of sampling. ] 10 D-PROGRAMLIB PIC X(8). * [ Library associated with ] * [ ProgramName. ] 10 D-FILENAME PIC X(8). * [ Name of the file which data ] * [ is being transferred to or ] * [ from. ] 10 D-FILELIB PIC X(8). * [ Library associated with ] * [ FileName. ] 01 S-SHARER-RECORD. * [ Record type 6 = Sharer statistics sample data record ] 05 FILLER PIC X(6). 05 S-PART1. 10 S-NRBUFFERS BINARY. * [ Number of 2Kb sharer buffers. ] 10 S-NRHITS PIC S9(7) COMP. * [ Number of times a sharer re- ] * [ quest is made and information ] * [ is available in buffer. ] 10 S-NRMISSES PIC S9(7) COMP. * [ Number of times a sharer re- ] * [ quest is made and information ] * [ is not available in the buffer] * [ since IPL. ] * [ The following statistics will only be written when ] * [ BackGround SAM runs on OS Ver. 06.30.00 or greater ] 05 S-PART2. 10 S-SHRMEM PIC S9(7) COMP. * [ Current sharer memory ] * [ available, in bytes. ] 10 S-NRMESS PIC S9(11) COMP. * [ Total number of messages ] * [ received at the sharer's port ] * [ since IPL. ] 10 S-NROPEN PIC S9(11) COMP. * [ Number of DMS open requests ] * [ since IPL. ] 10 S-NRCLOSE PIC S9(11) COMP. * [ Number of DMS close requests ] * [ since IPL. ] 10 S-NRREAD PIC S9(11) COMP. * [ Number of DMS read requests ] * [ since IPL. ] A-2 CHANGES TO RAW DATA FORMAT from Release 3.20.00 Sharer Record (continued) 10 S-NRWRITE PIC S9(11) COMP. * [ Number of DMS write requests ] * [ since IPL. ] 10 S-NRREWRITE PIC S9(11) COMP. * [ Number of DMS re-write ] * [ requests since IPL. ] 10 S-NRDELETE PIC S9(11) COMP. * [ Number of DMS delete ] * [ requests since IPL. ] 10 S-NRSTART PIC S9(11) COMP. * [ Number of DMS file-positioning] * [ start requests since IPL. ] 10 S-NRHOLD PIC S9(11) COMP. * [ Number of advanced sharing ] * [ requests (hold/release file or] * [ xrts) since IPL. ] 10 S-NRUSERS PIC S9(5) COMP. * [ Current number of shared file ] * [ users. ] 10 S-NRFILES PIC S9(5) COMP. * [ Current number of shared files] 10 S-CPUSECS PIC S9(9)V99 COMP. ADDED * [ CPU time used by SHARER ] 10 S-DISKIOS PIC S9(11) COMP. ADDED * [ DISKIOs by SHARER ] 10 S-NRCPUS PIC S9(2) COMP. ADDED * [ Number of active CPUs. ] 01 S-ENVIRONMENT-RECORD. * [ Record type 8 = Environment Data Record ] 05 FILLER PIC X(6). 05 E-SUBTYPE BINARY. * [ Subtypes: ] * [ 1 = System data, CPU type, ] * [ date, time, etc. ] * [ 2 = Device data one record per] * [ device ] * [ 3 = Counter data message, ] * [ record, misc. ] * [ 5 = Operator cancellation msg ] * [ Other types may be present at ] * [ times but are reserved for use] * [ by development. ] 05 E-SYSTEMDATA. * [ Subtype 1 - one environment ] * [ record of this type will be ] * [ written at the beginning of ] * [ the run. ] 10 E-CPUTYPE PIC S99 COMP. 10 E-MICROCODE PIC S9V99 COMP. 10 E-BPMICROCODE PIC X(8). * [ Reserved for later use. ] 10 E-IOPORCTYPE PIC X(8). * [ Reserved for later use. ] 10 E-OSVERSION PIC X(8). A-3 CHANGES TO RAW DATA FORMAT from Release 3.20.00 Environment Record (Continued) 10 E-SAMPLERVERSION PIC X(8). 10 E-FILEMNGVERSION PIC X(8). 10 E-OLDMEMORYSIZE PIC S9(5) COMP. RENAMED * [ In "K" Where K = 1024 bytes ] 10 E-FLAG1 PIC X. * [ Bit (8) ] * [ X'80' = Control blocks fixed ] * [ X'40' = Sharer buffers fixed ] * [ X'10' = XDMS cntrl blk fixed ] 10 E-USERID PIC X(8). * [ ID of user running SAM. ] 10 E-DATE PIC X(6). * [ YYMMDD when actual sampling ] * [ begins. ] 10 E-ASMOSVERSION PIC X(8). * [ the OS version SAM was ] * [ compiled for. ] 10 E-VTOCCACHESIZE BINARY. * [ the VTOC Cache size in pages ] 10 E-CPUCNFG PIC S9(02) COMP. * [Number of CPU's at IPL time PW1] 10 E-CNFG-FILE PIC X(08). * [Config File Name ] 10 E-CNFG-LIB PIC X(08). * [Config Library Name ] 10 E-CNFG-VOL PIC X(06). * [Config Volume Name ] 10 E-SYSNAME PIC X(08). * [System ID Name ] 10 E-RESERVED PIC X(16). * [ reserved for later use. PW1 ] 10 E-MEMORYSIZE PIC S9(7) COMP. ADDED * [ In "K" Where K = 1024 bytes ] 10 FILLER PIC X(360). 05 E-DEVICES REDEFINES E-SYSTEMDATA. * [ Subtype 2 - one environment ] * [ record of this type is written] * [ for each device configured on ] * [ the system. These records ] * [ follow the Subtype 1 record. ] 10 E-TYPE BINARY. * [ UCBType, see UCB DSECT or ] * [ EXTRDGTYPE in EXTRD. ] 10 E-CLASS BINARY. * [ UCBClass from UCB DSECT ] * [ 1 = workstation ] * [ 2 = magnetic tape ] * [ 3 = disk ] * [ 4 = printer ] * [ 5 = telecommunications ] * [ 6 = voice controllers ] * [ 7 = cluster controllers ] * [ 8 = image controllers ] 10 E-UNITADDRESS BINARY. * [ Unit number of device as seen ] * [ on the Operator's Screen. ] A-4 CHANGES TO RAW DATA FORMAT from Release 3.20.00 Environment Record (Continued) 10 E-DEVICEADDRESS BINARY. * [ UCBPDA- the physical device ] * [ address. May be decomposed ] * [ into the bus adaptor, IOP, ] * [ and the device. ] 10 E-RVOLUME PIC X(6). * [ Removable volume name mounted ] * [ on this device. ] 10 E-RDISKCAPACITY PIC S9(7) COMP. * [ Total number of blocks on disk] 10 E-FVOLUME PIC X(6). * [ Fixed volume name mounted on ] * [ this device. ] 10 E-FDISKCAPACITY PIC S9(7) COMP. * [ Total number of blocks on disk] * * [ The following three fields will only be written when ] * [ running SAMPLER version 03.00.00 or higher ] 10 E-DEVTYPE PIC X(8). * [ Device type (model number). ] 10 E-DEVDESC PIC X(20). * [ Device description. ] 10 E-HARDDISK PIC X(1). * [ "Y" = hard disk, "N" = floppy ] 10 E-CACHECTLR PIC X(1). % Not yet implemented. ADDED * ["Y" = device on caching ctlr ] 10 E-PERCENTUSED PIC S999 COMP.%Not implemented ADDED [% of disk space used ] 05 E-COUNTERS REDEFINES E-SYSTEMDATA. * [ Subtype 3 - There will be one ] * [ environment record of subtype] * [ 3 at the end of the file. ] 10 E-MSGSEND PIC S9(9) COMP OCCURS 13 TIMES INDEXED BY X-MSGSEND. * [ Number of msgs sent by SAMPLER] * [ by message type. ] * [ Note. All the counter arrays ] * [ are offset by 1(ZERO Relative)] * [ That is: ] * [ E-MSGSEND (1) is type 0; ] * [ E-MSGSEND (13) is type 12 ] * [ Message type descriptions: ] * [ 0 = Not Used ] * [ 1 = Synchronize message ] * [ 2 = File, lib, vol ] * [ 3 = Parameter data ] * [ 4 = Startup ] * [ 5 = Emergency stop ] * [ 6 = Acknowledge ] * [ 7 = Negative Acknowledge ] * [ 8 = Environment ] * [ 9 = Normal stop ] * [ 10 = Not used ] * [ 11 = Sample data ] * [ 12 = System data ] A-5 CHANGES TO RAW DATA FORMAT from Release 3.20.00 Environment Record (Continued) 10 E-MSGRECEIVED PIC S9(9) COMP OCCURS 13 TIMES INDEXED BY X-MSGRECEIVED. * [ Number of messages received ] * [ by SAMF by message type. ] * [ See E-MSGSEND above. Same ] * [ description and restrictions. ] 10 E-RECSEND PIC S9(9) COMP OCCURS 13 TIMES INDEXED BY X-RECSEND. * [ Number of records sent by ] * [ SAMPLER by record type. ] * [ Note. All the counter arrays ] * [ are offset by 1(ZERO Relative)] * [ That is: ] * [ E-RECSEND (1) is type 0; ] * [ E-RECSEND (13) is type 12 ] * [ Record type descriptions: ] * [ 0 = Unrecognizable ] * [ 1 = Disk sample ] * [ 2 = Task sample data ] * [ 3 = Memory summary data ] * [ 4 = Reserved ] * [ 5 = XDMS sample ] * [ 6 = Sharer sample ] * [ 7 = Memory page sample ] * [ 8 = Environment records ] * [ 9 = sample params ] * [ (select, rate, etc.) ] * [ 10 = RSF data ] * [ 11 = Invalid messages received] * [ 12 = files (Sysdata) ] 10 E-RECWRITTEN PIC S9(9) COMP OCCURS 13 TIMES INDEXED BY X-RECWRITTEN. * [ Number of records written by ] * [ SAMF by record type. ] * [ Note. All the counter arrays ] * [ are offset by 1(ZERO Relative)] * [ That is: ] * [ E-WRITTEN (1) is type 0; ] * [ E-WRITTEN (13) is type 12 ] * [ Record type descriptions: ] * [ 0 = Unrecognizable ] * [ 1 = Disk sample ] * [ 2 = Task sample data ] * [ 3 = Memory summary data ] * [ 4 = Reserved ] * [ 5 = XDMS sample ] * [ 6 = Sharer sample ] * [ 7 = Memory Utilization data ] * [ 8 = Environment records ] * [ 9 = sample params ] * [ (select, rate, etc.) ] * [ 10 = RSF data ] * [ 11 = Invalid messages received] * [ 12 = files (Sysdata) ] A-6 CHANGES TO RAW DATA FORMAT from Release 3.20.00 Environment Record (Continued) 10 E-MEMRECRECEIVED PIC S9(9) COMP. * [ Total number of memory records] * [ received. ] 10 E-INVALMSG PIC S9(9) COMP. * [ Number invalid msgs recd. ] 10 E-RECNOTWRIT PIC S9(9) COMP. * [ Number of records received but] * [ but not written. ] 10 E-INVALRECWRITTEN PIC S9(9) COMP. * [ Number of invalid records ] * [ records written. ] 10 E-PROGRAMCHECKS PIC S9(9) COMP. ADDED * [ Number of Program Checks due ] * [ to control block re-allocation] 10 E-EMPTYCOUNT PIC S9(9) COMP. ADDED * [ Number of times SAMPLER Xmit ] * [ queue is empty at Xmit time. ] 10 E-WAITCOUNT PIC S9(9) COMP. ADDED * [ Number of times SAMPLER can't ] * [ send ITM because File Manager ] * [ ITM buffers are full. ] 10 E-SAMPLERMSGRCVD PIC S9(9) COMP OCCURS 13 TIMES ADDED INDEXED BY X-SAMPLERMSGRCVD. * [ Number of messages received by] * [ SAMPLER by message type. See ] * [ E-MSGSEND above. ] 10 E-SAMPLESMISSED PIC S9(9) COMP OCCURS 13 TIMES ADDED INDEXED BY X-SAMPLESMISSED. * [ Number of times a sample was ] * [ skipped because it was too far] * [ beyond the scheduled time. ] 01 S-RSF-RECORD. * [ Record type 10 = RSF statistics sample data record ] 05 FILLER PIC X(6). 05 R-SUBTYPE BINARY. * [ 1 = General data ] * [ 2 = IRL data ] * [ 3 = ORL data ] * [ 4 = Show Files data ] 05 R-VARIABLE-DATA. * 10 R-GENERAL-DATA. * R-SUBTYPE = 1 15 R-CLUSTER-NAME PIC X(8). 15 R-CONFIG-NODES BINARY. 15 R-ACTIVE-NODES BINARY. 15 R-LOCAL-NODE-DATA. 20 R-LOC-NODE-NAME PIC X(8). 20 R-LOC-NODE-STATE PIC X(1). 20 FILLER PIC X(1). 20 R-LOC-NO-WAITING BINARY. A-7 CHANGES TO RAW DATA FORMAT from Release 3.20.00 RSF Record (Continued) 15 R-REMOTE-NODE-DATA OCCURS 3. * [ Max. Remote Nodes per record = 3 ] 20 R-REM-NODE-NAME PIC X(8). 20 R-REM-NODE-STATE PIC X(1). 20 FILLER PIC X(1). 20 R-REM-NO-OF-IRL BINARY. 20 R-REM-NO-OF-ORL BINARY. 20 R-REM-NO-OF-SESS BINARY. 20 R-REM-FILES BINARY. 20 R-REM-LOCAL-FILES BINARY. 20 R-REM-NO-WAITING BINARY. 15 R-REM-PAGE-FILES BINARY OCCURS 3 TIMES. ADDED * 10 R-SHOW-FILES-DATA REDEFINES R-GENERAL-DATA. * R-SUBTYPE = 4 15 R-OFB-ADDR PIC X(4). 15 R-NODE-FROM PIC X(8). 15 R-USER-ID PIC X(8). 15 R-VOLUME-NAME PIC X(6). 15 R-LIBRARY-NAME PIC X(8). 15 R-FILE-NAME PIC X(8). 15 R-NO-OF-IOS PIC S9(7) COMP. 15 R-OPENED-BY PIC X. ADDED A-8 APPENDIX B CHANGES TO REDUCED DATA FILES from Release 3.20.00 01 DETAIL-BY-DISK-RECORD. 05 FILLER PIC X(4). 05 DISK-INTERVAL-NUM PIC 9(4). 05 DETAIL-DISK-INFO. 08 IOP-NUMBER PIC X(2). * [ IOP/IOC number disk is attached] * [ to. ] 08 IOP-BUS PIC X(2). * [ bus number disk is attached to ] 08 DISK-NAME PIC X(6). * [ Volume name. ] 08 DISK-DEVICENO PIC 9(5) COMP. * [ Unit number of device as seen ] * [ on the Operator's Screen. ] 08 DISK-DEVTYPE PIC X(8). * [ The device type (model number)] 08 DISK-DEVDESC PIC X(20). * [ This is the actual description] * [ of the disk device type. ] 08 DISK-IO-PSEC PIC 9(5)V99 COMP. * [ The number of disk I/O's ] * [ performed by the disk during ] * [ the interval per second. ] 08 DISK-MAX-IO-PSEC PIC 9(5)V99 COMP. * [ The maximum number of disk ] * [ I/O's performed in a single ] * [ sample (per seond). ] 08 DISK-QDEPTH PIC 9(5) COMP. * [ The average number of users ] * [ awaiting a data tranfer. ] 08 DISK-MAX-QDEPTH PIC 9(5) COMP. * [ The maximum number of users ] * [ awaiting a data transfer at ] * [ the moment of sampling. ] 08 DISK-STATUS. 10 BUSY-PCT PIC 9(3). * [ Average percent the disk was ] * [ busy. ] 10 BUSY-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the middle of ] * [ performing a paging, file, ] * [ VTOC, or 'other type of busy ] * [ operation' in the Interval ] 10 PAGE-IN-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a page in request] 10 PAGE-IN-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a PAGE-IN request ] * [ in the Interval. ] B-1 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Detail by Disk Record (continued) 10 PAGE-OUT-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a page out ] * [ request. ] 10 PAGE-OUT-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a PAGE-OUT request ] * [ in the Interval. ] 10 PAGE-REQUESTS-PCT PIC 9(4). * [ The percent of samples in the ] * [ for which the disk activity ] * [ was a PAGE request. ] 10 FILE-READ-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a file read ] * [ request. ] 10 FILE-READ-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a FILE-READ ] * [ request in the Interval. ] 10 FILE-WRITE-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a file write ] * [ request. ] 10 FILE-WRITE-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a FILE-WRITE ] * [ request in the Interval. ] 10 FILE-REQUESTS-PCT PIC 9(4). * [ The percent of samples in the ] * [ interval for which the disk ] * [ was a file request. ] 10 VTOC-READ-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a VTOC read ] * [ request. ] 10 VTOC-READ-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a VTOC-READ ] * [ request in the Interval. ] 10 VTOC-WRITE-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a VTOC write ] * [ request. ] 10 VTOC-WRITE-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a VTOC-WRITE ] * [ request in the Interval. ] B-2 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Detail by Disk Record (continued) 10 VTOC-REQUESTS-PCT PIC 9(4). * [ The percent of samples in the ] * [ interval for which the disk ] * [ activity was a VTOC request. ] 10 CHANGED-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity type was unavailable.] 10 CHANGED-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was determined to be busy] * [ without being able to identify] * [ the disk state in the Interval] 08 DISK-SAMPLES-IN-INTERVAL PIC 9(7) COMP. ADDED * [ Total number of samples for ] * [ this device in the Interval. ] 08 DISK-CACHE-INDICATOR PIC X(1). ADDED * [ Whether or not this device is ] * [ on a caching controller. ] 08 DISK-CACHE-HITS PIC 9(11) COMP. ADDED * [ Total number of cache hits for] * [ this device in the Interval. ] 08 DISK-ACCESS-IO PIC 9(11) COMP. ADDED * [ The number of I/O's that ] * [ accessed the Disk (as opposed ] * [ to cache) for this device in ] * [ the Interval. ] 08 DISK-CACHE-RATIO PIC 9(3). ADDED * [ The cache hit ratio for this ] * [ device in the Interval. ] 08 DISK-PERCENT-FULL PIC S9(3) SIGN IS TRAILING. ADDED * [ The average percent full for ] * [ the device in the Interval. ] 01 DETAIL-BY-VOLUME-RECORD. 05 FILLER PIC X(4). 05 VOL-INTERVAL-NUM PIC 9(4). 05 DETAIL-VOL-INFO. 08 VOL-NAME PIC X(6). 08 VOL-IOPSEC PIC 9(5)V99 COMP. * [ The number of disk I/O's ] * [ performed by the disk during ] * [ the interval per second. ] 08 VOL-MAX-IOPSEC PIC 9(5)V99 COMP. * [ The maximum number of disk ] * [ I/O's performed in a single ] * [ sample (per seond). ] 08 VOL-Q-DEPTH PIC 9(5) COMP. * [ The average number of users ] * [ awaiting a data tranfer. ] 08 VOL-MAX-Q-DEPTH PIC 9(5) COMP. * [ The maximum number of users ] * [ awaiting a data transfer at ] * [ the moment of sampling. ] B-3 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Detail by Volume Record (continued) 08 VOL-STATUS. 10 VOL-BUSY-PCT PIC 9(3). * [ Average percent the disk was ] * [ busy. ] 10 VOL-BUSY-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the middle of ] * [ performing a paging, file, ] * [ VTOC, or 'other type of busy ] * [ operation' in the Interval ] 10 VOL-PAGEIN-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a page in request] 10 VOL-PAGEIN-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a PAGE-IN request ] * [ in the Interval. ] 10 VOL-PAGEOUT-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a page out ] * [ request. ] 10 VOL-PAGEOUT-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a PAGE-OUT request ] * [ in the Interval. ] 10 VOL-PAGE-REQUESTS-PCT PIC 9(4). * [ The percent of samples in the ] * [ for which the disk activity ] * [ was a PAGE request. ] 10 VOL-FILE-READ-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a file read ] * [ request. ] 10 VOL-FILE-READ-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a FILE-READ ] * [ request in the Interval. ] 10 VOL-FILE-WRITE-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a file write ] * [ request. ] 10 VOL-FILE-WRITE-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a FILE-WRITE ] * [ request in the Interval. ] 10 VOL-FILE-REQUESTS-PCT PIC 9(4). * [ The percent of samples in the ] * [ interval for which the disk ] * [ was a file request. ] B-4 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Detail by Volume Record (continued) 10 VOL-VTOC-READ-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a VTOC read ] * [ request. ] 10 VOL-VTOC-READ-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a VTOC-READ ] * [ request in the Interval. ] 10 VOL-VTOC-WRITE-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity was a VTOC write ] * [ request. ] 10 VOL-VTOC-WRITE-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was in the midst of ] * [ performing a VTOC-WRITE ] * [ request in the Interval. ] 10 VOL-VTOC-REQUESTS-PCT PIC 9(4). * [ The percent of samples in the ] * [ interval for which the disk ] * [ activity was a VTOC request. ] 10 VOL-CHANGED-PCT PIC 9(3). * [ Average percent the disk I/O ] * [ activity type was unavailable.] 10 VOL-CHANGED-SAMPLES PIC 9(7) COMP. * [ Total number of samples the ] * [ disk was determined to be busy] * [ without being able to identify] * [ the disk state in the Interval] 08 VOL-SAMPLES-IN-INTERVAL PIC 9(7) COMP. * [ Total number of samples for ] * [ this VOLUME in the Interval. ] 08 VOL-ELAPSED-TIME PIC 9(5)V99 COMP. ADDED * [ Total elapsed seconds for ] * [ this VOLUME in the Interval. ] 08 VOL-CACHE-INDICATOR PIC X(1). ADDED * [ Whether or not this VOLUME is ] * [ on a caching controller. ] 08 VOL-CACHE-HITS PIC 9(11) COMP. ADDED * [ Total number of cache hits for] * [ this VOLUME in the Interval. ] 08 VOL-ACCESS-IO PIC 9(11) COMP. ADDED * [ The number of I/O's that ] * [ accessed the DISK (as opposed ] * [ to cache) for this VOLUME in ] * [ the Interval. ] 08 VOL-CACHE-RATIO PIC 9(3). ADDED * [ The cache hit ratio for this ] * [ VOLUME in the Interval. ] 08 VOL-PERCENT-FULL PIC S9(3) SIGN IS TRAILING. ADDED * [ The average perdent full for ] * [ the VOLUME in the Interval. ] B-5 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Memory Subtype 2 - Detail Header Record 01 DETAIL-HDR. 05 FILLER PIC X(4). 05 INTERVAL-NUM PIC 9(4). * [ Interval number. ] 05 SAMPLES-PER-INTERVAL PIC 9(4). * [ The number of samples in the ] * [ interval. ] 05 INTERVAL-TIME. * [ Time Stamp of this interval. ] 10 INTERVAL-WEEKDAY PIC X(3). 10 INTERVAL-MO PIC X(2). 10 INTERVAL-DY PIC X(2). 10 INTERVAL-YR PIC X(2). 10 INTERVAL-HR PIC X(2). 10 INTERVAL-MN PIC X(2). 05 INTERVAL-DATE-STAMP. 10 INTERVAL-MONTH PIC X(2). 10 SLASH5 PIC X(1) . 10 INTERVAL-DAY PIC X(2). 10 SLASH6 PIC X(1) . 10 INTERVAL-YEAR PIC X(2). 05 INTERVAL-TIME-STAMP. 10 INTERVAL-HOUR PIC X(2). 10 COLON3 PIC X(1) . 10 INTERVAL-MINUTE PIC X(2). 05 ELAPSED-SECONDS PIC 9(5)V99. * [ The number of seconds elapsed ] * [ between the first sample of ] * [ the interval and the last ] * [ sample of the interval. ] 05 OUT-AVAIL PIC 9(6). * [ Average # memory pages ] * [ available in the interval. ] 05 OUT-RESID PIC 9(6). * [ Average # memory pages perma- ] * [nently resident in the interval] 05 OUT-TEMP PIC 9(6). * [ Average # memory pages tempo- ] * [ rarily fixed in the interval. ] 05 OUT-INPRO PIC 9(6). * [ Average # memory pages in ] * [ paging process in the interval] 05 OUT-POOL PIC 9(6). * [ Average # memory in Kilobytes ] * [ in the getmem pool in the ] * [ interval. ] 05 OUT-FAULT PIC 9(6). * [ Average # of page faults in ] * [ the interval. ] 05 TOTAL-PAGE-FAULTS PIC 9(13) COMP. * [ The total number of page ] * [ faults that occured during the] * [ interval. ] B-6 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Memory Detail Header Record (continued) 05 OUT-RATIO PIC 9(3). * [ The average VTOC cache hit ] * [ ratio in the interval. ] 05 OUT-AVAIL-ZERO PIC 9(3). ADDED * [ The percent of samples for ] * [ which 'memory pages available'] * [ was zero in the interval. ] * Sharer Record Type 3 - Detail-Sharer Record 01 DETAIL-HDR. 05 FILLER PIC X(4). 05 INTERVAL-NUM PIC 9(4). 05 SAMPLES-PER-INTERVAL PIC 9(4). 05 INTERVAL-TIME. 10 INTERVAL-WEEKDAY PIC X(3). 10 INTERVAL-MO PIC X(2). 10 INTERVAL-DY PIC X(2). 10 INTERVAL-YR PIC X(2). 10 INTERVAL-HR PIC X(2). 10 INTERVAL-MN PIC X(2). 05 INTERVAL-DATE-STAMP. 10 INTERVAL-MONTH PIC X(2). 10 SLASH5 PIC X(1) . 10 INTERVAL-DAY PIC X(2). 10 SLASH6 PIC X(1) . 10 INTERVAL-YEAR PIC X(2). 05 INTERVAL-TIME-STAMP. 10 INTERVAL-HOUR PIC X(2). 10 COLON3 PIC X(1) . 10 INTERVAL-MINUTE PIC X(2). 05 ELAPSED-SECONDS PIC 9(5)V99. * [ Elapsed time in seconds since ] * [ the start of this interval ] 05 OUT-NRHITS PIC 9(7). * [ Sharer/XDMS buffers hits for ] * [ this interval ] 05 OUT-NRHITS-PER-SEC PIC 9(4)V9. * [ Sharer/XDMS buffers hits per ] * [ sec for this interval ] 05 OUT-NRMISSES PIC 9(7). * [ Sharer/XDMS buffers misses for] * [ this interval ] 05 OUT-NRMISSES-PER-SEC PIC 9(4)V9. * [ Sharer/XDMS buffers misses per] * [ sec for this interval ] 05 OUT-RATIO PIC 9(3). * [ Sharer/XDMS buffers hit/miss ] * [ ratio for this interval ] 05 OUT-MEMORY PIC 9(4). * [ Average Sharer/XDMS memory ] * [ vailable during the interval ] * [ in KB ] B-7 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Detail Sharer Record (continued) 05 OUT-USERS PIC 9(5). * [ Average number of shared file ] * [ users during the interval ] 05 OUT-FILES PIC 9(5). * [ Average number of shared files] * [ open during this interval ] 05 OUT-NROPEN PIC 9(7). * [ Number of DMS/XDMS open ] * [ requests during this interval ] 05 OUT-NROPEN-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS open ] * [ requests during this interval ] * [ per second ] 05 OUT-NRCLOSE PIC 9(7). * [ Number of DMS/XDMS close ] * [ requests during this interval ] 05 OUT-NRCLOSE-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS close ] * [ requests during this interval ] * [ per second ] 05 OUT-NRREAD PIC 9(7). * [ Number of DMS/XDMS read ] * [ requests during this interval ] 05 OUT-NRREAD-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS read ] * [ requests during this interval ] * [ per second ] 05 OUT-NRREWRITE PIC 9(7). * [ Number of DMS/XDMS rewrite ] * [ requests during this interval ] 05 OUT-NRREWRITE-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS rewrite ] * [ requests during this interval ] * [ per second ] 05 OUT-NRDELETE PIC 9(7). * [ Number of DMS/XDMS delete ] * [ requests during this interval ] 05 OUT-NRDELETE-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS delete ] * [ requests during this interval ] * [ per second ] 05 OUT-NRSTART PIC 9(7). * [ Number of DMS/XDMS file ] * [ positioning start requests ] * [ during this interval ] 05 OUT-NRSTART-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS start ] * [ requests per second during ] * [ the interval ] 05 OUT-NRHOLD PIC 9(7). * [ Number of advanced sharing ] * [ requests (hold/release file or] * [ extension rights during this ] * [ interval ] B-8 CHANGES TO REDUCED DATA FILES from Release 3.20.00 Detail Sharer Record -(continued) 05 OUT-NRHOLD-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS hold ] * [ requests per second during ] * [ the interval ] 05 OUT-NRWRITE PIC 9(7). * [ Number of DMS/XDMS rewrite ] * [ requests during this interval ] 05 OUT-NRWRITE-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS write ] * [ requests during this interval ] * [ per second ] 05 OUT-NROTHER PIC 9(7). * [ Number of miscellaneous ] * [ DMS/XDMS requests during this ] * [ interval. ] 05 OUT-NROTHER-PER-SEC PIC 9(4)V9. * [ Number of miscellaneous ] * [ DMS/XDMS requests per second ] * [ during this interval. ] 05 OUT-NRMESS PIC 9(7). * [ Number of intertask messages ] * [ received at the sharer/XDMS's ] * [ port during this interval ] 05 OUT-NRMESS-PER-SEC PIC 9(4)V9. * [ Number of DMS/XDMS intertask ] * [ messages received per second ] * [ during the interval ] 05 OUT-CPU-UTIL PIC 9(3) COMP. ADDED * [ Sharer CPU Utilization ] * [ incurred for the Interval. ] 05 OUT-DISKIO-PER-SEC PIC 9(3) COMP. ADDED * [ Sharer DISK I/O per second ] * [ incurred for the Interval. ] RSF Detail Summary Record 01 DETAIL-SUMMARY. 05 FILLER PIC X(4). * RECORD-TYPE = 3 05 SUMMARY-INTERVAL-NUM PIC 9(4). 05 CLUSTER-NAME PIC X(8). 05 OLD-CONFIG-NODES PIC 9(1). * [ If 4 or fewer nodes are confi] * [gured, this contains the number] * [configured. If more than 4 are] * [configured, this number is zero] * [and the total is contained in ] * [CONFIG-NODES. ] B-9 CHANGES TO REDUCED DATA FILES from Release 3.20.00 RSF Detail Summary Record (continued) 05 OLD-ACTIVE-NODES PIC 9(1). * [ If 4 or fewer nodes are confi] * [gured, this contains the number] * [active. If more than 4 are ] * [configured, this number is zero] * [and the total active is con- ] * [tained in the variable ] * [ ACTIVE-NODES. ] 05 LOCAL-NODE-DATA. 10 LOC-NODE-NAME PIC X(8). 10 LOC-NODE-STATE PIC 9(1). * [ 0 = Down/Detached ] * [ 1 = Initializing ] * [ 2 = Up/Attached ] * [ 3 = Failed ] 10 LOC-NO-WAITING PIC 9(3). * [ Average # tasks waiting for ] * [ transport window to open in ] * [ the interval. ] 05 REMOTE-NODE-DATA OCCURS 3. * [ Max. Remote NOdes = 3 ] 10 REM-NODE-NAME PIC X(8). 10 REM-NODE-STATE PIC 9(1). * [ 0 = Down/Detached ] * [ 1 = Initializing ] * [ 2 = Up/Attached ] * [ 3 = Failed ] 10 REM-NO-OF-IRL PIC 9(5). * [ Average # of Inbound Remote ] * [ Logons from this node in the ] * [ interval. ] 10 REM-NO-OF-ORL PIC 9(5). * [ Average # of Outbound Remote ] * [ Logons from this node in the ] * [ interval. ] 10 REM-NO-OF-SESS PIC 9(5). * [ Average # sessions between ] * [ this node and the local node ] * [ in the interval. ] 10 REM-FILES PIC 9(5). * [ Average # files remotely ] * [ open on this node by local ] * [ users in the interval. ] 10 REM-LOCAL-FILES PIC 9(5). * [ Average # files open on the ] * [ local node by users form this ] * [ node in the interval. ] 10 REM-NO-WAITING PIC 9(5). * [ Average # tasks waiting on ] * [ this node waiting for the ] * [ transport window to be open in] * [ the interval. ] B-10 CHANGES TO REDUCED DATA FILES from Release 3.20.00 RSF Detail Summary Record (continued) 05 NEW-REMOTE-DATA OCCURS 3 TIMES. 10 REM-PAGE-FILES PIC 9(5). ADDED * [ Number of page files open on ] * [ this system by users on the ] * [ corresponding node. ] 05 CONFIG-NODES PIC 9(3). ADDED * [ Number of nodes configured. ] 05 ACTIVE-NODES PIC 9(3). ADDED * [ Number of nodes active. ] RSF Total Inbound Remote Logon Record 01 TOTAL-IRL. 05 FILLER PIC X(4). * RECORD-TYPE = 4. 05 T-IRL-INTERVAL-NUM PIC 9(4). 05 FILLER OCCURS 32. CHANGED * [ Max. Remote Nodes = 32 ] From 3 * [ per record, 999 total. ] To 32 10 IRL-TOTAL-LOGONS PIC 9(5). * [ Average # of Inbound Remote ] * [ Logons from REMOTE-NODE(X) in ] * [ the interval. ] RSF Total Outbound Remote Logon Record 01 TOTAL-ORL. 05 FILLER PIC X(4). * RECORD-TYPE = 6. 05 T-ORL-INTERVAL-NUM PIC 9(4). 05 FILLER OCCURS 32. CHANGED * [ Max. Remote Nodes = 32 ] FROM 3 * [ per record, 999 total. ] TO 32 10 ORL-TOTAL-LOGONS PIC 9(5). * [ Average # of Outbound Remote ] * [ Logons from REMOTE-NODE(X) ] * [ in the interval. ] RSF Total Show Files Record 01 TOTAL-SHOW-FILES. 05 FILLER PIC X(4). * RECORD-TYPE = 8. 05 T-FILES-INTERVAL-NUM PIC 9(4). 05 TOTALS OCCURS 20. CHANGED * [ Max. Remote Nodes = 20 ] FROM 3 * [ per record, 999 total. ] TO 20 10 TOTAL-USERS PIC 9(3). 10 TOTAL-FILES PIC 9(5). B-11 CHANGES TO REDUCED DATA FILES from Release 3.20.00 RSF Detail Show Files Record 01 DETAIL-SHOW-FILES. 05 FILLER PIC X(4). * RECORD-TYPE = 9. 05 D-FILES-INTERVAL-NUM PIC 9(4). 05 NODE-FROM PIC X(8). 05 USER-ID PIC X(8). 05 FILE-NAME PIC X(8). 05 LIBRARY-NAME PIC X(8). 05 VOLUME-NAME PIC X(6). 05 OFB-ADDR PIC X(4). * [ OFB address for an open file ] 05 NO-OF-IOS PIC 9(5). * [ Total # of IOs performed on ] * [ this file during the interval.] 05 ACCESSED-BY PIC X. ADDED * [ Server which Accessed this ] * [ file. "F" = FILSRV, "S" = ] * [ SHARER, "P" = @PAGE, "X" = ] * [ XDMSSERV. ] 05 NODE-NUMBER PIC X(3). ADDED * [ Position of this node on ] * [cluster. ] B-11