server task stats

Manages the gathering and reporting of statistics for ISAM servers and server instances.

Requires authentication (administrator ID and password) to use.

server task server_name-host_name stats get [component]

server task server_name-host_name stats list

server task server_name-host_name stats off [component]

server task server_name-host_name stats on component [interval [count]] [destination]

server task server_name-host_name stats reset [component]

server task server_name-host_name stats show [component]

The server task stats command manages the gathering and reporting of statistics for ISAM servers and server instances. We can use the stats commands with configuration setting defined by the stanza entries in the server configuration file to manage statistics. Statistics gathering is enabled through:

Then, we can use the stats on commands to modify the behavior for gathering and reporting statistics. For example, statistics are enabled to create five statistics reports with each report generated each day. We can use the stats on command to change the frequency to every 12 hours. For this example, assume the following command started statistics gathering:

To modify the interval to 12 hours and create 10 reports, issue the following command:

pdadmin sec_master> server task PDWebPI-linuxweb.wasp.ibm.com stats on \
pdwebpi.stats 43200 10

Although the destination is not specified, the statistics infrastructure assumes any preexisting value. Entering the previous command does disable statistics from being written to the previously defined log file. However, if you specified a different destination, statistics reports would be written to the new destination only. We cannot use the stats on command to write statistics reports to more than one destination.

For information about gathering statistics, see the Auditing topics in the Knowledge Center.

Options

Return codes

Examples

  • The following example:

    • Uses the status on command to enable gathering of statistics for the pd.log.EventPool.queue component on the ivacld-mogman.admogman.com authorization server.

    • Sets the reporting frequency to 30 days, that is, 2592000 seconds.

    • Sets the destination to the myEPstats.log log file.

      #pdadmin sec_master> server task ivacld-mogman.admogman.com stats on \
      pd.log.EventPool.queue 2592000 file path=myEPstats.log

    See also

    server list

    Parent topic: Commands and utilities