Policy rules: Syntax
Policy rules can apply to file placements, group pools, file migrations, file deletions, file exclusions, file lists, file restores, external storage pool definitions, and external list definitions.
The policy rules and their respective syntax diagrams are as follows. For more information about encryption-specific rules, see Encryption.
- File placement rules
RULE ['RuleName'] SET POOL 'PoolName' [LIMIT (OccupancyPercentage)] [REPLICATE (DataReplication)] [FOR FILESET ('FilesetName'[,'FilesetName']...)] [ACTION (SqlExpression)] [WHERE SqlExpression]
- Group pool rule; used to define a list of pools that may be used
as a pseudo-pool source or destination in either a FROM
POOL or TO POOL clause within
another rule
RULE ['RuleName'] GROUP POOL ['groupPoolName'] IS 'poolName' [LIMIT(OccupancyPercentage)] THEN 'poolName2' [LIMIT(n2)] THEN 'pool-C' [LIMIT(n3)] THEN ...
- File migration
rule
RULE ['RuleName'] [WHEN TimeBooleanExpression] MIGRATE [COMPRESS ({'yes' | 'no'})] [FROM POOL 'FromPoolName'] [THRESHOLD (HighPercentage[,LowPercentage[,PremigratePercentage]])] [WEIGHT (WeightExpression)] TO POOL 'ToPoolName' [LIMIT (OccupancyPercentage)] [REPLICATE (DataReplication)] [FOR FILESET ('FilesetName'[,'FilesetName']...)] [SHOW (['String'] SqlExpression)] [SIZE (numeric-sql-expression)] [ACTION (SqlExpression)] [WHERE SqlExpression]
For more information about file compression and decompression, see the topic File compression.
- File deletion rule
RULE ['RuleName'] [WHEN TimeBooleanExpression] DELETE [DIRECTORIES_PLUS] [FROM POOL 'FromPoolName'] [THRESHOLD (HighPercentage[,LowPercentage])] [WEIGHT (WeightExpression)] [FOR FILESET ('FilesetName'[,'FilesetName']...)] [SHOW (['String'] SqlExpression)] [SIZE (numeric-sql-expression)] [ACTION (SqlExpression)] [WHERE SqlExpression]
- File exclusion rule
RULE ['RuleName'] [WHEN TimeBooleanExpression] EXCLUDE [DIRECTORIES_PLUS] [FROM POOL 'FromPoolName'] [FOR FILESET ('FilesetName'[,'FilesetName']...)] [ACTION (SqlExpression)] [WHERE SqlExpression]
- File list rule
RULE ['RuleName'] [WHEN TimeBooleanExpression] LIST 'ListName' [EXCLUDE] [DIRECTORIES_PLUS] [FROM POOL 'FromPoolName'] [THRESHOLD (HighPercentage[,LowPercentage])] [WEIGHT (WeightExpression)] [FOR FILESET ('FilesetName'[,'FilesetName']...)] [SHOW (['String'] SqlExpression)] [SIZE (numeric-sql-expression)] [ACTION (SqlExpression)] [WHERE SqlExpression]
- File restore rule
RULE ['RuleName'] RESTORE TO POOL 'PoolName' [LIMIT (OccupancyPercentage)] [REPLICATE (DataReplication)] [FOR FILESET ('FilesetName'[,'FilesetName']...)] [ACTION (SqlExpression)] [WHERE SqlExpression]
- External storage pool definition rule
RULE ['RuleName'] EXTERNAL POOL 'PoolName' EXEC 'InterfaceScript' [OPTS 'OptionsString ...'] [ESCAPE '%SpecialCharacters'] [SIZE sum-number]
- External list definition rule
RULE ['RuleName'] EXTERNAL LIST 'ListName' EXEC 'InterfaceScript' [OPTS 'OptionsString ...'] [ESCAPE '%SpecialCharacters'] [THRESHOLD 'ResourceClass'] [SIZE sum-number]