START STGRULE (Start a replication rule)

Edit online

Use this command to start processing replication 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=REPLICATE
  • ACTIONTYPE=NOREPLICATING
Tip: In the Operations Center, you can start processing a replication storage rule immediately by clicking Storage > Storage Rules, selecting a replication storage rule, and clicking Run Now.

Syntax

Read syntax diagramSkip visual syntax diagram STArt STGRule storage_rule_name DURation=NOLimitDURationNOLimitINHeritminutesFORCEREConcile=NoFORCEREConcile=NoYesFULLPreview=NoPreview=NoYesLISTfiles=NoLISTfiles=NoYesWait=NoWait=NoYes

Parameters

storage_rule_name (Required)
Specifies the name of the storage rule. The rule must be previously defined by using the DEFINE STGRULE command.
DURation
Specifies the maximum number of minutes that the storage rule runs before it is automatically canceled. This parameter is optional. You can specify one of the following values:
NOLimit
Specifies that the storage rule runs until processing is completed. This is the default value.
INHerit
Specifies that the maximum processing time is inherited from the storage rule definition.
minutes
Specifies the number of minute the storage rule is allowed to execute until the process is cancelled for exceeding duration limit. You can specify a number in the range 60 - 1440.
FORCEREConcile
Specifies whether to compare all files on the source replication server with files on the target replication server and to synchronize the files. After initial replication, you might use this parameter for the following reasons:
  • To synchronize files on the source and target replication servers if they are different.
  • To resynchronize files if you previously used or are currently using the policies on the target replication server to manage replicated files.
  • To resynchronize the files if the database is regressed to an earlier point in time by using a method other than the DSMSERV RESTORE DB command.
  • To rebind files to the new management class on the target replication server if this management class did not exist when the files were replicated. You must be using the policies that are defined on the target replication server to manage replicated files.
  • To remove all files from a target replication server for a node and file space that do not exist on the replication source replication server.

This parameter is optional. You can specify one of the following values:

No
Specifies that replication processing does not force a reconcile operation to compare all files on the source replication server with files on the target replication server. Instead, replication processing tracks file changes on the source replication server since the last replication process and synchronizes these changes on the target replication server. NO is the default value.
Yes
Specifies that replication processing forces a reconcile operation to compare all files on the source replication server with files on the target replication server and synchronizes the files.
FULL
Specifies that replication processing forces a reconcile operation to compare all files on the source replication server with files on the target replication server and synchronizes the files. Any files that do not exist on the source replication server are removed from the target replication server. Files might be removed for the following reasons:
  • As a result of filespace backup or import operations, files on the target replication server are no longer managed by replication processing.
  • Replication-related orphaned objects on the target replication server are no longer managed by replication processing.
Restriction: Objects are deleted from the target replication server when nodes and file spaces are recognized by a replication process but the objects are not recognized.
Preview
Specifies whether to preview data to be replicated. This parameter is optional. The default value is NO. You can specify one of the following values:
No
Specifies that the data is replicated to the target server but that the data is not previewed.
Yes
Specifies that data is previewed but not replicated. If you specify PREVIEW=YES, only volumes that must be physically mounted, such as tape volumes, are displayed. Volumes that are assigned to storage pools that have a device class of FILE are not displayed.

The following information is displayed in the output:

  • The names of client nodes whose data is eligible for replication.
  • The number of files that are eligible for replication or deletion.
  • The estimated amount of time it would take to complete the node replication process.
  • A list of volumes that would be mounted during replication processing.

If the client node data that is specified in a subrule that is bound to the replication storage rule was never replicated and you specify PREVIEW=YES, the node and its file spaces are automatically defined on the target replication server that is specified in the replication storage rule.

LISTfiles

Specifies whether to list the names of files that would be replicated. This parameter is optional. The default is NO. If you specify this parameter, you must also specify the WAIT=YES parameter setting.

You can specify one of the following values:

No
Specifies that the names of files that would be replicated are not displayed.
Yes
Specifies that the names of files that would be replicated are displayed.
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 replicate data

Start a storage rule that is named REPL_ACTION. 
start stgrule repl_action

Related commands

Table 1. Commands related to START STGRULE
Command Description
DEFINE STGRULE (replicating) Defines a storage rule for replicating data.
DELETE STGRULE Deletes storage rules.
QUERY STGRULE Displays storage rule information.
UPDATE STGRULE (replicating) Updates a storage rule for replicating data.
UPDATE SUBRULE (replicating) Updates a subrule that is an exception to a replicating storage rule.