QUERY STGRULE (Display storage rule information)

Use this command to display information about storage rules that are defined for storage pools.

Privilege class

To issue this command, you must have system privilege.

Syntax

Parameters

rule_name

Specifies the name of one or more storage rules. This parameter is optional. You can use wildcard characters to specify this name. If you do not specify a value for this parameter, all storage rules are displayed. The maximum length of the name is 30 characters.

Format

Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. The following values are possible:

Standard: Specifies that partial information is displayed.
Detailed: Specifies that complete information is displayed.

ACTiontype

Specifies the storage action that is completed by the storage rules. The following values are possible:

ANY: All types of storage rules are displayed.
AUDit: Storage rules for audit operations are displayed.
GENdedupstats: Storage rules for data deduplication statistics are displayed.
REClaim: Storage rules for reclaiming cloud-container storage pools are displayed.
RETention: Storage rules defined for coping retention set data are displayed. Retention-copy storage rules are automatically created when you create a retention storage pool.
TIERBYAge: Storage rules for tiering based on age are displayed. If a storage tiering rule is based on age, all data that meets the age requirement is tiered.
TIERBYState: Storage rules for tiering based on state are displayed. If a storage tiering rule is based on state, only inactive data that meets the age requirement is tiered.
NOTiering: Storage rules that prevent data tiering are displayed.
COPY: Storage rules that copy data are displayed.
NOCopying: Storage rules that prevent data copying are displayed.
REPLICATE: Storage rules for replication of data to the target replication server are displayed.
NOREPLICATING: Storage rules that prevent replication of data to the target replication server are displayed.

ACTIVE

Specifies whether active or inactive storage rules are displayed. This parameter is optional. The default is ANY. The following values are possible:

ANY: Specifies that all storage rules are displayed.
Yes: Specifies that only active storage rules are displayed.
No: Specifies that only inactive storage rules are displayed.

Example: List all storage rules for all storage pools

Tip: In the output examples, some fields are blank because the item does not apply in the specified environment.

Query all storage rules for all storage pools. See Field descriptions.

query stgrule

Storage           Target Storage   Action        Active        Source Storage
Rule              Pool             Type                        Pools
Name                                                       
---------         ---------        ------        ---------     ------------------------
STGACTION1        CLOUD            TierByAge     Yes           DIRPOOL1
RULEREPL1         TARGET           REPLICATE     Yes

Example: Display detailed information about a storage rule for tiering

Query detailed information about a storage rule for tiering. See Field descriptions.

query stgrule format=detailed


   Storage Rule Name: COSRULE
 Target Storage Pool: COSPOOL
         Action Type: NoTiering
              Active: Yes
        Storage Type: Cloud
   Maximum Processes: 8
          Start Time: 14:20:15
     Delay (in days): 
            Duration:
         Description:
          Audit Type:
         Audit Level:
           Node Name:
     Filespace names:
           Name Type:
           Code Type:
      Percent Unused:
  Last Exe Date/Time:
Source Storage Pools: CONPOOL

Example: Display detailed information about a storage rule for auditing storage pools

Query detailed information about a storage rule for auditing storage pools. See Field descriptions.

query stgrule format=detailed

          Storage Rule Name: AUDIT
        Target Storage Pool: CTR
                Action Type: Audit
                     Active: Yes
               Storage Type: 
          Maximum Processes: 4
                 Start Time: 11:42:36
            Delay (in days): 7
                   Duration:
                Description:
                 Audit Type: Extent
                Audit Level: 5
                  Node Name:
            Filespace names:
                  Name Type:
                  Code Type:
             Percent Unused:
         Last Exe Date/Time: 01/19/2018 11:43:31
       Source Storage Pools:

Example: Display detailed information about a storage rule for generating data deduplication statistics

Query detailed information about a storage rule for generating data deduplication statistics. See Field descriptions.

query stgrule format=detailed

       Storage Rule Name: GEN1
     Target Storage Pool: DIRPOOL
             Action Type: GenDedupStats
                  Active: Yes
            Storage Type:
       Maximum Processes: 8
              Start Time: 12:06:46
         Delay (in days): 1
                Duration:
             Description:
              Audit Type:
             Audit Level:
               Node Name: *
         Filespace names: *
               Name Type: SERVER
               Code Type: BOTH
      Last Exe Date/Time: 01/18/2018 12:07:10
    Source Storage Pools:

Example: Display detailed information about a storage rule for reclaiming space in cloud-container storage pools

Query detailed information about a storage rule for reclaiming space in cloud-container storage pools. See Field descriptions.

query stgrule format=detailed

       Storage Rule Name: RECLAIM
     Target Storage Pool: CLOUD1
             Action Type: Reclaim
                  Active: Yes
            Storage Type:
       Maximum Processes: 8
              Start Time: 9:04:16
         Delay (in days): 
                Duration: 120
             Description:
              Audit Type:
             Audit Level:
               Node Name: *
         Filespace names: *
               Name Type: 
               Code Type: 
          Percent Unused: 50
      Last Exe Date/Time: 01/30/2018 12:07:10
    Source Storage Pools:

Example: Display detailed information about a storage rule for copying retention sets to tape storage

Query detailed information about a storage rule for copying retention set data to tape storage. See Field descriptions.

query stgrule format=detailed

       
     Storage Rule Name: RETPOOL
   Target Storage Pool: RETPOOL
           Action Type: Retention
                Active: Yes
          Storage Type:
     Maximum Processes: 8
            Start Time: 06:30:00
       Delay (in days): 1
              Duration: No Limit
           Description:
            Audit Type:
           Audit Level:
             Node Name:
       Filespace names:
             Name Type:
             Code Type:
        Percent Unused:
    Last Exe Date/Time:
Allow Tier Before Copy:
  Source Storage Pools:

Example: Display detailed information about a storage rule for replication operation

Query detailed information about a storage rule for replicating data from a source replication server to a target replication server. See Field descriptions.

query stgrule format=detailed

       
     Storage Rule Name: RULEREPL2
   Target Storage Pool: 
   Target Server Name: TARGET
           Action Type: NoReplicating
                Active: No
          Storage Type:
     Maximum Processes: 
            Start Time: 16:55:54
       Delay (in days): 
              Duration: No Limit
           Description:
            Audit Type:
           Audit Level:
             Node Name:
       Filespace names:
             Name Type:
             Code Type:
        Percent Unused:
    Last Exe Date/Time:
Maximum Sessions: 20
Transfer Method: TCPIP
  Source Storage Pools:

Field descriptions

Storage Rule Name: The name of the storage rule.
Target Storage Pool: The name of the target storage pool.
Target Server Name: The name of the target server.
Action Type: The type of storage rule.
Active: Indication of whether the storage rule is active or inactive.
Storage Type: The storage type of the target storage pool. For cloud tiering storage rules, the value of Cloud is displayed.
Maximum Processes: The maximum number of parallel processes per storage pool.
Tip: For tiering storage rules, this value specifies the maximum number of processes for the source storage pool. For audit storage rules, you cannot set a maximum process value. The server automatically sets and adjusts the number of maximum processes during audit operations.
Start Time: The starting time of the window when the storage rule runs.
Delay (in days): The number of days to wait before the storage rule operation occurs. For audit storage rules, the number represents the interval, in days, between audit operations. For tiering storage rules, the number represents the minimum number of days that an object must remain in a source storage pool before it is moved to a target storage pool.
Duration: The number of minutes that the storage rule processes the data when all associated processes are completed. No value indicates that processing continues until complete.
Description: A description of the storage rule.
Audit Type: The type of audit operation.
Audit Level: The level of audit operation.
Node Name: The name of the client node.
Filespace names: The names of one or more affected file spaces.
Name Type: Indication of how the server interprets file space names.
Code Type: Indication of the type of file spaces that are included.
Percent Unused: Percentage of unused space in reclamation storage rules.
Last Exe Date/Time: The last date and time when the storage rule was run.
Maximum Sessions: The maximum number of scheduled sessions as a percentage of the total number of available server sessions.
Transfer Method: The method of transfer that is used for data replication between source and target replication server.
Source Storage Pools: The name of the source storage pool or pools.

Related commands

Table 1. Commands related to QUERY STGRULE
Command	Description
DEFINE STGRULE (auditing)	Defines a storage rule for auditing storage pools.
DEFINE STGRULE (copying)	Defines a storage rule for copying data.
DEFINE STGRULE (data deduplication statistics)	Defines a storage rule for generating data deduplication statistics.
DEFINE STGRULE (reclaiming)	Defines a storage rule for reclaiming cloud-container storage pools.
DEFINE STGRULE (tiering)	Defines a storage rule for tiering.
DELETE STGRULE	Deletes storage rules.
UPDATE STGRULE (auditing)	Updates a storage rule for auditing storage pools.
UPDATE STGRULE (copying)	Updates a copy storage rule.
UPDATE STGRULE (data deduplication statistics)	Updates a storage rule for generating data deduplication statistics.
UPDATE STGRULE (reclaiming)	Updates a storage rule for reclaiming cloud-container storage pools.
UPDATE STGRULE (tiering)	Updates a tiering storage rule.