BEGIN-VM-DIALOG (Administration oder Operating starten)

Mit /BEGIN-VM-DIALOG wird aus einer privilegierten Benutzertask oder nach Verbindungsaufbau zu $VMCONS ein Dialog eröffnet,

• um die VM über VM2000-Kommandos zu verwalten (ADMIN-Dialog).Für jede VM können aus unterschiedlichen, privilegierten Benutzertasks bis zu 15 ADMIN-Dialoge parallel geführt werden. Zusätzlich kann über $VMCONS ein ADMIN-Dialog geführt werden.

• um das Gastsystem über $VMCONS zu bedienen (VC-Dialog).
  Pro VM können bis zu acht VC-Dialoge parallel über $VMCONS geführt werden.

  Die Gastsystem-Bedienung mit BS2000-Konsolen ist auf "Bedienen der Gastsysteme über BS2000-Konsolen" beschrieben.

/BEGIN-VM-DIALOG kann nicht von einer BS2000-Konsole des Monitorsystems eingegeben werden. Eröffnete Dialoge werden durch /END-VM-DIALOG, /DELETE-VM, durch /LOGOFF der Benutzertask oder durch einen Verbindungsabbruch zu $VMCONS beendet.

BEGIN-VM-DIALOG

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
,PASSWORD = *NONE / <c-string 1..8> / <x-string 1..16>
,TYPE =*STD / *BOTH / *ADMIN(...) / *VC(...)
	*ADMIN(...) / *VC(...)
		|	OUTPUT-PREFIX = *YES / *NO

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

PASSWORD = *NONE / <c-string 1..8> / <x-string 1..16>
Kennwort, das beim Initialisieren der VM oder mit /MODIFY-VM-ATTRIBUTES festgelegt wurde.

TYPE =
Bestimmt bei Kommandoeingabe über eine $VMCONS-Verbindung die Art des Dialogs, der begonnen werden soll.
Dieser Operand wird bei Kommandoeingabe aus einer privilegierten Benutzertask ignoriert, da in diesem Fall nur ein ADMIN-Dialog (ohne Ausgabepräfix) gestartet werden kann.

TYPE = *STD
In einer Benutzertask gilt:
Es soll ein ADMIN-Dialog begonnen werden.

Für eine $VMCONS-Verbindung gilt:

Ein ADMIN-Dialog und ein VC-Dialog sollen begonnen werden. Es soll ein ADMIN-Dialog begonnen werden.

TYPE = *BOTH
Sowohl ein ADMIN-Dialog als auch ein VC-Dialog sollen begonnen werden.
Den Ausgaben von ADMIN- bzw. VC-Dialog wird das VM- bzw. GS-Präfix vorangestellt.

TYPE = *ADMIN(...)
Bedienen der VM über VM2000-Kommandos (ADMIN-Dialog).

OUTPUT-PREFIX = *YES / *NO
Bestimmt, ob den Ausgaben des ADMIN-Dialogs der VM-Präfix VMnn vorangestellt wird.

TYPE = *VC(...)
Bedienen des Gastsystems, Operating (VC-Dialog).

OUTPUT-PREFIX = *YES / *NO
Bestimmt, ob den Ausgaben des VC-Dialogs der GS-Präfix GSnn vorangestellt wird.

Kommando-Returncodes

(SC2)   SC1	Maincode	Bedeutung
0 1             0 64 64 64 64 64 64 64 64	CMD0001 CMD0001 VMS1000 VMS1001 VMS1024 VMS1035 VMS1050 VMS1522 VMS2101 VMS4000	Kommando erfolgreich ausgeführt Keine Aktion erforderlich ADMIN-Dialog bereits eröffnet Für die VM ist bereits ein ADMIN-Dialog mit einem anderen Partner eröffnet Fehlerhaftes Kennwort angegeben Maximale Anzahl von VC-Dialogen für die VM erreicht VC-Dialog mit KVP konnte nicht eingerichtet werden Maximale Anzahl der ADMIN-/VC-Dialoge erreicht VM2000-Shutdown in Bearbeitung VM noch nicht initialisiert

Beispiel (privilegierte Benutzertask)

/begin-vm-dialog vm-id=system2,password=c'sys2',type=*std —————————————  (1)

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

(1)	Aus einer privilegierten Benutzertask wird ein ADMIN-Dialog eröffnet.

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

Beispiel (über $VMCONS)

vm02:/begin-vm-dialog vm-id=system2,password=c'sys2',type=*both————————  (1)
VM01: %  VMS1033 PARTNER 'OMS120   D016ZE04' HAS STARTED A VC DIALOG WITH
                  VIRTUAL MACHINE (2,SYSTEM2) —————————————————————————  (2)
VM01: %  VMS1013 PARTNER 'OMS120   D016ZE04' HAS STARTED AN ADMINISTRATION
                 DIALOG WITH VIRTUAL MACHINE (2,SYSTEM2).
                  ADMINISTRATION-ID USED: @002
VM02:VMS3000 VM2000 COMMAND /BEGIN-VM-DIALOG FOR
     VIRTUAL MACHINE (2,SYSTEM2) PROCESSED SUCCESSFULLY
VM02:NBR0740 COMMAND COMPLETED 'BEGIN-VM-DIALOG';
     RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>

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

(1)	Nach Aufbau der Verbindung zu $VMCONS wird ein ADMIN- und ein VC-Dialog mit der VM2 eröffnet.
(2)	Der VM2000-Administrator wird über den Beginn des ADMIN- und des VC-Dialogs informiert.

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