UPDATE SUBRULE (Update a subrule for copying data)

Use this command to define an exception to a storage rule for copying data.

Privilege class

To issue this command, you must have system privilege.

Syntax

Notes:

¹ You can specify the ADDFILESPACE parameter only if the ADDNODE parameter is also specified.
² You can specify the REMFILESPACE parameter only if the REMNODE parameter is also specified.

Parameters

parent_rule_name (Required)

Specifies the name of the parent storage rule.

subrule_name (Required)

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

ACTiontype (Required)

Specifies the subrule type. You must specify one of the following values:

COPY: Specifies that you can copy data from a container storage pool to a sequential-access copy storage pool.
NOCopying: Specifies that you cannot copy data from a container storage pool to a sequential-access copy storage pool.

MAXPRocess

Specifies the maximum number of parallel processes for the subrule. This parameter is optional. You can enter a value in the range 1 - 99. The default value is 2.

Restriction: You can specify this parameter only when the ACTIONTYPE=COPY parameter is specified.

TARGETSTGpool

Specifies the name of the sequential-access copy storage pool. This parameter is optional. The name must be unique, and the maximum length is 30 characters. By default, the target storage pool is the value that was specified on the parent rule.

Restriction: You can specify this parameter only when the ACTIONTYPE=COPY parameter is specified.

ADDNode

Specifies the name of a node to add to the subrule. This parameter is optional.

ADDFilespace

Specifies one or more file spaces. This parameter is optional. You can use wildcard characters. The specified value can have a maximum of 1024 characters. You can specify one of the following values:

*: Specify an asterisk (*) to specify all file spaces or IDs. This is the default.
filespace_name: Specifies the name of the file space.
fsid: Specifies the name of a file space identifier (FSID). This parameter is valid for clients with file spaces that are in Unicode format. Do not specify both file space names and FSIDs on the same command.

For clients with file spaces that are in Unicode format, you can enter either a file space name or an FSID. If you enter a file space name, the server might have to convert the file space name that you enter. For example, the server might have to convert the name that you enter from the server's code page to Unicode.

When you specify nodes and file spaces, the following rules apply:

You can specify a single node and a single file space, which corresponds to an existing virtual machine.
You can specify a single node and all file spaces by using an asterisk (*) as a wildcard to represent all file spaces, or by entering no value to include all file spaces.
You can specify a comma-delimited list of nodes and no file space to include all file spaces.
You can specify a single node and a file space name with one or more asterisks in the file space name. The asterisks can be placed in any part of the name.
If you use wildcard characters in a file space name, you cannot specify wildcard patterns that might result in overlapping node and file space pairs. Each wildcard pattern can specify one or more node and file space pairs, but the pairs in one pattern cannot overlap the pairs in another pattern. For example, you cannot specify node NODE1 and file space ABC* in one subrule, and specify node NODE1 and file space A* in the same subrule or in a different subrule.

REMNode

Specifies the name of a node to remove from the subrule. This parameter is optional.

REMFilespace

Specifies the name of a file space to remove from the subrule. This parameter is optional.

NAMEType

Specifies how you want the server to interpret the file space names that you enter. Use this parameter when IBM Spectrum® Protect clients have file spaces that are in Unicode format, and are on Windows, NetWare, or Macintosh OS X operating systems. This parameter is optional.

This parameter is required if you specify a node name and a file space name or FSID.

Restriction: When you specify this parameter, the file space name cannot contain an asterisk.

You can specify one of the following values:

SERVER: The server uses the server's code page to interpret the file space names. This is the default.
UNIcode: The server converts the file space name that is entered from the server code page to the UTF-8 code page. The success of the conversion depends on the characters in the name and the server's code page.
Restriction: Conversion can fail if the string includes characters that are not available in the server code page, or if the server cannot access system conversion routines.
FSID: The server interprets the file space names as their FSIDs.

CODEType

Specifies the type of file spaces to include in the subrule. The default value is BOTH, which specifies that file spaces are included regardless of code page type. Use this parameter only when you enter an asterisk to display information about all file spaces. This parameter is optional. You can specify one of the following values:

UNIcode: Include file spaces that are in Unicode format.
NONUNIcode: Include file spaces that are not in Unicode format.
BOTH: Include file spaces regardless of code page type.

Update a subrule

The storage rule OLDROSTERS is used to copy old employee rosters from a container storage pool to tape. The PRIORITY subrule was defined to ensure that current rosters, which are stored on the NODE1 node, remain in local storage. Update the subrule to ensure that rosters on both NODE1 and NODE2 remain in local storage.

update subrule oldrosters priority addnode node2 actiontype=nocopying

Related commands

Table 1. Commands related to UPDATE SUBRULE
Command	Description
DEFINE SUBRULE (copying)	Defines an exception to a copy storage rule.
DELETE SUBRULE	Deletes subrules.
UPDATE STGRULE (copying)	Updates a copy storage rule.
QUERY SUBRULE	Displays information about subrules.