statpolicy

Displays policy statistics for each fileset.

Read syntax diagramSkip visual syntax diagram
>>-statpolicy--+--------+--+- -pool -+-------------------------><
               +- -?----+  '- -rule--'
               +- -h----+
               '- -help-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–pool
Displays policy statistics for all filesets for all storage pools.
–rule
Displays policy statistics for all filesets for all rules.

Prerequisites

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

Policy statistics are maintained for each fileset. These statistics reset when:
  • The cluster is stopped and restarted.
  • A new policy is activated.
  • A metadata server is stopped, started, restarted, added, or dropped.
  • A fileset is moved to another metadata server or detached.
  • The default storage pool is changed or disabled.

You can manually reset the counters for the statistics by reactivating the current policy.

No data is available about a fileset, if the fileset is detached.

If you specify the –pool parameter, this command displays the following information:
  • Pool name.
  • Number of times a file was placed into this storage pool
  • Last time a file was placed into this storage pool.
If you specify the –rule parameter, this command displays the following information:
  • Rule name.
  • Ordinal position of the rule. The order is not viewable when editing a policy. It is sequenced automatically by the system. This is important because rules are evaluated in order. If possible, initially sort the table from lowest number to highest number
  • Number of times that the rule has caused an error while being evaluated. These are not syntax errors.
  • Number of times that the rule has been evaluated and its conditions were false, so the rule was not applied.
  • Number of times that the rule has been evaluated and its conditions were true, so that the rule was applied.
  • Last time a rule was applied. This is the last time the rule placed a file into a storage pool.

Example

List policy statistics The following example displays the policy rule statistics:
sfscli> statpolicy -rule
Rule Name	  Position   Evaluation   Evaluations    Applied
                             Errors       Not Applied    Evaluations
===================================================================
Myrule	               1           0	           97	         87
Myotherrule	       2          23	          798          8098

           Last Applied
=======================
Oct 28, 2003 12:35:43PM
Oct 28, 2003 12:35:43PM

Parent topic: Administrative commands

Related tasks
Viewing policy statistics

Related reference
catpolicy
lspolicy
mkpolicy
rmpolicy
usepolicy

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2