OS/2 Shareware BBS: SysTools/SysTools.zip/spm2.zip/SPMUI.HLP

OS/2 Help File | 1993-11-23 | 31KB | 1,084 lines

ΓòÉΓòÉΓòÉ 1. Help Panel Not Found ΓòÉΓòÉΓòÉ

The requested help panel was not found.


ΓòÉΓòÉΓòÉ 2. About ΓòÉΓòÉΓòÉ

This choice produces a screen that offers the title and version number of the
program, plus any available icon that will represent the program when it is
minimized, plus copyright information.  The screen will have a pushbutton at
the bottom to enable the user to remove it.


ΓòÉΓòÉΓòÉ 3. Cancel ΓòÉΓòÉΓòÉ

The Cancel pushbutton removes a window without applying any changes made in
that window.


ΓòÉΓòÉΓòÉ 4. Change ΓòÉΓòÉΓòÉ

This choice will present the selected object, in its current state, and allow
the user to change certain of the parameters or other fields associated with
the object.


ΓòÉΓòÉΓòÉ 5. Create ΓòÉΓòÉΓòÉ

This choice will allow the user to create a new instance of the object type
selected.


ΓòÉΓòÉΓòÉ 6. Delete ΓòÉΓòÉΓòÉ

Delete removes a selected object.  The space it occupied is usually filled by
the remaining object or objects in the window.


ΓòÉΓòÉΓòÉ 7. Display ΓòÉΓòÉΓòÉ

This choice presents the selected object for viewing only, with no changes
allowed.


ΓòÉΓòÉΓòÉ 8. Extended help ΓòÉΓòÉΓòÉ

The Extended Help choice offers more detailed assistance on the objects and
actions in the current context.


ΓòÉΓòÉΓòÉ 9. File ΓòÉΓòÉΓòÉ

This menu bar choice provides access to other choices that enable a user to
work with objects or with data storage devices, such as disks or diskettes.


ΓòÉΓòÉΓòÉ 10. Help ΓòÉΓòÉΓòÉ

This choice gives a user access to helpful information about objects, choices,
tasks, and products.


ΓòÉΓòÉΓòÉ 11. Help Index ΓòÉΓòÉΓòÉ

This choice on the Help menu presents an alphabetic listing of help topics for
an object.


ΓòÉΓòÉΓòÉ 12. Help for help ΓòÉΓòÉΓòÉ

Help for help provides detailed information on the kinds of help available and
how to use them.


ΓòÉΓòÉΓòÉ 13. Keys Help ΓòÉΓòÉΓòÉ

This choice presents a listing of all the key assignments for an object or a
product.


ΓòÉΓòÉΓòÉ 14. More ΓòÉΓòÉΓòÉ

The word More indicates that there is additional information not currently
viewable on the screen.  The screen must be scrolled in order to bring this
information into view.


ΓòÉΓòÉΓòÉ 15. New ΓòÉΓòÉΓòÉ

This choice creates another object from an existing object.  The new object
will appear in the existing window.


ΓòÉΓòÉΓòÉ 16. No ΓòÉΓòÉΓòÉ

Do not perform the act described in the panel.


ΓòÉΓòÉΓòÉ 17. Ok ΓòÉΓòÉΓòÉ

The OK pushbutton accepts the information in a window and closes it. If the
window contains changed information, those changes are applied before the
window is closed.


ΓòÉΓòÉΓòÉ 18. Open ΓòÉΓòÉΓòÉ

The Open choice opens a new window on an object or gives a user access to other
choices that open a new window on an object.


ΓòÉΓòÉΓòÉ 19. Save ΓòÉΓòÉΓòÉ

Save stores an object onto a storage device, such as a disk or diskette.


ΓòÉΓòÉΓòÉ 20. Save and Repeat ΓòÉΓòÉΓòÉ

Saves the current operation and places the user at the beginning point to
perform the operation again.


ΓòÉΓòÉΓòÉ 21. Save as ΓòÉΓòÉΓòÉ

Save as is a choice that creates a new object from an existing object and
leaves the existing object as it was.


ΓòÉΓòÉΓòÉ 22. Scroll ΓòÉΓòÉΓòÉ

Moves the viewable information in a window such that information currently not
in view comes into view.


ΓòÉΓòÉΓòÉ 23. Stop ΓòÉΓòÉΓòÉ

Stop the current processing.


ΓòÉΓòÉΓòÉ 24. Tutorial ΓòÉΓòÉΓòÉ

This choice gives a user access to online educational information.


ΓòÉΓòÉΓòÉ 25. Yes ΓòÉΓòÉΓòÉ

Perform the act described in the panel.


ΓòÉΓòÉΓòÉ 26. Information line ΓòÉΓòÉΓòÉ

This choice gives a user the ability to hide or display the information line
control.  The information line control displays additional information about
the field that has the cursor emphasis.


ΓòÉΓòÉΓòÉ 27. Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a copy request. The results of a copy to
an entry field will be as follows:

 o Any selected text in the control will be deleted.

 o The text being dropped will be inserted into the control at the cursor
   position.

 o The cursor will be placed following the dropped text.

 o The source of the dropped text will not be changed.


ΓòÉΓòÉΓòÉ 28. Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a move request. The results of a move to
an entry field will be as follows:

 o Any selected text in the control will be deleted.

 o The text being dropped will be inserted into the control at the cursor
   position.

 o The cursor will be placed following the dropped text.

 o The dropped text will be deleted from the source.


ΓòÉΓòÉΓòÉ 29. Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a copy request. The results of a copy to
a list will be as follows:

 o If the list is a sorted list, the dropped text will be inserted into the
   list in the sorted order.

 o If the list is an unsorted list, the dropped text will be inserted into the
   list following the list item the mouse is over when the drop is made.

 o The source of the dropped text will not be changed.


ΓòÉΓòÉΓòÉ 30. Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation was a move request. The results of a move to
a list will be as follows:

 o If the list is a sorted list, the dropped text will be inserted into the
   list in the sorted order.

 o If the list is an unsorted list, the dropped text will be inserted into the
   list following the list item the mouse is over when the drop is made.

 o The dropped text will be deleted from the source.


ΓòÉΓòÉΓòÉ 31. Direct Manipulation ΓòÉΓòÉΓòÉ

The direct manipulation operation requested was invalid. Pressing and holding a
key when the drop is made augments the operation as follows:

 o No key - defaults to a copy operation.

 o Ctrl key - copy operation.

 o Shift key - move operation for OS/2 2.0, invalid for OS/2 1.X.

 o Alt key - move operation for OS/2 1.X, invalid for OS/2 2.0.

 o Two or more keys - invalid operation.


ΓòÉΓòÉΓòÉ 32. res=498.Continue ΓòÉΓòÉΓòÉ

This choice will resume the process that has been interrupted.


ΓòÉΓòÉΓòÉ 33. res=503.Reset ΓòÉΓòÉΓòÉ

This choice returns the values of changed settings choices to their last saved
state.


ΓòÉΓòÉΓòÉ 34. res=504.Retry ΓòÉΓòÉΓòÉ

This choice tries a process again that has been interrupted because of a
situation that the user can attempt to correct.


ΓòÉΓòÉΓòÉ 35. res=505.Undo ΓòÉΓòÉΓòÉ

This choice returns the settings to their state prior to the last action.


ΓòÉΓòÉΓòÉ 36. res=507.Close ΓòÉΓòÉΓòÉ

This choice will remove the window without affecting the current process.
Close does not change the information in the window.


ΓòÉΓòÉΓòÉ 37. res=508.Resume ΓòÉΓòÉΓòÉ

This choice continues a process that was paused.


ΓòÉΓòÉΓòÉ 38. res=509.Apply ΓòÉΓòÉΓòÉ

This choice applies changes mad eto settings choices without removing the
window in which the changes were made.


ΓòÉΓòÉΓòÉ 39. res=510.Pause ΓòÉΓòÉΓòÉ

This choice temporarily suspends a process without ending the process.


ΓòÉΓòÉΓòÉ 40. Report Is Running ΓòÉΓòÉΓòÉ

The report is being created.  You will be notified when it completes and if it
was successful. At that time select Done or the system menu option Close to
dismiss the window.

If you wish to interrupt the report processing then select Stop or the system
menu option Close prior to completion. The report that you were creating will
be incomplete if you do this.


ΓòÉΓòÉΓòÉ 41. Monitor Session Description: xxxxxxxx.LOG ΓòÉΓòÉΓòÉ

Use this window to define a new monitor session description for either graphing
or recording or both.

In the Comment: entry field, type a small amount of identifying information.

To specify workstations to be included, either:

 o Type the name of a single workstation in the entry field and press Enter.
   Repeat until all desired workstations are entered.

   or

 o Highlight entries in the Available: list box. Select Add >>, to copy the
   highlighted entries to the Selected: list box.

 Notes:

 o A workstation can be monitored by only one monitor session description at a
   time.
 o If you want to monitor a local workstation on which NETBIOS is installed,
   specify the computer name for the workstation, rather than specifying LOCAL.
 o If you are working at a stand-alone workstation on which no LAN services are
   installed, type LOCAL in the workstation entry field, or select LOCAL from
   the Available: list box.

 Select Query to display a list of all workstations enabled for performance
 monitoring on the network.

 To remove an entry from the Available: list box, highlight that entry, and
 then select << Delete.

 Use the Select all check box to highlight all entries in both list boxes.

 To specify resources to be monitored select Preferences and then Resources.

 To specify data collection and recording frequencies select Preferences and
 then Time Periods.

 To save a new monitor session description file select File and then Save as.


ΓòÉΓòÉΓòÉ 42. File ΓòÉΓòÉΓòÉ

Select File to save a new monitor session description file.


ΓòÉΓòÉΓòÉ 43. Save ΓòÉΓòÉΓòÉ

Select Save to save a monitor session description file.


ΓòÉΓòÉΓòÉ 44. Save as ΓòÉΓòÉΓòÉ

Select Save as to save a new monitor session description file.


ΓòÉΓòÉΓòÉ 45. Preferences ΓòÉΓòÉΓòÉ

Select Preferences to specify resources or data collection and recording
frequencies.


ΓòÉΓòÉΓòÉ 46. Resources ΓòÉΓòÉΓòÉ

Select Resources to define the facilites of the computer system for which you
want to collect data.  Some examples of resources are:  CPU, disk, memory, and
input/output devices.


ΓòÉΓòÉΓòÉ 47. Time periods ΓòÉΓòÉΓòÉ

Select Time periods to specify data collection and recording frequency.


ΓòÉΓòÉΓòÉ 48. Monitor Session Resources ΓòÉΓòÉΓòÉ

  1. Highlight entries in the Available: list box, and then select Add >> to
     copy those choices to the Selected: list box. CPU, Disk 01, and Memory
     appear as default selections.

     a. To have the data graphed, the Selected: list box must contain at least
        one of the default selections.
     b. Before making a selection, you may want to expand the entries with
        ellipses (...) in the Available: list box by checking the Expand
        available resources box.  Selecting an unexpanded entry causes all
        instances of that resource to be selected. For example, selecting
        Disk... actually selects Disk 01 through Disk 24.

  2. Select OK to save your selections and return to the Monitor Session
     Description window.

 Select Collect application/process/thread level data to collect and record
 detailed data if required.  If this box is not selected, data is collected for
 the workstation level only.

  CAUTION:
 This option can be very intrusive on the system, both in terms of CPU cycles
 and the large amount of data stored in the collection files. Use this option
 only when very detailed reports are required for intensive problem solving or
 for debugging applications.


ΓòÉΓòÉΓòÉ 49. Monitor Session Time Periods ΓòÉΓòÉΓòÉ

Collection frequency

Specify how often the data should be collected in hours, minutes, and seconds.
For example, to collect data every 2 hours, 15 minutes, 3 seconds, specify 02
15 03.  Either type this information in the respective fields or use the spin
buttons to increase or decrease each field value.  The minimum collection
frequency is once per second.  The default frequency is to collect data every
10 seconds.

Use the Multiplier: field to specify the recording frequency as a multiple of
the collection frequency.  Either type this information in the field or use the
spin button to increase or decrease the field value.  The resultant recording
frequency will be displayed in the Recording frequency: fields.

The working set period specifies the time interval SPM/2 uses each time it
calculates the RAM working set.  The time interval is bounded at the end by the
current time, and at the beginning by the current time minus the working set
period.  The default is 60 seconds.

Select OK to save your selections and return to the Monitor Session Description
window.


ΓòÉΓòÉΓòÉ 50. SPM/2 Control ΓòÉΓòÉΓòÉ

This is the control window for SPM/2. To access any feature of the program
select an item from the menu bar located directly beneath the title.

The Active monitor box shows the active monitor sessions, the workstations from
which data is being collected, and your choice of either workstation status or
monitor session status.

Comment displays the comment line for the monitor session description (.LOG)
file currently highlighted.

You can alter the way the information in the Active monitor box is displayed by
using View on the menu bar.

Before you start graphing or recording data you should create a monitor session
description.  This description is used by SPM/2 to determine which data to
collect and store.

To create a monitor session description, select Monitor from the menu bar,
select Setup and then select New.  The Monitor Session Description panel will
display.

NOTE: Closing the SPM/2 control window does not stop real time data collection.
You must stop collection from the SPM/2 control window or from the command
line.


ΓòÉΓòÉΓòÉ 51. View ΓòÉΓòÉΓòÉ

Select View to customize the display of information in the SPM/2 Control window
and to specify the level of messages you want displayed in pop-up panels.


ΓòÉΓòÉΓòÉ 52. Sort by ΓòÉΓòÉΓòÉ

Select Sort by to display the options available for sorting information in the
Control window.


ΓòÉΓòÉΓòÉ 53. (Sort by) monitor session ΓòÉΓòÉΓòÉ

Select monitor session to alphabetically sort the monitor sessions active on
the local system.  Highlighting a monitor session displays the workstations
being monitored by that session in the workstations list box.


ΓòÉΓòÉΓòÉ 54. (Sort by) workstation ΓòÉΓòÉΓòÉ

Select workstation to alphabetically sort the workstations participating in all
monitor sessions active on the local system. Highlighting a workstation
displays the session monitoring that workstation in the Sessions: list box.


ΓòÉΓòÉΓòÉ 55. Status by ΓòÉΓòÉΓòÉ

Select Status by to show whether:

 o A monitor session is pending, graphing, or recording
 o A workstation is on-line or off-line.


ΓòÉΓòÉΓòÉ 56. (Status by) Monitor Session ΓòÉΓòÉΓòÉ

Select monitor session to display the current status of monitor sessions listed
in the Sessions list box. Possible status types include:

 o Pending - shown when not all workstations are running.  You can switch to
   status by workstations to show which are not running.
 o Graphing
 o Recording
 o Graph/Record


ΓòÉΓòÉΓòÉ 57. (Status by) Workstation ΓòÉΓòÉΓòÉ

Select workstation to display the current status of the workstations listed in
the Workstations list box.

 o On-line
 o Off-line


ΓòÉΓòÉΓòÉ 58. Full Path ΓòÉΓòÉΓòÉ

Select Full path to display the entire directory path and filename of the
monitor sessions listed in the Sessions list.


ΓòÉΓòÉΓòÉ 59. Logged Messages ΓòÉΓòÉΓòÉ

Select Logged messages to control the level of messages displayed in pop-up
panels.

 o If you deselect all the options, only fatal (nonrecoverable) errors are
   displayed on the screen.
 o This function is dependent on the logged message level specified in the SET
   SPMSNAP statement in the CONFIG.SYS file.
 o If the control window is not active, messages are still logged, but are not
   displayed, with the exception of fatal (nonrecoverable) errors, which are
   always displayed.  Fatal errors are displayed in a full-screen format if the
   control window is not active.


ΓòÉΓòÉΓòÉ 60. Warning ΓòÉΓòÉΓòÉ

Select Warning to display warning and error messages.


ΓòÉΓòÉΓòÉ 61. Error ΓòÉΓòÉΓòÉ

Select Error to display only error messages.  This is the default.


ΓòÉΓòÉΓòÉ 62. Monitor ΓòÉΓòÉΓòÉ

Select Monitor to setup or start or stop a monitor session.  A monitor session
must be setup and started in order for data to be recorded in a log or
displayed in a graph.


ΓòÉΓòÉΓòÉ 63. Setup ΓòÉΓòÉΓòÉ

Select Setup to create a new monitor session description, open an existing
monitor session description, or copy an existing monitor session description.

The monitor session description is used by SPM/2 to determine which data to
collect, which resources to collect it from and the disposition of the data,
for instance whether to display it in a graph or record it in a log.

You can create as many customized monitor session descriptions as you require
for your system.


ΓòÉΓòÉΓòÉ 64. New ΓòÉΓòÉΓòÉ

Select New to create a new monitor session description. Use this option when
you want to define a monitor session description that is completely different
from those that already exist.


ΓòÉΓòÉΓòÉ 65. Open ΓòÉΓòÉΓòÉ

Select Open to display an existing monitor session description. Use this option
when you want to check the parameters of a description or make a change to the
description.


ΓòÉΓòÉΓòÉ 66. Copy ΓòÉΓòÉΓòÉ

Select Copy to copy an existing monitor session description to a new name. Use
this option when you want to backup a monitor session description or use an
existing description as a model for another.

This option copies only the monitor session description, not the associated
data in the .LOG file.  If you want to copy the entire .LOG file use the OS/2
COPY command.


ΓòÉΓòÉΓòÉ 67. Start ΓòÉΓòÉΓòÉ

Select Start to display graphing and recording start options.


ΓòÉΓòÉΓòÉ 68. (Start) Graphing ΓòÉΓòÉΓòÉ

Select Graphing to display the window where you choose which monitor sessions
you want to use to graph live or prerecorded data.


ΓòÉΓòÉΓòÉ 69. (Start) Recording ΓòÉΓòÉΓòÉ

Select Recording to display the window where you choose which monitor session
descriptions you want to use to record data in the .LOG file.


ΓòÉΓòÉΓòÉ 70. (Start) Both ΓòÉΓòÉΓòÉ

Select Both to display the window where you choose which monitor sessions you
want to use to both Graph and Record data.


ΓòÉΓòÉΓòÉ 71. Stop ΓòÉΓòÉΓòÉ

Select Stop to stop graphing or recording data.


ΓòÉΓòÉΓòÉ 72. (Stop) Graphing ΓòÉΓòÉΓòÉ

Select Graphing to stop graphing activity for the monitor sessions you select.


ΓòÉΓòÉΓòÉ 73. (Stop) Recording ΓòÉΓòÉΓòÉ

Select Recording to stop the recording activity for the monitor sessions you
select.


ΓòÉΓòÉΓòÉ 74. (Stop) Both ΓòÉΓòÉΓòÉ

Select Both to stop both graphing and recording activity for the monitor
sessions you select.


ΓòÉΓòÉΓòÉ 75. Report ΓòÉΓòÉΓòÉ

Select Report to define a report description or to run or print a report.


ΓòÉΓòÉΓòÉ 76. Setup ΓòÉΓòÉΓòÉ

Select Setup to create a report description.  The report description defines
which resources and workstations to include in the report, the level of detail,
the time period for the data you want to see, and the format of the report.


ΓòÉΓòÉΓòÉ 77. New ΓòÉΓòÉΓòÉ

Select New to define a report description that is completely different from
those currently existing.


ΓòÉΓòÉΓòÉ 78. Open ΓòÉΓòÉΓòÉ

Select Open to check the parameters of an existing report description or change
the description.


ΓòÉΓòÉΓòÉ 79. Copy ΓòÉΓòÉΓòÉ

Select Copy to make a backup copy of a report description or to use an existing
description as a template for a new one.


ΓòÉΓòÉΓòÉ 80. Run ΓòÉΓòÉΓòÉ

Select Run to display the Run Report panel.


ΓòÉΓòÉΓòÉ 81. Print ΓòÉΓòÉΓòÉ

Select Print to display the Print Report panel.


ΓòÉΓòÉΓòÉ 82. Using help ΓòÉΓòÉΓòÉ

Press Help(F1) on any SPM/2 window or menu item to display the associated help
panel.  Helps are intended as memory joggers. Please see the online SPM/2
User's Guide and Reference, located in the SPM/2 program folder, for detailed
information about doing tasks and interpreting data.


ΓòÉΓòÉΓòÉ 83. Product Information ΓòÉΓòÉΓòÉ

Select Product information to display the SPM/2 product version number and
copyright notice.


ΓòÉΓòÉΓòÉ 84. Copy Description ΓòÉΓòÉΓòÉ

To specify the file to be copied, either:

 o Type the name of the file in the Source file: entry field.  You may precede
   the file name with the fully qualified path, or you may accept the path
   displayed in the Drive: and Directory: boxes.

   or

 o Select a drive from the Drive: box.  A list of available directories for
   that drive is displayed in the Directory: list box.  (To display
   subdirectories, double-click on the highlighted directory item.)  Select a
   directory. A list of available source files for that directory is displayed
   in the File: list box.  Select the source file you want to copy.

 To specify the target file, type the name of the file in the Target file:
 entry field.  You may precede the file name with the fully qualified path, or
 you may accept the path displayed in the Drive: and Directory: boxes.

 The action bar Copy option copies only the monitor session description, not
 the associated data in the .LOG file.  To copy the entire .LOG file, use the
 OS/2 COPY command.


ΓòÉΓòÉΓòÉ 85. Help for VIEW.EXE ΓòÉΓòÉΓòÉ

Help for message about not be able to start view.exe program.


ΓòÉΓòÉΓòÉ 86. Open Description ΓòÉΓòÉΓòÉ

Use this window to check the parameters of an existing description or make a
change to the description.

To specify the file to use; either:

 o Type the name of a single file in the Filename: entry field.

   or

 o Select a drive from the Drive: drop-down list.  A list of available
   directories for that drive is displayed in the Directory: list box.  (To
   display subdirectories, double-click on the highlighted directory item.)
   Select a directory.  A list of available monitor session description files
   for that directory is displayed in the File: list box.  Select the file you
   want.

 From the Type of file: drop-down list, select the appropriate file extension.
 Monitor session description files must have an extension of .LOG; report
 description files, an extension of .RDF.


ΓòÉΓòÉΓòÉ 87. Print Report ΓòÉΓòÉΓòÉ

 o Type the name of the file in the Filename: entry field.

 o Select a printer from the Output port drop down list.

 o Select OK to start printing the report and return to the SPM/2 control
   window.

   Note: Scroll through the Type of file: list to find the appropriate file
   extension.


ΓòÉΓòÉΓòÉ 88. Run Report ΓòÉΓòÉΓòÉ

To specify which file to use:

 o Type the name of the file in the Filename: entry field.

   or

 o Select a drive from the Drive: drop-down list. A list of available
   directories for that drive is displayed in the Directory: list box.  (To
   display subdirectories, double-click on the highlighted directory item.)
   Select a directory. A list of available report description files for that
   directory is displayed in the File: list box.  Select the file(s) you want.

 Scroll through the Type of file: list to find the appropriate file extension.


ΓòÉΓòÉΓòÉ 89. Report Tabular Format ΓòÉΓòÉΓòÉ

Workstation causes the report to be formatted with the workstation name as the
column heading.

Resource Data causes the report to be formatted with the resource data as the
column heading.

Unit causes the report to be formatted with resource data represented by unit
value (for example, bytes or number of occurrences).

Percentage causes the report to be formatted with resource data represented by
a percentage.

Spreadsheet compatible report creates a format that can be imported to various
spreadsheet programs.  In this format, text strings are delimited with
quotation marks.


ΓòÉΓòÉΓòÉ 90. Report Country Options ΓòÉΓòÉΓòÉ

The defaults for the list separator character and decimal character are comma
( ,) and period ( . ). You can select different characters from the drop down
lists if needed.


ΓòÉΓòÉΓòÉ 91. Report Time Periods ΓòÉΓòÉΓòÉ

The Collection time periods in selected logs box displays the active periods
for the monitor session (.LOG) files specified in the Report Description
window.  The report time periods must fall within the range of time during
which all the specified .LOG files were active.

In the Time periods to be included in the report fields, specify a start
date-time and a stop date-time between which to analyze the data.  Either type
this information in the respective fields or use the spin buttons.

Time periods are specified in a year, month, day, hour, minute, second
(YY MMDD HH MM SS) format.  The defaults are the earliest and latest date-times
when data was recorded in all the monitor session (.LOG) files.  If one of the
monitor sessions is active, the default for the stop time is the time of the
most current record.

Specify the interval at which data should be summarized.  Summary intervals are
specified in a day, hour, minute, second (DDD HH MM SS) format.

For the summary and tabular reports, the default is to process the report as a
single recording interval (unless the data spans 24 hours, in which case the
default interval is 1 day).  To specify that the report always be summarized as
a single interval, set the summary interval value to all zeros.

For the dump report, the summary interval is always  the same as the recording
frequency, so that every sample is shown.


ΓòÉΓòÉΓòÉ 92. Report Description: xxxxxxxx.RDF ΓòÉΓòÉΓòÉ

The report description defines which resources and workstations to include in
the report, the format of the data, and the time period for the data you want
to see.  Several detail levels are also available, depending on the type of
data collected during recording.

To create a report description, select the monitor sessions you want to include
then select Preferences on the action bar to define the report details.

To accept the SPM/2 report defaults, select the monitor sessions you want to
include and click on OK.  A default report is in Tabular format with all the
recorded data from the selected monitor sessions summarized at the workstation
level.


ΓòÉΓòÉΓòÉ 93. File ΓòÉΓòÉΓòÉ

Select File to save the Report Description you just created.


ΓòÉΓòÉΓòÉ 94. Save ΓòÉΓòÉΓòÉ

Select Save to save the report description file using the current name.


ΓòÉΓòÉΓòÉ 95. Save as ΓòÉΓòÉΓòÉ

Select Save as to save the report description file using a new name.


ΓòÉΓòÉΓòÉ 96. Preferences ΓòÉΓòÉΓòÉ

Select Preferences to define the following:

 o Format
 o Summarization level
 o Resources
 o Workstations
 o Time periods.

 Note:
 To restore the report defaults instead of saving new selections, select
 Preferences and then Restore defaults.


ΓòÉΓòÉΓòÉ 97. Format ΓòÉΓòÉΓòÉ

Select Format to display options for formatting reports. The default report is
Tabular which provides a high-level summary of data similar to that shown in
the SPM/2 Graphs.


ΓòÉΓòÉΓòÉ 98. Tabular ΓòÉΓòÉΓòÉ

The tabular report format provides a high-level summary of recorded data
similar to that graphed by the SPM/2 Graph.

If you want to create a report that can be imported to various spreadsheet
programs use the Tabular format and check the Spreadsheet compatible report
option.


ΓòÉΓòÉΓòÉ 99. Summary ΓòÉΓòÉΓòÉ

The summary report format can provide information about the following system
resources:  CPU, memory, files, file system (both FAT and HPFS), physical disk,
printers, communications ports.

The number of resources listed in a summary report, and the specific kind of
information provided for these resources, depends on which of the following
report levels you choose:

 o Workstation
 o Application
 o Process
 o Thread.


ΓòÉΓòÉΓòÉ 100. Dump ΓòÉΓòÉΓòÉ

Select Dump to generate a report which shows values for the lowest level
performance counters and timers as sampled at requested intervals.


ΓòÉΓòÉΓòÉ 101. Country options ΓòÉΓòÉΓòÉ

Select Country options if you want to use other than the default list separator
(a comma) or decimal point character (a period).


ΓòÉΓòÉΓòÉ 102. Summarization level ΓòÉΓòÉΓòÉ

Select Summarization level to display options for summarizing data in the
report. You can summarize by workstation, application, process, or thread.


ΓòÉΓòÉΓòÉ 103. Workstation ΓòÉΓòÉΓòÉ

The data is summarized as total activity for the entire workstation. That is,
you cannot see data about activity for individual applications, processes, or
threads within that workstation.


ΓòÉΓòÉΓòÉ 104. Application ΓòÉΓòÉΓòÉ

In addition to workstation totals, activity is listed for each individual
application running at that workstation.


ΓòÉΓòÉΓòÉ 105. Process ΓòÉΓòÉΓòÉ

In addition to workstation totals and application breakdown, activity is also
listed by individual process.


ΓòÉΓòÉΓòÉ 106. Thread ΓòÉΓòÉΓòÉ

Activity is summarized at the thread level and at every higher level (that is,
workstation, application, and process).


ΓòÉΓòÉΓòÉ 107. Resources ΓòÉΓòÉΓòÉ

Select Resources to define which resources you want to include in your report.
Some examples of resources are:  CPU, disk, memory, and input/output devices.


ΓòÉΓòÉΓòÉ 108. Workstations ΓòÉΓòÉΓòÉ

Select Workstations to specify the computers you want to include in the report.


ΓòÉΓòÉΓòÉ 109. Time periods ΓòÉΓòÉΓòÉ

Select Time periods to specify beginning and ending dates and times, and the
summary interval you want to use for data included in the report.

Note:  Summarization intervals do not apply to Dump reports.


ΓòÉΓòÉΓòÉ 110. Restore defaults ΓòÉΓòÉΓòÉ

Select Restore defaults to restore the SPM/2 report defaults instead of saving
your current selections.


ΓòÉΓòÉΓòÉ 111. Report Resources ΓòÉΓòÉΓòÉ

  1. Highlight entries in the Available: list box, and then select Add >> to
     copy those choices to the Selected: list box.
  2. Select OK to save your selections and return to the Report Description
     window.

 Notes:

 To display the respective instances of a resource, double-click on the
 resource in the Available: list box.

 Select Verbose (include nonactive resources) to display all possible
 applications, processes, threads, and files, including those that were
 inactive and therefore contain only zero data.


ΓòÉΓòÉΓòÉ 112. Define New Application ΓòÉΓòÉΓòÉ

Use the Define New Application window to specify processes you want to group
together in an application. This allows you to obtain reports about
applications not previously defined.

An application is a set of OS/2 processes (.EXE files). SPM/2 has some
applications predefined and existing applications are listed in the Available
list box on the Report Application Definitions panel.

Note Process (.EXE) files of an application are generally all found in the same
subdirectory.  Therefore, if you are not sure what .EXE files to include in an
application definition, you can try looking at a directory listing for that
application's subdirectory.


ΓòÉΓòÉΓòÉ 113. Report Application Definitions ΓòÉΓòÉΓòÉ

 o Highlight entries in the Available: list box, and then select Add >> to copy
   those choices to the Selected: list box.

 o Select the New pushbutton to define a new application

 o Select the Change pushbutton to modify the list of program files to be
   included in the definition.

 o Select the Delete pushbutton to remove an application from the list box.

 o Select OK to save your selections and return to the Report Description
   window.


ΓòÉΓòÉΓòÉ 114. Change Application Definition ΓòÉΓòÉΓòÉ

Use the Change Application Definition window to modify the list of program
(.EXE) files to be included in the definition.


ΓòÉΓòÉΓòÉ 115. Report Workstations ΓòÉΓòÉΓòÉ

To specify workstations to be included, highlight entries in the Available:
list box then select Add >>, to copy the highlighted entries to the Selected:
list box.


ΓòÉΓòÉΓòÉ 116. Save as ΓòÉΓòÉΓòÉ

Use this window to save a new monitor session description file or a new report
description file:

To specify the file to use; either:

 o Type the name of a single file in the Filename: entry field.

   or

 o Select a drive from the Drive: drop-down list.  A list of available
   directories for that drive is displayed in the Directory: list box.  (To
   display subdirectories, double-click on the highlighted directory item.)
   Select a directory.  A list of available monitor session description files
   for that directory is displayed in the File: list box.  Select the file you
   want.

 From the Type of file: drop-down list, select the appropriate file extension.
 Monitor session description files must have an extension of .LOG; report
 description files, an extension of .RDF.

 Select Save to save the selection and return to the previous window.

 Note: If you select an existing file name, a pop-up window warns that the new
 description will overwrite the old one of the same name.  Select Overwrite to
 overwrite the old description with the new one and return to the previous
 window.


ΓòÉΓòÉΓòÉ 117. SPM/2 Recording Options ΓòÉΓòÉΓòÉ

Select Append to append recorded data to any existing data in the monitor
session (.LOG) file.  This is the default.

Select Replace to record over any existing data in the monitor session (.LOG)
file.


ΓòÉΓòÉΓòÉ 118. Start (Graphing/Recording) ΓòÉΓòÉΓòÉ

To specify which monitor session files to use, either:

 o Type the name of a single monitor session (.LOG) file in the entry field and
   press Enter.  Entries in this field are reflected in the Selected: list box.
   Repeat until all desired sessions are entered.  You may precede the file
   name with the fully qualified path, or you may accept the path displayed in
   the Drive: and Directory: boxes.

   or

 o Select a drive from the Drive: drop-down list.  A list of available
   directories for that drive is displayed in the Directory: drop-down list.
   (To display subdirectories, double-click on the highlighted directory item.)
   Select a directory.  A list of available monitor session (.LOG) files for
   that directory is displayed in the Available: list box.  Highlight entries
   in the Available: list box.  Select Add >> to copy the highlighted entries
   to the Selected: list box.


ΓòÉΓòÉΓòÉ 119. SPM/2 Stop (Graphing/Recording) ΓòÉΓòÉΓòÉ

To stop a monitor session, highlight the session in the available list then
click on Add to select it.  Select Ok to return to the SPM/2 control window.