Use the CACHEADM command for the following tasks:
- Stopping the Cache Manager
- Flushing a specific cache
- Querying a specific cache
- Enabling or disabling logging
- Logging flags
- Starting and stopping statistics gathering
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:
- Returns information about a cache, if only the cache ID is
specified.
- Returns information about a specific cached page if url is
specified.
- Returns information about all pages if all is specified.
Other programs use all option to format or interpret the
results. Each line contains the following information:
- Page key
- Page age
- Page length
- Page creation date
- Page expiration date
- Date the page was last referenced
All dates are in standard UNIX integer time format.
Performance tip: The option cache query all can
impact performance and should be used sparingly.
- 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 ]