UPDATE STGRULE (Update a rule for auditing a storage pool)

Use this command to update a rule that schedules audit operations for a storage pool.

Privilege class

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

Syntax


                              .-DELAY--=--7-----.   
>>-UPDate STGRULE--rule_name--+-----------------+--------------->
                              '-DELAY--=--delay-'   

   .-AUDITType--=--Extent-.  .-AUDITLevel--=--5-----.   
>--+----------------------+--+----------------------+----------->
                             '-AUDITLevel--=--+-1-+-'   
                                              '-5-'     

   .-STARTTime--=--current_time-.  .-ACTIVE--=--Yes-----.   
>--+----------------------------+--+--------------------+------->
   '-STARTTime--=--time---------'  '-ACTIVE--=--+-No--+-'   
                                                '-Yes-'     

>--+-----------------------------+-----------------------------><
   '-DESCription--=--description-'

Parameters

rule_name (Required)

Specifies the name of the storage rule. The name must be unique, and the maximum length is 30 characters.

DELAY

Specifies the interval, in days, between audit operations. This parameter is optional. The default value is 7 days. You can specify an integer in the range 1 - 9999.

AUDITType

Specifies the audit type. This parameter is optional. You can specify the following value:

Extent: Specifies that only extents are audited. This is the default value.
Restriction: In IBM Spectrum Protect™ Version 8.1.5, you can use the audit storage rule only to audit extents. Objects are not audited.

AUDITLevel

Specifies the level of the audit. This parameter is optional. The following values are possible:

1: Specifies a minimal audit operation of the extents in the storage pool.
5: Specifies a full audit operation of the extents in the storage pool. This is the default value.

STARTTime

Specifies the time for the beginning of the window in which the storage rule is first processed. The default is the current time. This parameter is optional.

You can 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 storage rule processing occurs. This parameter is optional. The following values are possible:

Yes: Specifies that the storage rule is active. The storage rule is processed at the scheduled time. This is the default value.
No: Specifies that the storage rule is inactive. The storage rule is not processed at the scheduled time.

DESCription: Specifies a description of the storage rule. This parameter is optional. The maximum length of the description is 255 characters. If the description includes spaces, enclose the description in quotation marks.

Update a rule for an extent-level audit operation

Update a storage rule, AUDITACCOUNTING, to schedule a full, extent-level audit of data starting at 3 AM. The audit operation takes place every 14 days:

update stgrule auditaccounting delay=14 auditlevel=5 starttime=03:00:00

Related commands

Table 1. Commands related to UPDATE STGRULE
Command	Description
DELETE STGRULE	Deletes storage rules.
QUERY STGRULE	Displays storage rule information.
UPDATE STGRULE (auditing)	Updates a storage rule for auditing storage pools.