Tivoli Storage Manager for Windows: Administrator's Reference
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 192. Commands Related to QUERY MACHINE
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]