START STGRULE (Start a storage rule)

Use this command to start processing a storage rule without waiting for the scheduled time.

Privilege class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege.
Restriction: To issue this command, one of the following action types must be specified on the DEFINE STGRULE command:
  • ACTIONTYPE=NOTIERING
  • ACTIONTYPE=TIERBYAGE
  • ACTIONTYPE=TIERBYSTATE
Tips:
  • If you use this command to start processing a tiering storage rule, data might not be tiered immediately because the data must meet any specified requirements for age and state before the data can be tiered.
  • In the Operations Center, you can start processing a storage tiering rule immediately by clicking Storage > Tiering Rules, selecting a tiering rule, and clicking Run Now.

Syntax

Read syntax diagramSkip visual syntax diagram STArt STGRULE storage_rule_name ,SRCPools=source_poolTIERDelay=30TIERDelay=delayWait=NoWait=NoYes

Parameters

storage_rule_name (Required)
Specifies the name of the storage rule. The name must be unique, and the maximum length is 30 characters.
SRCPools
Specifies the name of the source storage pool from which data is tiered to the target storage pool. This parameter is optional. To specify multiple storage pools, separate the names with commas with no intervening spaces.

If you do not specify a source storage pool, the source storage pool that was defined in the DEFINE STGRULE command is used.

TIERDelay
Specifies the interval, in days, after which data is tiered. You can specify an integer in the range 0 - 9999. This parameter is optional. If ACTIONTYPE=TIERBYAGE is specified, the default value is 30. If ACTIONTYPE=TIERBYSTATE is specified, the default value is 1. If ACTIONTYPE=NOTIERING is specified, you cannot specify a tier delay.
Tip: To start processing a storage tiering rule immediately, set the TIERDELAY parameter to 0 when you issue the START STGRULE command.
Wait
Specifies whether to wait for the server to complete processing of this command. This parameter is optional. The default value is NO. You can specify this parameter only from an administrative command line. You can specify one of the following values:
No
Specifies that the command processes run in the background.
Yes
Specifies that the command processes run in the foreground. Messages are displayed when the command completes processing.

Start a storage rule to tier data

Start a storage rule that is named tieraction to tier data from a source storage pool sourcepool1. 
start stgrule tieraction srcpools=sourcepool1

Related commands

Table 1. Commands related to START STGRULE
Command Description
DELETE STGRULE Deletes storage rules.
QUERY STGRULE Displays storage rule information.