UPDATE STGRULE (Update a storage rule for tiering)

Use this command to update a storage rule for one or more storage pools. The storage rule schedules tiering between container storage pools.

Privilege class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege.

Syntax

Read syntax diagramSkip visual syntax diagram UPDate STGRULE rule_name ACTiontype=TIERBYAgeTIERBYStateNOTiering,SRCPools=source_poolTIERDelay=delayMAXPRocess=numberDURation=minutesNOLimitSTARTTime=timeACTIVE=NoYesDESCription=description

Parameters

rule_name(Required)
Specifies the name of the storage rule. The maximum length of the name is 30 characters.
ACTiontype
Specifies whether the storage rule tiers data and, if so, the method for tiering data. This parameter is optional. Specify one of the following values:
TIERBYAge
Specifies that data is tiered after an age threshold is met.
TIERBYState
Specifies that only inactive data is tiered after an age threshold is met.
NOTiering
Specifies that data is not tiered.
SRCPools
Specifies the name of one or more directory-container storage pools from which objects are tiered to the target storage pool. To specify multiple storage pools, separate the names with commas with no intervening spaces.
TIERDelay
Specifies the number of days to wait before the storage rule tiers objects to the next storage pool. You can specify an integer in the range 0 - 9999. The parameter value applies to all files in the storage pool.
MAXProcess
Specifies the total maximum number of parallel processes for the storage rule and each of its subrules. This parameter is optional. Enter a value in the range 1 - 99. The default value is 8. For example, if the default value of 8 is specified, and the storage rule has four subrules, the storage rule can run eight parallel processes and each of its subrules can run eight parallel processes. The total number of parallel processes is 40.
Tip: To optimize the process of tiering data to tape, ensure that the sum of all MAXPROCESS values for a rule and its subrules is less than or equal to the number of tape drives.
DUration
Specifies the maximum number of minutes that the storage rule runs before it is automatically canceled. You can specify a number in the range 60 - 1440. If you specify a value of NOLimit, the storage rule runs until it is completed. This parameter is optional.
STARTTime
Specifies the time for the beginning of the window in which the storage rule is first processed. This parameter is optional. The storage rule runs daily within 5 minutes following the specified time.
Specify one of the following values:
Value Description Example
HH:MM:SS A specific time. 23:30:08
NOW The current time. NOW
NOW+HH:MM or +HH:MM The current time plus the specified number of hours and minutes. NOW+02:00 or +02:00
NOW-HH:MM or -HH:MM The current time minus the specified number of hours and minutes. NOW-02:00 or -02:00
ACTIVE
Specifies whether the storage rule processing occurs. This parameter is optional. The following values are possible:
No
Specifies that the defined storage rule is inactive. The storage rule is not processed at the scheduled time.
Yes
Specifies that the defined storage rule is active. The storage rule is processed at the scheduled time.
DESCription
Specifies a description of the storage rule. This parameter is optional.

Update a storage rule for cloud tiering

Update a storage rule that is named TIERACTION to move data from directory-container storage pools DIRPOOL1 and DIRPOOL2 to the cloud-container storage pool CLOUDPOOL1. Ensure that the data is tiered by state, which means that only inactive data is tiered. Specify a start time of 23:30:08 hours and a maximum of 16 processes:
update stgrule tieraction actiontype=tierbystate srcpools=dirpool1,dirpool2 
maxprocess=16 starttime=23:30:08

Update a storage rule for tape tiering

Update a storage rule that is named TIERTOTAPE. The TIERTOTAPE storage rule is used to move medical data that is 30 days old from directory-container storage pools to a tape storage pool, TAPE1. Specify a start time of 2 AM and a maximum of five processes:
update stgrule tiertotape maxprocess=5 starttime=02:00:00

Related commands

Table 1. Commands related to UPDATE STGRULE
Command Description
DEFINE STGRULE (tiering) Defines a storage rule for tiering.
DEFINE SUBRULE (tiering) Defines an exception to a tiering storage rule.
DELETE STGRULE Deletes storage rules.
QUERY STGRULE Displays storage rule information.