PROTECT STGPOOL (Protect data that belongs to a storage pool)

Use this command to protect data in directory-container storage pools by storing the data in another directory-container storage pool on the target server.

When you issue this command, data that is stored in the directory-container storage pool on the source server is backed up to a directory-container storage pool on the target server. By protecting the directory-container storage pool, you can repair damaged storage pools by using the REPAIR STGPOOL command.

Issue this command on the server that is the source server for data.

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-PROTect STGPool--source_stgpool------------------------------>

   .-FORCEREConcile--=--No------.   
>--+----------------------------+------------------------------->
   '-FORCEREConcile--=--+-No--+-'   
                        '-Yes-'     

   .-MAXSESSions--=--2-------------------.   
>--+-------------------------------------+---------------------->
   '-MAXSESSions--=----number_sessions---'   

   .-Preview--=--No------.  .-PURGEdata--=--No----------.   
>--+---------------------+--+---------------------------+------->
   '-Preview--=--+-No--+-'  '-PURGEdata--=--+-No------+-'   
                 '-Yes-'                    +-All-----+     
                                            '-Deleted-'     

   .-Wait--=--No------.   
>--+------------------+----------------------------------------><
   '-Wait--=--+-No--+-'   
              '-Yes-'

Parameters

source_stgpool (Required)

Specifies the name of the directory-container storage pool on the source server where you back up the data.

Restriction: You must specify the PROTECTSTGPOOL parameter on the DEFINE STGPOOL or UPDATE STGPOOL command to back up the data.

FORCEREConcile

Specifies whether to reconcile the differences between data extents in the directory-container storage pool on the source server and target server. This parameter is optional. The default value is NO. Specify one of the following values:

No: Specifies that data backup does not compare all data extents in the directory-container storage pool on the source server with data extents on the target server. Instead, data backup tracks changes to the data extents on the source server since the last backup and synchronizes these changes on the target server.
Yes: Specifies that data backup compares all data extents on the source server with data extents on the target server and synchronizes the data extents on the target server with the source server.

MAXSESSions

Specifies the maximum allowable number of data sessions that can send data to a target server. This parameter is optional. The value that you specify can be in the range 2 - 100. The default value is 2. If you increase the number of sessions, you can improve throughput for the storage pool.

When you set a value for the MAXSESSIONS parameter, ensure that the available bandwidth and the processor capacity of the source and target servers are sufficient.

Tips:

If you issue a QUERY SESSION command, the total number of sessions might exceed the number of data sessions. The difference is because of short control sessions that are used to query and set up operations.
The number of sessions that are used for protection depends on the amount of data that is backed up. If you are backing up only a small amount of data, there is no benefit to increasing the number of sessions.

Preview

Specifies whether to preview data. This parameter is optional. The default value is NO. Specify one of the following values:

No: Specifies that the data is backed up to the target server but that the data is not previewed.
Yes: Specifies that data is previewed but not backed up.

PURGEdata

Specifies that data extents are deleted from the target server. This parameter is optional. The default value is NO. You can specify one of the following values:

No: Specifies that data extents are not deleted from the target server.
All: Specifies that all data extents are deleted from the target server. Data extents that are referenced by other data in the target storage pool are not deleted.
Deleted: Specifies that data extents that were deleted on the source server are deleted from the target server. New data extents are not protected.

Wait

Specifies whether to wait for the server to process this command in the foreground. This parameter is optional. The default value is NO. You can specify one of the following values:

No: Specifies that the command is processed in the background. To monitor the background processes of this command, issue the QUERY PROCESS command.
Yes: Specifies that the command is processed in the foreground. Messages are not displayed until the command completes processing.
Restriction: You cannot specify WAIT=YES from the server console.

Example: Delete all data extents from the target server

Delete all data extents in a directory-container storage pool on the target server. The directory-container storage pool that is named POOL1 on the source server is no longer protected by the directory-container storage pool on the target server. You might delete all extents to clean the directory-container storage pool on the target server that no longer protects the source server.

protect stgpool pool1 purgedata=all

Example: Protect a storage pool and specify a maximum number of data sessions

Protect a storage pool that is named SPOOL1 on the source server by backing up the data to a target replication server, TPOOL1. Specify a maximum of 10 data sessions.

update stgpool spool1 protectstgpool=tpool1
protect stgpool spool1 maxsessions=10

Table 1. Commands related to PROTECT STGPOOL
Command	Description
DEFINE STGPOOL	Defines a storage pool as a named collection of server storage media.
DEFINE STGPOOLDIRECTORY	Defines a storage pool directory to a directory-container storage pool.
REPAIR STGPOOL	Repairs a storage pool.
REPLICATE NODE	Replicates data in file spaces that belong to a client node.
SET REPLSERVER	Specifies a target replication server.