RECOVER-VM-DEFINITION (Recover a VM definition)

/RECOVER-VM-DEFINITION recovers a VM definition, i.e. a VM definition is transferred from a remote Server Unit to the local Server Unit.

The remote Server Unit has to be in the same SU cluster as the local Server Unit. The remote Server Unit must not run. This check has to be done by the caller.

This command is reserved for the VM2000 administrator.

RECOVER-VM-DEFINITION

VM-NAME = <name 1..8>

,SERVER-UNIT-NAME = *UNIQUE / <composed-name 1..64>

VM-NAME = <name 1..8>
Name of the VM definition to be recovered from the remote Server Unit.

SERVER-UNIT-NAME =
Name of the Server Unit from which the VM definition is to be recovered.

SERVER-UNIT-NAME = *UNIQUE
If an SU cluster consists of only two Server Units, the remote SU is unique and chosen automatically. Otherwise, the name of the remote SU has to be specified.

SERVER-UNIT-NAME = <composed-name 1..64>
Name of the remote Server Unit.
   In case of a remote SU /390, this is the BS2000 host name of the monitor system.

 

Command return codes

(SC2)   SC1	Main code	Meaning
0 64 64 64 64 64 64 64 64 64 64 64 64	CMD0001 VMS2300 VMS2311 VMS2332 VMS2341 VMS2342 VMS2343 VMS2344 VMS2345 VMS2346 VMS2347 VMS2400 VMS4013	Command successfully executed VM definition does not exist Maximum number of VM definitions already reached Storage for VM definitions cannot be reached (SU /390) No unique remote SU found Specified SU is the local SU Specified SU not in an SU cluster with the local SU Remote SU is running Unable to retrieve VM definition from the remote SU VM definition is not unique in the SU cluster Local SU not detected in any SU cluster SU not detected VM name not available

Guaranteed messages

VMS2340

Example

/recover-vm-definition vm-name=g4ivn
VMS2340 DEFINITION OF VM 'G4IVN' RECOVERED FROM REMOTE SU 'D021ZE01'