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
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. |