QUERY MACHINE (Query machine information)

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

Attention: Tivoli Storage Manager does not use the information in any way. It is available only to help you plan for the disaster recovery of client machines.

Tivoli Storage Manager 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 Tivoli Storage Manager 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 Tivoli Storage Manager server.
No: The machines do not contain a Tivoli Storage Manager server.

Format

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

Standard: Tivoli Storage Manager displays partial information for the machines.
Detailed: Tivoli Storage Manager displays all information for the machines.
RECOVERYInstructions: Tivoli Storage Manager displays only machine recovery instructions. This option is valid only when querying a specific machine.
CHaracteristics: Tivoli Storage Manager displays only machine characteristics. This option is valid only when querying a specific machine.

Example: Display information for a specific machine

Display information for a machine named MACH1. See Field descriptions for field descriptions.

query machine MACH1

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

Example: Display detailed information for priority 1 machines

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

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

                   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

Field descriptions

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 Tivoli Storage Manager server.
Description: A description of the machine.
Node Name: The Tivoli Storage Manager 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 Tivoli Storage Manager database.

Related commands

Table 1. 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.