Tivoli Storage Manager for Sun Solaris Administrator's Reference

QUERY NODE (Query Nodes)

Use this command to display information about one or more registered nodes.

Privilege Class

Any administrator can issue this command.

Syntax

                 .-*---------.
>>-Query Node----+-----------+---------------------------------->
                 '-node_name-'
 
>-----+--------------------------------+------------------------>
      |            .-,--------------.  |
      |            V                |  |
      '-DOmain--=-----domain_name---+--'
 
      .-Format--=--Standard-----.   .-Type--=--Client-----.
>-----+-------------------------+---+---------------------+----->
      '-Format--=--+-Standard-+-'   '-Type--=--+-Server-+-'
                   '-Detailed-'                +-Client-+
                                               '-Any----'
 
      .-KEEPMP--=--No------.
>-----+--------------------+-----------------------------------><
      '-KEEPMP--=--+-No--+-'
                   '-Yes-'
 

Parameters

node_name
Specifies the name of the client node to be queried. You can use wildcard characters to specify this name. All matching client nodes are queried. If you do not specify a value for this parameter, all client nodes are queried. The parameter is optional.

DOmain
Specifies a list of policy domains that limit the client node query. Only nodes that are assigned to one of the specified policy domains are displayed. This parameter is optional. Separate the items in the list by commas, with no intervening spaces. You can use wildcard characters to specify a domain. All clients assigned to a matching domain are displayed. If you do not specify a value for this parameter, all policy domains are included in the query.

Format
Specifies how the information is displayed. This parameter is optional. The default value is STANDARD. Possible values are:

Standard
Specifies that partial information is displayed for the specified client nodes.

Detailed
Specifies that complete information is displayed for the specified client nodes.

Type
Specifies the type of node to include in the query results. The parameter is optional. The default value is CLIENT. Possible values are:

Client
Specifies client nodes that are backup-archive or HSM clients.

Server
Specifies client nodes that are other TSM servers.

Any
Specifies any type of node.

KEEPMP
Specifies the type of mount point to include in the query results. The parameter is optional. The default value is NO. Possible values are:

Yes
Specifies the client nodes that must retain the mount point during the entire session. If policy definitions cause data to be stored to a disk storage pool after storing data to a sequential access storage pool, any mount points held by the session will not be released.

No
Specifies the client nodes that release the mount point during the session. If policy definitions cause data to be stored to a disk storage pool after storing data to a sequential access storage pool, any mount points held by the session will be released.

Examples

Task 1

Display information on all registered client nodes.

Command:
query node

Output:
 

+--------------------------------------------------------------------------------+
|Node Name   Platform  Policy Domain  Days Since  Days Since  Locked?            |
|                      Name                 Last    Password                     |
|                                         Access         Set                     |
|---------   --------  --------        ---------   ---------- ---------          |
|CLIENT1       AIX     STANDARD               6            6    No               |
|GEORGE        AIX     STANDARD               1            1    No               |
|JANET         AIX     STANDARD               1            1    No               |
|JOEOS2        (?)     STANDARD              <1           <1    No               |
|TOMC          (?)     STANDARD               1            1    No               |
+--------------------------------------------------------------------------------+

where:

Node Name
Specifies the name of the client node.

Platform
Specifies the platform of the client node. A question mark (?) is displayed until the client node first accesses the server and reports its platform type.
Note:After a node initially accesses the server and reports its platform type, the platform type will be constant, even if the node platform subsequently changes.

Policy Domain Name
Specifies the name of the policy domain to which the client node is assigned.

Days Since Last Access
Specifies the number of days that have elapsed since the last time the client node accessed the server.

Days Since Password Set
Specifies the number of days that have elapsed since the client node's password was set.

Locked?
Specifies whether the client node is locked out of TSM.

Task 2

Display complete information on the client node named JOE.

Command:
query node joe format=detailed

Output:

+--------------------------------------------------------------------------------+
|                                                                                |
|                     Node Name: JOE                                             |
|                      Platform: WinNT                                           |
|               Client OS Level: 4.00                                            |
|                Client Version: Version 3, Release 1, Level 3.0                 |
|            Policy Domain Name: STANDARD                                        |
|         Last Access Date/Time: 05/19/1999 18:55:46                             |
|        Days Since Last Access: 6                                               |
|        Password Set Date/Time: 05/19/1999 18:26:43                             |
|       Days Since Password Set: 6                                               |
|         Invalid Sign-on Count: 0                                               |
|                       Locked?: No                                              |
|                       Contact:                                                 |
|                   Compression: Client's Choice                                 |
|       Archive Delete Allowed?: Yes                                             |
|        Backup Delete Allowed?: No                                              |
|        Registration Date/Time: 05/19/1999 18:26:43                             |
|     Registering Administrator: SERVER_CONSOLE                                  |
|Last Communication Method Used: Tcp/Ip                                          |
|   Bytes Received Last Session: 108,731                                         |
|       Bytes Sent Last Session: 698                                             |
|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                                            |
|                     Optionset:                                                 |
|                           URL: http://client.host.name:1581                    |
|                     Node Type: Client                                          |
|    Password Expiration Period: 60                                              |
|             Keep Mount Point?: No                                              |
|  Maximum Mount Points Allowed: 2                                               |
+--------------------------------------------------------------------------------+

where:

Node Name
Specifies the name of the client node.

Platform
Specifies the platform of the client node. A question mark (?) is displayed until the client node first accesses the server and reports its platform type.
Note:After a node initially accesses the server and reports its platform type, the platform type will be constant, even if the node platform subsequently changes.

Client OS Level
Specifies the level of the client's operating system.

Client Version
Specifies the version of the client you have installed.

Policy Domain Name
Specifies the client node's assigned policy domain.

Last Access Date/Time
Specifies the last date and time that the client node accessed the server.

Days Since Last Access
Specifies the number of days that have elapsed since the last time the client node accessed the server.

Password Set Date/Time
Specifies the date and time that the client node's password was set.

Days Since Password Set
Specifies the number of days that have elapsed since the client node's password was set.

Invalid Sign-on Count
Specifies the number of invalid sign-on attempts that have been made since the last successful sign-on. This count can only be non-zero when an invalid password limit (SET INVALIDPWLIMIT) is greater than zero. When the number of invalid attempts equals the limit set by the SET INVALIDPWLIMIT command, the node is locked out of the system.

Locked?
Specifies whether the client node is locked out of TSM.

Contact
Specifies any contact information for the client node.

Compression
Specifies whether compression is enabled.

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

Backup Delete Allowed?
Specifies whether the client node can delete its own backup files.

Registration Date/Time
Specifies the date and time that the client node was registered.

Registering Administrator
Specifies the name of the administrator that registered the client node.

Last Communication Method Used
Specifies the communication method that was last used by the client node.

Bytes Received Last Session
Specifies the number of bytes received by the server during the last client node session.

Bytes Sent Last Session
Specifies the number of bytes sent to the client node.

Duration of Last Session (sec)
Specifies how long the most recent client node session lasted.

Pct. Idle Wait Last Session
Specifies the percentage of the total session time that the client was not performing any functions.

Pct. Comm. Wait Last Session
Specifies the percentage of the total session time that the client waited for a communication response from the server.

Pct. Media Wait Last Session
Specifies the percentage of the total session time that the client waited for a removable volume to be mounted.

Optionset
Specifies the name of the client option set.

URL
Specifies the client's Uniform Resource Locator (URL) address that the administrator can contact from the administrative web interface.

Node Type
Specifies the type of client node. The value is either Client (backup-archive client or HSM client) or Server (a TSM server).

Password Expiration Period
Specifies the client node's password expiration period.

Keep Mount Point?
Specifies the client node's ability to retain a mount point during a session.

Maximum Mount Points Allowed
Specifies the mount points a client node is allowed to use on the server. If a client node is registered under Version 3.7, the value will be between 0 -999, depending on the value that is set with the MAXNUMMP parameter of the REGISTER NODE command. If the client node was registered under previous versions of ADSM and the MAXNUMMP parameter was not explicity set using the UPDATE NODE command, then the value is set to NOLIMIT.

Related Commands

Table 186. Commands Related to QUERY NODE

Command Description
LOCK NODE Prevents a client from accessing the server.
QUERY ADMIN Displays information about one or more TSM administrators.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.
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.
RENAME NODE Changes the name for an existing user that belongs to a specific policy domain.
SET INVALIDPWLIMIT Sets the number of invalid logon attempts before a node is locked.
SET MINPWLENGTH Sets the minimum length for client passwords.
UNLOCK NODE Enables a locked user in a specific policy domain to access the server.
UPDATE NODE Changes the attributes associated with a client node.


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