END-VM-DIALOG (Terminate administration or operation)

/END-VM-DIALOG is used to terminate an ADMIN dialog or VC dialog opened with a corresponding /BEGIN-VM-DIALOG. Termination of guest system operation with BS2000 consoles is described on "Operating the guest systems using BS2000 consoles".

/END-VM-DIALOG also clears the connection to $VMCONS if the terminal was only connected to $VMCONS (OPNCON), but no dialog has yet been opened.

When the /DELETE-VM command is issued, all ADMIN dialogs with the VM and all VC dialogs with the guest system on the VM are terminated implicitly.

The VM administrator can enter /END-VM-DIALOG for his/her VM. If the VM2000 administrator enters /END-VM-DIALOG for a VM other than the monitor VM, all affected dialogs of the VM are terminated, depending on the specification in the TYPE operand (ignoring the DISCONNECT operand). If the VM2000 administrator enters /END-VM-DIALOG for the monitor VM from a BS2000 console, all ADMIN dialogs of the monitor VM are terminated.

The output of periodic monitored data (/SHOW-VM-STATUS PERIOD=<integer>) is terminated if the associated ADMIN dialog is terminated.

If VC dialogs only are conducted across a $VMCONS connection, /END-VM-DIALOG must be specified with the prefix VM00: to distinguish it from inputs at the guest system.

   

END-VM-DIALOG

VM-IDENTIFICATION = *CURRENT / <integer 1..99> / <name 1..8>

,DISCONNECT = *YES / *NO

,TYPE = *BOTH / *ADMIN / *VC

VM-IDENTIFICATION =
Identification of the virtual machine.

VM-IDENTIFICATION = *CURRENT
The VM identification assigned previously by means of /BEGIN-VM-DIALOG is used.

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifies the virtual machine by means of a VM index or VM name.

DISCONNECT = *YES / *NO
Determines whether or not the connection to $VMCONS is to be cleared down. The DISCONNECT operand is only evaluated when the last dialog of a connection to $VMCONS is terminated. This operand is not evaluated for ADMIN dialogs from a privileged user task. It is also evaluated if the VM2000 administrator terminates dialogs of other VMs.

TYPE =
Defines the type of dialog to be terminated for command input via $VMCONS. This operand is ignored with command input from a privileged user task, as in this case only one ADMIN dialog can be conducted.

TYPE = *BOTH
Both the ADMIN dialog and all the VC dialogs are to be terminated.

TYPE = *ADMIN
The ADMIN dialog is to be terminated.

TYPE = *VC
The VC dialogs are to be terminated.

Command return codes

(SC2)   SC1	Main code	Meaning
0 64 64 64	CMD0001 VMS1037 VMS1039 VMS4000	Command successfully executed No corresponding dialog has been opened TYPE specification is not allowed VM not yet created

Example (using $VMCONS)

vm02:/end-vm-dialog ———————————————————————————————————————————————————— (1)
VM01: %  VMS1012 PARTNER HAS TERMINATED AN ADMINISTRATION DIALOG WITH
         VIRTUAL MACHINE (2,SYSTEM2). ADMINISTRATION-ID USED '@002'————  (2)
VM01: %  VMS1032 PARTNER HAS TERMINATED A VC DIALOG WITH
         VIRTUAL MACHINE (2,SYSTEM2)
VM02:VMS3000 VM2000 COMMAND /END-VM-DIALOG FOR
     VIRTUAL MACHINE (2,SYSTEM2) PROCESSED SUCCESSFULLY
VM02:NBR0740 COMMAND COMPLETED 'END-VM-DIALOG';
     (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
@: OMS0006 CONNECTION TO PARTNER ($VMCONS/D021ZE01) LOST
   (PAC=VM02; CODE=00000000)

--------------------------------------------------------------------------------------------------------------------

(1)	The VM administrator terminates the ADMIN dialog and the VC dialog.
(2)	The VM2000 administrator is informed of the termination of the ADMIN dialog and the VC dialog.