Administrator's Reference

QUERY SERVER (Query a Server)

Use this command to display information about a server definition.

Privilege Class

Any administrator can issue this command.

Syntax

                   .-*-----------.
>>-Query SERver----+-------------+------------------------------>
                   '-server_name-'
 
      .-Format--=--Standard-----.
>-----+-------------------------+------------------------------><
      '-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.

Examples

Task 1

Display information in standard format about all servers.

Command:
query server *

Output:
+--------------------------------------------------------------------------------+
|Server  Comm.  High-level    Low-level   Days Server   Virtual  Allow           |
|Name    Method Address       Address    Since Password Volume Replacement       |
|                                          Last Set     Password                 |
|                                        Access         Set                      |
|-------- ------ ------------- --------- ------ -------- -------- --------       |
|SERVER_A TCPIP  9.115.35.6    1501         11  Yes      No       No             |
|SERVER_B TCPIP  9.115.45.247  1500         <1  Yes      No       No             |
|ASTRO    TCPIP  9.115.32.210  1500         24  Yes      No       No             |
+--------------------------------------------------------------------------------+

Task 2

From a managed server, display detailed information about SERVER_A.

Command:
query server server_a format=detailed

Output:
+--------------------------------------------------------------------------------+
|                                  Server Name: SERVER_A                         |
|                                 Comm. Method: TCPIP                            |
|                           High-level Address: 9.115.4.15                       |
|                            Low-level Address: 1500                             |
|                                  Description:                                  |
|                            Allow Replacement:                                  |
|                                    Node Name:                                  |
|                        Last Access Date/Time: 06/09/1998 12:51:51              |
|                       Days Since Last Access: <1                               |
|                                      Locked?:                                  |
|                                  Compression: Client's Choice                  |
|                      Archive Delete Allowed?: No                               |
|                                          URL:                                  |
|                       Registration Date/Time: 06/09/1998 12:51:51              |
|                    Registering Administrator: $$CONFIG_MANAGER$$               |
|                  Bytes Received Last Session: 0                                |
|                      Bytes Sent Last Session: 0                                |
|               Duration of Last Session (sec): 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 Date/Time:                                  |
|               Days since Server Password Set:                                  |
|             Invalid Sign-on count for Server:                                  |
|                  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                                |
+--------------------------------------------------------------------------------+

where:

Server Name
The name of the server.

Communication Method
The communication method used to connect to the server.

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

Locked?
Whether the client node is locked out of TSM.

Compression
The type of compression performed by TSM on client files.

Archive Delete Allowed?
Whether the client node can delete its own archive files.

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 (sec)
The length of the last client node session, in seconds.

Pct. Idle Wait Last Session
The percentage of the total session time that the client was not performing 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
How many days an object remains on the target server after it has been marked for deletion.

Managing Profile?
The profile from which the managed server got the definition of this server.

Server Password Set Date/Time
When the server's password was 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 will accept.

Virtual Volume Password Set:
Whether the password used to sign on to the target server has been set.

Virtual Volume Password Set Date/Time:
When the password for virtual volume support was last 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.

Related Commands

Table 173. 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 name.
DELETE FILESPACE Deletes data associated with client's filespaces.
DELETE SERVER Deletes the definition of a server.
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 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.
UPDATE DEVCLASS Changes the attributes of a device class.
UPDATE NODE Changes the attributes associated with a client node.
UPDATE SERVER Updates information about a server.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]