DEFINE MACHINE (Define machine information for disaster recovery)

Use this command to save disaster recovery information for a server or client node machine. This information will be included in the plan file to help you recover your machines.

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-DEFine MACHine--machine_name--------------------------------->

>--+-----------------------------+--+-----------------------+--->
   '-DESCription--=--description-'  '-BUilding--=--building-'   

>--+-----------------+--+---------------+----------------------->
   '-FLoor--=--floor-'  '-ROom--=--room-'   

   .-PRIority--=--50---------.  .-ADSMServer--=--No------.   
>--+-------------------------+--+------------------------+-----><
   '-PRIority--=----number---'  '-ADSMServer--=--+-No--+-'   
                                                 '-Yes-'

Parameters

machine_name (Required)

Specifies the machine name. The name can be up to 64 characters.

DESCription

Specifies a machine description. This parameter is optional. The text can be up to 255 characters. Enclose the text in quotation marks if it contains any blank characters.

BUilding

Specifies the building that this machine is 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.

FLoor

Specifies the floor that this machine is on. This parameter is optional. The text can be up to 16 characters. Enclose the text in quotation marks if it contains any blank characters.

ROom

Specifies the room that this machine is 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 restore priority for the machine an integer from 1 to 99. The highest priority is 1. This parameter is optional. The default is 50.

ADSMServer

Specifies whether the machine is a Tivoli® Storage Manager server. Only one machine can be defined as a Tivoli Storage Manager server. This parameter is optional. The default is NO. Possible values are:

No: This machine is not a Tivoli Storage Manager server.
Yes: This machine is a Tivoli Storage Manager server.

Example: Define a machine's disaster recovery information

Define a machine named DISTRICT5, and specify a location, a floor, and a room name. This machine contains critical data and has the highest priority.

define machine district5 building=101 floor=27 
room=datafacilities priority=1

Related commands

Table 1. Commands related to DEFINE MACHINE
Command	Description
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.
QUERY MACHINE	Displays information about machines.
UPDATE MACHINE	Changes the information for a machine.