QUERY SERVER (Query a server)

Use this command to display information about a server definition.

Privilege class

Any administrator can issue this command.

Syntax


                 .-*-----------.  .-Format--=--Standard-----.   
>>-Query SERver--+-------------+--+-------------------------+--><
                 '-server_name-'  '-Format--=--+-Standard-+-'   
                                               '-Detailed-'

Parameters

server_name

Specifies the name of the server to be queried. You can use wildcard characters to specify this name. This parameter is optional. The default is all server names.

Format

Specifies how the information is displayed. The parameter is optional. The default is STANDARD.

Standard: Specifies that partial information is displayed.
Detailed: Specifies that complete information is displayed.

Example: List all servers

Display information in standard format about all servers. See Field descriptions for field descriptions.

query server *

Server  Comm.   High-level  Low-level Days  Server   Virtual  Allow   
Name    Method  Address     Address   Since Password Volume   Replace-
                                      Last  Set      Password ment    
                                      Access         Set              
-------- ------ ----------- --------  ------ ------- -------- --------
SERVER_A TCPIP  9.115.35.6  1501         11  Yes      No       No     
SERVER_B TCPIP  9.115.45.24 1500         <1  Yes      No       No  
ASTRO    TCPIP  9.115.32.21 1500         24  Yes      No       No

Example: Display detailed information about a specific server

From a managed server, display detailed information about SERVER_A. See Field descriptions for field descriptions.

query server server_a format=detailed

                               
                                  Server Name: SERVER_A
                                 Comm. Method: TCPIP
                              Transfer Method: TCPIP
                           High-level Address: 9.115.4.15
                            Low-level Address: 1500
                                  Description:
                            Allow Replacement: No
                                    Node Name:
                        Last Access Date/Time: 07/09/2013 09:00:00
                       Days Since Last Access: <1
                                  Compression: Client's choice
                      Archive Delete Allowed?: No
                                          URL:
                       Registration Date/Time: 07/08/2013 09:15:09
                    Registering Administrator: $$CONFIG_MANAGER$$
                  Bytes Received Last Session: 362
                      Bytes Sent Last Session: 507
                     Duration of Last Session: 0.00
                  Pct. Idle Wait Last Session: 0.00
                 Pct. Comm. Wait Last Session: 0.00
                 Pct. Media Wait Last Session: 0.00
                        Grace Deletion Period: 5
                             Managing profile:
                          Server Password Set: Yes
                Server Password Set Date/Time: 07/08/2013 09:15:09
               Days Since Server Password Set: 1
             Invalid Sign-on Count for Server: 0
                  Virtual Volume Password Set: No
        Virtual Volume Password Set Date/Time: (?)
       Days Since Virtual Volume Password Set: (?)
Invalid Sign-on Count for Virtual Volume Node: 0
                            Validate Protocol: No
                                      Version: 7
                                      Release: 1                                
                                        Level: 0.0
                                      Role(s): Replication
                                          SSL: No

Field descriptions

Server Name: The name of the server.
Comm. Method: The communication method that is used to connect to the server.
Transfer Method: The method that is used for server-to-server data transfer.
High-level Address: The IP address (in dotted decimal format) of the server.
Low-level Address: The port number of the server.
Description: The server description.
Allow Replacement: Specifies whether a server definition on a managed server can be replaced with a definition from a configuration manager.
Node Name: The name of the client node.
Last Access Date/Time: The last date and time that the client node accessed the server.
Days Since Last Access: The number of days since the client node accessed the server.
Compression: The type of compression that is completed by IBM Spectrum Protect™ on client files.
Archive Delete Allowed?: Specifies whether the client node can delete its own archive files. A value of (?) denotes that this field is not set and does not apply to this definition.
URL: The URL used to access this server from a web browser-based interface.
Registration Date/Time: The date and time that the client node was registered.
Registering Administrator: The name of the administrator that registered the client node.
Bytes Received Last Session: The number of bytes received by the server during the last client node session.
Bytes Sent Last Session: The number of bytes sent to the client node.
Duration of Last Session: The length of the last client node session, in seconds.
Pct. Idle Wait Last Session: The percentage of the total session time during which the client did not complete any functions.
Pct. Comm. Wait Last Session: The percentage of the total session time that the client waited for a response from the server.
Pct. Media Wait Last Session: The percentage of the total session time that the client waited for a removable volume to be mounted.
Grace Deletion Period: The number of days an object remains on the target server after it is marked for deletion.
Managing Profile: The profile from which the managed server got the definition of this server.
Server Password Set: Specifies whether the password for the server is set.
Server Password Set Date/Time: Specifies when the password for the server is set.
Days since Server Password Set: The number of days since the server password was set.
Invalid Sign-on count for Server: The maximum number of invalid sign-on attempts that the server can accept.
Virtual Volume Password Set: Specifies whether the password used to log on to the target server is set.
Virtual Volume Password Set Date/Time: Specifies when the password for virtual volume support is set.
Days Since Virtual Volume Password Set: The number of days since the password for virtual volume support was set.
Invalid Sign-on Count for Virtual Volume Node: The maximum number of invalid sign-on attempts that are accepted on the target server.
Validate Protocol: Specifies whether the storage agent has the data validation function enabled.
Version: The software version of the IBM Spectrum Protect server.
Release: The software release of the IBM Spectrum Protect server.
Level: The software level of the IBM Spectrum Protect server.
Role(s): The role of the server. For example, one of the roles that the server is used for is replication.
SSL: Specifies whether Secure Sockets Layer (SSL) communication is used.

Related commands

Table 1. Commands related to QUERY SERVER
Command	Description
DEFINE DEVCLASS	Defines a device class.
DEFINE SERVER	Defines a server for server-to-server communications.
DELETE DEVCLASS	Deletes a device class.
DELETE FILESPACE	Deletes data associated with client file spaces. If a file space is part of a collocation group and you remove the file space from a node, the file space is removed from the collocation group.
DELETE SERVER	Deletes the definition of a server.
PROTECT STGPOOL	Protects a directory-container storage pool.
QUERY NODE	Displays partial or complete information about one or more clients.
RECONCILE VOLUMES	Reconciles source server virtual volume definitions and target server archive objects.
REGISTER NODE	Defines a client node to the server and sets options for that user.
REMOVE NODE	Removes a client from the list of registered nodes for a specific policy domain.
REPLICATE NODE	Replicates data in file spaces that belong to a client node.
SET REPLSERVER	Specifies a target replication server.
UPDATE DEVCLASS	Changes the attributes of a device class.
UPDATE NODE	Changes the attributes that are associated with a client node.
UPDATE SERVER	Updates information about a server.