NAME

oscmstat − print status information about a Cache Manager process

SYNOPSIS

oscmstat hostname version-number

DESCRIPTION

oscmstat prints out status information about hostname’s Cache Manager process for debugging the storage system ( hostname defaults to the local host.) It prints out one line for every Server to which the Cache Manager is connected. For each Server, it prints a line giving the name of the Server host, the client process ID of the client being processed, or 0 if none is being processed, and a string saying what the thread is doing or what it most recently did. 

It also prints out the names all files known to the Cache Manager.  This is useful if you are trying to determine if files are in active use by ObjectStore, or are ObjectStore files no longer in use that can be deleted (with oscmrf). The second word of an ObjectStore file name is always the name of the host that created and owns or owned the file, so, for files named objectstore_doolittle_commseg_8 and objectstore_doolittle_cache_3, the host name is doolittle. oscmstat doolittle prints out a list of all the files that the Cache Manager daemon on host doolittle currently knows about. If your file is not on the list, it is no longer in use, and can be removed with oscmrf. 

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

Output typically looks like the following:

 ObjectStore Cache Manager, Release 2.0, Version 3.2. 
 Process ID 22758, started Mon Oct 26 11:28:47 1992
 Soft Allocation Limit 0, Hard Allocation Limit 120000000.
 Allocated: free 32907264, used 8536064.
 Server host: Client process ID: Status for this host:
 doolittle    0                  Initializing: constructor finished
 higgins      0                  Initializing: constructor finished
 pickering    0                  Initializing: constructor finished
 pickering    0                  Initializing: constructor finished
 
 There is 1 client currently running on this host:
     1637 101 (null) v3.0 0xf7660000
     Free cache files:
       /tmp/objectstore_doolittle_cache_3 (8388608)
       /tmp/objectstore_doolittle_cache_5 (23994368)
     In-use cache files:
       /tmp/objectstore_doolittle_cache_1 (8388608)
     Free commseg files:
       /tmp/objectstore_doolittle_commseg_4 (147456)
       /tmp/objectstore_doolittle_commseg_6 (376832)
     In-use commseg files:
       /tmp/objectstore_doolittle_commseg_2 (147456)

Version in the top line is an internal version number that has nothing to do with ObjectStore release numbers. 

Process ID is the operating system process ID of the Cache Manager process. The allocation limit parameters are as described in the parameter file. The Allocated line gives the total sizes of the used pool and the free pool. 

A list of lines follows, one for each Server connection to the Cache Manager. This information is sometimes useful in debugging. 

The last section consists of a list of lines, one for each client (ObjectStore application process) currently running on this host. For each client it gives the oper ating system process ID and user ID, the "name" of the client (assuming the client has called objectstore::set_client_name()), an internal version number that also has nothing to do with ObjectStore release numbers, and a virtual address within the Cache Manager that is useful in debugging the Cache Manager. 

The version-number argument is useful only to sites that are running both a Release 1 Cache Manager and a Release 2 Cache Manager. In Release 2, version-number defaults to 2, but by specifying it with a value of 1, you can operate on the Release 1 Cache Manager with the oscmstat command that is installed as part of Release 2.  Users who purchase Release 2 initially, who have not upgraded from Release 1, should not use the version-number argument. 

FILES

$OS_ROOTDIR/bin/oscmstat

ObjectStore 2.0  —  Last change: October 1992