The CACHEADM Command

Use the CACHEADM command for the following tasks:

All parameters can be abbreviated to the minimum unique set of characters.

Syntax:

>>-cacheadm----+---------------------+---+-----------------+---->
               '-hostname--hostname--'   '-port--port_num--'
 
>-----+-activate-------------------------------------+---------->
      +-deactivate-----------------------------------+
      +-flags--flags---------------------------------+
      +-flush----------------------------------------+
      +-query--+-all-------+-------------------------+
      |        '-url--url--'                         |
      +-purge----url--url----------------------------+
      +-statistics--+-off--------------------------+-+
      |             '-on--+----------------------+-' |
      |                   '-interval--interval---'   |
      '-terminate------------------------------------'
 
>-----+--------------------+-----------------------------------><
      '-cacheid--cache_id--'
 

Parameters:

activate
Activates a specified cache. If the cache is already active, Cache Manager does nothing.

cache_id
A string variable identifying the cache in which the page is located. For example: cache1.

deactivate
Deactivates a specified cache. If the cache is already inactive, Cache Manager does nothing. All pending operations are completed and no new ones accepted. When the last operation is completed, the Cache Manager marks the cache as inactive.

flags
Specifies whether the listed flags should be toggled on or off.

D_ALL
Turn on all trace flags.

D_NONE
Turn off all trace flags.

flush
Flushes a cache, specified by the cache_id parameter, which is required by this parameter. This parameter unconditionally deletes all items from the specified cache.

hostname
Specifies the name of the machine where the cache is running, if it is different from the machine where the cacheadm command is issued. For example: myhost.

port_num
Specifies the cache port number, if the number is different from the default (7175). This number must be unique within the system.

purge
Specifies that a specific page to be purged from cache. If url is specified, Cache Manager purges the page with a key matching url. If dependency is specified, Cache Manager purges all items with the associated dependency and writes their keys to stdout, the standard output stream.

query
Returns caching data, depending on the parameters you specify:

statistics
Enables or disables logging of statistics gathering for a specific cache and requires cache_id parameter. If an interval is specified with the statistics parameter set to on, Net.Data sets or resets the interval between updates to the specified number of seconds.

terminate
Specifies to stop the Cache Manager.

tranlogging
Enables or disables transaction logging for a specific cache and requires the cache_id parameter. This parameter takes affect only if a valid transaction log for the cache is specified in the Cache Manager configuration file with the tran-log parameter.

url
The Universal Relative Location (URL) address that specifies the location of the file on a Web server. For example: http:www.ibm.com/mydir/page1.


[ Top of Page | Previous Page | Next Page | Index ]