QUERY SUBRULE (Display subrule rule information)

Use this command to display information about one or more subrules.

Privilege class

To issue this command, you must have system privilege.

Syntax

Parameters

parent_rule_name (Required)

Specifies the name of the parent storage rule.

subrule_name

Specifies the name of the subrule. The name must be unique, and the maximum length is 30 characters. This parameter is optional.

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.

Example: List all subrules for a storage rule

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

Query all subrules for parent storage rule, RULE1, to view complete information. See Field descriptions.

query subrule rule1 format=detailed

Subrule Name    Subrule  Action Type      Delay (in   Maximum       Subrule Members
                     ID                        days)  Processes                    
--------------- -------  ------------     ----------  --------- -------------------
TESTSUBRULE           1  TierByAge                 1          2         NODE1:*    
TESTSUBRULE2          2  TierByState               1          3         NODE2:*    
TESTSUBRULE3          3  NoTiering                            4         NODE3:*    
TESTSUBRULE4          4  Copy                                 2         NODE4:*    
TESTSUBRULE5          5  NoCopying                            3         NODE5:*    
SUBRULE11             6  Replicate                            0         NODEA:*

Example: List detailed information about a tiering subrule

Query a tiering subrule, TAPESUB, with the parent storage rule, TAPERULE, to view complete information. The subrule is used to specify exceptions to the parent tiering storage rule.

query subrule taperule tapesub format=detailed

       Subrule Name: TAPESUB
         Subrule ID: 15
        Action Type: TierByAge
    Delay (in days): 30
  Maximum Processes: 3
Target Storage Pool: 3592TAPE
    Subrule Members: CDNODE2:- CDNODE3:- CDNODE4:- CMNODE2:-

Example: List detailed information about a replication subrule

Query a replication subrule, SUBRULE1 with parent storage rule, REPRULE to view complete information. The subrule is used to specify exceptions to the parent replication storage rule.

query subrule reprule subrule1 format=detailed

       Subrule Name: SUBRULE1
         Subrule ID: 13
        Action Type: Replicate
    Delay (in days): 
          Data Type: All
  Maximum Processes: 0
Target Storage Pool: 
    Subrule Members: BROVAR-B52:-

Field descriptions

Subrule Name

The name of the subrule.

Subrule ID

The number that is associated with the subrule.

Action Type

The type of action that the subrule performs. The following action types are possible:

TierByAge: Specifies that the subrule can tier data by age.
TierByState: Specifies that the subrule can tier data by state.
NoTiering: Specifies that the subrule does not tier data.
Copy: Specifies that the subrule can copy data from a directory-container storage pool to a sequential-access storage pool.
NoCopying: Specifies that the subrule does not copy data from a directory-container storage pool to a sequential-access storage pool.
Replicate: Specifies that the subrule can replicate data to the target server.
NoReplicate: Specifies that the subrule can prevent replication of data to the target server.

Delay (in days)

The interval, in days, after which data is tiered.

Data Type

The type of data to be replicated to target server.

Maximum Processes

The maximum number of parallel processes for the subrule.

Target Storage Pool

The name of a target storage pool.

Subrule Members

The members of the subrule. The members are any clients and virtual machine file spaces to which the subrule applies.

Related commands

Table 1. Commands related to QUERY SUBRULE
Command	Description
DEFINE SUBRULE	Defines an exception to a storage rule.
UPDATE SUBRULE (copying)	Updates a subrule that is an exception to a copy storage rule.
UPDATE SUBRULE (tiering)	Updates a subrule that is an exception to a tiering storage rule.