Tivoli Storage Manager for Windows: 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--=--+-Client-+-'
'-Detailed-' +-NAS----+
+-Server-+
'-Any----'
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:
- Any
- Specifies any type of node.
- Client
- Specifies client nodes that are backup-archive or HSM clients.
- |NAS
- |Specifies NAS nodes.
- Server
- Specifies client nodes that are other TSM servers.
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 WinNT STANDARD 1 1 No |
| |
+--------------------------------------------------------------------------------+
where:
- Node Name
- Specifies the name of the client node.
- Platform
- Specifies the client node's platform that was backed up last.
A question mark (?) is displayed until the client node first accesses the
server and reports its platform type.
- 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 |
| Auto Filespace Rename: 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.
|This field does not apply to NAS nodes.
- 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.
- Note:
- |This does not apply to NAS nodes.
|
- 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.
|This field does not apply to NAS nodes.
- Bytes Sent Last Session
- Specifies the number of bytes sent to the client node.
|This field does not apply to NAS nodes.
- Duration of Last Session (sec)
- Specifies how long the most recent client node session lasted.
|This field does not apply to NAS nodes.
- Pct. Idle Wait Last Session
- Specifies the percentage of the total session time that the client was not
performing any functions.
|This field does not apply to NAS nodes.
- Pct. Comm. Wait Last Session
- Specifies the percentage of the total session time that the client waited
for a communication response from the server.
|This field does not apply to NAS nodes.
- Pct. Media Wait Last Session
- Specifies the percentage of the total session time that the client waited
for a removable volume to be mounted.
|This field does not apply to NAS nodes.
- 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), Server (a TSM server), or NAS (a NAS
file 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.
- Auto Filespace Rename
- Specifies whether the client is prompted for renaming file spaces when the
client system upgrades to a client that supports Unicode. This field is
valid only for client systems that use Windows NT or Windows 2000 operating
systems.
Related Commands
Table 196. 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 a 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 ]