Tivoli Header

Administrator's Reference

QUERY MACHINE (Query Machine Information)

Use this command to display information for one or more machines. You can use this information to recover TSM client machines in case of a disaster.

Note:
TSM does not use the information in any way. It is available only to help you plan for the disaster recovery of client machines.
TSM displays information for multiple machines in the following order:

Privilege Class

Any administrator can issue this command.

Syntax

                  .-*------------.
>>-Query MACHine--+--------------+--+-----------------------+--->
                  '-machine_name-'  '-BUilding--=--building-'
 
>--+-----------------+--+---------------+----------------------->
   '-FLoor--=--floor-'  '-ROom--=--room-'
 
>--+-----------------------+--+------------------------+-------->
   '-PRIority--=--priority-'  '-ADSMServer--=--+-Yes-+-'
                                               '-No--'
 
   .-Format--=--Standard-----------------.
>--+-------------------------------------+---------------------><
   '-Format--=--+-Standard-------------+-'
                +-Detailed-------------+
                +-RECOVERYInstructions-+
                '-CHaracteristics------'
 
 

Parameters

machine_name
Specifies the name of one or more machines to be queried. You can use wildcard characters to specify this name. This parameter is optional. The default is all machines that meet the specified criteria.

BUilding
Specifies the name or number of the building that the machines are in. This parameter is optional. Enclose the text in quotation marks if it contains any blank characters.

FLoor
Specifies the name or number of the floor that the machines are on. This parameter is optional. Enclose the text in quotation marks if it contains any blank characters.

ROom
Specifies the name or number of the room that the machines are in. This parameter is optional. The text can be up to 16 characters. Enclose the text in quotation marks if it contains any blank characters.

PRIority
Specifies the priority number of the machines. This parameter is optional.

ADSMServer
Specifies if the machine contains a TSM server. This parameter is optional. The default is to display any machines that meet the other criteria. Possible values are:

Yes
The machine contains a TSM server.

No
The machines do not contain a TSM server.

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

Standard
TSM displays partial information for the machines.

Detailed
TSM displays all information for the machines.

RECOVERYInstructions
TSM displays only machine recovery instructions. This option is valid only when querying a specific machine.

CHaracteristics
TSM displays only machine characteristics. This option is valid only when querying a specific machine.

Examples

Task 1

Display information for a machine named MACH1.

Command:
query machine MACH1

Output:
+--------------------------------------------------------------------------------+
|Machine  Machine  Building Floor Room  Node Name  Recovery                      |
|Name     Priority                                 Media Name                    |
|-------  -------- -------- ----- ----- ---------  ----------                    |
|MACH1       1       21       2   2929  VIRGINIA   RECMED1                       |
+--------------------------------------------------------------------------------+

Task 2

Display detailed information for all priority 1 machines on the second floor of building 21.

Command:
query machine * building=21 floor=2 priority=1 
format=detailed

Output:
+--------------------------------------------------------------------------------+
|                   Machine Name: MACH1                                          |
|               Machine Priority: 1                                              |
|                       Building: 21                                             |
|                          Floor: 2                                              |
|                           Room: 2929                                           |
|                        Server?: Yes                                            |
|                    Description: TSM server machine                             |
|                      Node Name: VIRGINIA                                       |
|            Recovery Media Name: RECMED1                                        |
|               Characteristics?: Yes                                            |
|         Recovery Instructions?: Yes                                            |
+--------------------------------------------------------------------------------+

where:

Machine Name
The name of the machine.

Machine Priority
The recovery priority of the machine.

Building
The building in which the machine is located.

Floor
The floor on which the machine is located.

Room
The room in which the machine is located.

Server?
Whether the machine contains a TSM server.

Description
A description of the machine.

Node Name
The TSM client nodes associated with this machine.

Recovery Media Name
The recovery media associated with this machine.

Characteristics?
Whether the characteristics text of the machine is stored in the database.

Recovery Instructions?
Specifies whether recovery instructions text for a machine is stored in the TSM database.

Related Commands

Table 159. Commands Related to QUERY MACHINE

Command Description
DEFINE MACHINE Defines a machine for DRM.
DEFINE MACHNODEASSOCIATION Associates a Tivoli Storage Manager node with a machine.
DEFINE RECMEDMACHASSOCIATION Associates recovery media with a machine.
DELETE MACHINE Deletes a machine.
INSERT MACHINE Inserts machine characteristics or recovery instructions into the Tivoli Storage Manager database.
UPDATE MACHINE Changes the information for a machine.


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