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

Read syntax diagramSkip visual syntax diagramDEFine MACHine machine_nameDESCription=descriptionBUilding=buildingFLoor=floorROom=roomPRIority=50PRIority=numberADSMServer=NoADSMServer=NoYes

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 an IBM Spectrum® Protect server. Only one machine can be defined as an IBM Spectrum Protect server. This parameter is optional. The default is NO. Possible values are:
No
This machine is not an IBM Spectrum Protect server.
Yes
This machine is an IBM Spectrum Protect 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 an IBM Spectrum Protect 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 IBM Spectrum Protect database.
QUERY MACHINE Displays information about machines.
UPDATE MACHINE Changes the information for a machine.