home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / osrm2 / osrm210u.doc < prev    next >
Encoding:
Text File  |  1989-09-15  |  52.0 KB  |  1,396 lines
  1.  
  2.  
  3.  
  4.  
  5.                                        OSRM2
  6.                            OS/2 Resource Monitor Facility
  7.                                     Version 1.0
  8.                         Real Time Monitor And Data Collector
  9.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  10.  
  11.  
  12.             Packing List
  13.  
  14.             Files and documentation included in this Version 1.0 set
  15.             contains the following:
  16.  
  17.             OSRM2 Version 1.0 Real Time Monitor And Collector
  18.  
  19.                  OSRM210.DOC    =    This file
  20.                  OSRM2.INI      =    Sample Initialization File
  21.                  OSRM210.EXE    =    Real Time Monitor Only.
  22.                  OSRM2D10.DLL   =    Dynamic Support Dynalibs
  23.                  OSRM2S10.DLL   =    Static Support Dynalibs
  24.  
  25.             OSRM2 Version 1.0 Report And Analysis Utility
  26.  
  27.                  OSRM2RAU.ZIP   =    Report And Analysis Utility
  28.  
  29.             OSRM2 Version 1.0 Technical Reference ( Registered Users )
  30.                  OSRMUES.ZIP    =    UES Developers Toolkit
  31.  
  32.             Please note that the OSRM2RAU executable has a limited
  33.             amount of functionality in the unregistered version. Also
  34.             note that the UES developers toolkit is available with
  35.             registrations for OSRM2 Version 1.0.
  36.  
  37.             C.O.L. Consulting developers have not inserted any nagware
  38.             signs, timers or flags that pester you with the fact that
  39.             you have an unregistered copy.
  40.  
  41.  
  42.  
  43.                                        OSRM2
  44.                            OS/2 Resource Monitor Facility
  45.                                     Version 1.0
  46.                         Real Time Monitor And Data Collector
  47.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  48.  
  49.  
  50.                  General Information And Registration
  51.  
  52.             C.O.L. Consulting LTD., incorporated January of 1989, is a
  53.             registered subchapter 'S' corporation in the State Of New
  54.             York. The corporation provides DP consulting, software
  55.             development ( MVS, VM, MS-DOS, UNIX, OS/2 ) as well as
  56.             maintenance services.
  57.  
  58.             C.O.L. Consulting LTD., reserves the right to limit the
  59.             functionality of future versions in unregistered copies, but
  60.             will continue to support Version 0.1 in it's entirety.
  61.  
  62.             The software included in this archive package is a fully
  63.             functional evaluation copy of OSRM2 Version 1.0.
  64.  
  65.             This application is shareware, software that is free to use
  66.             for a trial period, that being fairly defined by C.O.L.
  67.             Consulting LTD. as 1 months time ( 30 days ).
  68.  
  69.             If at the end of the evaluation period, as defined above,
  70.             you do not wish to register OSRM210.EXE, you are obligated
  71.             to discontinue its use.
  72.  
  73.             This shareware archive package which includes those files as
  74.             listed above must be distributed in their entirety.
  75.  
  76.             Any questions, comments, suggestions and criticisms are
  77.             welcome. Please see the registration and service section at
  78.             the end of this document.
  79.  
  80.             Upgrade costs will be based on the amount of functionality
  81.             that is added to the application. For instance, C.O.L.
  82.             Consulting LTD. will be porting this over to run under the
  83.             Presentation Manager of OS/2 as a full PM application, OSRM2
  84.             Version 1.1.
  85.  
  86.             If you care to register your copy of OSRM2 Version 1.0,
  87.             please refer to the upgrading information section and
  88.             registration sheet at the end of this document. Both single
  89.             user and corporate discounts are available.
  90.  
  91.  
  92.  
  93.                                        OSRM2
  94.                            OS/2 Resource Monitor Facility
  95.                                     Version 1.0
  96.                         Real Time Monitor And Data Collector
  97.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  98.  
  99.  
  100.                  General Information And Registration
  101.  
  102.             An agreement with HH-InfoNet BBS, New Hartford CT, enables
  103.             you to pre-register your copy and expedite the registration
  104.             process. Upon completion of the on-line registration script,
  105.             see the registration section at the end of this document,
  106.             all you need do is send in your registration payment.
  107.  
  108.             Through HH-InfoNet you will also be able to communicate
  109.             directly with the OSRM2 developers for all versions of the
  110.             system. OSRM2 registered users will receive priority
  111.             response and will receive update information by mail.
  112.  
  113.             You may also register by filling out the appropriate form at
  114.             the end of this documentation, please see the registration
  115.             schedule to determine the cost of registration.
  116.  
  117.             With registration of OSRM2 Version 1.0, you will receive:
  118.  
  119.                  *    OSRM2 Version 1.0, Supporting DLL libraries and
  120.                       printed documentation.
  121.  
  122.                  *    OSRM2 Report And Analysis Utility Version 1.0,
  123.                       Supporting DLL libraries and printed
  124.                       documentation.
  125.  
  126.                  *    OSRM2 UES Software Development Kit. Which includes
  127.                       documentation, API library interface, header files
  128.                       and include files for 'C' and MASM.
  129.  
  130.  
  131.  
  132.                                 Thank you.
  133.  
  134.                                 C.O.L. Consulting, LTD.
  135.  
  136.  
  137.  
  138.                                        OSRM2
  139.                            OS/2 Resource Monitor Facility
  140.                                     Version 1.0
  141.                         Real Time Monitor And Data Collector
  142.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  143.  
  144.  
  145.                  Introduction
  146.  
  147.  
  148.  
  149.             OSRM2 was created to provide OS/2 users with:
  150.  
  151.                  The ability to observe system resource contention and
  152.                  consumption in a real-time environment.
  153.  
  154.                  More importantly, to provide the OS/2 user, or
  155.                  administrator, a data collector in which system
  156.                  resource usage trends can be stored and analyzed when
  157.                  considering upgrades ( CPU, memory, peripherals,
  158.                  software ).
  159.  
  160.             The real-time monitor can provide the performance tuner with
  161.             indicators as to cpu or memory consumption as well as IO
  162.             contention  under varying workloads.
  163.  
  164.             The capacity planner data collector, available with Version
  165.             1.0, will provide trend information to observe exactly what
  166.             resources are being impacted the most and thus guide them to
  167.             configuring for cost effectiveness, one wouldn't buy a
  168.             faster CPU if memory contention is causing swapping
  169.             overhead.
  170.  
  171.             As with other multitasking operating systems ( MVS, UNIX )
  172.             resources are shared in an OS/2 environment thus allowing
  173.             concurrent workloads to exist at the same time in one
  174.             system.
  175.  
  176.             Because resources are generally limited, a careful eye must
  177.             be kept to insure that it is not exhausted. Once this occurs
  178.             processes may wait for a very long time thereby negating the
  179.             productivity and throughput originally meant to be provided.
  180.  
  181.             Having solid information as to what the CPU average percent
  182.             busy was or the average memory usage percent, will provide a
  183.             much better guide to problem resolution or job scheduling
  184.             then an eyeball approach. Of course capacity planning
  185.             entails much more then mentioned here, but it is this base
  186.             that all capacity plans are built. Please refer to the
  187.             technical documentation.
  188.  
  189.  
  190.  
  191.                                        OSRM2
  192.                            OS/2 Resource Monitor Facility
  193.                                     Version 1.0
  194.                         Real Time Monitor And Data Collector
  195.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  196.  
  197.  
  198.                  Introduction
  199.  
  200.             OSRM2 will provide this information to you in a varying
  201.             degree of formats and granularity. Considering the cost of
  202.             this application versus 'seat of the pants' capacity
  203.             planning, OSRM2 has the potential to save you time, energy
  204.             and money.
  205.  
  206.             Each of the components that make up the OSRM2 system will be
  207.             generally discussed in the following order:
  208.  
  209.             Real-time Monitor ( Version 1.0 )
  210.  
  211.             Collector ( Version 1.0 )
  212.  
  213.             Analyzer And Reporter ( Version 1.0 )
  214.  
  215.             User Exit Support ( Version 1.0 )
  216.  
  217.             For detail information about any specific topic please refer
  218.             to the included documentation or technical notes.
  219.  
  220.  
  221.  
  222.                                        OSRM2
  223.                            OS/2 Resource Monitor Facility
  224.                                     Version 1.0
  225.                         Real Time Monitor And Data Collector
  226.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  227.  
  228.  
  229.                  Real-time Monitor
  230.  
  231.  
  232.  
  233.             The real-time monitor is a visual display that provides the
  234.             user with a constantly updated information screen. The
  235.             information provided shows the average CPU utilization, the
  236.             amount of physical memory allocated, as well as the average
  237.             attainable IO disk operations per second.
  238.  
  239.             For CPU utilization, the system runs a medium priority
  240.             regular dispatchable thread. The real-time monitor
  241.             calculates the CPU utilization by dividing the amount of
  242.             millisecond since its last update by 1000. The result is
  243.             utilization as utilization = busy/time.
  244.  
  245.             For the physical memory consumption, the amount of storage
  246.             physically installed in the system as well as memory
  247.             consuming configuration options are considered in
  248.             determining the approximate amount of physical storage
  249.             remaining for user applications. The monitor continuously
  250.             queries for the largest physical block of memory available
  251.             and then divides this by the physical memory total.
  252.  
  253.             The disk access service time indicator is based on the
  254.             average time it takes to perform and IO to each of the
  255.             partitions configured in the system. The user can configure
  256.             various partitions to be tested in any order.
  257.  
  258.             The constant information is kept in an initialization file
  259.             in the same directory as the executable files.
  260.  
  261.  
  262.  
  263.                                        OSRM2
  264.                            OS/2 Resource Monitor Facility
  265.                                     Version 1.0
  266.                         Real Time Monitor And Data Collector
  267.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  268.  
  269.  
  270.                  Collector
  271.  
  272.             The Collector is an integral part of the Real Time Monitor.
  273.  
  274.             The Collector samples the average CPU, memory, and IO
  275.             variables kept by the real time monitor. The granularity at
  276.             which this information is gathered is set by the
  277.             administrator of the system. The Collector then summarizes
  278.             these samples and records the data to disk. For example you
  279.             can set the collector to sample every 5 minutes and to
  280.             report on the hour interval. This will give you the average
  281.             indicator per hour of resource usage collected every 5
  282.             minutes.
  283.  
  284.             The data is written to the data history file every increment
  285.             of reporting, in the case of the above example, this would
  286.             be every hour. Time stamps and date stamps, as well as
  287.             minimum and maximum resource values, will allow for a large
  288.             amount of analysis and cross reference.
  289.  
  290.             The collector will then clear out all of its buffers and
  291.             then start collecting again. In the example above the
  292.             collector will reset all real-time averages for the
  293.             following hours interval.
  294.  
  295.             Each month the collector will create a new file which can
  296.             then allow the user to archive back dated history files and
  297.             not consume hard disk space. It is recommended to keep a
  298.             good amount of history data for analysis as the trends will
  299.             be more accurate as the historic data grows.
  300.  
  301.  
  302.  
  303.                                        OSRM2
  304.                            OS/2 Resource Monitor Facility
  305.                                     Version 1.0
  306.                         Real Time Monitor And Data Collector
  307.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  308.  
  309.  
  310.                  Report And Analysis Utility
  311.  
  312.  
  313.  
  314.             The report and analysis ( OSRM2RAU.EXE ) is a separate
  315.             executable application that uses the information stored by
  316.             the Collector to report on the amount of resource per time
  317.             interval that a particular system is consuming.
  318.  
  319.             Variations as to the report interval are allowed as well as
  320.             range definitions, for example one might require a report on
  321.             the average amount of CPU utilization between the hours of
  322.             10:00 AM and 12:00 noon, for weeks 2 and 4 of the June 1989.
  323.  
  324.             The user or administrator will have the ability to report on
  325.             utilization growth in the key areas of the system: CPU,
  326.             Memory and Disk IO. Regression analysis and queueing delays
  327.             will be available for review as well as generated
  328.             suggestions for enhancing performance ( Registered Copies
  329.             Only ). With this knowledge, upgrading the system will be an
  330.             exact decision, and will vary from user to user. This way
  331.             selective system enhancements will be possible.
  332.  
  333.             The ability for developers and users to implement their own
  334.             summarization routines and reporting formats are allowed
  335.             through the use of UES ( User Exit Support ). Please see
  336.             information in this document as well as the technical
  337.             references for more detail.
  338.  
  339.             Various data manipulation routines will be implemented over
  340.             time into the standard library, as well as the ability to
  341.             create a flat file which can be read into various
  342.             statistical packages or spread sheets for a more detailed
  343.             analysis. Of course it is the intent of C.O.L. Consulting,
  344.             LTD. to provide the user with a one stop application and the
  345.             features that will be implemented will have the objective of
  346.             obtaining this goal.
  347.  
  348.  
  349.  
  350.                                        OSRM2
  351.                            OS/2 Resource Monitor Facility
  352.                                     Version 1.0
  353.                         Real Time Monitor And Data Collector
  354.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  355.  
  356.  
  357.                  User Exit Support
  358.  
  359.  
  360.  
  361.             UES support is available with registered copies of OSRM2
  362.             Version 1.0. Included in the registration is a UES Software
  363.             Development Kit. IT IS NOT INCLUDED IN THIS ARCHIVE.
  364.  
  365.             For this feature alone we must respect the capabilities that
  366.             OS/2 has offered to use.
  367.  
  368.             User Exit Support ( UES ) is a feature that allows the user
  369.             to develop various routines in a Dynamic Link Library  (DLL)
  370.             format and hook these routines into various areas of the
  371.             OSRM2 Collector and OSRM2 Report And Analysis Utility.
  372.  
  373.             The OSRM2 Collector saves to disk files what in essence is a
  374.             series of data structures ( objects ! ) which contains
  375.             variables of system activity and performance. With UES a
  376.             routine can be called from the OSRM2 Collector and have this
  377.             structure passed to it for manipulation.
  378.  
  379.             The OSRM2 Report and Analysis Utility calls its own data
  380.             reduction and summary routines via DLL calls. In the same
  381.             vein, UES will support the calling of routines both pre and
  382.             post analysis. This can allow for more advanced data
  383.             analysis routines and report writers to be added.
  384.  
  385.             Through UES, there is the potential for a vast interchange
  386.             of data manipulation and reporting routines that may be
  387.             freely distributed.
  388.  
  389.             Just as spreadsheet macros are communicated across bulletin
  390.             boards as well as incorporated into libraries, the potential
  391.             exposure is great and the benefit to the end user even
  392.             greater as this would reduce the time required to create
  393.             their own routines. At the same time productivity increases
  394.             and development time decreases.
  395.  
  396.             The major difference of UES versus macros is that the power
  397.             of a programming language, and its flexibility, can be used
  398.             in place of the sometimes limited macro capabilities.
  399.  
  400.             C.O.L. Consulting LTD. will not be responsible for
  401.             maintaining third party UES libraries but will provide
  402.             support through license and maintenance agreements with the
  403.             UES developers.
  404.  
  405.  
  406.  
  407.                                        OSRM2
  408.                            OS/2 Resource Monitor Facility
  409.                                     Version 1.0
  410.                         Real Time Monitor And Data Collector
  411.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  412.  
  413.  
  414.                  Installation Requirements
  415.  
  416.                                 OSRM2 Versions 1.0
  417.  
  418.  
  419.  
  420.             The above versions of OSRM2 require at least OS/2 Version
  421.             1.0 operating system. The executable programs included
  422.             within this archive package were assembled as a Window
  423.             Compatible application which will permit it to run in a text
  424.             window under version 1.1 of OS/2 ( Presentation Manager ).
  425.             The application will detect if it is running full screen or
  426.             as a window and adjust it's color scheme accordingly.
  427.  
  428.             It is recommended to install this application on a hard disk
  429.             system, as the IO timing will not allow floppy disk drives
  430.             to be tested due to the delay to processing during IO.
  431.  
  432.                                 Development Environment
  433.  
  434.             OSRM2 was developed with the following:
  435.  
  436.             SOFTWARE
  437.  
  438.                  OS/2 Version 1.1
  439.                  Microsoft MASM 5.1
  440.                  Microsoft C 5.1
  441.                  Microsoft Editor Protected Mode ( MEP ).
  442.  
  443.             HARDWARE
  444.  
  445.                  Intel based 80386
  446.                  7 Megabytes Real Memory
  447.                  80 Megabytes Hard Disk Space with 5 Partitions
  448.                  VGA Adapter with a Paradise VGA Controller
  449.  
  450.  
  451.  
  452.                                        OSRM2
  453.                            OS/2 Resource Monitor Facility
  454.                                     Version 1.0
  455.                         Real Time Monitor And Data Collector
  456.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  457.  
  458.  
  459.                  Installation
  460.  
  461.  
  462.  
  463.             To install the OSRM2 system for various operating system
  464.             environments follow these global instructions:
  465.  
  466.             Place the files OSRM210.EXE, OSRM2RAU.EXE  and OSRM2.INI in
  467.             a directory together. The OSRM2.INI file included in this
  468.             archive package is a working sample and can be edited for
  469.             your specific configuration.
  470.  
  471.             Place the files OSRM2D10.DLL, OSRM2S10.DLL, RAULIB.DLL,
  472.             OSRMMSG.DLL in the directory specified in your CONFIG.SYS in
  473.             the LIBPATH= statement. You can optionally place the DLL
  474.             files in the same directory as the executable files but be
  475.             sure to change your LIBPATH statement to include the
  476.             directory and reboot your machine.
  477.  
  478.             Add the program and path specification to the Program
  479.             Selector in Version 1.0 of OS/2 or the Start Program Manager
  480.             of Version 1.1 of OS/2.
  481.  
  482.             Create a directory where you will be storing the history
  483.             data files as well as the generated report and analysis
  484.             files. Make sure to indicate the full designator and path
  485.             created in the OSRM2.INI file before starting the system.
  486.  
  487.             If installed to run under Presentation Manager of OS/2
  488.             Version 1.1, specify to run under a text window to display
  489.             within the Presentation Manager Screen Space. This is
  490.             optional as the OSRM2 system will run full screen as well.
  491.  
  492.             Follow the initialization instructions on the options
  493.             available for the OSRM2.INI file.
  494.  
  495.  
  496.  
  497.                                        OSRM2
  498.                            OS/2 Resource Monitor Facility
  499.                                     Version 1.0
  500.                         Real Time Monitor And Data Collector
  501.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  502.  
  503.  
  504.                  Initialization Parameters
  505.  
  506.  
  507.  
  508.             OSRM2 1.0 includes a required initialization file,
  509.             OSRM2.INI, which defines various options to be used during
  510.             the processing of each run.
  511.  
  512.             In general each parameter, with the exception of the REAL
  513.             parameter, is optional. You may omit to include the optional
  514.             parameters and OSRM2 will default to the values noted as
  515.             DEFAULT under each description.
  516.  
  517.             Following is the current list of acceptable parameters:
  518.                   [REAL=]            Real memory indicator.
  519.                   [NUMDRIVES=]       Number of drive partitions to test.
  520.                   [DESIGNATOR=]      Drive designator list.
  521.                   [TIMEDRIVES=]      Disk drive test visit interval.
  522.                   [OPTIONIO=]        Drive Testing Options.
  523.                   [COLLECTORINTV=]   Collector sample interval.
  524.                   [SUMMARY=]         Summary and file interval.
  525.                   [UES=]             User Exit Support requests.
  526.                   [MODNAME=]         UES dynamic link library.
  527.                   [PROCNAME=]        UES procedure for collector.
  528.                   [FILESPATH=]       Path to store data files.
  529.                   [END]              Indicated End of INI file.
  530.  
  531.             In time additional parameters may be added, or current
  532.             parameters may be dropped based on applicability, user
  533.             request and functionality.
  534.  
  535.  
  536.  
  537.                                        OSRM2
  538.                            OS/2 Resource Monitor Facility
  539.                                     Version 1.0
  540.                         Real Time Monitor And Data Collector
  541.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  542.  
  543.  
  544.                  Parameter Rules
  545.  
  546.  
  547.  
  548.             All parameters must be entered in UPPER CASE ONLY and have
  549.             both the parameter name and assigned value enclosed in
  550.             brackets: [PARAMETER=assigned value].
  551.  
  552.             DO NOT imbed spaces between the '=' sign and the assigned
  553.             value, note the examples and supplied OSRM2.INI file.
  554.  
  555.             Comments are allowed and should be preceded by a semi-colon
  556.             character ';', for example:
  557.             [PARAMETER=assigned value]    ; Comment
  558.             ; Or comment here as well.
  559.  
  560.             Note the ranges currently acceptable for the parameters,
  561.             when an out of range is detected OSRM2 will use default
  562.             values for that parameter. Out of range events will be
  563.             detected when summary reports are created, those parameters
  564.             out of range will be flagged.
  565.  
  566.  
  567.  
  568.                                        OSRM2
  569.                            OS/2 Resource Monitor Facility
  570.                                     Version 1.0
  571.                         Real Time Monitor And Data Collector
  572.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  573.  
  574.  
  575.                  Parameter Setting
  576.  
  577.             [REAL=# of megabytes]
  578.                  THIS IS A REQUIRED PARAMETER!
  579.  
  580.             DESCRIPTION
  581.                  The REAL option allows the user to specify the amount
  582.                  of real physical memory installed in the system. This
  583.                  value entered will be used in determining the amount of
  584.                  free physical memory during each real time monitor
  585.                  update. The value specified in this option must be
  586.                  rounded to the nearest megabyte boundary.
  587.  
  588.                                 VERSIONS  0.1 / 1.0
  589.  
  590.                                 RANGES    2 - 16
  591.  
  592.                                 DEFAULT   Value must be specified
  593.  
  594.             EXAMPLE   [REAL=7]
  595.                  Specifies that there is 7 megabytes of real memory
  596.                  installed in the system.
  597.  
  598.             NOTES
  599.                  This value may be varied upwards to test the effect of
  600.                  increasing real memory to reduce swapping and decrease
  601.                  response time.
  602.  
  603.             CAUTION
  604.                  Not using this variable, or specifying an illegal value
  605.                  may result in undesirable errors during real-time
  606.                  processing, data recording and reporting. For example,
  607.                  if value specified is lower then available memory
  608.                  during processing.
  609.  
  610.             RECOMMENDED
  611.                   At least the amount of actual memory.
  612.  
  613.  
  614.  
  615.                                        OSRM2
  616.                            OS/2 Resource Monitor Facility
  617.                                     Version 1.0
  618.                         Real Time Monitor And Data Collector
  619.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  620.  
  621.  
  622.  
  623.  
  624.             [NUMDRIVES=Number Of Disk Partitions To Test]
  625.  
  626.             DESCRIPTION
  627.                  The number of hard disk partitions to track IO
  628.                  performance for.
  629.  
  630.                                 VERSION   0.1 / 1.0
  631.  
  632.                                 RANGES    1 - 5
  633.  
  634.                                 DEFAULT   1
  635.  
  636.             EXAMPLE   [NUMDRIVES=3]
  637.                  This would indicate that there are three partitions to
  638.                  be tested during the monitor session.
  639.  
  640.             NOTES
  641.                  Although specifying 1 will test a drive, the user will
  642.                  not be able to appreciate the variations to other
  643.                  partitions performance as it does differ with respect
  644.                  to data set activity, location and read/write head
  645.                  movement.
  646.  
  647.             CAUTION
  648.                  Attempting to specify more drives then are installed
  649.                  will cause the default to be used. See DESIGNATOR
  650.                  cautions as they are included.
  651.  
  652.             RECOMMENDED
  653.                  At least the number of partitions installed or the
  654.                  maximum ( 5 ) if the number of partitions exceeds the
  655.                  range.
  656.  
  657.  
  658.  
  659.                                        OSRM2
  660.                            OS/2 Resource Monitor Facility
  661.                                     Version 1.0
  662.                         Real Time Monitor And Data Collector
  663.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  664.  
  665.  
  666.  
  667.  
  668.             [DESIGNATOR=Partition List]
  669.  
  670.             DESCRIPTION
  671.                  The list of disk drive partition designators that will
  672.                  be IO tested.
  673.  
  674.                                 VERSION    0.1 / 1.0
  675.  
  676.                                 RANGES     Combinations of C - Z
  677.  
  678.                                 DEFAULT    C
  679.  
  680.             EXAMPLE    [DESIGNATOR=C D F]
  681.                  Would indicate that drives C, D and F would be tested
  682.                  at the TIMEDRIVES interval.
  683.  
  684.             NOTES
  685.                  The reason for excluding the floppy drives is due to
  686.                  the inherent delay associated with removable media. See
  687.                  NUMDRIVES notes if more then 1 partition in system.
  688.  
  689.             CAUTION
  690.                  Specifying an invalid designator will cause the default
  691.                  to be used. See NUMDRIVES caution as they are included.
  692.  
  693.             RECOMMENDED
  694.                  Valid drive for number specified in NUMDRIVES
  695.                  parameter.
  696.  
  697.  
  698.  
  699.                                        OSRM2
  700.                            OS/2 Resource Monitor Facility
  701.                                     Version 1.0
  702.                         Real Time Monitor And Data Collector
  703.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  704.  
  705.  
  706.  
  707.  
  708.             [TIMEDRIVES=IO Test Time In Seconds]
  709.  
  710.             DESCRIPTION
  711.                  The time in seconds that spaces the IO testing period.
  712.                  This value must be rounded to the nearest second.
  713.  
  714.                                 VERSIONS  0.1 / 1.0
  715.  
  716.                                 RANGES    1 - 15
  717.  
  718.                                 DEFAULT   5
  719.  
  720.             EXAMPLE   [TIMEDRIVES=5]
  721.                  This would cause the real time monitor to test the disk
  722.                  drive IO rate approximate every five seconds. If using
  723.                  the designator options in the DESIGNATOR example drive
  724.                  C would be tested first then 5 seconds later drive D
  725.                  would be tested, etc..
  726.  
  727.             NOTES
  728.                  A small enough value will insure that an accurate
  729.                  picture of disk drive performance is being captured.
  730.  
  731.             CAUTION
  732.                  To small a value will degradate the performance of
  733.                  other applications IO activity.
  734.  
  735.             RECOMMENDED
  736.                  4 - 6 Seconds depending on the number of drives being
  737.                  tested. Version 1.0 users please reference the OPTIONIO
  738.                  parameter notes.
  739.  
  740.  
  741.  
  742.                                        OSRM2
  743.                            OS/2 Resource Monitor Facility
  744.                                     Version 1.0
  745.                         Real Time Monitor And Data Collector
  746.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  747.  
  748.  
  749.  
  750.  
  751.             OPTIONIO=Options for TIMEDRIVES testing]
  752.  
  753.             DESCRIPTION
  754.                  This option allows the user to specify that the disk
  755.                  drives selected with the DESIGNATOR will be test each
  756.                  during a TIMEDRIVES interval ( VALUE = 1 ) or that all
  757.                  drives will be tested at once during the TIMEDRIVES
  758.                  interval.
  759.  
  760.                                 VERSIONS  1.0
  761.  
  762.                                 RANGES    0 - 2
  763.  
  764.                                 DEFAULT   1
  765.  
  766.             EXAMPLE   [OPTIONIO=2]
  767.                  Using all the above disk drive IO testing options, this
  768.                  would cause drives C, D and F to be tested at one time
  769.                  every five seconds. Whereas using a value of 1 would
  770.                  cause the drive testing to rotate and only one drive at
  771.                  a time tested every five seconds.
  772.  
  773.             NOTES
  774.                  Keep in mind that if a low TIMEDRIVES value is used in
  775.                  combination with a large NUMDRIVES value and using a
  776.                  value of 2 for the OPTIONIO parameter may cause
  777.                  degradation to system performance.
  778.  
  779.             CAUTION
  780.                  None other then performance issues.
  781.  
  782.             RECOMMENDED
  783.                  1 with many drives and small TIMEDRIVES value or 2 with
  784.                  less then 3 drives and a minimum 5 second TIMEDRIVES
  785.                  value.
  786.  
  787.  
  788.  
  789.                                        OSRM2
  790.                            OS/2 Resource Monitor Facility
  791.                                     Version 1.0
  792.                         Real Time Monitor And Data Collector
  793.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  794.  
  795.  
  796.  
  797.  
  798.             [COLLECTORINTV=Collector Sampling Interval]
  799.  
  800.             DESCRIPTION
  801.                  This option allows the user to specify a sampling
  802.                  interval, in minutes, for collecting performance
  803.                  statistics from the real-time monitor.
  804.  
  805.                                 VERSIONS  1.0
  806.  
  807.                                 RANGES    1 - 15 minutes.
  808.  
  809.                                 DEFAULTS  1 minute
  810.  
  811.             EXAMPLE   [COLLECTORINTV=5]
  812.                  This would cause the collector to collect the real-time
  813.                  monitor variables approximate once every five ( 5 )
  814.                  minutes.
  815.  
  816.             NOTES
  817.                  To large a value will cause peaks of performance
  818.                  indicators to be averaged out, this would give
  819.                  misleadingly low percentages of resource consumption.
  820.                  The real-time monitor averages out during each of it's
  821.                  monitor passes that while being accurate will
  822.                  eventually smooth out over times of inactivity.
  823.  
  824.             RECOMMENDED
  825.                  If activity is in bursts set this value low, if the
  826.                  system sustains constant activity this value may be
  827.                  increased but should not exceed 5 to 10 minutes.
  828.  
  829.  
  830.  
  831.                                        OSRM2
  832.                            OS/2 Resource Monitor Facility
  833.                                     Version 1.0
  834.                         Real Time Monitor And Data Collector
  835.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  836.  
  837.  
  838.  
  839.  
  840.             [SUMMARY=Time to gather collector records to file]
  841.  
  842.             DESCRIPTION
  843.                  The summary value is used collect and summarize the
  844.                  COLLECTORINTV record and write the record to disk. A
  845.                  time and date stamp are appended to each record before
  846.                  being written to disk.
  847.  
  848.                                 VERSIONS  1.0
  849.  
  850.                                 RANGES    15 to 60 minutes
  851.  
  852.                                 DEFAULT   15 minutes.
  853.  
  854.             EXAMPLE   [SUMMARY=15]
  855.                  This would cause a summary record to be recorded to
  856.                  disk every fifteen minutes during the session.
  857.  
  858.             NOTES
  859.                  The more numerous the summary records the more accurate
  860.                  the analysis.
  861.  
  862.             RECOMMENDED
  863.                  Same considerations as COLLECTINTV.
  864.  
  865.  
  866.  
  867.                                        OSRM2
  868.                            OS/2 Resource Monitor Facility
  869.                                     Version 1.0
  870.                         Real Time Monitor And Data Collector
  871.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  872.  
  873.  
  874.  
  875.  
  876.             [UES=Flag indicating user exit requested]
  877.  
  878.             DESCRIPTION
  879.                  This flag is for indicating that a User Exit Support
  880.                  DLL is requesting to be called after the summary record
  881.                  is written.
  882.  
  883.                                 VERSIONS  1.0
  884.  
  885.                                 RANGES    Y or N
  886.  
  887.                                 DEFAULT   N
  888.  
  889.             EXAMPLE   [UES=Y]
  890.                  Indicates that the user is requesting to load a UES
  891.                  routine.
  892.  
  893.             NOTES
  894.                  See UES Technical Reference.
  895.  
  896.             RECOMMENDED
  897.                  Highly!
  898.  
  899.  
  900.  
  901.                                        OSRM2
  902.                            OS/2 Resource Monitor Facility
  903.                                     Version 1.0
  904.                         Real Time Monitor And Data Collector
  905.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  906.  
  907.  
  908.  
  909.  
  910.             [MODNAME=Name of UES DLL file]
  911.  
  912.             DESCRIPTION
  913.                  This parameter designates the 1 to 8 character DLL file
  914.                  name.
  915.  
  916.                                 VERSIONS  1.0
  917.  
  918.                                 RANGES    Only 1 UES module in Real Time
  919.                                 Monitor.
  920.  
  921.                                 DEFAULT   No UES module loaded
  922.  
  923.             EXAMPLE   [MODNAME=MYUES001
  924.                  This would indicate that the User Exit Support
  925.                  procedures are in a DLL called MYUES001.DLL.
  926.  
  927.             NOTES
  928.                  See UES Technical Reference
  929.  
  930.  
  931.  
  932.                                        OSRM2
  933.                            OS/2 Resource Monitor Facility
  934.                                     Version 1.0
  935.                         Real Time Monitor And Data Collector
  936.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  937.  
  938.  
  939.  
  940.  
  941.             [PROCNAME=Name of UES procedure to call]
  942.  
  943.             DESCRIPTION
  944.                  This parameter designates the UES procedure to call
  945.                  from the MODNAME DLL file.
  946.  
  947.                                 VERSIONS  1.0
  948.  
  949.                                 RANGES    Only 1 procname allowable
  950.  
  951.                                 DEFAULT   No procedure called
  952.  
  953.             EXAMPLE   [PROCNAME=ExtractDiskTiming]
  954.                  This would cause OSRM2 to call the ExtractDiskTiming
  955.                  procedure from the specified MODNAME module.
  956.  
  957.             NOTES
  958.                  The procedure called has unlimited possibilities and
  959.                  may call other routines that are imported from other
  960.                  libraries. This basically serves as a gateway for
  961.                  object passing. See UES Technical Reference.
  962.  
  963.             CAUTION
  964.                  The called procedure should not exact a large overhead
  965.                  as the real-time monitor will wait until the call is
  966.                  returned from.
  967.  
  968.             RECOMMENDED
  969.                  See UES Technical Reference.
  970.  
  971.  
  972.  
  973.                                        OSRM2
  974.                            OS/2 Resource Monitor Facility
  975.                                     Version 1.0
  976.                         Real Time Monitor And Data Collector
  977.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  978.  
  979.  
  980.  
  981.  
  982.             [FILESPATH=Path to data file storage]
  983.  
  984.             DESCRIPTION
  985.                  This option specifies the drive \path (up to 64
  986.                  characters) specification for storing data summary
  987.                  records.
  988.  
  989.                                 VERSIONS  1.0
  990.  
  991.                                 RANGES    See description.
  992.  
  993.                                 DEFAULT   Current directory
  994.  
  995.             EXAMPLE   [FILESPATH=C \OSRM2\HISTRECS]
  996.  
  997.             NOTES
  998.                  For organizational purposes this should remain separate
  999.                  from other application data and program files.
  1000.  
  1001.             CAUTION
  1002.                  Specify a valid path or will default to current
  1003.                  directory.
  1004.  
  1005.             RECOMMENDED
  1006.                  See notes.
  1007.  
  1008.  
  1009.  
  1010.                                        OSRM2
  1011.                            OS/2 Resource Monitor Facility
  1012.                                     Version 1.0
  1013.                         Real Time Monitor And Data Collector
  1014.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1015.  
  1016.  
  1017.  
  1018.  
  1019.             [END]
  1020.  
  1021.             DESCRIPTION
  1022.                  This indicates that there are no more parameters to be
  1023.                  read from the INI file.
  1024.  
  1025.                                 VERSIONS  0.1 / 1.0
  1026.  
  1027.                                 RANGES    N/A
  1028.  
  1029.                                 DEFAULT   N/A
  1030.  
  1031.             EXAMPLE   [FILESPATH=C \OSRM2\HISTRECS]
  1032.                                      [END]
  1033.                                      [UES=Y]
  1034.                  This indicates that there the end statement will cause
  1035.                  the remainder of the INI file to be disregarded.
  1036.  
  1037.             NOTES
  1038.                  N/A
  1039.  
  1040.             CAUTION
  1041.                  Make sure at least the REAL parameter is placed before
  1042.                  the END statement.
  1043.  
  1044.             RECOMMENDED
  1045.                   Have one to reduce INI parsing overhead.
  1046.  
  1047.  
  1048.  
  1049.                                        OSRM2
  1050.                            OS/2 Resource Monitor Facility
  1051.                                     Version 1.0
  1052.                         Real Time Monitor And Data Collector
  1053.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1054.  
  1055.  
  1056.                  Starting OSRM2
  1057.  
  1058.  
  1059.  
  1060.             Before starting the OSRM2 real time monitor, please insure
  1061.             that you have:
  1062.  
  1063.                  *    Installed the system files in their proper places,
  1064.                       refer to Installation on Page 7.
  1065.  
  1066.                  *    Prepared your OSRM2.INI file with the proper                 *    Prepared your OSRM2.INI file with the proper
  1067.                       parameter settings for your monitor session, refer
  1068.                       to Initialization Parameter File section starting
  1069.                       on Page 8.
  1070.  
  1071.             Before starting OSRM2, it is recommended to insure that it
  1072.             is the first applications started after a boot up of OS/2.
  1073.  
  1074.                                 To Start OSRM2 From
  1075.  
  1076.                                 OS/2 Version 1.0
  1077.  
  1078.             From the program selector choose the program name you have
  1079.             assigned to OSRM2 and press enter. If you have not installed
  1080.             OSRM2 into the program selector, start a OS/2 session and
  1081.             switch to the directory where you have installed OSRM2 and
  1082.             at the command prompt enter
  1083.  
  1084.             [C:\OSRM2]osrm2 [ then press the enter key ]
  1085.  
  1086.                                 OS/2 Version 1.1
  1087.  
  1088.             From the Start Program dialog box, open the group where you
  1089.             have installed the OSRM2 program entry and double click on
  1090.             the application name you have assigned OSRM2. If you have
  1091.             not installed OSRM2 into the Start Program dialog box, start
  1092.             a windowed OS/2 screen session and switch to the directory
  1093.             where you have installed OSRM2 and at the command prompt
  1094.             enter
  1095.  
  1096.             [C:\OSRM2]osrm2 [ then press the enter key ]
  1097.  
  1098.             You will immediately see the real-time monitor screen jump
  1099.             to life as it begins measuring system activity.
  1100.  
  1101.  
  1102.  
  1103.                                        OSRM2
  1104.                            OS/2 Resource Monitor Facility
  1105.                                     Version 1.0
  1106.                         Real Time Monitor And Data Collector
  1107.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1108.  
  1109.  
  1110.                  The OSRM2 Real Time Display
  1111.  
  1112.  
  1113.  
  1114.             When OSRM2 is started, the initialization file is read and
  1115.             processed and then the system activity display ( SAD ) is
  1116.             created.
  1117.  
  1118.             There are 3 system indicators displayed; the CPU utilization
  1119.             percent, the Real Memory percent allocated, and the number
  1120.             of Disk IO's attainable per second.
  1121.  
  1122.             Following are the abbreviations for the resource indicators
  1123.             in the SAD:
  1124.  
  1125.                                 CPU   Cpu Percent Utilization
  1126.  
  1127.                                 MEM   Percent Memory Allocated
  1128.  
  1129.                                 IOs   Attainable IO Per Second.
  1130.  
  1131.             As you watch the display, you will see the bars that
  1132.             indicate resource utilization, or work, change as the number
  1133.             of applications and the work they are performing consume
  1134.             these resources.
  1135.  
  1136.             If OSRM2 is the only application started then you can see
  1137.             the effect of all three indicators change by opening an OS/2
  1138.             command prompt window and listing a long file with the type
  1139.             command.
  1140.  
  1141.             First the memory utilization will increase as storage is
  1142.             allocated to open the command environment.
  1143.  
  1144.             The CPU will flash across the utilization range as windows
  1145.             are activated and the window is used to process work.
  1146.  
  1147.             The attainable disk IO will change if you create work that
  1148.             requires a disk access.
  1149.  
  1150.             If you make the OSRM2 window the active window, note that
  1151.             the activity of the CPU will decrease, this is because the
  1152.             window has input focus, which prioritizes itself, and OSRM2
  1153.             does not consume much overhead in it's timing or calculation
  1154.             threads.
  1155.  
  1156.  
  1157.  
  1158.                                        OSRM2
  1159.                            OS/2 Resource Monitor Facility
  1160.                                     Version 1.0
  1161.                         Real Time Monitor And Data Collector
  1162.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1163.  
  1164.  
  1165.                  Function Keys
  1166.  
  1167.             Along with the SAD are two ( 2 ) control functions as
  1168.             described below:
  1169.  
  1170.             F1)  TOGGLE OSRM2 DISPLAY UPDATES: Pressing the F1 key will
  1171.                  toggle the updating of the SAD. This will increase IO
  1172.                  testing as the overhead for constantly updating the
  1173.                  screen display is used in the IO timing visit loop. If
  1174.                  you find that you often turn off screen updating you
  1175.                  may wish to lengthen the delay in the TIMEDRIVES
  1176.                  parameter.
  1177.  
  1178.             F2)  TOGGLE DISK TEST: Pressing the F2 key will toggle the
  1179.                  disk test on or off. If disk test is toggled off only
  1180.                  the memory and CPU tests occur and a flag is written to
  1181.                  the collector structure indicating possible invalid
  1182.                  disk timing data.
  1183.  
  1184.             F5)  EXIT OSRM2: Pressing the F5 key will exit the real-time
  1185.                  monitor in all versions, and in Versions 1.0 and above
  1186.                  this will also shutdown the data collector and summary
  1187.                  execution threads and processes respectfully.
  1188.  
  1189.  
  1190.  
  1191.                                        OSRM2
  1192.                            OS/2 Resource Monitor Facility
  1193.                                     Version 1.0
  1194.                         Real Time Monitor And Data Collector
  1195.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1196.  
  1197.  
  1198.                  ENDING OSRM2
  1199.  
  1200.  
  1201.  
  1202.             As mentioned in the above, pressing the F5 key will exit
  1203.             OSRM2 from the system and shutdown all associated processes.
  1204.  
  1205.  
  1206.  
  1207.                                        OSRM2
  1208.                            OS/2 Resource Monitor Facility
  1209.                                     Version 1.0
  1210.                         Real Time Monitor And Data Collector
  1211.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1212.  
  1213.  
  1214.                  UPGRADE  PROCEDURES AND SUPPORT
  1215.  
  1216.  
  1217.  
  1218.             Current OSRM2 Version 1.0 Users ( Unregistered )
  1219.  
  1220.             EITHER:
  1221.                  Send in the included registration form, making sure to
  1222.                  include all information as well as payment by check or
  1223.                  money order for your registration payment.
  1224.  
  1225.             OR:
  1226.                  Dial in to HH-InfoNet BBS (203) 738-0306 or (203) 738-
  1227.                  1046 and fill out the registration script on-line.
  1228.  
  1229.             PLEASE SEE THE REGISTRATION FORM CONCERNING THE COST
  1230.             SCHEDULES AND SITE LICENSE PLANS.
  1231.  
  1232.  
  1233.  
  1234.                                        OSRM2
  1235.                            OS/2 Resource Monitor Facility
  1236.                                     Version 1.0
  1237.                         Real Time Monitor And Data Collector
  1238.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1239.  
  1240.  
  1241.                  SUPPORT
  1242.  
  1243.             C.O.L. Consulting, LTD. can be reached on-line from:
  1244.  
  1245.                  Compuserve:COMPUSERVE ID [72261,2700]
  1246.  
  1247.                  HH-InfoNEt:  (203) 738-0306 / (203) 738-1046 send
  1248.                  messages to Frank Castellucci.
  1249.  
  1250.                  Brentwood:  (914) 835-1315 send message to Frank
  1251.                  Castellucci.
  1252.  
  1253.             When leaving a message, please include registration number
  1254.             as well as hardware description and nature of problem.
  1255.  
  1256.  
  1257.  
  1258.                                        OSRM2
  1259.                            OS/2 Resource Monitor Facility
  1260.                                     Version 1.0
  1261.                         Real Time Monitor And Data Collector
  1262.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1263.  
  1264.  
  1265.                  Registration Payment Schedule
  1266.  
  1267.                                 Single User Registrations
  1268.  
  1269.             Below are the single user registration schedules to follow
  1270.             when registering a copy of OSRM2:
  1271.  
  1272.              Single User        $70.00
  1273.  
  1274.             Upgrade to 1.1      $100.00
  1275.  
  1276.             The upgrade to 1.1 fee includes Version 1.0 to be mailed
  1277.             immediately and Version 1.1 will ship automatically upon
  1278.             release.
  1279.  
  1280.                                 Corporate Discounts Version 1.0 / 1.1
  1281.  
  1282.             1 - 20 Users         $70.00 per user
  1283.  
  1284.             Upgrade to 1.1      $100.00 per user
  1285.  
  1286.  
  1287.  
  1288.             21 - 50             $59.50 per user
  1289.  
  1290.             Upgrade to 1.1      $85.00 per user
  1291.  
  1292.             If number of users is greater then 50 you qualify for a site
  1293.             license:
  1294.  
  1295.             Site License   $2400.00 flat rate.
  1296.  
  1297.             Upgrade to 1.1 $3300.00 flat rate.
  1298.  
  1299.             Upgrade to 1.1 fees will ship Version 1.0 immediately and
  1300.             Version 1.1 will ship automatically when released.
  1301.  
  1302.             When registering include a work or daytime phone number as
  1303.             well as the OS/2 version currently in use and the size
  1304.             floppy diskette ( 5 1/4 or 3 1/2 ).
  1305.  
  1306.  
  1307.  
  1308.                                        OSRM2
  1309.                            OS/2 Resource Monitor Facility
  1310.                                     Version 1.0
  1311.                         Real Time Monitor And Data Collector
  1312.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1313.  
  1314.  
  1315.                  Registration Form  Template
  1316.  
  1317.                  Single user registration:
  1318.  
  1319.             Date __ / __ / __
  1320.  
  1321.             Copys to Register              @ $70.00 each  _____
  1322.  
  1323.                                      Total Enclosed  $ _____.__
  1324.  
  1325.             USER INFORMATION
  1326.  
  1327.             Name:     _________________________________
  1328.  
  1329.             Address:  _________________________________
  1330.  
  1331.                       _________________________________
  1332.  
  1333.             City:     _________________________________
  1334.  
  1335.             State:    __   Zip: __________
  1336.  
  1337.             Phone:    ( ___ ) ___ - ____
  1338.  
  1339.             OS/2 1.__      Floppy Size    ____
  1340.  
  1341.             Media on 5 1/4 is 360kb density    Media on 3 1/2 is 720kb
  1342.             density
  1343.  
  1344.             Please make all registration payments by check or money
  1345.             orders in United States Dollars to:
  1346.  
  1347.                       C.O.L. Consulting, LTD.
  1348.                       RR1 265 Overlook Way
  1349.                       Purdys NY, 10578
  1350.  
  1351.  
  1352.  
  1353.                                        OSRM2
  1354.                            OS/2 Resource Monitor Facility
  1355.                                     Version 1.0
  1356.                         Real Time Monitor And Data Collector
  1357.                      (C) Copyright 1989, C.O.L. Consulting LTD.
  1358.  
  1359.  
  1360.                  Corporate registration:
  1361.  
  1362.             Date __ / __ / __
  1363.  
  1364.             Number of Users to Register   ( see schedule )    _____
  1365.  
  1366.                                      Total Enclosed      $ _____.__
  1367.  
  1368.             COMPANY INFORMATION
  1369.  
  1370.             Contact:  _________________________________
  1371.  
  1372.             Company
  1373.                  Name:_________________________________
  1374.  
  1375.             Address:  _________________________________
  1376.  
  1377.                       _________________________________
  1378.  
  1379.             City:     _________________________________
  1380.  
  1381.             State:    __   Zip: __________
  1382.  
  1383.             Phone:    ( ___ ) ___ - ____
  1384.  
  1385.             OS/2      1.__      Floppy Size    ____
  1386.  
  1387.             Media on 5 1/4 is 360kb density    Media on 3 1/2 is 720kb
  1388.             density
  1389.  
  1390.             Please make all registration payments by check or money
  1391.             orders in United States Dollars to:
  1392.  
  1393.                       C.O.L. Consulting, LTD.
  1394.                       RR1 265 Overlook Way
  1395.                       Purdys NY, 10578
  1396.