OS/2 Professional

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / osrm2 / osrm2rau.doc < prev next >

Wrap

Text File | 1989-09-15 | 53.9 KB | 1,358 lines

OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Packing List Files and documentation included in this Version 1.0 archive set contains the following: OSRM2 Version 1.0 Real Time Monitor And Collector OSRM210.ZIP = Real Time Monitor OSRM2 Version 1.0 Report And Analysis Utility OSRM2RAU.DOC = This File RAULIB.DLL = RAU Video Support Library OSRMMAIN.DLL = RAU Function Support Library OSRMMSG.DLL = Message Support Library RAUSTDLB.DLL = RAU Standard Reports Library OSRM2 Version 1.0 Technical Reference ( Registered Users ) OSRMUES.ZIP = UES Developers Toolkit Please note that the OSRM2RAU executable has a limited amount of functionality in the unregistered version. Also note that the UES developers toolkit is only available with registrations for OSRM2 Version 1.0. C.O.L. Consulting developers have not inserted any nagware signs, timers or flags that pester you with the fact that you have an unregistered copy. When you attempt to use a function not implemented in the unregistered copy a short message will let you know. Information in this document is subject to change without notice and does not represent a commitment on the part of C.O.L. Consulting, LTD. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other then the purchaser's personal use, without the written permission of C.O.L. Consulting, LTD. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. General Information And Registration C.O.L. Consulting LTD., incorporated January of 1989, is a registered subchapter 'S' corporation in the State Of New York. The corporation provides DP consulting, software development ( MVS, VM, MS-DOS, UNIX, OS/2 ) as well as maintenance services. C.O.L. Consulting LTD., reserves the right to limit the functionality of unregistered copy versions. The software included in this archive package is a fully functional evaluation copy of OSRM2 Version 1.0, Report And Analysis Utility. This application is shareware, software that is free to use for a trial period, that being fairly defined by C.O.L. Consulting LTD. as 1 months time ( 30 days ). If at the end of the evaluation period, as defined above, you do not wish to register OSRM210, you are obligated to discontinue its use. This shareware archive package which includes those files as listed above must be distributed in their entirety. Any questions, comments, suggestions and criticisms are welcome. Please see the registration and service section at the end of this document. Upgrade costs will be based on the amount of functionality that is added to the application. For instance, C.O.L. Consulting LTD. will be porting this over to run under the Presentation Manager of OS/2 as a full PM application, OSRM2 Version 1.1. If you care to register your copy of OSRM2 Version 1.0, please refer to the upgrading information section and registration sheet at the end of this document. Both single user and corporate discounts are available. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. General Information And Registration An agreement with HH-InfoNet BBS, New Hartford CT, enables you to pre-register your copy and expedite the registration process. Upon completion of the on-line registration script, see the registration section at the end of this document, all you need do is send in your registration payment. Through HH-InfoNet you will also be able to communicate directly with the OSRM2 developers for all versions of the system. OSRM2 registered users will receive priority response and will receive update information by mail. You may also register by filling out the appropriate form at the end of this documentation, please see the registration schedule to determine the cost of registration. With registration of OSRM2 Version 1.0, you will receive: * OSRM2 Version 1.0, Supporting DLL libraries and printed documentation. * OSRM2 Report And Analysis Utility Version 1.0, Supporting DLL libraries and printed documentation. * OSRM2 UES Software Development Kit. Which includes documentation, API library interface, header files and include files for 'C' and MASM. Thank you. C.O.L. Consulting, LTD. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Introduction OSRM2 was created to provide OS/2 users with: The ability to observe system resource contention and consumption in a real-time environment. More importantly, to provide the OS/2 user, or administrator, a data collector in which system resource usage trends can be stored and analyzed when considering upgrades ( CPU, memory, peripherals, software ). The real-time monitor can provide the performance tuner with indicators as to cpu or memory consumption as well as IO contention under varying workloads. The Data Collector, available with Version 1.0, will provide trend information to observe exactly what resources are being impacted the most and thus guide them to configuring for cost effectiveness, one wouldn't buy a faster CPU if memory contention is causing swapping overhead. As with other multitasking operating systems ( MVS, UNIX ) resources are shared in an OS/2 environment thus allowing concurrent workloads to exist at the same time in one system. Because resources are generally limited, a careful eye must be kept to insure that it is not exhausted. Once this occurs processes may wait for a very long time thereby negating the productivity and throughput originally meant to be provided. Having solid information as to what the CPU average percent busy was or the average memory usage percent, will provide a much better guide to problem resolution or job scheduling then an eyeball approach. Of course capacity planning entails much more then mentioned here, but it is this base that all capacity plans are built. Please refer to the technical documentation. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Introduction OSRM2 will provide this information to you in a varying degree of formats and granularity. Considering the cost of this application versus 'seat of the pants' capacity planning, OSRM2 has the potential to save you time, energy and money. Please refer to the Real Time Monitor And Data Collector documentation for a discussion on the components of the OSRM2 system. The following will discuss the Report And Analysis Utility ( Version 1.0 ) only. Please refer to pertinent documentation for other parts of the system. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Report And Analysis Utility Overview The report and analysis ( OSRM2RAU.EXE ) is a separate executable application that uses the information stored by the Collector to report on the amount of resource per time interval that a particular system is consuming. Variations as to the report interval are allowed as well as range definitions, for example one might require a report on the average amount of CPU utilization between the hours of 10:00 AM and 12:00 noon, for June 1989. The user or administrator will have the ability to report on utilization growth in the key areas of the system: CPU, Memory and Disk IO. Regression analysis and queueing delays will be available for review as well as generated suggestions for enhancing performance ( Registered Copies Only ). With this knowledge, upgrading the system will be an exact decision, and will vary from user to user. This way selective system enhancements will be possible. The ability for developers and users to implement their own sumarization routines and reporting formats are allowed through the use of UES ( User Exit Support ). Please see information in this document as well as the technical references for more detail. Various data manipulation routines will be implemented over time into the standard library, as well as the ability to create a flat file which can be read into various statistical packages or spread sheets for a more detailed analysis. Of course it is the intent of C.O.L. Consulting, LTD. to provide the user with a one stop application and the features that will be implemented will have the objective of obtaining this goal. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Installation Requirements OSRM2 Versions 1.0 The above versions of OSRM2 require at least OS/2 Version 1.0 operating system. The executable programs included within this archive package were assembled as a Window Compatible application which will permit it to run in a text window under version 1.1 of OS/2 ( Presentation Manager ). The application will detect if it is running full screen or as a window and adjust it's color scheme accordingly. It is recommended to install this application on a hard disk system, as the IO timing will not allow floppy disk drives to be tested due to the delay to processing during IO. Development Environment OSRM2 was developed with the following: SOFTWARE OS/2 Version 1.1 Microsoft MASM 5.1 Microsoft C 5.1 Microsoft Editor Protected Mode ( MEP ). HARDWARE Intel based 80386 7 Megabytes Real Memory 80 Megabytes Hard Disk Space with 5 Partitions VGA Adapter with a Paradise VGA Controller OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Installation To install the OSRM2 system for various operating system environments follow these global instructions: Place the files OSRM210.EXE, OSRM2RAU.EXE and OSRM2.INI in a directory together. The OSRM2.INI file included in this archive package is a working sample and can be edited for your specific configuration. Place the files OSRM2D10.DLL, OSRM2S10.DLL, RAULIB.DLL, OSRMMAIN.DLL, OSRMMSG.DLL and RAUSTDLB.DLL in the directory specified in your CONFIG.SYS in the LIBPATH= statement. You can optionally place the DLL files in the same directory as the executable files but be sure to change your LIBPATH statement to include the directory and reboot your machine. Add the program and path specification to the Program Selector in Version 1.0 of OS/2 or the Start Program Manager of Version 1.1 of OS/2. Create a directory where you will be storing the history data files as well as the generated report and analysis files. Make sure to indicate the full designator and path created in the OSRM2.INI file before starting the system. If installed to run under Presentation Manager of OS/2 Version 1.1, specify to run under a text window to display within the Presentation Manager Screen Space. This is optional as the OSRM2 system will run full screen as well. Follow the initialization instructions on the options available for the OSRM2.INI file as described in the Real Time Monitor And Data Collector documentation. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Starting OSRM2RAU Before starting the OSRM2 Reporter And Analysis Utility, please insure that you have: * Installed the system files in their proper places. * Prepared your OSRM2.INI file with the proper * Prepared your OSRM2.INI file with the proper parameter settings for your monitor session, refer to Initialization Parameter File section of the Real Time Monitor And Data Collector documentation. To Start OSRM2RAU From OS/2 Version 1.0 From the program selector choose the program name you have assigned to OSRM2RAU and press enter. If you have not installed OSRM2RAU into the program selector, start a OS/2 session and switch to the directory where you have installed OSRM2RAU and at the command prompt enter [C:\OSRM2]osrm2rau [ then press the enter key ] OS/2 Version 1.1 From the Start Program dialog box, open the group where you have installed the OSRM2RAU program entry and double click on the application name you have assigned OSRM2RAU. If you have not installed OSRM2RAU into the Start Program dialog box, start a windowed OS/2 screen session and switch to the directory where you have installed OSRM2RAU and at the command prompt enter [C:\OSRM2]osrm2rau [ then press the enter key ] The application will initialize and present you with a screen of options. You are now ready to work with the Report And Analysis Utility. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. USING OSRM2RAU Before using the Report And Analysis Utility it is recommended that you have data to work with. System indicators should be collected at least for a few days. Once you start OSRM2RAU, you will be presented with a screen of options, the options available in the unregistered version are: Detail Data Display Criteria Data Extraction ( Limited ) Standard Report Library ( Limited ) In the registered version the following functions are also available as well as the fully functional version of the options listed above: Regression and Queueing Analysis UES Sumarization Capability UES Reporting Capability The remainder of this documentation will step through each available function and describe their operation and uses. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Report And Analysis - MAIN MENU Upon the start of OSRM2RAU you will be presented with the main menu as seen below. Main Menu F1 Step Through History Record F2 Perform Criteria Record Search F3 Use Standard Report Library F4 F5 F6 UES Summary Routine F7 UES Reporting Routine F8 F9 F10 Exit Report And Analysis Utility You made it! Note that only the first three options are active in the unregistered version, this documentation will cover those options only. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records Your data is recorded at intervals as set within the OSRM2.INI initialization file. One of the options defines the summary interval at which OSRM2 will write statistic data to disk. This data is kept in monthly files that reside in the directory defined in the OSRM2.INI initialization file. OSRM2 automatically creates a new monthly file whenever it detects that a new month has begun. With option F1 the user has the ability to display each detail record within a single months data file. You will be presented with another screen that will ask you to pick the monthly file to use for viewing. If there is only one month there is very little choosing for you do. When choosing the file to be displayed, the directional arrow keys work like this: LEFT and RIGHT keys Move the highlight between YEAR and MONTH so that you can choose the proper time period for display. UP and DOWN Will scroll the month or year value depending on where the highlight is located. If you decide to skip using this function, the F10 key will return you to the previous menu. F10 key is the exit key throughout the entire application. Once you have arrived at the proper setting, hitting the ENTER key will cause the file to be read into memory in preparation for display. You can then use the F2 option ( Display Records ) to begin displaying the currently chosen history file from the first record. The screen on the following page is what you are presented with. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records Detail record view screen with raw system statistics as saved by the OSRM2 Real Time Monitor And Data Collector. Note that the record may contain various values based on the record type, refer to the descriptions following the chart. Date : Hour : Minute : Record Type : Record Count : --------------- CPU Statistics In Ms -------------------- Minimum : Average : Maximum : --------------- DASD Statistics In Ms ------------------- 1 2 3 4 5 Min : Avg : Max : ------------- Memory Statistics In Segments ------------- System Total : System Available : F1 = Previous F2 = Next F10 = Exit GENERAL DATE FIELD DESCRIPTIONS: Date Calendar day of the month the record was recorded. Hour The hour of the day this record was recorded. Minute The minute of the hour this record was recorded. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records RECORD FIELD DESCRIPTIONS: Record Type This field describes the data record type and can be anyone of the following values: 00 Session start up record. This record is produced when ever the OSRM2 Real Time Monitor And Data Collector are started. The data in the resource fields are primarily invalid. 02 Summary interval record. This record is produced at intervals as set in the SUMMARY field of the OSRM2.INI initialization file. It indicates a normal data record. The data in the resource fields are valid. 05 Month change over record. This record indicates that a new data file was created as the current session was active during a new month occurrence. The data in the resource fields are valid. 10 Session shut down record. This record is produced when the user has specified a shutdown of the OSRM2 Real Time Monitor And Data Collector session. Record Count This value reflects 0 for record type 0, otherwise it reflects the number of records summarized before being written as a type 2,5 or 10 record. For type 2 records this value should be a multiple of the COLLECTINTV value as set in the OSRM2.INI initialization file. For example, with a COLLECTINTV of 1 minute and a SUMMARY of 15 minutes, for a type 2 record the record count should show a value of 15. For a record type of 5 or 10, the record count will display the number of records summarized prior to the event that caused the record to be saved. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records CPU FIELD DESCRIPTIONS The CPU Statistics in Ms fields reflect the timing delay in milliseconds that the OSRM2 Real Time Monitor And Data Collector sampled for the interval. These values are an indicator of processor busy. The larger the value, the busier the processor was during that interval. Key indicator here folks! Minimum This field is the value of the minimum time busy for the interval. It is likely to be 0 for most records as the sampler function is a fairly tight loop and will report its own delay when there is no other work in the system. This is not an average but an actual value. Average This field is the running average of all samples taken during the interval of processor busy, the higher the value the busier the processor was on an average. For example: With the COLLECTINTV set at 1 minute and SUMMARY at 15 minutes, if this value shows 32 ms then the processor was busy 32 milliseconds of the second or: 32 / 1000 ms (1 sec) = 3.2 % busy. Maximum This field holds the value of the maximum time busy for the interval. It is possible for this value to exceed 1000 ms ( 1 second ) which would result in a greater then 100% busy value. Of course this reflects that the system was so busy that the Real Time Monitor And Data Collector was in a WAIT and READY state. Ready to execute but waiting to be dispatched. The Standard Library has reports which indicate hour of day trends for these statistics; CPU Average And CPU Peak. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records DASD FIELD DESCRIPTIONS The DASD Statistics In Ms display the values for the IO operations that test the disk partition service time. The 1 - 5 line is a reference for the drive partitions identified to be tested as the DESIGNATOR parameter in the OSRM2.INI initialization file. Values under the 1 reference mark are for the first drive partition identified, 2 for the second and so on. As this is a raw data display, the actual drive identifiers ( C: E: Z: ... ) are omitted but are available in the Standard Library Reports. The DASD Min, Avg and Max values indicate the Minimum, Average and Maximum time it took to perform the disk operations of the DASD test. Minimum This field indicates the minimum, or least, amount of time that it took the DASD IO test to complete. This can be considered the best time as operations that take little time will allow more operations to occur within a time frame. Average This field is the average of all tests as described above for the COLLECTINTV. Maximum This field is the maximum value detected for the tests as described above. Therefor with these values, attainable IO per second is calculated, for example: DASD 1 Average 33 ms - Means that it took an average of 33 milliseconds to complete 1 disk IO during the interval. This indicates that the attainable IO per Second would be about 30 IOs. Not to good, I know because that's about what I get! OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records MEMORY FIELD DESCRIPTIONS The Memory Statistics In Segments indicators are for the total system memory as defined in the REAL parameter of the OSRM2.INI initialization file, and the memory available field which is a measurement of largest available block. System Total This is the amount of memory in 64K segments that were defined in the REAL parameter as stated above. For example if this field indicated 112 it would mean that the user who defined the REAL parameter entered a value of 7 ( Megabytes ). 112 x 64K = 7,168,000 bytes of memory. System Available This value is the average of the size of the largest contiguous block of memory found during the sampling intervals. C.O.L. Consulting is working on a way to detect the ACTUAL amount of real memory available for allocation without forcing a core scan as this would consume CPU time and incur delays. This is considered a mishap on the part of the OS/2 developers, they left out an API call to detect total real memory available. It is believed that because OS/2 incorporates swapping, the developers may have thought that the total value would not be needed as virtual memory relaxes memory usage considerations. We do not think so. As with the System Total field the System Available field is reported in 64K segments. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F1 - Stepping Through Detail Records Function Key Options There are three options when displaying the raw data records: F1 Moves backward through the records F2 Moves forward through the records F10 Exits the raw data display . OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option 2 - Perform Criteria Record Search With option F2 you have the ability to gather records from the history data based on a Boolean search criteria. If the search is successful you will then be able to display the records that were found using the same display as function on uses to display the raw data. Conducting a criteria search consists of the following: From The Criteria Search For Records Menu * Choose A History File To Work With ( F1 ) * Set Up The Search Criteria ( F2 ) From The Criteria Set Menu * Choose The Resources To Base Search On ( F1 - F5 ) * Conduct The Search ( F7 ) At this point OSRM2RAU will conduct the search and then return to the Criteria Search For Records menu. You would then use: * Display Search Results ( F3 ) You are also able to reset the history record and search criteria to conduct additional searches. The following sections will describe the functions available from the top menu. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option 2 - Perform Criteria Record Search F1 Choose A History Data Set This function operates the same as with displaying the raw history data file. You are presented with a menu which allows you to choose the history data file with which to conduct the logical search for records. Please refer to OPTION 1 for details on this operation. F2 Set Criteria For Search Pressing this key will invoke the Criteria Set Menu, see the description below. This option will not activate until a history file has been chosen ( F1 ). F3 Display Search Results Once the search has been completed you will be able to display the results with this function. The screen and navigation controls for displaying the results is the same as those used in displaying raw history records. Please refer to OPTION 1 for details of this operation. If there are no results you will be informed of such and will then have the ability to conduct another search. F4 Print Search Results The function is not available in the unregistered version of OSRM2RAU. But it functions as a option which will allow the printing of the search results in a variety of formats. F5 Reset History And Criteria Files This option will reset the currently selected history file as well as erase the search results, if any. At this point you will be able to respecify a history file as well as criteria for searches. F10 Exit Record Search This will return you to the main menu. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option 2 - Perform Criteria Record Search Once you have chosen option Set Criteria For Search ( F2 ) on the Perform Criteria Record Search menu, you will be presented with another menu which allows you to choose which resources to base the search on. Currently OSRM2RAU, both registered and unregistered versions, are limited to two (2) keys with which to search the history data bases. F1 Date If you use Date as one of your options you will be allowed to define a criteria based on the date of the month from the history data base. Value range from 0 to 31. You can specify greater then 31 but it is highly unlikely your search will produce results. F2 Hour Of Day Will allow a search based on the hour of the day regardless of the records date formats. Value range from 0 - 23. F3 CPU Average This will allow a search based on the Average CPU as recorded in the history file, values must be specified in milliseconds. F4 DASD IO Average This will allow a search based on the Average DASD IO from the first drive in the DESIGNATOR list as set in the OSRM2.INI initialization file. Although the search is conducted on the first disk partition configured all other data will be included in the results. This value must be specified in milliseconds. F5 Memory Allocation This will allow a search based on the System Memory Available field. This value must be specified in the number of 64K segments as described in the OPTION 1 function for displaying raw data. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option 2 - Perform Criteria Record Search There are two keys ( Criteria ) allowed in this function, if at any point before you conduct the search you wish to redefine the keys: F6 Reset Search Criteria Will allow both keys to be respecified F7 Perform Search Pressing this key will proceed with the criteria search as you have defined. If you have only defined one ( 1 ) search key you will be able to conduct as search as well. If there has been no keys defined, you will be unable to conduct a search as this would result in selecting the full data base. If that is what you intended then use the Display History Records function from the Main Menu. F10 Exit And Abandon Search Pressing this key will allow you to abandon the search procedure and will return you to the previous menu. Note that there is another menu that is activated whenever you choose options F1 thru F5, this is the logical defines that you will base your search on. Please make note of how the search is conducted based on the keys that you have defined. This may save you some frustration when the results that you were looking for may not be the results of the search. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option 2 - Perform Criteria Record Search The following will describe the logical operators available with which to base the search on. After their description please read the note on how the search is conducted and various results that may occur. When any of the options listed below, with the exception of the exit key ( F10 ), are chosen, a small entry field will activate for you to enter the value for the logical operation you have selected. Please refer to the resource definitions on the values you may enter. F1 Less Then This allows you to search on values for the field that are LESS then the number you enter for this operation. F2 Greater Then This allows you to search on values for the field that are GREATER then the number you enter for this operation. F3 Equal To This allows the search on values for the field that are EQUAL to the number you enter. F4 Not Equal To This allows the search on values for the field that are NOT EQUAL to the number you enter. F5 Less Then Or Equal To This allows the search on values for the field that are LESS THEN OR EQUAL to the number you enter. F6 Greater Then Or Equal To This allows the search on values for the field that are GREATER THEN OR EQUAL to the number you enter. F10 Cancel And Return This allows NOTHING! Pressing this will return you to the previous menu. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option 2 - Perform Criteria Record Search Notes On Criteria Searches OSRM2RAU takes the criteria you set and then reads in the history file you have chosen and compares the fields that you have set in the criteria against the real values in the data base. For all separate keys defined this search is conducted as an AND operation, in other words both criteria 1 AND 2 must be met before a record is selected. For example lets say that you want to pull all records with a DATE greater then 15 and a CPU Average of less then or equal to 25 milliseconds. In order for a record to satisfy this criteria, the DATE field for the current record MUST be GREATER then the 15th of the month AND !!! the Average CPU time MUST be LESS THEN OR EQUAL to 25 milliseconds. Keep this in mind when conducting criteria searches, sometimes you may be thinking of an OR operation and will not have successful results. This concludes the Criteria Record Search section, if there are any question in your mind as to the operation of this function, please, take the time to read it again or get in touch with technical support through the various Bulletin Board Services listed in this document. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F3 - Use Standard Report Library The OSRM2RAU Standard Report Library option allows the user to print various summarization reports or character plots of a particular resource, or all of the system resources as defined in the history data base. The Standard Report Library ( SRL ) also has integrated the Report And Analysis Catalog Manager ( RACM ). RACM can be accessed by UES libraries via OSRM2RAU API Library calls documented in the UES Developers Toolkit. This will allow a common report handling interface for the user. The SRL in the unregistered version of OSRM2RAU is limited to report capability only, no plotting capability, and reports can only be run against specific historic data bases. When you choose the SRL option, the following menu is activated: OSRM2 Standard Library Version 1.0 F1 CPU Reports F2 DASD Reports F3 Memory Reports F4 F5 F6 F7 F8 F9 F10 Exit Standard Library The three resource options create summarization reports which will average usage of that resource Average Or Maximum value for a selected historic data base. The reports are based on a months total usage and show by hour what those averages are. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F3 - Use Standard Report Library Once the period of interest has been specified, you are then asked if you would like to report on the Average Or Maximum Values for that report. For example an Hourly Report Of Average CPU Utilization For September 1989 would look like this: CPU Average Utilization By Hour - For Period OSRM2 Report And Analysis Utility Copyright (c) C.O.L. Consulting LTD, 1989 ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ Period : OSRM0989.COL Hour Samples Average %-Pct ------------------------------------------------------------ 0 6 4 0.00 1 7 126 0.13 2 5 16 0.02 3 0 0 0.00 4 0 0 0.00 5 0 0 0.00 6 0 0 0.00 7 0 0 0.00 8 3 6 0.01 9 7 27 0.03 10 10 13 0.01 11 13 93 0.09 12 15 17 0.02 13 18 22 0.02 14 11 22 0.02 15 12 14 0.01 16 11 27 0.03 17 11 16 0.02 18 8 8 0.01 19 6 8 0.01 20 3 6 0.01 21 8 36 0.04 22 9 60 0.06 23 11 18 0.02 OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F3 - Use Standard Report Library If this is the first time that you are running the SRL and you complete the operation of creating a report, a sub- directory called COLREPTS will be created off of the directory where your history files are located as defined in the OSRM2.INI initialization file. If you create a report and then look at this directory you will notice the file RAURPT.CAT, this is a catalog of reports in the directory. Each time you create a report this library will grow by 64 bytes. As the RACM is not active in the unregistered copy of OSRM2RAU you will have no way to control this. The registered release contains many functions that will allow this to be modified and optimized. You will also notice peculiar naming conventions for the reports you create which consists of the following structure: c???????.RPT | .PLT Where c = C for CPU reports D for DASD reports M for Memory Reports S for System Reports ( Registered Version ) U for UES Reports ( " ) X for unknown reports. ??????? = Any number from 1 to 65534 which is the sequential number of the report. .RPT | .PLT ( Extensions ) = RPT for Reports PLT for Plots ( Registered Version Only ) The reports themselves are recorded in straight ascii text with a form feed character at the end. Each report is 1 page long in the unregistered version. OSRM2 OS/2 Resource Monitor Facility Version 1.0 Report And Analysis Utility (C) Copyright 1989, C.O.L. Consulting LTD. Option F3 - Use Standard Report Library These reports will form the basis of system analysis that OSRM2 was created for. With the reporting and data manipulation routines you will be able to view system statistics over a broad range of Real Time samples and make decisions based on fact, rather then seat of the pants guesswork. OSRM2RAU unregistered was released to provide you the OS/2 user / administrator / analyst with enough insight to the application so that it's value would be realized. The reports produced in this unregistered version could certainly be all you need to make business and financial decisions. You will at least be able to view what your system is doing, a valuable tool in itself. With UES support more analysis and reporting routines are possible that would increase the value of OSRM2 to you as well. Statistical analysis, graphing and exception reporting are just of few of the potential applications. C.O.L. Consulting LTD. is pleased to make this application available to the OS/2 community, and feels that it will prove to be an invaluable tool now and in the future of this exciting, and contrary to some belief, long term system operating environment. If you are interested in registering a copy of the OSRM2 system, you will find the information necessary to do so in the OSRM2 Real Time Monitor And Data Collector guide. Thank you for your support C.O.L. Consulting LTD.