General
Application area: | Requesting and accessing lists and tables; see "Requesting and accessing lists and tables" |
Macro type: | Type S, MF format 3: D/C/E/L form; see "S-type macros" |
The VM2000 virtual machine system allows different, completely separate system environments to run on one server, with a performance comparable to a “native” system. VM2000 thus increases the number of possible applications of a server and the degree to which it is utilized. For further information, see the “VM2000” manual [17 (Related publications)].
Macro description
The VMGINF macro tells the caller whether BS2000 is running under VM2000 (<PREFIX><MACID>VIND field of the parameter list). If this is the case, the caller is provided with the following information on the VM2000 system, under which BS2000 is currently running or on which the IPL of BS2000 has been executed:
the index (VM-INDEX) and the name (VM-NAME) of the virtual machine
whether the system is a monitor system
the SYSID (VM-CONFIGURATION-ID) of the monitor system.
specific VM privileges and states of the guest system
the version of VM2000
the BCAM name of the monitor system
the version of the monitor system
Xen domain ID (x86 servers)
Macro format and description of operands
VMGINF |
SRVUNIT = *STD / *INITIAL / *CURRENT ,MF=D / C / E / L [,PARAM=addr / (r)] ,PREFIX=V / p ,MACID=MGI / macid |
SRVUNIT=
Specifies the Server Unit whose data is to be output.
*STD
Currently valid default setting of the Server Unit.
*INITIAL
Server Unit on which IPL was performed for BS2000.
*CURRENT
Server Unit on which BS2000 is currently running.
MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. PREFIX, MACID and PARAM), see section “S-type macros”. The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.
A PREFIX can be specified in the C form or D form of the macro and additionally a MACID in the C form (see section “S-type macros”).
Layout of the data area
VMGINF MF=D 1 MFTST MF=D,PREFIX=V,MACID=MGI,ALIGN=F, C 1 DMACID=MGI,SUPPORT=(E,D,C,M,L) 2 VMGI DSECT , 2 *,##### PREFIX=V, MACID=MGI ##### 1 VMGIUNIT EQU 137 unit number 1 * 1 VMGIFC04 EQU 4 function number 1 * 1 VMGIVR02 EQU 2 version number 1 * 1 * parameterarea description 1 VMGIPA DS 0F begin of parameterarea _INOUT 1 VMGIHDR FHDR MF=(C,VMGI),EQUATES=NO Standardheader 2 VMGIHDR DS 0A 2 VMGIFHE DS 0XL8 0 GENERAL PARAMETER AREA HEADER 2 * 2 VMGIIFID DS 0A 0 INTERFACE IDENTIFIER 2 VMGIFCTU DS AL2 0 FUNCTION UNIT NUMBER 2 * BIT 15 HEADER FLAG BIT, 2 * MUST BE RESET UNTIL FURTHER NOTICE 2 * BIT 14-12 UNUSED, MUST BE RESET 2 * BIT 11-0 REAL FUNCTION UNIT NUMBER 2 VMGIFCT DS AL1 2 FUNCTION NUMBER 2 VMGIFCTV DS AL1 3 FUNCTION INTERFACE VERSION NUMBER 2 * 2 VMGIRET DS 0A 4 GENERAL RETURN CODE 2 VMGISRET DS 0AL2 4 SUB RETURN CODE 2 VMGISR2 DS AL1 4 SUB RETURN CODE 2 2 VMGISR1 DS AL1 5 SUB RETURN CODE 1 2 VMGIMRET DS 0AL2 6 MAIN RETURN CODE 2 VMGIMR2 DS AL1 6 MAIN RETURN CODE 2 2 VMGIMR1 DS AL1 7 MAIN RETURN CODE 1 2 VMGIFHL EQU 8 8 GENERAL OPERAND LIST HEADER LENGTH 2 * 1 * main return codes 1 VMGIMSCC EQU 0 function executed 1 VMGIMPAR EQU 1 parameter error 1 VMGIMINT EQU 2 internal error 1 VMGIMTIM EQU 7 timeout error 1 VMGIMANA EQU 64 VM2000 agent not available 1 VMGIMXNA EQU 65 xend not available 1 *
1 VMGIVIND DS FL1 VM2000 indicator 1 * VM2000 indicator set 1 VMGIVM2R EQU 232 VM2000 running 1 VMGIVM2N EQU 213 VM2000 not running 1 * 1 VMGISIND DS AL1 status indicator 1 VMGIV2MO EQU X'80' monitor system 1 VMGILTSY EQU X'40' local time syn via adjust 1 * time 1 VMGIMPAD EQU X'20' MP grade adjustment possible 1 VMGIPIOM EQU X'10' VM-PRIV: DYNAMIC-IOREC 1 VMGIPGIO EQU X'08' VM-PRIV: VMGLOB-IOREC 1 VMGIUNU0 EQU X'04' unused 1 VMGIGS2N EQU X'02' GS-UNIT2 not in use 1 VMGIGS1N EQU X'01' GS-UNIT1 not in use 1 VMGIVCID DS X VM configuration ID 1 * 1 VMGIVM_IDENT DS 0XL9 VM identification 1 VMGIVMIX DS X VM index 1 VMGIVMNM DS CL8 VM name 1 * 1 VMGIV1IN DS AL1 valid indicator 1 1 VMGIV1O1 EQU X'80' :S: _OUT_11 valid 1 VMGIV1O2 EQU X'40' :S: _OUT_12 valid 1 VMGIV1O3 EQU X'20' :S: _OUT_13 valid 1 VMGIV1O4 EQU X'10' :S: _OUT_14 valid 1 VMGIV1O5 EQU X'08' :S: _OUT_15 valid 1 VMGIUNU1 EQU X'07' unused 1 VMGIV2IN DS AL1 valid indicator 2 1 VMGIUNU3 EQU X'FF' unused 1 VMGIVVRS DS CL6 VM2000 version (Vxx.xx) 1 * _OUT_11 1 VMGISIN2 DS AL1 status indicator 2 1 VMGIPIDA EQU X'80' VM-PRIV: IMPL-DEV-ASSIGN 1 * _OUT_12 1 VMGIPIOP EQU X'40' VM-PRIV: IO-PRIORITY _OUT_12 1 VMGIPIOR EQU X'20' VM-PRIV: IO-RESET _OUT_12 1 VMGICHMF EQU X'10' CHN-MON-FCL ACTIVE FOR VM 1 * _OUT_12 1 VMGIMBCA EQU X'08' BCAM ACTIVE IN MONITOR 1 * _OUT_12 1 VMGIPASA EQU X'04' VM-PRIV: AUTO-SNAP-ASSIGN 1 * _OUT_12 1 VMGIRSCS EQU X'02' RSC SUPPORTED _OUT_14 1 VMGISRDF EQU X'01' state RUNNING(DIFF) _OUT_15 1 VMGIMBCN DS CL8 monitor BCAM name _OUT_12 1 VMGIMOVS DS CL10 monitor OSD version _OUT_12 1 VMGIDOID DS XL8 Xen domid _OUT_13 1 VMGIRES1 DS XL43 reserved
1 VMGISUI DS FL1 server unit indicator 1 * Server unit indicator set 1 VMGISUIS EQU 0 standard 1 VMGISUII EQU 1 initial 1 VMGISUIC EQU 2 current 1 * 1 VMGICID DS FL1 caller identifier (internal 1 * use) 1 * Caller identifier set 1 VMGICIDS EQU 0 system 1 VMGICIDU EQU 1 user 1 * 1 VMGI# EQU *-VMGIHDR
Return information and error flags
Standard header:
+---------------+ | | | | | |c|c|b|b|a|a|a|a| +---------------+
A return code relating to the execution of the VMGINF macro is transferred in the standard header (cc=Subcode2, bb=Subcode1, aaaa=Maincode):
X'cc' | X'bb' | X'aaaa' | Meaning |
|---|---|---|---|
X'00' | X'01' | X'0001' | Parameter error |
X'00' | X'20' | X'0002' | Internal error |
X'00' | X'40' | X'0007' | Timeout error |
X'00' | X'82' | X'0040' | VM2000 agent not available |
X'00' | X'82' | X'0041' | Administration component of VM system not available |
Other return codes which, in accordance with conventions, apply to all macros are given in the table “Standard return codes” (Standard header).
The names of the output fields are given in the parameter list.