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:

According to the priority specified.
Within a priority, according to the specified location and machine name.

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