QUERY REPLFAILURES (Query data about replication failures)

Use this command to display a list of client nodes that failed to replicate. Issue this command on the server that acts as a source for replicated data.

When you issue this command, you will see which client nodes failed during the replication process. Files that failed to replicate from the source server to the target server are displayed during this process.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram Query REPLFAILures ,node_namenode_group_nameType=SummaryType=SummaryObjects

Parameters

node_name or node_group_name
Specifies the name of the client node or defined group of client nodes that you want to verify. This parameter is optional. You can also specify a combination of client node names and client-node group names. To specify multiple client node names or client-node group names, separate the names with commas with no intervening spaces. You can use wildcard characters with client node names but not with client-node group names.
Type
Specifies the output format. This parameter is optional. The default value is SUMMARY. You can specify one of the following values:
Summary
Specifies that summarized status is displayed.
Objects
Specifies that a full report is displayed of all objects that failed to replicate.

Example: Display a summary about a specific replication failure

Display a summary about the NODE2 replication failure. See Field descriptions for field descriptions.
query replfailures node2
                    
                          Node Name: NODE2
                               FSID: 1
                          Source RC: 3024
              Source RC Explanation: The bitfile is damaged
                          Target RC: 1062
              Target RC Explanation: The replication transaction is not being processed
                       Object Count: 3

Example: Display details about all replication failures

Display detailed information about all replication failures on NODE2. See Field descriptions for field descriptions.
query replfailures node2 type=objects 
    
          Object Name: \PROJECTS\A.txt
            Object ID: 256004
           Time Stamp: 04/16/2018 14:50:36
            Node Name: NODE2
                 FSID: 1
            Source RC: 3224
Source RC Explanation: The bitfile is damaged
            Target RC: 1062
Target RC Explanation: The replication transaction is not being processed

          Object Name: \PROJECTS\B.txt
            Object ID: 256005
           Time Stamp: 04/16/2018 14:50:36
            Node Name: NODE2
                 FSID: 1
            Source RC: 3224
Source RC Explanation: The bitfile is damaged
            Target RC: 3014
Target RC Explanation: An unknown error occurred during an attempt to store a              
                       file on the target replication server. The possible cause 
                       is a failed write operation to disk storage

Field descriptions

Node Name
The name of the client node whose data is displayed.
Time Stamp
The date and time when the object starts to be replicated.
FSID
The file space identifier (FSID).
Object Name
The name of the object that failed to replicate.
Object ID
The object identifier.
Source RC
The error code.
Source RC Explanation
The reason why the node on the source server was not replicated.
Target RC
The error code.
Target RC Explanation
The reason why the target server was unable to store data for the node.

Related commands

Table 1. Commands related to QUERY REPLFAILURES
Command Description
CANCEL PROCESS Cancels a background server process.
CANCEL REPLICATION Cancels node replication processes.
QUERY FILESPACE Displays information about data in file spaces that belong to a client.
QUERY NODE Displays partial or complete information about one or more clients.
QUERY REPLICATION Displays information about node replication processes.
QUERY REPLNODE Displays information about the replication status of a client node.
QUERY REPLRULE Displays information about node replication rules.
QUERY SERVER Displays information about servers.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.
REGISTER NODE Defines a client node to the server and sets options for that user.
REMOVE REPLNODE Removes a node from replication.
PROTECT STGPOOL Protects a directory-container storage pool.
SET REPLRECOVERDAMAGED Specifies whether node replication is enabled to recover damaged files from a target replication server.
UPDATE FILESPACE Changes file-space node-replication rules.
UPDATE NODE Changes the attributes that are associated with a client node.
UPDATE REPLRULE Enables or disables replication rules.
VALIDATE REPLICATION Verifies replication for file spaces and data types.