OPEN MONITOR UTILITY
                  Release Level December 4, 1992 9:43 




This application consists of one runfile: OpenMonitor.Run

Product Name   : Open Monitor
Supported On   : B24, B26, B27, B28, B38, B39, and all SuperGen hardware
Supported OS   : BTOS II, CTOS I, CTOS II, CTOS III

Description    : The Open Monitor application is a system service which 
                 continuously monitors the status of all file activity on a 
                 given system.

Directions/Use : The Open Monitor utility will continuously monitor all file 
                 activity.  A data file ([Sys]<Sys>OpenMonitor.Data - the 
                 default) is automatically created, with a default size of 10 
                 sectors, when the application is installed.  This file is 
                 used as a circular trace buffer.  Should a larger trace file 
                 be desired, manually create the file 
                 '[Sys]<Sys>OpenMonitor.Data', or a the filename which will be 
                 specified when the monitor is installed, with an explicit 
                 sector size.  
                 The display of an Open File, Open File Long Lived, or Reopen 
                 file request consists of the following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request
                 3. The file name.
                 4. Path (if the path is not part of the original file name).
                 5. The open mode (in parenthesis).
                 6. The hexadecimal File Handle.
                 7. Any error code (in decimal and in parentheses).
                 
                 The display of a Create File request consists of the 
                 following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request
                 3. File name.
                 4. The Path (if the path is not part of the original file 
                    name).
                 5. Any error code (in decimal and in parentheses).
                 
                 The display of a Remake File Handle request consists of the 
                 following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request.
                 3. The old File Handle.
                 4. The new File Handle.
                 5. Any error code (in decimal and in parentheses).
                 
                 The display of a Close File or Delete File request consists 
                 of the following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request.
                 3. The hexadecimal File Handle (if present).
                 4. Any error code (in decimal and in parentheses).
                 
                 The display of a Close All Files or Close All Files request 
                 consists of the following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request.
                 3. Any error code (in decimal and in parentheses).
                 
                 The display of a Change User Number request consists of the 
                 following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request.
                 3. The hexadecimal old user number.
                 4. The hexadecimal new user number.
                 5. Any error code (in decimal and in parentheses).
                 
                 The display of a Create Directory or Delete Directory request 
                 consists of the following:
                 
                 1. The hexadecimal user number.
                 2. The name of the request.
                 3. The name of the directory.
                 4. The Path (if the path is not part of the original file 
                    name).
                 5. Any error code (in decimal and in parentheses).
                 
                 To use the Open Monitor utility, execute the 
                 executive command /Open Monitor using the paramters which are 
                 detailed and explained below:
                 
                 Install, Start, Stop, Reset
                 
                 This field is mandatory.  Enter Install to install the Open 
                 Monitor service in memory.  Enter Start to start the 
                 tracing.  Enter Stop or nothing to stop the tracing.  Enter 
                 Reset to clear the trace buffer. 
                 
                 [Output File (default = vid)]
                 
                 This field is optional.  Enter a file or device name to 
                 output the trace log.
                 
                 [Data File (default = [Sys]<Sys>OpenMonitor.Data)]
                 
                 This field is optional.  Enter the filename where the trace 
                 information is to be stored.
                 
                 [Data File Password]
                 
                 This field is optional.  Enter the volume password where the 
                 Open Monitor data file is to reside.
                 
                 [User Number Display (default = all user numbers)]
                 
                 This field is optional.  Enter the user number to be 
                 displayed.  To enter a user number in hex, enter the hex 
                 value followed by an h.
 
                                 
COMMAND

/Open Monitor
  Install, Start, Stop, Reset
  [Output File (default = vid)]
  [Data File (default = [Sys]<Sys>OpenMonitor.Data)]
  [Data File Password]
  [User Number Display (default = all user numbers)]
  
The display of an Open File, Open File Long Lived, or Reopen file request
consists of the following:
 
   1. The hexadecimal user number.
   2. The name of the request
   3. The file name.
   4. Path (if the path is not part of the original file name).
   5. The open mode (in parenthesis).
   6. The hexadecimal File Handle.
   7. Any error code (in decimal and in parentheses).

The display of a Create File request consists of the following:

   1. The hexadecimal user number.
   2. The name of the request
   3. File name.
   4. The Path (if the path is not part of the original file name).
   5. Any error code (in decimal and in parentheses).

The display of a Remake File Handle request consists of the following:

   1. The hexadecimal user number.
   2. The name of the request.
   3. The old File Handle.
   4. The new File Handle.
   5. Any error code (in decimal and in parentheses).

The display of a Close File or Delete File request consists of the following:

   1. The hexadecimal user number.
   2. The name of the request.
   3. The hexadecimal File Handle (if present).
   4. Any error code (in decimal and in parentheses).

The display of a Close All Files or Close All Files request consists of the
followin:

   1. The hexadecimal user number.
   2. The name of the request.
   3. Any error code (in decimal and in parentheses).

The display of a Change User Number request consists of the following:

   1. The hexadecimal user number.
   2. The name of the request.
   3. The hexadecimal old user number.
   4. The hexadecimal new user number.
   5. Any error code (in decimal and in parentheses).

The display of a Create Directory or Delete Directory request consists of the
following:

   1. The hexadecimal user number.
   2. The name of the request.
   3. The name of the directory.
   4. The Path (if the path is not part of the original file name).
   5. Any error code (in decimal and in parentheses).