END-VM-DIALOG (Administration oder Operating beenden)

Mit /END-VM-DIALOG wird ein ADMIN- oder VC-Dialog beendet, der mit dem zugehörigen /BEGIN-VM-DIALOG eröffnet wurde. Das Beenden der Gastsystem-Bedienung über BS2000-Konsolen ist auf "Bedienen der Gastsysteme über BS2000-Konsolen" beschrieben.

Mit /END-VM-DIALOG wird eine bestehende Verbindung zu $VMCONS auch dann abgebaut, wenn das Terminal lediglich an $VMCONS angeschlossen war (OPNCON), aber noch keinen Dialog begonnen hatte.

Bei /DELETE-VM werden implizit alle ADMIN-Dialoge mit der VM und alle VC-Dialoge mit dem Gastsystem auf der VM beendet.

/END-VM-DIALOG kann vom VM-Administrator für seine VM eingegeben werden. Gibt der VM2000-Administrator /END-VM-DIALOG für eine VM ungleich der Monitor-VM ein, so werden je nach Angabe im Operanden TYPE alle betroffenen Dialoge der VM beendet (der Operand DISCONNECT wird dabei ignoriert). Gibt der VM2000-Administrator /END-VM-DIALOG für die Monitor-VM von einer BS2000-Konsole ein, so werden alle ADMIN-Dialoge der Monitor-VM beendet.

Die Ausgabe von periodischen Messwerten (/SHOW-VM-STATUS PERIOD=<integer>) wird durch die Beendigung des zugehörigen ADMIN-Dialoges ebenfalls beendet.

Werden über eine $VMCONS-Verbindung nur VC-Dialoge geführt, muss /END-VM-DIALOG mit dem Präfix VM00: zur Unterscheidung von Eingaben an das Gastsystem angegeben werden.

      

END-VM-DIALOG

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

,DISCONNECT = *YES / *NO

,TYPE = *BOTH / *ADMIN / *VC

VM-IDENTIFICATION =
Identifikation der virtuellen Maschine.

VM-IDENTIFICATION = *CURRENT
Es wird die VM-Identifikation genommen, die mit einem zuvor gegebenen /BEGIN-VM-DIALOG zugewiesen wurde.

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifikation der virtuellen Maschine durch VM-Index oder VM-Name.

DISCONNECT = *YES / *NO
Legt fest, ob eine bestehende Verbindung zu $VMCONS abgebaut werden soll oder nicht. Der Operand DISCONNECT wird nur ausgewertet, wenn der letzte Dialog einer Verbindung zu $VMCONS beendet wird.
Dieser Operand wird für ADMIN-Dialoge aus einer privilegierten Benutzertask nicht ausgewertet. Er wird ebenfalls nicht ausgewertet, wenn der VM2000-Administrator Dialoge anderer VMs beendet.

TYPE =
Bestimmt bei Kommandoeingabe über $VMCONS die Art der Dialoge, die beendet werden sollen. Dieser Operand wird bei Kommandoeingabe aus einer privilegierten Benutzertask ignoriert, da in diesem Fall nur ein ADMIN-Dialog geführt werden kann.

TYPE = *BOTH
Sowohl der ADMIN-Dialog als auch alle VC-Dialoge sollen beendet werden.

TYPE = *ADMIN
Der ADMIN-Dialog soll beendet werden.

TYPE = *VC
Die VC-Dialoge sollen beendet werden.

Kommando-Returncodes

(SC2)   SC1	Maincode	Bedeutung
0 64 64 64	CMD0001 VMS1037 VMS1039 VMS4000	Kommando erfolgreich ausgeführt Kein entsprechender Dialog eröffnet Die TYPE-Angabe ist nicht zulässig VM noch nicht initialisiert

Beispiel (unter $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)	Der VM-Administrator beendet den ADMIN- und den VC-Dialog.
(2)	Das Ende des ADMIN- und VC-Dialogs wird dem VM2000-Administrator gemeldet.