Administrator's Reference
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://JOE:2121 |
| Node Type: Client |
| Password Expiration Period: 60 |
| Keep Mount Point?: 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.
|
- 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.
Related Commands
Table 180. 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 ]