QUERY REPLNODE (Display information about replication status for a client node)

Use this command to display the number of files that are stored for each replicated file space. Information is displayed about file spaces for every client node that is configured for replication.

Privilege class

Any administrator can issue this command.

Syntax

Parameters

node_name (Required)

Specifies the client node that owns the files about which you want information. You can specify one or more names. If you specify multiple names, separate the names with commas. Do not use intervening spaces. You can specify an asterisk (*) to query all applicable client nodes.

Information about client nodes that match the file criteria, but that are not configured for replication, is not displayed.

target_server_name

Specifies the name of the target replication server to query for replication information. This parameter is optional. If you do not specify a value for this parameter, all servers that are configured to the client node as target replication servers are listed.

As the value for this parameter, you can also specify a server that was formerly a target for replicated data.

The client nodes that are defined to a replication server can be the source or the target of replicated data. To determine whether a particular client node is sending or receiving data, issue the QUERY NODE command. Look for the value Send or Receive in the Replication Mode field of the output.

To display the name of the active target replication server, issue the QUERY REPLSERVER command, and look for the name in the Server Name field.

Example 1: Display information about the file spaces of the client node and all target replication servers

The DEFINE STGRULE command was used to configure replication from a client node, NODE1, to two target replication servers, DALLAS-DR and PHOENIX-DR. Run a query to display information about NODE1, including its file spaces and target replication servers.

query replnode node1

Node      Type     Filespace   FSID            Files on              Files on   Target Replication
Name                    Name                     Source    Target Replication              Server 
                                     Replication Server                Server                     
--------- ---- -------------   ----  ------------------    ------------------   ------------------
NODE1     Bkup         /data      1                  10                     0            DALLAS-DR

Node      Type     Filespace   FSID            Files on              Files on   Target Replication
Name                    Name                     Source    Target Replication              Server 
                                     Replication Server                Server                     
--------- ---- -------------   ----  ------------------    ------------------   ------------------
NODE1     Bkup         /data      1                  10                    10           PHOENIX-DR

The number of files that are displayed for target replication servers might differ from the expected results for the following reasons:

The output of the QUERY REPLNODE command displays file counts that are obtained from the occupancy table. The occupancy table lists only files that have a size greater than 0 bytes. Files that have a size of 0 bytes and that have been replicated are not reflected in this output.
If only active data is replicated to the target replication server, the file count that is displayed for the source replication server will be larger than the file count that is displayed on the target replication server. The reason for the difference is that the source replication server has both active and inactive data, and the target replication server has only active data.
A client node might have data that was exported from the source replication server and imported to the target replication server. If that data was synchronized and if the client node also stored data on the target replication server, the number of files on the target replication server will be greater than the number of files stored as a result of export-and-import operations and replication.
When you replicate node data from a source replication server earlier than version 7.1 to a target replication server at version 7.1 or later, files that are larger than 10 GB are split into smaller files if the SPLITLARGEOBJECTS parameter for the node definition is set to YES. Each of these split files is counted on the target replication server.

Example 2: Display information about the file space of the client node and a specified target replication server

Display information for a client node, NODE2, and one of its specified target replication servers, SEATTLE-DR.

query replnode node2 seattle-dr

Node      Type     Filespace   FSID            Files on              Files on   Target Replication
Name                    Name                     Source    Target Replication              Server 
                                     Replication Server                Server                     
--------- ---- -------------   ----  ------------------    ------------------   ------------------
NODE2     Bkup         /data      1                  10           unavailable           SEATTLE-DR
                                                                                       unavailable

In the example, you can see the status of the target replication server, SEATTLE-DR, is unavailable. Because the target replication server is unavailable, the number of files on the server cannot be determined.

Field descriptions

Node Name

The name of the client node that owns the files.

Type

The type of data. If this field is blank, the client node is configured for replication, but it does not have data on the source replication server.

The following values are possible:

Arch: Archive data
Bkup: Backup data
SpMg: Data that was migrated by IBM Spectrum® Protect for Space Management clients.

Filespace Name

The name of the file space that belongs to the node.

If this field is blank, the client node is configured for replication, but it does not have data on the source replication server.

File space names can be in a different code page or locale than the server. If they are, the names in the Operations Center and the administrative command-line interface might not be displayed correctly. Data is backed up and can be restored normally, but the file space name or file name might be displayed with a combination of invalid characters or blank spaces.

If the file space name is Unicode-enabled, the name is converted to the server code page for display. The success of the conversion depends on the operating system, the characters in the name, and the server code page. Conversion can be incomplete if the string includes characters that are not available in the server code page or if the server cannot access system conversion routines. If the conversion is incomplete, the name might contain question marks, blanks, unprintable characters, or ellipses (...).

FSID

The file space identifier for the file space. The server assigns a unique FSID when a file space is initially stored on the server. If this field is blank, the client node is configured for replication, but it does not have data on the replication server.

Files on Source Replication Server

The number of backup, archive, and space-managed files on the server on which this command is issued. If this field is blank, the client node is configured for replication, but it does not have data.

Files on Target Replication Server

The number of files for that are stored on the target replication server. If the target replication server is unavailable, the field value is specified as unavailable.

If the field value is 0, one or more of the following conditions might exist:

The target replication server has no data.
The client node is not defined on any target replication server.
The client node is defined on a target replication server, but the node is not configured for replication.
The corresponding file space on the source replication server does not have data or the file space is not defined.

Target Replication Server

The name of the server that is being queried. If the target replication server is unavailable, the field value is specified as unavailable along with the server name.

Related commands

Table 1. Commands related to QUERY REPLNODE
Command	Description
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 REPLRULE	Displays information about node replication rules.
REPLICATE NODE	Replicates data in file spaces that belong to a client node.
UPDATE REPLRULE	Enables or disables replication rules.