oscmstat: Displaying Cache Manager Status

Syntax

oscmstat [hostname] [version-number]


hostname 
Specifies the name of the host of the Cache Manager for which you want information. The default is the local host.


version-number 

Specifies the version of the Cache Manager for which you want information. The default is 6.

If you do not specify a host name, the default is the local host.

The oscmstat utility prints information about every Server to which the Cache Manager is connected. For each Server, it displays

• The name of the Server host
• The client process ID of the client being processed, or 0 if none is being processed
• Information on notifications queued for clients

The information for the cache and commseg files includes the size of the files, the directory used to store them, the version of ObjectStore, and the name of the host that created and owns or owned the file. In the example shown below, the host name is kellen.

Files labeled "Free" can be safely deleted using oscmrf.

If oscmstat reports that no Cache Manager is running, it is safe to delete the files as long as you are certain that oscmstat did not fail due to temporary network failure or something similar.

Example

kellen% oscmstat
ObjectStore Release 6.0
Cache Manager:
  Host:      kellen
    PID:      11679 1
    Executable:      /os/top/lib/oscmgr6 2
  Version:      6.0
  Started at:      Fri Jan 22 14:35:40 1999
    Soft Allocation Limit:      none 3
    Hard Allocation Limit;      none
    Used Temp File Space:      8.04MB 4
  Free Temp File Space:      1.91MB
Free Cache Files: 5
1.91MB  /tmp/wirth/ostore/objectstore_6_kellen_cache_1
In-Use Cache Files:
     8MB  /tmp/ostore/objectstore_6_kellen_cache_109
Free Commseg Files:
     8KB  /tmp/wirth/ostore/objectstore_6_kellen_commseg_2
In-Use Commseg Files:
    40KB  /tmp/ostore/objectstore_6_kellen_commseg_110
Client Connections: 6
  PID      UID      Commseg      Name & Version
  27230      263      0x00000000       /h/mangle/3/mj/tests

      /mj.houdini.sol2c4.picsym.2/obj/tscoll/houdini/colltest 

      -dbname colltest.db -lgcard 100 (6.0)
Client Notifications: 7
      Client      Queue      Received      Sent to      Pending      Overflows
      PID      Size      by cmgr       Client
      27230      50      0      0      0      0
Server Connections:
Host      Callbacks      Notifies
kellen      0      0
kellen% 

2 The executable cache manager file that is accessed by oscmstat.

3 The allocation limit parameters are as described in the Cache Manager parameter file. See Setting Cache Manager Parameters. oscmstat does not display this information for Cache Managers running on Windows systems.

4 Total sizes of the Free and In-Use cache and commseg files. oscmstat does not display this information for Cache Managers running on Windows systems.

5 Free and In-Use cache and commseg files known to the Cache Manager. Cache file names end in odd numbers and commseg file names end in even numbers. Cache files and commseg files are paired; the cache file whose name ends in 1 and the commseg file whose name ends in 2 go together. Likewise, the cache file whose name ends in 3 and the commseg file whose name ends in 4 go together, and so on. Files labeled "Free" can be safely deleted with the oscmrf utility. oscmstat does not display this information for Cache Managers running on Windows systems.

6 Clients (ObjectStore application processes) currently running on this host. For each client, it gives the operating system process ID, the user ID associated with the client process, the commseg address for the process (useful in debugging the Cache Manager), the name of the client (assuming that the client has called objectstore::set_client_name()), and the ObjectStore version number.

7 Notification information for each client. The oscmstat output displays the following :

• Process ID (PID) of the client.
• Size of the queue.
• Received by cmgr is the number of notifications that were received from any Servers and were addressed to this client process. Each such notification either went into the client's queue or was discarded because the queue was full (that is, it was an overflow notification). Both kinds are counted here. This number only increases.
• Sent to Client is the number of notifications sent to the client. This means that the client called os_notification::receive and obtained the notification. This number does not include the overflow notifications or the notifications that are still in the queue. This number only increases.
• Pending is the number of notifications that are in the queue. This number can increase and decrease.
• Overflows is the number of notifications that were discarded because the queue was full. This number is for the lifetime of the client process and it only increases.

Updated: 03/11/99 11:19:07