QUERY SUBRULE (Query a subrule)

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, and provide complete information. See Field descriptions for field descriptions.

query subrule rule1 format=detailed


Subrule Name    Subrule  Action Type  Delay (in   Maximum Processes    Subrule Members
                     ID                    days)    
--------------- -------  ------------ ----------  --------- --------------------------
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                Replicate                0

Example: List detailed information about a tiering subrule

Query a tiering subrule that is named TAPESUB, and provide complete information. The subrule is used to move data from disk storage to tape storage.

query subrule 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 replicate subrule

Query a replicate subrule that is named SUBRULE1, and provide complete information. The subrule is used to replicate data to the target server.

query subrule 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 copy sequential-access storage pool.
NoCopying: Specifies that the subrule does not copy data from a directory-container storage pool to a copy 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.