| |
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure VMDBK VIRTUAL MACHINE DEFINITION BLOCK
VMDSDSC and VMDSDEXT fields:
State Descriptor Area (See SIEBK prolog)
WARNING: This area is defined by processor architecture.
Do NOT modify this area EXCEPT to install
architected changes.
0000 0 Bitstring 256 VMDSDSC Guest machine state descriptor
0100 256 Bitstring 256 VMDSDEXT Guest machine state descriptor
extension
Embedded USRBK
The embedded USRBK area is mapped by the USRBK
DSECT. VMDUSER is a shared field with the USRBK
and must be positioned inside VMDUSRBK at the
same offset as it is in the USRBK. A CHKMAINT
macro in HCPUSR verifies they are laid out exactly.
0200 512 Bitstring 32 VMDUSRBK Area for embedded USRBK
0200 512 Character 8 VMDUSER User logon identification also
USRUSER
USER IDENTIFICATION AND ACCOUNTING AREA
0220 544 Character 8 VMDDIST USER DISTRIBUTION CODE THIS IS
THE DEFAULT DISTRIBTUION CODE
OBTAINED FROM THE DIRECTORY FOR
THIS USER. IT IS USED IN SPOOL
FILE COMMANDS TO ASSIGN THE
DEFAULT DISTRIBUTION CODE TO THE
SPOOL FILE.
0228 552 Character 8 VMDGRPN RACF ACI GROUP NAME
0230 560 Signed 4 VMDTODON SESSION LOGON TOD, BITS 0-31
0234 564 Signed 4 VMDATODN VALUE OF VMDTODON AT LAST 'ACNT'
OR AT LOGON, WHICHEVER IS LATER.
THE FOLLOWING FIELDS CONTAIN THE VALUES OF THE
INDICATED ACCOUNTING FIELDS AT THE LAST 'ACNT'
COMMAND OR AT LOGON, WHICHEVER IS LATER.
SUBSEQUENT ACCOUNTING RECORDS ARE GENERATED USING
THE DIFFERENCE BETWEEN THE CURRENT VALUE AND THE
'LAST' VALUE. THIS ALLOWS ACCOUNTING RECORDS TO
BE GENERATED DURING A SESSION WHILE ALSO MAINTAINING
SESSION TOTALS.
NOTES : THE ASSEMBLER CONSTRUCT 'FL8S12' IS USED TO
GENERATE A FIXED-POINT NUMBER WHICH REPRESENTS A
TIME VALUE (IN MICROSECONDS) IN TOD CLOCK FORMAT
OR CPU TIMER FORMAT. USE OF 'FL8S12E6' IS USED
TO GENERATE A TIME VALUE IN SECONDS (RATHER THAN
MICROSECONDS).
VMDATTMP and VMDAVTMP are initialized to:
- 0 for the SYSTEM and SYSTEMMP VMDBKs
- PFXTMMAX for all other VMDBKs
0238 568 Signed 8 VMDATTMP Value of VMDTTMP at last 'ACNT'
0240 576 Signed 8 VMDAVTMP Value of VMDVTMP at last 'ACNT'
0248 584 Character 8 VMDADIST Accounting DISTRIBUTION field
when VMDDIA4C is on
0250 592 Signed 4 VMDSIGCT Count of SIGA instructions
0254 596 Signed 4 VMDCCSIO Count of completed virtual I/O
starts (except diag 58 & 98).
Includes starts to all devices
except virtual spooling and
virtual console devices.
0258 600 Signed 4 VMDACPGW TOTAL NUMBER OF PAGE/SPOOL WRITES
AT LAST 'ACNT'
025C 604 Signed 4 VMDACPGR TOTAL NUMBER OF PAGE/SPOOL READS
AT LAST 'ACNT'
VMDATTMS and VMDAVTMS are initialized to:
- 0 for the SYSTEM and SYSTEMMP VMDBKs
- PFXTMMAX for all other VMDBKs
0260 608 Signed 8 VMDATTMS Value of VMDTTMS at last 'ACNT'
0268 616 Signed 8 VMDAVTMS Value of VMDVTMS at last 'ACNT'
0270 624 Signed 8 VMDLACTM Last time active, for IND ACT
0278 632 Bitstring 1 VMDDIAST DIAGNOSE STATUS BYTE
1... .... VMDDIA4C X'80' VMDDIA4C DIAG4C WAS LAST
ACCOUNT RECORD PROCESSED
.1.. .... VMDUDST X'40' VMDUDST Indicate user spool
distribution
0279 633 Bitstring 1 VMDACFL Accounting Flag byte. Valid in
all VMDBKs.
1... .... VMDNETA X'80' VMDNETA This indicates
Network Transmission accounting
records are wanted. Set at logon
time if the NETACCOUNTING or
NETROUTER option is specified on
the OPTIONS statement in the
user's directory.
.1.. .... VMDNETR X'40' VMDNETR User is a Network
Router. Set at logon time if the
NETROUTER option is specified on
the OPTIONS statement in the
user's directory.
027A 634 Bitstring 1 VMDADJFL ADJUNCT FLAGS
1... .... VMDCMSAJ X'80' VMDCMSAJ This is an adjunct
VMDBK
.1.. .... VMDRDPDG X'40' VMDRDPDG A read was pending
for the VMDBK that activated the
adjunct
..1. .... VMDSTOPA X'20' VMDSTOPA An ADJUNCT STOP
command was issued before this
ADJUNCT cmnd
...1 .... VMDVISAD X'10' VMDVISAD VMDBK is a
"visible" adjunct. That is, if
#CP commands are entered while
the adjunct is executing, they
will be directed to the adjunct.
Also, CP reads done by HCPCFM
will be executed on the adjunct
if it's runnable.
027B 635 Bitstring 1 VMDDSPTC Previous dispatch type for call
to HCPSRNRS This byte requires
scheduler lock serialization to
modify.
The following five fields contain the indicated
counts at the last 'ACNT' command or at LOGON
whichever is later. Accounting records are
generated using the difference between the current
value and the value at the last ACNT command. This
allows accounting records to be generated during a
session while also maintaining session totals.
027C 636 Signed 4 VMDACRDR Count at last ACNT command of
cards read from virtual spooled
devices At each 'ACNT' command,
this field is set to the current
value of VMDCTRDR.
This field is signigicant in all VMDBK's, serialized
by master-only.
0280 640 Signed 4 VMDACPCH Count at last ACNT command of
lines written to virtual spooled
punches At each 'ACNT' command,
this field is set to the current
value of VMDCTPCH.
This field is significant in all VMDBK's, serialized
by master-only.
0284 644 Signed 4 VMDACPRT Count at last ACNT command of
lines spooled to virtual printers
At each 'ACNT' command, this
field is set to the current value
of VMDCTPRT.
This field is significant in all VMDBK's, serialized
by master-only.
0288 648 Signed 4 VMDARSIO Count at last ACNT command of
virtual I/O starts which have
been requested, but not
completed. At each 'ACNT'
command, this field is set to the
current value of VMDCTSIO.
This field is significant in all VMDBK's, serialized
by master-only.
028C 652 Signed 4 VMDACSIO Count at last ACNT command of
virtual I/O starts which have
been requested and completed. At
each 'ACNT' command, this field
is set to the current value of
VMDCCSIO.
This field is significant in all VMDBK's, serialized
by master-only.
0290 656 Bitstring 1 VMDLOGFG Flag bits set at logon and
replicated in all vMP and Adjunct
VMDBKs for this userid.
1... .... VMDIDENT X'80' VMDIDENT This VMDBK is for
an Identity userid.
0291 657 Bitstring 1 * Reserved for IBM use
0292 658 Signed 2 VMDALGSL SSI slot number of userid that
caused this user's logon. This
field is paired with VMDALGID and
is set at logon and is never
changed.
0294 660 Address 4 VMDVOPEX Operand FETCH/STORE exit address
Console Function Command Region
0298 664 Address 4 VMDPACPE Promote/Annex CPEBK pointer High
order bit used as lock
029C 668 Address 4 VMDBOMBT Time bomb TRQBK address CONSOLE
FUNCTION COMMAND STATUS AND
COMMUNICATION AREA
02A0 672 Character 8 VMDCOMND LAST CP COMMAND EXECUTED
02A8 680 Dbl-Word 8 * (0)
02A8 680 Bitstring 1 VMDCFCTL CONSOLE FUNCTION CONTROL
1... .... VMDEXCF X'80' VMDEXCF INDICATES THAT
CONSOLE FUNCTION EXECUTION IS IN
PROGRESS. THAT IS, ONE OF THE
FOLLOWING FUNCTIONS IS ACTIVE:
THE STACK OF CONSOLE FUNCTION
OUTPUT IS BEING DISPLAYED. THE
CALL-FROM-CFM CPEBK STACK IS
BEING UNSTACKED AND PROCESSED.
THE COMMAND INPUT BUFFER IS BEING
UNSTACKED AND COMMANDS ARE BEING
PROCESSED. THIS BIT IS USED BY
THE DISPATCHER TO PREVENT THE
VMDBK FROM BEING DROPPED FROM THE
DISPATCH LIST.
.1.. .... VMDDGCF X'40' VMDDGCF CONSOLE FUNCTION
MODE ENTERED VIA DIAGNOSE
INSTRUCTION
.... .1.. VMDSTOPD X'04' VMDSTOPD INDICATES WHEN SET
THAT A VIRTUAL CPU IS IN A HARD
STOPPED STATE AS DEFINED BY 370
ARCHITECTURE. THAT IS, NO
INSTRUCTIONS OR INTERRUPTIONS
OTHER THAN THE RESTART
INTERRUPTION MAY BE EXECUTED
WHILE IN THIS STATE. THIS BIT IS
USED BY CP TO DETERMINE WHICH
VMDBKS MAY RUN. WHILE SET IN A
VMDBK, THE VMDBK IS NOT ALLOWED
TO RUN. IT IS SET WHEN HANDLING
SOFT ABENDS AND PROGRAM INTERRUPT
LOOPS, SYSTEM AND CPU RESETS, AND
WHEN INITIALIZING VMDBKS. IT IS
RESET WHEN PROCESSING THE BEGIN,
IPL AND SYSTEM RESTART COMMANDS.
.... ..1. VMDCFIDL X'02' VMDCFIDL INDICATES THAT THE
GUEST CONFIGURATION IS IN CONSOLE
FUNCTION WAIT AND IS IDLE. IT IS
USED TO INDICATE THAT CONSOLE
INPUT BE DIRECTED TO CP.
02A9 681 Bitstring 1 VMDCFLAG CONSOLE FUNCTION STATUS FLAGS
1... .... VMDLOGON X'80' VMDLOGON USER NOT YET
LOGGED ON
.1.. .... VMDLOGOF X'40' VMDLOGOF USER IS LOGGING
OFF. THIS BIT IS SET ONCE LOG OFF
PROCESSING BEGINS FOLLOWING A
COMMAND REQUESTING LOGOFF OF A
USER OR CPU, OR A CP DETECTED
PROBLEM REQUIRING A LOGOFF.
..1. .... VMDREST X'20' VMDREST GUEST SYSTEM RESET
IN PROGRESS. THIS BIT IS USED FOR
TWO PURPOSES: TO FLAG SOFTWARE
EXTERNAL INTERRUPT ROUTINES THAT
THEY ARE BEING CALLED DUE TO A
GUEST SYSTEM RESET; AND TO FLAG
THE ROUTINE THAT RESTORES THE
GUEST VIRTUAL PAGE USED BY THE
IPL SIMULATOR THAT IT IS BEING
CALLED DUE TO A SYSTEM RESET.
...1 .... VMDUTERM X'10' VMDUTERM CONSOLE FUNCTION
OUTPUT IS NOT TO BE DISPLAYED TO
THE DISPLAY STATION, BUT IS
WRITTEN TO AND CONTROLLED BY THE
VIRTUAL CONSOLE. THIS IS USED FOR
TRACE OUTPUT AND CP COMMANDS
ISSUED VIA THE DIAGNOSE X'08'
INSTRUCTION.
.... .1.. VMDBUFWT X'04' VMDBUFWT VALID ONLY IN THE
PRIMARY VMDBK: SET FOR CONSOLE
FUNCTION OUTPUT TO A USER BUFFER
ADDRESS FROM A DIAGNOSE CONSOLE
FUNCTION. - WHEN SET, THE
FOLLOWING FIELDS IN - THE PRIMARY
VMDBK ARE ALSO VALID: - VMDBUFVM
= ADDRESS OF VMDBK - VMDBUFAD =
ADDRESS OF BUFFER - VMDBUFLN =
REMAINING LENGTH
.... ..1. VMDBUFIF X'02' VMDBUFIF VMDBUFIF IS SET TO
INDICATE THAT A GUEST PSW SWAP
OCCURRED IN THE SIMULATION OF A
DIAGNOSE X'08' INSTRUCTION THAT
REQUESTED OUTPUT TO A BUFFER. THE
PSW WAS SWAPPED TO REFLECT A
PROGRAM INTERRUPTION FOR AN
INSTRUCTION FETCH PER EVENT. IT
IS NECESSARY TO RECORD THIS
INFORMATION IN VMDBUFIF SINCE THE
PROCESSING OF THE DIAGNOSE X'08'
COMMANDS OCCURS AFTER THE
DIAGNOSE INSTRUCTION SIMULATION
HAS REACHED ENDOP AND THE PER
EVENT PROGRAM INTERRUPTION IS
REFLECTED. THE CONDITIN CODE FOR
THE DIAGNOSE INSTRUCTION MUST BE
SET BASED ON THE SUCCESS OF
STORING THE COMMAND OUTPUT IN THE
GUEST BUFFERS. IF THE PER
INSTRUCTION FETCH IS ACTIVE, THE
CONDITION CODE MUST BE SET IN THE
GUEST'S PROGRAM CHECK OLD PSW,
OTHERWISE IT IS SET IN THE
GUEST'S CURRENT PSW.
.... ...1 VMDHXBLE X'01' VMDHXBLE The command now
running may halted by the CPHX
command. This bit is defined in
the origin VMDBK only.
02AA 682 Bitstring 1 VMDOSTAT VIRTUAL MACHINE OPERATING STATUS
Serialized by master processor
1... .... VMDSYSOP X'80' VMDSYSOP USER IS PRIMARY
SYSTEM OPERATOR
.1.. .... VMDUSRCT X'40' VMDUSRCT USER INCLUDED IN
SYSTEM USER CT
..1. .... VMDAPROC X'20' VMDAPROC AUTOLOG/XAUTOLOG
in process This bit is set when a
user is automatically logged on
and gets turned off when the
user's IPL statement is
processed, or (if there is no IPL
to process) when autolog
processing is completed.
...1 .... VMDFORCE X'10' VMDFORCE USER IS TO BE
LOGGED OFF. THIS BIT IS SET
WHENEVER CP DETERMINES THAT A
VMDBK MUST BE LOGGED OFF. IT IS A
CP REQUEST TO BEGIN LOGOFF
PROCESSING FOR A VMDBK. THE
REQUEST MAY BE A FORCED LOGOFF OR
AT THE USER'S REQUEST VIA THE
LOGOFF COMMAND.
.... 1... VMDUFORC X'08' VMDUFORC USER IS FORCED TO
LOGOFF THE SYSTEM.
.... .1.. VMDDISC X'04' VMDDISC USER IS RUNNING
DISCONNECTED
.... ..1. VMDAUTOL X'02' VMDAUTOL AUTOLOG/XAUTOLOG
command issued This bit is set
when a user is automatically
logged on and gets turned off if
and when that user enters a LOGON
command from a terminal to
RECONNECT.
.... ...1 VMDXAUTO X'01' VMDXAUTO The original
command was XAUTOLOG. Valid for
the base VMDBK only.
02AB 683 Bitstring 1 VMDSTAT2 Virtual Machine Operating status
flags. This byte is a logical
extension of VMDOSTAT. Serialized
by master processor
1... .... VMDRDISC X'80' VMDRDISC A remote
disconnect was initiated for this
user via a FORCE or LOGON
command. This bit is reset when
the user reconnects. It is valid
in all VMDBKs and is updated by
dispatch on the origin VMDBK.
.1.. .... VMDHASHD X'40' VMDHASHD Indicates that
this VMDBK has been deleted from
the VMDBK hash table.
..1. .... VMDDISCP X'20' VMDDISCP A disconnect is in
progress for this user. This bit
is set in every VMDBK in the
local cyclic list.
...1 .... VMDSYSLG X'10' VMDSYSLG Indicates that
this VMDBK was autologged as part
of system initialization
.... 1... VMDESMON X'08' VMDESMON Indicates that the
ESM has been called via HCPRPWEP
to do logon authorization
checking and a HCPRPIRA LOGOFF
audit call needs to be done.
02AC 684 Bitstring 1 VMDCFPND CONSOLE FUNCTION IS PENDING. THIS
FIELD CONTROLS THE PROCESSING OF
THE CONSOLE FUNCTION TASK FOR A
GUEST CONFIGURATION. ONCE THE
C.F. TASK BEGINS, VMDCFPND IS SET
TO ZERO TO KEEP THE C.F. TASK
ACTIVE AS LONG AS THERE ARE
(POSSIBLY) MORE CONSOLE FUNCTIONS
TO HANDLE.
02AD 685 Bitstring 1 VMDCFPDR CONSOLE FUNCTION READ PENDING.
USED IN HCPCFM TO INDICATE A CP
READ REQUEST IS PENDING. A CP
READ IS REQUESTED BY FIRST
CALLING HCPCFMBK TO ASSIGN ZEROS
TO VMDCFPDR, AND STACKING A GOTO
TO HCPCFMRD TO HANDLE THE PENDING
READ.
02AE 686 Bitstring 1 VMDCFHXF CONSOLE FUNCTION HALT FLAG. USED
TO HALT LONG RUNNING CONSOLE
FUNCTIONS (I.E. DISPLAY, DUMP)
AND TO STOP ALL STACKED CONSOLE
FUNCTION DISPLAY FROM BEING
DISPLAYED. IT IS USED TO
INTERRUPT CONSOLE FUNCTION OUTPUT
WHEN THE USER ENTERS THE BRKKEY
OR IS BEING FORCED TO LOGOFF.
02AF 687 Bitstring 1 VMDCWAIT CF WAIT CONTROL
1... .... VMDSTOP X'80' VMDSTOP VIRTUAL MACHINE IN
STOP STATE
.1.. .... VMDSLEEP X'40' VMDSLEEP VIRTUAL MACHINE IS
SLEEPING
..1. .... VMDCKST X'20' VMDCKST VIRT CPU IN CHECK
STOP STATE
...1 .... VMDDSCWT X'10' VMDDSCWT USER IS IN
'DISCONNECTED WAIT' MODE. I/O WAS
ATTEMPTED TO THE USER'S DISPLAY
AND THE USER WAS DISCONNECTED, SO
A TIMER IS SET TO LOG the user
off if not reconnected within the
disconnect timeout interval.
.... ...1 VMDSKSLP X'01' VMDSKSLP SLEEP skipped for
user with RUN set ON because
disconnect timeout interval is
zero. If the virtual machine
attempts another console read
while disconnected, it will be
put to sleep to await a
reconnect.
02B0 688 Signed 4 VMDCFBUF THIS IS THE ANCHOR TO A STACK OF
INPUT BUFFERS (GSDBKS) CONTAINING
CONSOLE COMMANDS TO BE PROCESSED.
THE FIRST GSDBK ON THE STACK
CONTAINS THE NEXT COMMAND TO BE
PROCESSED. Dispatch Lock is used
for serialization.
02B4 692 Signed 4 VMDCOMPR Pointer to command in a GSDBK
02B8 696 Signed 4 VMDCFCAL QUEUE OF CPEBKS TO BE SCHEDULED
UPON ENTRY TO CONSOLE FUNCTION
MODE. EXECUTE BLOCKS ARE STACKED
ON THIS QUEUE WHEN A FUNCTION
MUST EXECUTE WITH ALL VIRTUAL
CPUS IN A VIRTUAL MP
CONFIGURATION HELD AT ENDOP.
02BC 700 Bitstring 1 VMDCFREQ CONSOLE FUNCTION ENTRY FLAG.
INDICATES WHEN A VMDBK IN THE
LOCAL CYCLIC LIST HAS BEEN
REQUESTED TO ENTER HCPCFM TO
SUPPORT CONSOLE FUNCTION ENTRY
REQUIREMENTS. A VALUE OF X'FF'
INDICATES A REQUEST HAS BEEN
MADE. ZEROS INDICATE NO REQUEST
HAS BEEN MADE. THIS FIELD IS USED
TO ENSURE THAT ALL VMDBKS IN THE
LOCAL CYCLIC LIST ENTER HCPCFM
BEFORE ANY CONSOLE FUNCTIONS ARE
PROCESSED. THIS IS PART OF THE
TECHNIQUE TO REQUIRE ALL VMDBKS
IN THE LOCAL CYCLIC LIST TO REACH
ENDOP BEFORE PROCESSING CONSOLE
FUNCTIONS.
02BD 701 Bitstring 1 VMDCFDSP CONSOLE FUNCTION ENDOP FLAG. THIS
FIELD INDICATES WHEN A VIRTUAL
MACHINE IS BEING HELD AT ENDOP
FOR CONSOLE FUNCTION MODE. A
VALUE OF X'FF' INDICATES THE
VMDBK WAS NOT RUNNING BUT WAS AT
ENDOP. ZEROS INDICATE IT WAS
RUNNING. HCPCFM SETS VMDCFDSP
WHENEVER IT IS STOPPING A RUNNING
VMDBK TO ENTER CONSOLE FUNCTION
MODE. IT RESETS VMDCFDSP BEFORE
EXITING TO HCPRUNU TO START A
VMDBK RUNNING.
02BE 702 Bitstring 1 VMDCFACT Console Read active. Serialized
via Test-and-Set: X'00' = read
not active X'FF' = read active or
about to become active Valid only
in origin VMDBK. A console
function read may not be pending
and active at the same time.
Therefore, the following logic
must be used to turn on VMDCFACT:
TS VMDCFACT BC CC1,SOMEWHER MVI
VMDCFPDR,X'FF' Note: VMDCFPDR is
negative logic
02BF 703 Bitstring 1 VMDCFCT1 Console Function Controls, 2nd
byte
...1 .... VMDPRVRD X'10' VMDPRVRD Indicates that the
virtual configuration had
previously issued a console
function read. It is set on when
a console function read
completes. It is set off when
there is no more console function
mode work to do for the guest or
the guest is in a sleep state. It
is tested along with VMDRDNUL
whenever a console function read
is to be issued, to determine if
the CP prompt should be written
first. . VMDPRVRD 0, VMDRDNUL 0 -
write prompt for linemode
displays only . VMDPRVRD 1,
VMDRDNUL 0 - don't write prompt .
VMDPRVRD 1, VMDRDNUL 1 - write
prompt for all displays It is
serialized by TS on VMDCFACT, and
is valid only in the origin
VMDBK.
.... 1... VMDRDNUL X'08' VMDRDNUL If set, indicates
the previous console function
read was null (no data). This
flag is valid only when VMDPRVRD
is on. See VMDPRVRD for a
description of how this flag is
used. It is serialized by TS on
VMDCFACT, and is valid only in
the origin VMDBK. THE FOLLOWING
FIELDS ARE VALID ONLY IN THE
PRIMARY VMDBK ADDRESSED BY
VMDORIG IN EACH VMDBK WITHIN A
LOCAL CYCLIC LIST
02C0 704 Signed 4 VMDCFCNT CONSOLE FUNCTION ENDOP COUNT. A
POSITIVE VALUE IN THIS FIELD
INDICATES A COUNT OF RUNNING
VMDBKS IN A VIRTUAL
CONFIGURATION. A ZERO VALUE
INDICATES AN IDLE CONFIGURATION,
ALL CPUS IN THE VIRTUAL
CONFIGURATION ARE AT ENDOP. A
VALUE OF MINUS ONE INDICATES THAT
A CONSOLE FUNCTION IS RUNNING FOR
THE CONFIGURATION. THIS FIELD IS
THE CONSOLE FUNCTION LOCK, USED
TO SERIALIZE THE PROCESSING OF
CONSOLE FUNCTIONS. ONCE HELD
EXCLUSIVELY (VMDCFCNT < 0), A
CONSOLE FUNCTION TASK IS RUNNING
AND NO SECOND CONSOLE FUNCTION
TASK MAY BEGIN.
02C4 708 Address 4 VMDFORGS The address of the command GSDBK
created by a FOR command and
queued on the VMDCFBUF chain on
FOR command target. This field is
only valid in the origin VMDBK.
02C8 712 Signed 4 VMDCFCPU ASYNCHRONOUS COMMAND AND CONSOLE
FUNCTION READ TARGET. THIS FIELD
CONTAINS THE ADDRESS OF THE VMDBK
IN A VIRTUAL MP CONFIGURATION
THAT IS TO RECEIVE ALL '#CP'
COMMANDS (ASYNCHRONOUS COMMANDS)
AND INPUT FROM A CP READ. THE
USER CHANGES THE VALUE IN THIS
FIELD BY ISSUING THE 'CPU NNN'
COMMAND. THE VMDBK ASSOCIATED
WITH THE VIRTUAL CPU WITH CPU
ADDRESS NNN WILL BE ASSIGNED TO
VMDCFCPU.
02CC 716 Signed 4 VMDBUFVM CONTAINS THE VMDBK ADDRESS OF THE
VIRTUAL CPU THAT EXECUTED THE
DIAGNOSE X'08' INSTRUCTION
REQURING OUTPUT TO A BUFFER.
02D0 720 Dbl-Word 8 VMDBUFIA i-ASIT that identifies the
address space containing the
diagnose x'08' issuer's command
output response buffer
02D8 728 Address 4 VMDFORBK Address of FORBK control block
which is used for *ASYNCMD
connections for a user using the
FOR command.
02DC 732 Signed 4 VMDBUFLN CONTAINS THE LENGTH REMAINING IN
THE DIAGNOSE X'08' CONSOLE
FUNCTION BUFFER. IT IS INITIALLY
SET TO THE LENGTH OF THE BUFFER
AND IS CONTINUALLY CHANGED AS
CONSOLE FUNCTION OUTPUT IS MOVED
TO THE BUFFER.
END OF PRIMARY-ONLY AREA FOR CONSOLE FUNCTION CONTROLS
02E0 736 Signed 4 VMDOSTAK CONSOLE FUNCTION OUTPUT STACK.
THIS IS AN ANCHOR OF A STACK OF
GSDBKS CONTAINING OUTPUT FROM A
CONSOLE FUNCTION THAT IS DEFERRED
UNTIL THE CONSOLE FUNCTION
COMPLETES.
02E4 740 Bitstring 1 VMDCFOPT CONSOLE FUNCTION OPTIONS.
Serialized by CFM to store,
i-stream or CFM to fetch
1... .... VMDBOMBA X'80' VMDBOMBA Time bomb is
active (i.e., is armed) Valid
only in a base VMDBK
.1.. .... VMDBOMBE X'40' VMDBOMBE Time bomb is
enabled (i.e., has been
initialized via Diagnose) Valid
only in a base VMDBK
..1. .... VMDBOMBS X'20' VMDBOMBS Time bomb is
suspended by SET TIMEBOMB OFF
command Valid only in a base
VMDBK
...1 .... VMDCFRUN X'10' VMDCFRUN GUEST MACHINE CAN
RUN FOLLOWING A CONSOLE FUNCTION
OPERATION WITHOUT REQUIRING THE
USER TO ENTER A 'BEGIN' COMMAND
OR A COMMAND WITH AN IMPLIED
BEGIN. THIS BIT IS SET AND RESET
BY THE 'SET RUN' COMMAND.
.... 1... VMDCFMCP X'08' VMDCFMCP Multiple virtual
CPUs have been specified on a
nested CPU command Valid only in
the origin VMDBK.
.... .1.. VMDCFMCE X'04' VMDCFMCE Error msg has been
issued for specifying more than
one nested multi-vCPU CPU
command. Valid only in the origin
VMDBK.
.... ..1. VMDCFPCL X'02' VMDCFPCL Guest machine can
not issue the "SET PRIVCLASS"
command unless "SET PRIVCLASS
UNLOCK" is issued first.
02E5 741 Bitstring 1 VMDCMDMC ACI 'MAC' authorized priviledge
classes - byte 0. serialized by
CFM
1... .... CLASSA X'80' CLASSA CLASS A FUNCTIONS
.1.. .... CLASSB X'40' CLASSB CLASS B FUNCTIONS
..1. .... CLASSC X'20' CLASSC CLASS C FUNCTIONS
...1 .... CLASSD X'10' CLASSD CLASS D FUNCTIONS
.... 1... CLASSE X'08' CLASSE CLASS E FUNCTIONS
.... .1.. CLASSF X'04' CLASSF CLASS F FUNCTIONS
.... ..1. CLASSG X'02' CLASSG CLASS G FUNCTIONS
.... ...1 CLASSH X'01' CLASSH CLASS H FUNCTIONS
02E6 742 Bitstring 1 VMDJURNL Journaling Flag, valid only for
the base VMDBK, and valid in
console function mode only.
1... .... VMDNOAUT X'80' VMDNOAUT Indicates user may
not AUTOLOG or XAUTOLOG anyone.
02E7 743 Bitstring 1 VMDCTYPE COMMAND TYPE(S) THIS USER IS
AUTHORIZED TO ISSUE.
1... .... CLASSA X'80' CLASSA CLASS A FUNCTIONS
.1.. .... CLASSB X'40' CLASSB CLASS B FUNCTIONS
..1. .... CLASSC X'20' CLASSC CLASS C FUNCTIONS
...1 .... CLASSD X'10' CLASSD CLASS D FUNCTIONS
.... 1... CLASSE X'08' CLASSE CLASS E FUNCTIONS
.... .1.. CLASSF X'04' CLASSF CLASS F FUNCTIONS
.... ..1. CLASSG X'02' CLASSG CLASS G FUNCTIONS
.... ...1 CLASSH X'01' CLASSH CLASS H FUNCTIONS
02E8 744 Bitstring 4 VMDPCL (0) AUTHORIZED PRIVILEGE CLASSES
02E8 744 Bitstring 1 VMDPCLB0 AUTHORIZED PRIV CLASSES - BYTE 0
1... .... CLASSA X'80' CLASSA CLASS A FUNCTIONS
.1.. .... CLASSB X'40' CLASSB CLASS B FUNCTIONS
..1. .... CLASSC X'20' CLASSC CLASS C FUNCTIONS
...1 .... CLASSD X'10' CLASSD CLASS D FUNCTIONS
.... 1... CLASSE X'08' CLASSE CLASS E FUNCTIONS
.... .1.. CLASSF X'04' CLASSF CLASS F FUNCTIONS
.... ..1. CLASSG X'02' CLASSG CLASS G FUNCTIONS
.... ...1 CLASSH X'01' CLASSH CLASS H FUNCTIONS
02E9 745 Bitstring 1 VMDPCLB1 AUTHORIZED PRIV CLASSES - BYTE 1
1... .... CLASSI X'80' CLASSI CLASS I FUNCTIONS
.1.. .... CLASSJ X'40' CLASSJ CLASS J FUNCTIONS
..1. .... CLASSK X'20' CLASSK CLASS K FUNCTIONS
...1 .... CLASSL X'10' CLASSL CLASS L FUNCTIONS
.... 1... CLASSM X'08' CLASSM CLASS M FUNCTIONS
.... .1.. CLASSN X'04' CLASSN CLASS N FUNCTIONS
.... ..1. CLASSO X'02' CLASSO CLASS O FUNCTIONS
.... ...1 CLASSP X'01' CLASSP CLASS P FUNCTIONS
02EA 746 Bitstring 1 VMDPCLB2 AUTHORIZED PRIV CLASSES - BYTE 2
1... .... CLASSQ X'80' CLASSQ CLASS Q FUNCTIONS
.1.. .... CLASSR X'40' CLASSR CLASS R FUNCTIONS
..1. .... CLASSS X'20' CLASSS CLASS S FUNCTIONS
...1 .... CLASST X'10' CLASST CLASS T FUNCTIONS
.... 1... CLASSU X'08' CLASSU CLASS U FUNCTIONS
.... .1.. CLASSV X'04' CLASSV CLASS V FUNCTIONS
.... ..1. CLASSW X'02' CLASSW CLASS W FUNCTIONS
.... ...1 CLASSX X'01' CLASSX CLASS X FUNCTIONS
02EB 747 Bitstring 1 VMDPCLB3 AUTHORIZED PRIV CLASSES - BYTE 3
1... .... CLASSY X'80' CLASSY CLASS Y FUNCTIONS
.1.. .... CLASSZ X'40' CLASSZ CLASS Z FUNCTIONS
..1. .... CLASS1 X'20' CLASS1 CLASS 1 FUNCTIONS
...1 .... CLASS2 X'10' CLASS2 CLASS 2 FUNCTIONS
.... 1... CLASS3 X'08' CLASS3 CLASS 3 FUNCTIONS
.... .1.. CLASS4 X'04' CLASS4 CLASS 4 FUNCTIONS
.... ..1. CLASS5 X'02' CLASS5 CLASS 5 FUNCTIONS
.... ...1 CLASS6 X'01' CLASS6 CLASS 6 FUNCTIONS
CLASSALL DEFINITION
VMDPCLB3 CLASSALL X'FFFFFFFF' CLASSALL ALL
FUNCTIONS ALLOWED
02EC 748 Signed 4 VMDTRQDL DELAYED SLEEP OR LOGOFF TRQBK
POINTER. VMDTRQDL POINTS TO THE
TRQBK THAT WAS SET TO EITHER TIME
THE GUEST IN A SLEEP STATE FOR A
LIMITED PERIOD OF TIME OR TO TIME
THE INTERVAL BEFORE LOGGING OFF A
DISCONNECTED GUEST FOLLOWING AN
ATTEMPTED DISPLAY I/O (TIME BOMB
LOGOFF).
02F0 752 Bitstring 1 VMDCTPWD DIAGNOSE LINK PASSWORD COUNT
02F1 753 Bitstring 1 VMDMLVL MESSAGE RECEIVING LEVEL
1... .... VMDMSGON X'80' VMDMSGON CONTROLS WHETHER
MESSAGES SENT BY OTHER USERS ARE
DISPLAYED. (CONTROLLED BY THE SET
MSG OR TERMINAL MSG COMMANDS)
.1.. .... VMDWNGON X'40' VMDWNGON CONTROLS WHETHER
MESSAGES SENT USING THE WARNING
COMMAND ARE DISPLAYED.
(CONTROLLED BY THE SET WNG OR
TERMINAL WNG COMMANDS)
..1. .... VMDMCODE X'20' VMDMCODE CONTROLS ERROR
MESSAGE DISPLAY OF THE ERROR
MESSAGE CODE. (CONTROLLED BY THE
SET EMSG OR TERMINAL EMSG
COMMANDS)
...1 .... VMDMTEXT X'10' VMDMTEXT CONTROLS ERROR
MESSAGE DISPLAY OF THE ERROR
MESSAGE TEXT. (CONTROLLED BY THE
SET EMSG OR TERMINAL EMSG
COMMANDS)
.... 1... VMDSPMSG X'08' VMDSPMSG CONTROLS WHETHER
SPECIAL MESSAGES SENT BY OTHER
USERS CAN BE RECEIVED.
(CONTROLLED BY THE SET SMSG
COMMAND)
.... .1.. VMDMIMSG X'04' VMDMIMSG CONTROLS THE
DISPLAY OF SELECTED CP COMMAND
INFORMATIONAL RESPONSES. IF SET
THE RESPONSES ARE DISPLAYED, IF
NOT THE RESPONSES WILL NOT BE
DISPLAYED. (CONTROLLED BY THE SET
IMSG AND TERMINAL IMSG COMMANDS)
.... ...1 VMDMCNFG X'01' VMDMCNFG Message level set
from system configuration file
02F2 754 Bitstring 1 VMDMIUCV 'SET' command IUCV flags
1... .... VMDMSGIU X'80' VMDMSGIU Indicates that MSG
is set to IUCV.
.1.. .... VMDWNGIU X'40' VMDWNGIU Indicates that WNG
is set to IUCV.
..1. .... VMDEMSGI X'20' VMDEMSGI Indicates that
EMSG is set to IUCV.
.... 1... VMDSMSGI X'08' VMDSMSGI Indicates that
SMSG is set to IUCV.
.... .1.. VMDIMSGI X'04' VMDIMSGI Indicates that
IMSG is set to IUCV.
.... ..1. VMDCPCOI X'02' VMDCPCOI Indicates that
CPCONIO is set to IUCV.
.... ...1 VMDVMCOI X'01' VMDVMCOI Indicates that
VMCONIO is set to IUCV.
02F3 755 Bitstring 1 VMDMSSFL Message System Service flags
1... .... VMDMSSVP X'80' VMDMSSVP Indicates there is
a valid path to the Message
System Service (and that the
field VMDPTHID is therefore
valid).
.1.. .... VMDMSSCS X'40' VMDMSSCS Indicates that an
IUCV "connect" is in progress to
the *MSG System Service.
..1. .... VMDMSAVP X'20' VMDMSAVP Indicates there is
a valid path to the *MSGALL
System Service (and that the
field VMDMAPTH is therefore
valid).
...1 .... VMDMSACS X'10' VMDMSACS Indicates that
connection processing has started
(and possibly completed) for a
path to *MSGALL.
02F4 756 Signed 2 VMDPTHID The path id for the userid's
connection to the Message System
Service. This field is only valid
when the flag VMDMSSVP is set.
NOTE: This is the path ID from
the perspective of the *MSG
system service, not the guest.
02F6 758 Signed 2 VMDMAPTH The path id for the *MSGALL
System Service's connection to
this userid. This field is only
valid when the flag VMDMSAVP is
set. NOTE: This is the path ID
from the perspective of the
*MSGALL system service, not the
guest.
02F8 760 Bitstring 1 VMDMLVL2 Additional message level flags
This Byte is Modified only when
the user is in under console
function mode
1... .... VMDSILNT X'80' VMDSILNT Command running
silently This Bit is SET/RESET
only when console function mode
is held at the beginning of the
SILENTLY Command OR Logon/Logoff
.1.. .... VMDSILEN X'40' VMDSILEN Command enabled
for silencing This Bit is
SET/RESET only when console
function mode is held at the
beginning of normal command
execution or logoff
..1. .... VMDFOR X'20' VMDFOR Command output for
another user This Bit is
SET/RESET only when console
function mode is held at the
beginning/end of command
execution
.... ..1. VMDATCMD X'02' VMDATCMD Indicates that
this VMDBK was created as a
result of the AT command. This
bit is valid in all VMDBKs and
only turned on when the VMDBK is
created on the target system. It
is not altered at any other time.
.... ...1 VMDATEX X'01' VMDATEX Indicates that this
VMDBK is in the midst of a local
AT command. This bit is valid in
all VMDBKs and only changed in
HCPXAT (while under Console
Function mode) when a local AT
command begins or ends
02F9 761 Bitstring 1 VMDLOGCT COUNT OF INVALID LOGON ATTEMPTS
02FA 762 Signed 2 VMDCTRAU Count of AUTOLOG commands that
reject because of incorrect
passwords. Valid only in ORIGIN
VMDBK. Serialization: Console
function mode. Should not be
changed over a system incident.
02FC 764 Signed 4 VMDTREXT ADDRESS OF EXTENDED TRACE BLOCK
VMDTREXT VMDTREX3 00001 VMDTREXT+3,1 OVLY FOR TEST
OF LOW-ORDER BYTE
0300 768 Dbl-Word 8 VMDABEXE (0) Abort exit address and parameter
0300 768 Address 4 VMDABEXA Address of abort exit routine.
Valid in any MP VMDBK, and only
for that VMDBK. A zero value
indicates that no abort exit has
been set. Set using the HCPCFMAE
SET macro. Reset using the
HCPCFMAE CLEAR macro. Serialized
by the target VMDBK being the
currently-executing VMDBK.
0304 772 Signed 4 VMDABEXP Parameter for abort exit routine.
Valid in any MP VMDBK, and only
if VMDABEXA is not zero. Set
using the HCPCFMAE SET macro.
Reset using the HCPCFMAE CLEAR
macro. Serialized by the target
VMDBK being the
currently-executing VMDBK.
0308 776 Character 8 VMDHXID UserID who told us to HX Valid in
ORIGIN VMDBK only
0310 784 Address 8 VMDBUFAE Guest real address fields for a
buffer to receive the next
console function output for
commands issued via the Diagnose
x'08' instruction. This field is
initially set to the address
provided by the guest in the
Diagnose instruction and is
continually changed as output is
moved to the buffer.
DEBUGGING AND PATCH AREA FOR IBM SERVICING USE
0318 792 Signed 4 * RESERVED FOR FUTURE IBM USE
031C 796 Signed 4 * RESERVED FOR FUTURE IBM USE
THIS AREA CAN BE USED TO SET A LOCAL TRAP WHICH IS
ACTIVE ONLY FOR AN INDIVIDUAL USER. THE TRAP WOULD
BE ACTIVATED BY 'BAL R14,VMDEBUG1'. USERS FOR WHICH
THE TRAP DO NOT APPLY WOULD CONTAIN 'BR R14' IN THE
DEBUG AREA. THE USER FOR WHICH THE TRAP IS TO BE
EFFECTIVE WOULD HAVE A BRANCH INSTRUCTION REPLACING
THE 'BR R14', WHICH WOULD BRANCH TO THE TRAP CODE.
THE TRAP CODE WOULD LATER RETURN ON R14.
THE FOLLOWING 8 HALFWORDS MUST EACH BE INITIALIZED TO
BR R14
0320 800 Signed 2 VMDEBUG1 (2) RESERVED FOR PATCHING, DEBUGGING
0324 804 Signed 2 VMDEBUG2 (2) RESERVED FOR PATCHING, DEBUGGING
0328 808 Signed 2 VMDEBUG3 (2) RESERVED FOR PATCHING, DEBUGGING
032C 812 Signed 2 VMDEBUG4 (2) RESERVED FOR PATCHING, DEBUGGING
THE ABOVE EIGHT HALFWORDS MUST
EACH BE INITIALIZED TO BR R14
0330 816 Signed 4 VMDEBUG5 RESERVED FOR PATCHING, DEBUGGING
0334 820 Signed 4 VMDEBUG6 RESERVED FOR PATCHING, DEBUGGING
0338 824 Signed 4 VMDEBUG7 RESERVED FOR PATCHING, DEBUGGING
033C 828 Signed 4 VMDEBUG8 RESERVED FOR PATCHING, DEBUGGING
Guest access registers
0340 832 Bitstring 64 VMDARS (0) Guest value of access registers
0-15.
0340 832 Signed 4 VMDAR0 Access register 0
0344 836 Signed 4 VMDAR1 Access register 1
0348 840 Signed 4 VMDAR2 Access register 2
034C 844 Signed 4 VMDAR3 Access register 3
0350 848 Signed 4 VMDAR4 Access register 4
0354 852 Signed 4 VMDAR5 Access register 5
0358 856 Signed 4 VMDAR6 Access register 6
035C 860 Signed 4 VMDAR7 Access register 7
0360 864 Signed 4 VMDAR8 Access register 8
0364 868 Signed 4 VMDAR9 Access register 9
0368 872 Signed 4 VMDAR10 Access register 10
036C 876 Signed 4 VMDAR11 Access register 11
0370 880 Signed 4 VMDAR12 Access register 12
0374 884 Signed 4 VMDAR13 Access register 13
0378 888 Signed 4 VMDAR14 Access register 14
037C 892 Signed 4 VMDAR15 Access register 15
Guest general registers
0380 896 Bitstring 64 VMDGPRS (0) GUEST GENERAL PURPOSE REGISTERS
0-15.
00000383 VMDGPRLO VMDGPRS+3,1 TO ACCESS LOW-ORDER
BYTE OF A GUEST GPR
0380 896 Signed 4 VMDGPR0 GUEST GENERAL PURPOSE REGISTER 0
0384 900 Signed 4 VMDGPR1 GUEST GENERAL PURPOSE REGISTER 1
0388 904 Signed 4 VMDGPR2 GUEST GENERAL PURPOSE REGISTER 2
038C 908 Signed 4 VMDGPR3 GUEST GENERAL PURPOSE REGISTER 3
0390 912 Signed 4 VMDGPR4 GUEST GENERAL PURPOSE REGISTER 4
0394 916 Signed 4 VMDGPR5 GUEST GENERAL PURPOSE REGISTER 5
0398 920 Signed 4 VMDGPR6 GUEST GENERAL PURPOSE REGISTER 6
039C 924 Signed 4 VMDGPR7 GUEST GENERAL PURPOSE REGISTER 7
03A0 928 Signed 4 VMDGPR8 GUEST GENERAL PURPOSE REGISTER 8
03A4 932 Signed 4 VMDGPR9 GUEST GENERAL PURPOSE REGISTER 9
03A8 936 Signed 4 VMDGPR10 GUEST GENERAL PURPOSE REGISTER 10
03AC 940 Signed 4 VMDGPR11 GUEST GENERAL PURPOSE REGISTER 11
03B0 944 Signed 4 VMDGPR12 GUEST GENERAL PURPOSE REGISTER 12
03B4 948 Signed 4 VMDGPR13 GUEST GENERAL PURPOSE REGISTER 13
03B8 952 Dbl-Word 8 VMDGPE45 (0) GUEST GPR 14-15 FOR SIE TRANSFER
03B8 952 Signed 4 VMDGPR14 GUEST GENERAL PURPOSE REGISTER 14
03BC 956 Signed 4 VMDGPR15 GUEST GENERAL PURPOSE REGISTER 15
03C0 960 Bitstring 64 * Reserved for IBM use
0380 896 Bitstring 128 VMDGGRS (0) General-Purpose Registers
0380 896 Dbl-Word 8 VMDGGR0 General-Purpose Register 0
0388 904 Dbl-Word 8 VMDGGR1 General-Purpose Register 1
0390 912 Dbl-Word 8 VMDGGR2 General-Purpose Register 2
0398 920 Dbl-Word 8 VMDGGR3 General-Purpose Register 3
03A0 928 Dbl-Word 8 VMDGGR4 General-Purpose Register 4
03A8 936 Dbl-Word 8 VMDGGR5 General-Purpose Register 5
03B0 944 Dbl-Word 8 VMDGGR6 General-Purpose Register 6
03B8 952 Dbl-Word 8 VMDGGR7 General-Purpose Register 7
03C0 960 Dbl-Word 8 VMDGGR8 General-Purpose Register 8
03C8 968 Dbl-Word 8 VMDGGR9 General-Purpose Register 9
03D0 976 Dbl-Word 8 VMDGGR10 General-Purpose Register 10
03D8 984 Dbl-Word 8 VMDGGR11 General-Purpose Register 11
03E0 992 Dbl-Word 8 VMDGGR12 General-Purpose Register 12
03E8 1000 Dbl-Word 8 VMDGGR13 General-Purpose Register 13
03F0 1008 Bitstring 16 VMDGG145 (0) Covers both GPR 14 and 15
03F0 1008 Dbl-Word 8 VMDGGR14 General-Purpose Register 14
03F8 1016 Dbl-Word 8 VMDGGR15 General-Purpose Register 15
Reserved for future IBM use
NOTES : This section of the VMDBK may be
overlaid in the vSIE VMDBK definition, so
care should be taken when using this
reserved area. Any fields defined here
should only be used in non-vSIE VMDBKs.
0400 1024 Bitstring 128 VMDVSIEO (0) Non-vSIE VMDBK area
0400 1024 Bitstring 120 * Reserved for future IBM use
Reserved for non-vSIE use
0478 1144 Address 4 VMDFPVRB Floating-Point(/Vector) Register
Block address (FPRBK or VECBK).
If VMDMFEAT.VMDVVECT=1 then it
points to a VECBK. Serialized by
CFM or iStream.
047C 1148 Signed 2 VMDVRLEN Vector Register length in bytes
Serialized by CFM or iStream.
047E 1150 Signed 2 * Reserved for future non-vSIE use
00000080 VMDVSIL1 *-VMDVSIEO Length of area for
vSIE overlay **----- End of
VMDVSIEO area
******************************--
Guest CPU Definition and Status Region
0480 1152 Bitstring 1 VMDNTMOD INTERCEPTION CODE 36 MODIFIER
00000004 VMDNTFIO 04 VMDNTFIO I/O INTERRUPTION
00000008 VMDNTFRS 08 VMDNTFRS RESTART INTERRUPTION
0000000C VMDNTFMC 12 VMDNTFMC MACHINE CHECK
INTERRUPTION
00000010 VMDNTFEX 16 VMDNTFEX SIMULATED EXTERNAL
INTERRUPTION
00000014 VMDNTFPG 20 VMDNTFPG SIMULATED PROGRAM
INTERRUPTION
0000001C VMDNTFPF 28 VMDNTFPF HOST PAGE FAULT ON
USER PAGE
00000020 VMDNTFGX 32 VMDNTFGX UNSTACKED GOTO/CPEX
FOR ENDOP
00000024 VMDNTFIS 36 VMDNTFIS INTERRUPT SCAN, I/O,
EXTERNAL
00000028 VMDNTXDS 40 VMDNTXDS Exception driven
simulation
0481 1153 Bitstring 1 VMDWPEND WORK PENDING STATUS
1... .... VMDPDPPF X'80' VMDPDPPF Reflect an initial
PAGEX program interrupt to the
guest.
.1.. .... VMDCKPSW X'40' VMDCKPSW CHECK THE FORMAT
OF THE GUEST PSW. WHENEVER A NEW
GUEST PSW IS ESTABLISHED EITHER
FROM STARTING THE GUEST RUNNING
FOLLOWING SOME STOPPED STATE OR
WHEN SWAPPING PSWS TO REFLECT AN
INTERRUPT TO THE GUEST, THIS BIT
IS SET REQUESTING THE NEW GUEST
PSW TO BE EXAMINED AND VALIDATED.
WHEN SET, THE GUEST'S PSW IS
VALIDATED BEFORE ENTERING SIE FOR
THE GUEST.
..1. .... VMDPDTMR X'20' VMDPDTMR UPDATE THE GUEST
INTERVAL TIMER
...1 .... VMDPDIRP X'10' VMDPDIRP SCAN GUEST
INTERRUPTION LISTS
.... 1... VMDPDCFM X'08' VMDPDCFM PERFORM CONSOLE
FUNCTION
.... .1.. VMDPDSIE X'04' VMDPDSIE Force an entry to
SIE
.... ..1. VMDPDTRD X'02' VMDPDTRD TRACE DISPLAY IS
PENDING
.... ...1 VMDPD9CW X'01' VMDPD9CW One or more vCPUs
may be in Diag 9C soft-wait on
this VMDBK. Take any VMDBK that
was soft-waiting on this VMDBK
out of soft-wait.
0482 1154 Bitstring 1 VMDIPEND Interrupt pending and ENDOP work
pending Significant in all
VMDBKS, serialized by Dispatch
Lock.
1... .... VMDXTKEY X'80' VMDXTKEY SIGNIFIES THAT AN
EXTERNAL KEY INTERRUPT IS PENDING
FOR THE GUEST.
.1.. .... VMDUNRIO X'40' VMDUNRIO Indicates an
unreflectible I/O interruption is
pending for this virtual CPU.
This bit is turned on when a
partially enabled (for I/O)
BC-mode PSW is encountered and
there are interruptions pending
for non-enabled channels. This
bit is inspected and an
interruption scan may be
requested: - when handling a wait
state interception from SIE - at
minor time slice end (this acts
as a "polling" mechanism to catch
guest enablement changes).
..1. .... VMDEXMCK X'20' VMDEXMCK THIS BIT IS SET TO
INDICATE AN EXIGENT MACHINE CHECK
HAS BEEN MADE PENDING FOR THE
GUEST AND A GOTO WAS STACKED TO
ENTER HCPENDOP TO BEGIN
PROCESSING TO REFLECT THE EXIGENT
MACHINE CHECK.
...1 .... VMDVOPHI X'10' VMDVOPHI HCPVOP is holding
the IPTE lock to be released at
ENDOP.
0483 1155 Bitstring 1 VMDTYPE Identifies the VMDBK type. May
only be one of the defined types.
00000000 VMDTYPPR 00 VMDTYPPR PROTOTYPE VMDBK
00000058 VMDTYPSY 88 VMDTYPSY SYSTEM VMDBK
00000015 VMDTYPUS 21 VMDTYPUS USER VMDBK
0000001F VMDTYPAD 31 VMDTYPAD USER ADJUNCT VMDBK
00000017 VMDTYPMP 23 VMDTYPMP USER DEFINED CPU
(GUEST MP)
0000002C VMDTYPSI 44 VMDTYPSI USER VIRTUAL SIE
VMDBK
0484 1156 Bitstring 1 VMDGTLB GUEST TLB STATUS
..1. .... VMDGPTLB X'20' VMDGPTLB GUEST PTLB WAS
SIMULATED. FOR SIMULATION OF THE
PTLB INSTRUCTION AND FOR
SIMULATION OF OTHER INSTRUCTIONS
THAT REQUIRE CLEARING THE TLB,
VMDGPTLB IS SET.
...1 .... VMDINVPG X'10' VMDINVPG One or more frames
backing guest-absolute storage,
or one or more PGMBKs / page
tables, have been reclaimed by
Storage Management, possibly
obsoleting shadow page-table or
segment-table entries.
0485 1157 Bitstring 1 VMDGSTAT GUEST VIRTUAL RUNNING STATUS
1... .... VMDVSIE X'80' VMDVSIE GUEST IS IN V/SIE
MODE. THIS BIT IS SET WHEN
SIMULATING A SIE INSTRUCTION,
AFTER A V/SIE VMDBK HAS BEEN
BUILT, AND ALL SIE ENTRY VALIDITY
CHECKS ARE COMPLETE IN
PREPARATION FOR ENTERING
EMULATION. IT IS RESET AFTER AN
INTERRUPT OR INTERCEPT TAKES US
OUT OF EMULATION AND THE VGUEST
STATE DESCRIPTOR IS MADE TO
APPEAR AS THOUGH SIE WERE JUST
EXITED FOR THAT GUEST.
.1.. .... VMDRGPER X'40' VMDRGPER PRESERVE A PENDING
PER INTERRUPT DURING THE
SIMULATION OF A GUEST SIE
INSTRUCTION. THE PENDING PER
INTERRUPT IS CLEARED DURING THE
SIMULATION OF SIE TO PREVENT IT
FROM BEING REFLECTED PREMATURELY
IN THE EVENT OF A SUBSEQUENT
INTERRUPT.
..1. .... VMDRGTRD X'20' VMDRGTRD PRESERVE A PENDING
TRACE DISPLAY DURING THE
SIMULATION OF A GUEST SIE
INSTRUCTION. THE PENDING TRACE
DISPLAY IS CLEARED DURING THE
SIMULATION OF SIE TO PREVENT THE
DISPLAY FROM OCCURRING
PREMATURELY IN THE EVENT OF A
SUBSEQUENT INTERRUPT.
...1 .... VMDIPTLH X'10' VMDIPTLH IPTE LOCK HELD FOR
THIS VIRTUAL CPU. FOR VIRTUAL MP,
THE IPTE LOCK (THE SYSTEM CONTROL
AREA POINTED TO BY SIEISCAA) WILL
BE OBTAINED SHARED FOR A PAGEABLE
VGUEST. THIS IS DONE TO
SYNCHRONIZE THE CASE WHERE ONE
VGUEST IS IN SIE MODE, AND
ANOTHER VGUEST ISSUES AN IPTE.
THE SYNCHRONIZATION IS NEEDED TO
KEEP THE SHADOW TABLES OF THE
FIRST VGUEST UP TO DATE WITH THE
PAGE TABLES AFFECTED BY THE IPTE.
.... 1... VMDSCALK X'08' VMDSCALK PAGE CONTAINING
THE SYSTEM CONTROL AREA (SCA) IS
LOCKED FOR A PAGEABLE RGUEST.
THIS IS SET BY V/SIE SUPPORT IN
PREPARATION FOR ISSUING SIE FOR
THE V/SIE VMDBK. IT IS RESET WHEN
THE RGUEST IS REMOVED FROM V/SIE
MODE.
0486 1158 Bitstring 1 VMDTIMER GUEST TIMER CONTROLS Serialized
by CFM-or-Istream
1... .... VMDPTRQ X'80' VMDPTRQ GUEST TIMERS ARE
BEING TRACKED DURING GUEST
PSW-WAIT STATE. (SEE ALSO
VMDPTRQQ AND VMDPTRQL.)
.1.. .... VMDITMRL X'40' VMDITMRL THIS BIT
DESIGNATES THAT THE INTERVAL
TIMER IS TO BE UPDATED DURING
BOTH RUN AND WAIT TIME FOR THE
USER. THE SET TIMER COMMAND
CONTROLS THE SETTING OF THIS BIT.
..1. .... VMDVPTRK X'20' VMDVPTRK GUEST CPU TIMER
BEING TRACKED. BEFORE A V/SIE
VMDBK IS RUN, THE CPU TIMER IS
SET TO THE SMALLER OF EITHER THE
CURRENT HOST CPU TIMER OR THE
SMALLEST RGUEST TIMER VALUE (CPU
TIMER OR CLOCK COMPARATOR
INTERVAL). VMDVPTRK IS SET TO
INDICATE WHEN THE RGUEST TIMER
VALUE IS USED. (USED ONLY DURING
THE SIMULATION OF A GUEST SIE
INSTRUCTION).
...1 .... VMDTODAC X'10' VMDTODAC TOD CLOCK
ACCOUNTING FLAG FLAG INDICATING
THE TOD CLOCK ACCOUNTING
INTERFACE IS ACTIVE (DIAGNOSE
X'70'). SEE VMDTODAI, VMDTODAIR
.... 1... VMDINTTR X'08' VMDINTTR This bit is set to
indicate that an interval timer
interrupt is pending for an ESA
family guest running with
370ACCOM set on.
.... .1.. VMDITMRI X'04' VMDITMRI Interval timer
interrupt pending (Applies only
to ESA/390 guest machines with
370 mode accomodation (SET
370ACCOM ON).)
.... ..1. VMDITMOF X'02' VMDITMOF Guest interval
timer disabled (Applies only to
ESA/390 guest machines with 370
mode accomodation (SET 370ACCOM
ON). The SET TIMER command
controls the setting of this
bit.)
0487 1159 Bitstring 1 VMDTRCTL GUEST MACHINE TRACING CONTROL
1... .... VMDTRACT X'80' VMDTRACT TRACE ACTIVE BIT.
THIS BIT IS SET WHEN THE GUEST IS
USING THE TRACE FACILITY AND
THERE IS AN ACTIVE TRACE SET
WHICH CONTAINS ACTIVE TRACE
TRAPS. WHEN THIS BIT IS SET, IT
IS POSSIBLE THAT EXECUTION OF THE
GUEST MACHINE MAY HALT BECAUSE A
TRACE TRAP IS HIT.
.1.. .... VMDTRALT X'40' VMDTRALT TRACE ALTERED BIT.
THIS BIT IS SET WHEN THE GUEST IS
USING THE TRACE FACILITY AND
TRACE HAS DECIDED THAT THE
GUEST'S PSW AND/OR CONTROL
REGISTERS MUST BE ALTERED TO
ACCOMPLISH THE REQUESTED TRACING
FUNCTION.
..1. .... VMDTRCTR X'20' VMDTRCTR CCW TRACING
ACTIVE, TERMINAL
...1 .... VMDTRCPR X'10' VMDTRCPR CCW TRACING
ACTIVE, PRINTER
..11 .... VMDTRCCW VMDTRCTR+VMDTRCPR VMDTRCCW CCW
TRACING ACTIVE
.... 1... VMDTRTRS X'08' VMDTRTRS TRSOURCE trace.
This bit is set when the guest is
enabled for TRSOURCE trace.
.... .1.. VMDTRTRA X'04' VMDTRTRA TRSOURCE trace
alter bit. This bit is set when
the guest is using the TRSOURCE
trace facility and the guest's
state descriptor has been
altered.
.... ..1. VMDTRTBL X'02' VMDTRTBL TRSOURCE trace
bit. This bit is set to indicate
the user is only allowed to be in
an enabled BLOCK-mode trace.
0488 1160 Signed 2 VMDPRGIL THE VGUEST INSTRUCTION LENGTH
CODE IS MAINTAINED IN THIS FIELD
FOR INSTRUCTIONS SIMULATED IN
V/SIE.
048A 1162 Bitstring 1 VMDWSTAT PSEUDO-WAIT CONDITIONS
1... .... VMDWTPAG X'80' VMDWTPAG GUEST IS IN PAGE
WAIT. THIS IS A SOFT (OR PSEUDO)
WAIT STATE ENTERED FROM HANDLING
A HOST PAGE FAULT FOR A GUEST
PAGE. THE SOFT WAIT STATE IS
ENDED WHEN THE PAGING OPERATION
COMPLETES OR IF THE GUEST
RECEIVES AN I/O, OR EXTERNAL
INTERRUPT, OR ENTERS A COMMAND.
.1.. .... VMDWTTIO X'40' VMDWTTIO GUEST IS IN
TIO-BUSY WAIT
..1. .... VMDWTTSC X'20' VMDWTTSC GUEST IS IN
TSCH-BUSY WAIT
...1 .... VMDWIUCV X'10' VMDWIUCV Indicate IUCV soft
wait
.... 1... VMDWT9C X'08' VMDWT9C Indicate Diag 9C
soft wait
.... ...1 VMDWCFCP X'01' VMDWCFCP Indicate CF is in
a soft wait
048B 1163 Bitstring 1 VMDCFGEM Virtual configuration indicators.
This field is valid in the base
VMDBK only. Updates to it are
serialized by CFM, read access
requires CFM or
exclusive-from-CFM.
1... .... VMDNOISI X'80' Configuration can not use
iSIE.
.1.. .... VMDCPUAF X'40' CPUAFFinity is requested
for this virtual configuration
This bit requires scheduler lock
serialization to modify.
048C 1164 Bitstring 1 VMDSTFNX Index into either the logical or
real address array of the STFLE
section (ARDSISEC) of the guest's
ARD. Used to locate this guest's
STFL/STFLE output.
048D 1165 Bitstring 1 VMDPUTYP CPU type This byte requires
scheduler lock serialization to
modify.
048E 1166 Bitstring 1 VMDPUST CPU Status flag
1... .... VMDAFSUP X'80' VMDAFSUP Indicates that
CPUAFFinity is suppressed for
this virtual CPU. This bit
requires scheduler lock
serialization to modify.
.1.. .... VMDIBMU1 X'40' VMDIBMU1 Already in use by
IBM.
..1. .... VMDSECPR X'20' VMDSECPR CPU is defined as
a secondary processor.
048F 1167 Bitstring 1 VMDDSPTY CPU type for dispatch This byte
requires scheduler lock
serialization to modify.
0490 1168 Signed 8 VMDPTLBT (0) TOD clock at last host TLB purge
request for this user. This field
is compared to the saved TOD
value at the last TLB purge
(whether by PTLB or CSP/G) on the
current CPU (via PFXPTLBT) to
determine whether the TLB must be
purged prior to the space being
attached (that is, dispatch of
the user VMDBK, HCPACCESS of the
user's space by CP, or running a
vSIE VMDBK in emulation mode).
0490 1168 Signed 4 VMDPTLHI FIRST WORD OF VMDPTLBT
0494 1172 Signed 4 VMDPTLLO SECOND WORD OF VMDPTLBT
0498 1176 Signed 4 VMDMSO MAIN STORAGE ORIGIN FOR NON-
PAGEABLE GUEST
049C 1180 Signed 4 VMDMSL MAIN STORAGE LIMIT FOR NON-
PAGEABLE GUEST
04A0 1184 Address 8 VMDVMDRA Host real addr of VMDBK/SIEBK
04A8 1192 Address 4 VMDSCALA Host logical addr of SCABK (The
host real addr of SCABK is stored
in SIEISCAA)
04AC 1196 Signed 2 VMDCPUAD CPU ADDRESS OF VIRTUAL CPU
04AE 1198 Bitstring 1 VMDIAGF1 Diagnose option flags I. Valid in
all VMDBKs.
..1. .... VMD8GSDM X'20' VMD8GSDM GSDBK located by
VMDCFBUF is a multi-command
GSDBK. (This flag belongs in the
GSDBK, but GSDTYPE and GSDFLAG
are all used up and there are no
free flags to use. Accordingly,
be extremely sensitive to the
need to reset this flag when the
GSDBK is released.)
...1 .... VMD8GSDJ X'10' VMD8GSDJ GSDBK located by
VMDCFBUF has been logged by
HCPDOCLG. (This flag belongs in
the GSDBK, but GSDTYPE and
GSDFLAG are all used up and there
are no free flags to use.
Accordingly, be extremely
sensitive to the need to reset
this flag when the GSDBK is
released.)
.... .1.. VMD8LOCK X'04' VMD8LOCK User may not issue
SET D8ONECMD against himself.
.... ..1. VMD8LOG X'02' VMD8LOG Watch for (and log)
diagnose 8 instructions that
specify multiple commands.
.... ...1 VMD8FAIL X'01' VMD8FAIL Disallow diagnose
8 instructions that specify
multiple commands. VMD8LOG must
also be on.
04AF 1199 Bitstring 1 VMDIAGF2 Diagnose and guest option flags
II. Valid in all VMDBKs.
1... .... VMDNOFSL X'80' VMDNOFSL No fair share
limit applies. Set at LOGON if
the NOMDCFS option is specified
on the OPTIONS statement in the
user's direct- ory.
.1.. .... VMDCSRMI X'40' VMDCSRMI The Virtual
machine is authorized to obtain
real machine information. This
bit is set at logon if the
RMCHINFO option is specified on
the options statement in the
user's directory
..1. .... VMDNOINS X'20' VMDNOINS User is prevented
from inserting any tracks into
the minidisk cache. (set when SET
MDC INS OFF is issued)
...1 .... VMDLXAP X'10' VMDLXAP This virtual
machine is author- ized to issue
some diagnose functions for Linux
applications. For the time being,
it authorizes the virtual machine
to issue Diag x'2C4'. Set at
LOGON when the directory option
LXAPP is specified
.... 1... VMDLNKS X'08' VMDLNKS This virtual
machine is author- ized to use
the LINK command with SR/SW/SM
access mode
.... .1.. VMDLNKE X'04' VMDLNKE This virtual
machine is author- ized to use
the LINK command with ER/EW
access mode and SR/SW/SM access
mode
.... ..1. VMDEXCLD X'02' VMDEXCLD User is to be
excluded from auditing/protection
by the external security manager
.... ...1 VMDSHARE X'01' VMDSHARE This virtual
machine is author- ized to use
the PERMIT function of the
ADRSPACE macro. Set at LOGON from
the user's directory if XCONFIG
ADDR SHARE is speci- fied. Valid
in all VMDBKs.
04B0 1200 Bitstring 1 VMDIAGFL DIAGNOSE AND GUEST OPTION FLAGS
1... .... VMDIAG98 X'80' VMDIAG98 This virtual
machine authorized to issue DIAG
X'98' real I/O facilities. Set at
LOGON from the directory. Valid
in all VMDBKs.
.1.. .... VMDLNKNP X'40' VMDLNKNP Allows guest to
link any DASD without directory
password authorization. VALID IN
ALL VMDBKS. Set at LOGON.
..1. .... VMDD84NP X'20' VMDD84NP Allows DIAG X'84'
to bypass directory password
authorization for subfunctions
when processing for guest with
this specified. VALID IN ALL
VMDBKS. Set at LOGON.
...1 .... VMDSETOR X'10' VMDSETOR This virtual
machine is author- ized to issue
the subfunction code zero with
DIAG F8. Set at LOGON from the
user's directory if OPTION
SETORIG is specified. Valid in
all VMDBKs.
.... 1... VMDDEVI X'08' VMDDEVI User is authorized
to receive relocation and real
device info about another user's
minidisk. Set via DIAG E4,
subcodes 0 and 1. Valid in all
VMDBKs. Set at LOGON.
.... .1.. VMDDEVM X'04' VMDDEVM User is authorized
to receive relocation and real
device info and to create a
read/write full- pack-overlay
minidisk. Valid in all VMDBKs.
Set at LOGON.
.... ..1. VMDMCCW X'02' VMDMCCW User is authorized
to execute diagnostic CCW's on
full pack diagnostic minidisks,
full pack overlay minidisks, and
dedicated DASD. Valid in all
VMDBKs. Set at LOGON.
.... ...1 VMDIAG88 X'01' VMDIAG88 User is authorized
to issue Diagnose 88 to validate
access and link minidisks. Valid
in all VMDBKs. Set at LOGON.
04B1 1201 Bitstring 1 VMDRFEAT GUEST MACHINE SIMULATION OPTIONS
SERIALIZED : WRITE IS CFM. READ
IS CFM OR EXCLUSIVE-FROM-CFM
.1.. .... VMDSVMST X'40' VMDSVMST SVMSTAT specified
in the OPTION directory card for
this user.
..1. .... VMDVMCFA X'20' VMDVMCFA VM COMMUNICATION
FACILITY ALLOWED. This bit is no
longer used. Now, a non-zero
value in VMDVMCB of the base
VMDBK indicates that one or more
processors in a virtual MP
complex are VMCF authorized. A
non-zero value for bit VMDVAUTH
in VMDVMCFA indicates that this
processor is VMCF authorized.
...1 .... VMDVERP X'10' VMDVERP VIRTUAL ERROR
RECORDING ACTIVE VMDVERP = 0
(DEFAULT) - CP INTERCEPTS GUEST
SVC76 AND PERFORMS ERROR
RECORDING ON BEHALF OF THE GUEST.
VMDVERP = 1 - SVC76 IS REFLECTED
TO THE GUEST.
.... 1... VMDCFLF X'08' VMDCFLF Guest machine is
authorized to join a CFLF I/O
configuration.
.... .1.. VMDCMSRV X'04' VMDCMSRV Guest machine is
authorized as a communication
server, set in base VMDBK by
VCTRL logon processing. Copied to
local cylic list.
.... ..1. VMDACTRC X'02' VMDACTRC GUEST MACHINE MAY
CREATE ACCOUNT RECORDS
.... ...1 VMDVTOD X'01' VMDVTOD The TODENABLE
option has been specified in the
OPTION statement in the
directory. Valid in all VMDBKs.
04B2 1202 Bitstring 1 VMDSTORE STORAGE OPTIONS Serialized by CFM
1... .... VMDPAGEX X'80' VMDPAGEX PSEUDO PAGE FAULT
OPTION ACTIVE
.1.. .... VMDPFTOK X'40' VMDPFTOK PFAULT page-fault
handshaking token has been set in
VMDPFAUL or VMDGPFAUL.
..1. .... VMDPFTK2 X'20' VMDPFTK2 Version 2 of
PFAULT is in effect. This bit
modifies VMDPFTOK. 64-bit
interface for z/Arch guests, host
primary support, PSW masking are
in version 2.
...1 .... VMDMASST X'10' VMDMASST Valid in all
VMDBKs. 0-MEMASSIST OFF,
1-MEMASSIST ON Flag to indicate
whether or not the CMM facility
is made available to the guest.
If the real machine supports CMM,
the flag will be set ON at logon.
The flag is also controlled by
the SET MEMASSIST command, and is
inherited by DEFINE CPU.
.... 1... VMDMAACT X'08' VMDMAACT Valid in all
VMDBKs. 1 - indicates that the
user has executed at least one
ESSA instr- uction since the last
virtual machine reset (i.e. is
actively using the CMM facility).
This flag is inherited by DEFINE
CPU.
.... .1.. VMDMAOFF X'04' VMDMAOFF Valid in all
VMDBKs. 1 - indicates that SET
MEMASSIST OFF has been issued for
this user, but that it will not
take effect until the next
virtual machine reset because the
user is using the CMM facility.
This flag is inherited by DEFINE
CPU.
04B3 1203 Bitstring 1 VMDEMCTL Emulation Controls. This field is
significant in all VMDBKs, is
serialized by the Dispatch Lock.
1... .... VMDBYPEW X'80' VMDBYPEW Bypass
Enabled-Wait Processing. This bit
is used to force an entry into
interpretive execution mode even
if the guest has an enabled-wait
PSW.
.1.. .... VMDALEDE X'40' VMDALEDE Alerting
deactivated. Set when an alert
interception is received to
indicate that alerting has been
deactivated, and therefore need
not be done so as part of normal
wake-up processing.
..1. .... VMDPTRQQ X'20' VMDPTRQQ The TRQBK
(anchored at VMDTRQPT) for
tracking timers during guest wait
state has been enqueued on the
queue of active (un-expired)
TRQBKs. When tracking timers for
guest wait state it is sometimes
not necessary to enqueue the
TRQBK. Therefore when VMDPTRQ is
set, VMDPTRQQ may or may not be
set. When VMDPTRQ is zero,
VMDPTRQQ will also be zero. See
also VMDPTRQL.
...1 .... VMDPTRQL X'10' VMDPTRQL We did not enqueue
the TRQBK (anchored at VMDTRQPT)
when we began tracking timers
during guest wait state, because
the Elapsed Time Slice end TRQBK
will pop first. It may have to be
enqueued later, if nothing else
takes the guest CPU out of wait
state before we inspect this bit
(drop from dispatch list). When
VMDPTRQ is set, VMDPTRQL may or
may not be set. When VMDPTRQ is
zero, VMDPTRQL will also be zero.
See also VMDPTRQQ.
.... 1... VMDSIUSR X'08' VMDSIUSR Indicates this
guest issues the SIE instruction.
Valid for V=F guests only. Set at
the first SIE intercept for a
Vcpu, it is used to show that the
test for iSIE enablement has been
done once.
.... .1.. VMDALERT X'04' VMDALERT Alert Processing
Required. The guest is capable of
I/O interruption passthru for
either adapter interrupts,
subchannel interrupts, or both.
The guest must be enabled for
hardware alerting.
04B4 1204 Bitstring 1 VMDCPUCT COUNT OF GUEST DEFINED CPUS.
VALUE IS ONE LESS THAN THE NUMBER
OF VIRTUAL CPUS IN THE
CONFIGURATION. (THE BASE CPU IS
NOT COUNTED FOR IT IS NOT GUEST
DEFINED.) KEEPS TRACE OF THE
NUMBER OF CPUS IN A GUEST VIRTUAL
MP CONFIGURATION. ALSO USED AS AN
INDICATION OF WHETHER THE GUEST
IS A VIRTUAL MP GUEST (A NON ZERO
VALUE INDICATES GUEST MP). This
field is serialized by Console
Function Mode (CFM) or I-stream.
04B5 1205 Bitstring 1 VMDCPULT MAX MP GUEST CPU COUNT LESS ONE
WHICH MAY BE DEFINED, INCL BASE
04B6 1206 Bitstring 1 VMDSTYPE STORAGE TYPE
.1.. .... VMDVF X'40' VMDVF This bit signifies
that the Guest is a V=F Guest.
The storage for the V=F Guest is
mapped from the Host Real storage
V=F Area as defined at system
generatation.
04B7 1207 Bitstring 1 VMDTODFL FLAG FOR TIME-OF-DAY CLOCK BUSY.
THIS IS MAINTAINED BY TEST-AND-
SET TO PREVENT MORE THAN ONE
STACKED CALL-FROM-CFM BECOMING
PENDING FOR SCK FUNCTIONS TO BE
EXECUTED WITH ALL VIRTUAL CPUS AT
ENDOP.
04B8 1208 Bitstring 1 VMDILFNC INDICATOR OF WHAT CP FUNCTION(S)
REQUIRED NOTIFICATION OF GUEST
PSW CHANGES
1... .... VMDILIOP X'80' VMDILIOP I/O PASS THROUGH
04B9 1209 Bitstring 1 VMDMCFLG Monitor call intercept flags
1... .... VMDMC10I X'80' VMDMC10I Intercept monitor
call class 10
...1 .... VMDMC10E X'10' VMDMC10E Status of guest
CR8 Monitor call class 10
Enhanced-Monitor Mask bit
setting.
.... 1... VMDMCLC8 X'08' VMDMCLC8 Status of
intercept LCTL CR8 flag in SIEBK
.... .1.. VMDMCSTC X'04' VMDMCSTC Status of
intercept STCTL flag in SIEBK
.... ..1. VMDMCPRG X'02' VMDMCPRG Status of
intercept program interruptions
flag in SIEBK
.... ...1 VMDMC10S X'01' VMDMC10S Status of guest
CR8 Monitor call 10 bit
04BA 1210 Bitstring 1 VMDRCAPG Recording-Capable-Guest flag in
base VMDBK, Serialized by
I-stream, reset by CFM
00000000 VMDRCGNO X'00' VMDRCGNO Guest is not
recording capable.
000000FF VMDRCG76 X'FF' VMDRCG76
Recording-Capable-Guest, Guest
issued SVC76 with IPL record.
04BB 1211 Bitstring 1 VMDVMCF VMCF-specific flags
Serialization: CFM or I-stream
1... .... VMDVAUTH X'80' VMDVAUTH Virtual processor
is authorized for VMCF. Bit is
valid in all (base and non-base)
VMDBKs
04BC 1212 Address 4 VMDCHPPT POINTER TO INOP CHPID ARRAY THE
INOPERATIVE CHPID ARRAY IS A 256
BIT (32 BYTE) ARRAY WHERE BITS 0
TO 255 REPRESENT CHPIDS 0 TO 255.
A BIT IS ON IF THE ASSOCIATED
CHANNEL PATH IS NOT OPERATIONAL
(I.E. A CHANNEL PATH TERMINAL CRW
HAS BEEN RECEIVED FOR IT AND IT
HAS NOT BEEN SUCCESSFULLY
RECOVERED).
04C0 1216 Signed 4 VMDCACHN Number of Minidisk Cache inserts
during interval. No seriali-
zation. Valid in Base and MP
VMDBKs.
NOTES : The VMDMMODE field has a long history, very little
of which is relevant today. The description of its
fields has been cleaned up, with the result, one
hopes, of making it somewhat clearer.
IMPORTANT:
Tempting as it may be, it is NOT a good idea to
change the bit position of any of these fields,
since there is at least one place in the system
that depends on them: the KEYENTRY macro in HCPCDE.
More information concerning these bits and when they are
set may be found in HCPCFSMA, the SET MACHINE command
processor.
The bits in this field are used by the HCPVMODE macro to
determine a guest's architectural mode.
04C4 1220 Bitstring 1 VMDMMODE Virtual machine type and
architectural mode.
1... .... VMDMRG32 X'80' VMDMRG32 Guest is in
ESA/390 mode, i.e. has 32-bit
registers.
.1.. .... VMDMRG64 X'40' VMDMRG64 Guest is in
z/Architecture mode, i.e. has
64-bit registers.
.... 1... VMDMZ X'08' VMDMZ Guest is
z/Architecture-only. Bit is on
for SET MACHINE Z
.... .1.. VMDMXC X'04' VMDMXC Guest is ESA/XC
mode. Bit is on for SET MACHINE
XC
.... ..1. VMDMESA X'02' VMDMESA Guest is ESA mode.
Bit is on for SET MACHINE ESA, Z,
or XA
.... ...1 VMDM370 X'01' VMDM370 Guest is S/370
mode. This is obsolete and is
never set, but is retained
because it is referenced
throughout the system
04C5 1221 Bitstring 1 VMDMFEAT Feature byte. Valid in all VMDBK.
Serialized by CFM-or-istream.
1... .... VMDSETXA X'80' VMDSETXA Indicates that the
SET MACHINE XA command was
issued.
.1.. .... VMD370AC X'40' VMD370AC Indicates that the
370 Accommodation facility is
active (as by the 'SET 370ACCOM
ON' command).
..1. .... VMDVEXFP X'20' VMDVEXFP Indicates that the
guest is enabled for extended
floating-point facilities
...1 .... VMDVVECT X'10' VMDVVECT Indicates that the
guest is enabled for vector
facilities and VMDFPVRB points to
a VECBK
04C6 1222 Signed 2 VMDSTDV (0) Storage Device Management options
04C6 1222 Bitstring 1 VMDSTDV1 STDEVOPT flag 1
1... .... VMDLIBC X'80' VMDLIBC Guest has library
control. Valid in all VMDBKs.
.1.. .... VMDTZA X'40' VMDTZA Guest has CONCOPY
authorization
04C7 1223 Bitstring 1 VMDCPUSC The number of scheduleable
virtual CPUs in the virtual
configuration - valid only in the
base VMDBK and serialized by the
scheduler lock. This number is
one less than the actual number
of virtual CPUs.
04C8 1224 Dbl-Word 8 VMDGTEID (0) The translation-exception
identification associated with a
(host) page-, segment-,
region-third-, region-second-, or
region-first translation
exception. Serialized by the
Dispatch Lock. Meaningful (at
times) in every VMDBK in the
local-cyclic list.
04C8 1224 Bitstring 7 * (top bytes of fault id)
04CF 1231 Bitstring 1 VMDGTEI7
04D0 1232 Signed 4 VMDIBMU2 Already in use by IBM.
04D4 1236 Bitstring 1 VMDFEAID The exception access
identification associated with a
(host) page- or segment-
translation exception. Serialized
by Dispatch Lock. Meaningful
(sometimes) in every VMDBK in the
local-cyclic list. VMDGTEID and
VMDFEAID are updated together
with no loss of control in
between.
04D5 1237 Bitstring 1 * Reserved for IBM use
VMDVLTBL is a VDEV lookaside table used to eliminate the
need to scan the VDEV radix trees. VMDVLADD is the device
id and VMDVLLOC is the VDEV address. Searching the
lookaside requires i-stream serialization and purging the
lookaside (across virtual CPUs) requires console function
mode. These fields are managed exclusively by the
HCPVLKUP macro.
These fields are not valid for SYSTEM VMDBKs.
04D6 1238 Bitstring 6 VMDVLTBL (0) Lookaside table
04D6 1238 Signed 2 VMDVLADD Device address
04D8 1240 Address 4 VMDVLLOC VDEV location
04DC 1244 Signed 4 * Reserved for future IBM use
04E0 1248 Bitstring 1 * Reserved for future IBM use
04E1 1249 Bitstring 1 VMDCFDIR Virtual Crypto Facility
definition. (Valid only on the
base.)
1... .... VMDCRYPT X'80' VMDCRYPT CRYPTO control
statement was specified in the
user's directory entry.
.... 1... VMDAPCR X'08' VMDAPCR Authorized to issue
AP crypto instructions in
directory entry (APVIRT - shared
access)
.... .1.. VMDAPDED X'04' VMDAPDED Authorized to
issue AP crypto instructions in
directory entry (APDED -
dedicated acess)
04E2 1250 Bitstring 1 * Reserved for future IBM use
04E3 1251 Bitstring 1 * Reserved for future IBM use
04E4 1252 Bitstring 1 * Reserved for future IBM use
04E5 1253 Bitstring 1 VMDMSTAT Virtual Machine status flags
(valid for base VMDBK only)
1... .... VMDSIGAC X'80' VMDSIGAC A signal (e.g.,
shutdown) is active for this
guest
04E6 1254 Bitstring 1 VMDVOPF1 Various HCPVOP flags
1... .... VMDVOPGI X'80' VMDVOPGI Tell VOP to get
the IPTE lock
.1.. .... VMDVOPXS X'40' VMDVOPXS Exit specified
04E7 1255 Bitstring 1 VMDCRYMF Miscellaneous crypto flags
1... .... VMDAPMS X'80' VMDAPMS Authorized to
obtain data from the
AP-Crypto-Measurement-Data
facility. This bit is set at
logon when CRYMeasure is
specified on the OPTION statement
in the user directory entry.
VMDPPRLG will contain the address of the Pending Page
Release Log or zero. When VMDPPRLG is non-zero, VMDPPRCR
will point to the next available entry in the log. Bit
0 of VMDPPRCR acts as a lock bit to serialize access to
the log (0 means available) and is manipulated with CS.
04E8 1256 Signed 4 VMDPPRLG Pending Page Release Log
04EC 1260 Signed 4 VMDPPRCR Pending Page Release CuRsor
FIELDS FOR INSTRUCTION OPERAND PROCESSING
04F0 1264 Signed 4 VMDVOBUF THIS FIELD IS USED DURING
INSTRUCTION SIMULATION AND TRACE
PROCESSING TO FIND THE VIRTUAL
OPERAND BUFFER. THE VIRTUAL
OPERAND BUFFER IS USED TO PASS
THE OPERANDS OF A GUEST
INSTRUCTION TO AND FROM MODULE
HCPVOP. This buffer is also used
to pass parameters between
HCPVINOP and HCPVOP for
HCPVINOP's compare and swap
functions.
00000000 VMDVOCMP 0 Offset of the compare parameter
in the VMDVOBUF buffer.
00000008 VMDVOSWP 8 Offset of the swap parameter in
the VMDVOBUF buffer.
00000021 VMDVOSIZ 33 Simulation buffer length in
doublewords.
00000020 VMDVOWSZ VMDVOSIZ-1 Simulation buffer
length in doublwords minus 1
doubleword 32 DOUBLEWORDS ARE THE
LARGEST OPERANDS POSSIBLE, (EX:
MVC INSTRUCTION.) ONE EXTRA
DOUBLEWORD IS NEEDED FOR
ALIGNMENT PURPOSES WHICH ALLOWS
BLOCK CONSISTENT ACCESS TO
OPERANDS IN GUEST STORAGE.
04F4 1268 Signed 4 VMDVOSAV Simulation savearea stack anchor.
To reduce the path length in a
performance sensitive path, a
stack of SVGBK save areas is
allocated when the VMDBK is
created. Frequently called module
HCPVOP uses saveareas from this
VMDBK local HCPVOP savearea stack
rather than dynamically obtaining
and releasing saveareas.
00000002 VMDVODEP 2 Depth of HCPVOP simulation save
area stack
04F8 1272 Dbl-Word 8 VMDCPCA (0) CP communication area fields must
be contiguous and on a DWB
04F8 1272 Signed 4 VMDCPCAA Guest absolute address of CP
communication area
04FC 1276 Signed 4 VMDCPCAS Size of CP communication area in
fullwords
0500 1280 Signed 4 VMDFPCR (0) Floating-point control register
0500 1280 Bitstring 1 VMDFPCB0 FPCR byte 0, masks
0501 1281 Bitstring 1 VMDFPCB1 FPCR byte 1, flags
0502 1282 Bitstring 1 VMDFPCB2 FPCR byte 2, DXC / VXC
0503 1283 Bitstring 1 VMDFPCB3 FPCR byte 3, DRM / BRM
0504 1284 Signed 4 VMDVOPBK HCPVOP simulation fetch/store
work area. Like the VMDVOSAV
stack above, this VMDBK local
work area is obtained when the
VMDBK is created, and released
when the VMDBK is destroyed.
GUEST CPU EXTERNAL, MACHINE CHECK INTERRUPTIONS
0508 1288 Dbl-Word 8 * (0)
0508 1288 Bitstring 20 VMDXT (0) EXTERNAL INTERRUPT PENDING DATA.
0508 1288 Dbl-Word 8 VMDXTMFA A BIT MASK FOR THE SOURCE VIRTUAL
CPUS WHICH HAVE MADE MALFUNCTION
ALERTS PENDING ON THIS VIRTUAL
CPU. THIS MASK IS USED TO FIND
ALL VIRTUAL CPUS WHICH HAVE MADE
A MALFUNCTION ALERT PENDING ON
THIS VIRTUAL CPU.
0510 1296 Dbl-Word 8 VMDXTEMS A BIT MASK OF THE SOURCE VIRTUAL
CPUS WHICH HAVE MADE EXTERNAL
EMERGENCY SIGNALS PENDING ON THIS
VIRTUAL CPU. THIS MASK IS USED TO
FIND ALL VIRTUAL CPUS WHICH HAVE
MADE EXTERNAL EMERGENCY SIGNALS
TO THIS VIRTUAL CPU.
0518 1304 Signed 4 VMDXTSFI ANCHOR OF PENDING SFXBK'S. SFXBKS
ARE USED TO MAINTAIN THE DATA
REQUIRED FOR GUEST SOFTWARE
EXTERNAL INTERRUPTS WHILE THE
INTERRUPT IS PENDING.
051C 1308 Signed 4 * Reserved for future IBM use
0520 1312 Signed 4 VMDTRQPT ADDRESS OF TRQBK FOR GUEST TIMERS
WHILE THE GUEST IS IN A WAIT
STATE.
0524 1316 Address 4 VMD9CWVM Address of VMDBK this VMDBK is
soft-waiting on.
0528 1320 Signed 4 VMDSWTIM Soft wait target time (TOD 0-31)
052C 1324 Signed 4 * Reserved for IBM use
0530 1328 Signed 4 VMDSFIPM (0) SOFTWARE-GENERATED-INTERRUPT
ENABLEMENT MASK Updates to this
field require console function
mode or instruction-stream
serialization
0530 1328 Bitstring 1 VMDSFIP0 SOFTWARE INTERRUPT MASK BYTE 0
0531 1329 Bitstring 1 VMDSFIP1 SOFTWARE INTERRUPT MASK BYTE 1
1... .... SFXIMVMC X'80' SFXIMVMC VMCF INTERRUPTION
MASK
.... 1... SFXIMTZN X'08' SFXIMTZN Normal Time Zone
Interrupt mask
.... .1.. SFXIMTZC X'04' SFXIMTZC Control Pgm Time
Zone Int. mask
0532 1330 Bitstring 1 VMDSFIP2 SOFTWARE INTERRUPT MASK BYTE 2
0533 1331 Bitstring 1 VMDSFIP3 SOFTWARE INTERRUPT MASK BYTE 3
FLOATING INTERRUPTION STATUS
0534 1332 Signed 4 VMDFIN POINTER TO FLOATING INTERRUPTION
QUEUE CONTROL (FINBK). THE FINBK
MAINTAINS A GUEST'S PENDING
FLOATING EXTERNAL INTERRUPTS.
0538 1336 Signed 4 VMDPPFPT LIST OF PSEUDO PAGE FAULT PENDING
INTERRUPTS (PPFBLOK) Serialized
by dispatch lock
053C 1340 Signed 2 VMDPPFCT Count of pseudo page faults for
pages not yet resolved (those for
which an initial PAGEX interrupt
has been reflected, but no
completion interrupt has been
reflected yet).
053E 1342 Signed 2 * Reserved for future IBM use
VIRTUAL MACHINE CHECK SIMULATION FIELDS
0540 1344 Signed 4 VMDMCV POINTER TO MCVBK, FOR GUEST
PENDING NON-FLOATING MACHINE
CHECK INTERRUPTS. A SINGLE MCVBK
IS ADDRESSED BY THIS FIELD THAT
CONTAINS ALL NON-FLOATING MACHINE
CHECK CONDITIONS THAT ARE PENDING
AGAINST THIS VIRTUAL MACHINE.
0544 1348 Signed 4 VMDCTFLT Count of host segment and page
faults on guest pages while
running this virtual CPU.
0548 1352 Signed 4 VMDSVPBK Pointer to SCLP Information
Control Block. When an operating
system that uses the system
console (as a guest it would use
the logon console as the system
console) for communication issues
the first write-event-mask SCLP
command, an SVPBK is created and
anchored here. Valid only in the
base VMDBK.
054C 1356 Signed 4 VMDMSGCT Count of queued message blocks.
This equals the number of CPEBKs
currently stacked on the system
VMDBK to write out I/O error
messages resulting from I/O that
was initiated by this user. This
field is valid in all VMDBK's, is
serialized using compare and
swap.
0550 1360 Bitstring 1 VMDDMPFL Dump Function byte. For Base
VMDBK only. Bits in this byte are
for VMDUMP / Diagnose 94 and are
are not serialized by any formal
locking mechanism. All of these
bits are turned ON or OFF in code
that is running at a time when no
other tasks except for VMDUMP are
executing. That is, this byte may
only be altered in single-
threaded parts of a vmdump or
Diagnose 94 operation.
1... .... VMDCONTM X'80' VMDCONTM Indicates guest is
in continuous output mode
.1.. .... VMDDG94 X'40' VMDDG94 Indicates guest is
processing a Diagnose 94
0551 1361 Bitstring 1 VMDDATFL User default date format flag
This field serialized by Console
Function Mode
0552 1362 Bitstring 1 * RESERVED FOR FUTURE IBM USE, Be
0553 1363 Bitstring 1 * RESERVED FOR FUTURE IBM USE, Be
0554 1364 Signed 4 VMDVDUPT Address of VDUBK. For base VMDBK
only.
Virtual Console and Real Terminal Region
0558 1368 Signed 4 VMDRTERM USER DISPLAY STATION RDEVBK
ADDRESS. THIS IS THE RDEV OF THE
DISPLAY STATION THE USER LOGGED
ON TO.
055C 1372 Signed 4 VMDVCONS GUEST CONSOLE VDEVBLOK ADDRESS
0560 1376 Bitstring 1 VMDTOPTN USER DEFINED DISPLAY STATION
OPTIONS
1... .... VMDCLEXT X'80' VMDCLEXT AN EXTERNAL
INTERRUPT IS TO BE SIMULATED TO
THE VIRTUAL MACHINE WHEN THE PA2
KEY IS HIT. (ONLY WHEN IN VM
READ, MORE, OR HOLDING STATUS AND
THE TERMINAL APL ON COMMAND HAS
BEEN ISSUED.)
.1.. .... VMDEDIT X'40' VMDEDIT SPECIFIES THAT
EDITING, USING THE USER DEFINED
EDITING CHARACTERS, IS TO BE DONE
ON CONSOLE INPUT.
..1. .... VMDATTCP X'20' VMDATTCP ONE OR MORE
ATTENTIONS ON THE CONSOLE WILL
PUT THE CONSOLE INTO CP READ
MODE.
...1 .... VMDTSTAM X'10' VMDTSTAM REQUEST TIME STAMP
ON CP OUTPUT
.... 1... VMDNOBKY X'08' VMDNOBKY TERMINAL BREAK-KEY
IS DISABLED
.... .1.. VMDPFIKY X'04' VMDPFIKY IMMEDIATE PF KEY
REQUEST
.... ..1. VMDGSTCL X'02' VMDGSTCL BREAKIN IN
GUESTCTL (VALID ONLY IN ORIGIN
VMDBK)
.... ...1 VMDHLITE X'01' VMDHLITE TERMINAL HILIGHT
FLAG
0561 1377 Bitstring 1 VMDSCREN MORE AND HOLDING STATUS FOR THE
DISPLAY SCREEN.
1... .... VMDCRMOR X'80' VMDCRMOR DISPLAY SCREEN
AUTOMATICALLY CLEARS AFTER 60
SECONDS WITH A 10 SECOND ALARM
WARNING.
.1.. .... VMDCRHLD X'40' VMDCRHLD SCREEN GOES TO
'HOLDING' STATUS RATHER THAN
'MORE' IF ALARMED OUTPUT IS
PRESENT ON THE DISPLAY SCREEN.
..1. .... VMDNHOLD X'20' VMDNHOLD Stop screen from
going into ... HOLDING state
(AUTO_WARM_IPL and TERM HOLD OFF)
This bit (VMDNHOLD) is valid only
in the origin VMDBK
...1 .... VMDNULLD X'10' VMDNULLD Remember null text
entered, so VMDNHOLD does not
apply next time (switch MORE to
HOLDING)
0562 1378 Signed 2 VMDMORTM (0) Contains the time intervals from
MORE to beep to clear These
fields (VMDMORBP and VMDMORCL)
are valid only in the origin
VMDBK For a connected user they
are duplicated in RDEVMRTM in the
terminal RDEV (pointed to by
VMDRTERM)
0562 1378 Bitstring 1 VMDMORBP Contains the time from the
appearance of MORE to beep
(defaults to 50 seconds)
0563 1379 Bitstring 1 VMDMORCL Contains the time from the beep
to the screen clearing (defaults
to 10 seconds)
0564 1380 Bitstring 1 VMDTOPT2 USER DEFINED DISPLAY STATION
OPTIONS BYTE 2
1... .... VMDTLEOV X'80' VMDTLEOV THE DEFAULT
LINE-DELETE CHARACTER HAS BEEN
RESET FROM A CENT SIGN TO A LEFT
BRACKET AT LOGON FOR AN ASCII
TERMINAL.
.1.. .... VMDNOCTL X'40' VMDNOCTL USER SUPPLIED LINE
CONTROL CHARACTERS WILL BE USED
FOR A LINE MODE ASCII TERMINAL.
...1 .... VMDSTAMP X'10' VMDSTAMP Time stamp all
console output
.... 1... VMDBRMIN X'08' VMDBRMIN BREAKIN MINIMAL IN
EFFECT, WHEN SET VMDGSTCL IS ALSO
SET IN VMDTOPTN (VALID ONLY IN
ORIGIN VMDBK)
.... .1.. VMDAUTCR X'04' VMDAUTCR TERMINAL AUTOCR
OFF OPTION DEFAULT IS ON
.... ..1. VMDCFINP X'02' VMDCFINP The currently
active CP read was issued from
the origin VMDBK but the input
will be executed from the default
VMDBK (VMDCFCPU). This bit can
only be on in the origin VMDBK
and is only used to determine the
CPU prefix to use when
redisplaying command input in a
virtual MP.
0565 1381 Bitstring 1 VMDTRMDV REAL DISPLAY DEVICE STATUS
1... .... VMDTRMIO X'80' VMDTRMIO INDICATES TO I/O
SUBSYSTEM THAT THIS I/O HAS BEEN
INITIATED TO A REAL DISPLAY
DEVICE.
0566 1382 Bitstring 1 VMDBCSFL DBCS support flag
1... .... VMDBCLDI X'80' VMDBCLDI Linemode DBCS
Input Support ON
0567 1383 Bitstring 1 * Reserved for future IBM use
0568 1384 Signed 2 VMDCNFCT Count of entries into HCPCNFTS.
Used to determine when to open a
dispatch window.
056A 1386 Signed 2 VMDHPIC Saved host PIC used during host
fault handling caused by guest
accesses. TERMINAL INPUT LINE
EDITING CHARACTERS
056C 1388 Signed 4 VMDTEDIT (0) DISPLAY INPUT LINE EDITING
CHARACTERS
056C 1388 Character 1 VMDTLEND CONTAINS THE CHARACTER DEFINED AS
THE LINE END CHARACTER USED FOR
EDITING CONSOLE INPUT.
056D 1389 Character 1 VMDTLDEL CONTAINS THE CHARACTER DEFINED AS
THE LINE DELETE CHARACTER USED
FOR EDITING CONSOLE INPUT.
056E 1390 Character 1 VMDTCDEL CONTAINS THE CHARACTER DEFINED AS
THE CHARACTER DELETE CHARACTER
USED FOR EDITING CONSOLE INPUT.
056F 1391 Character 1 VMDTESCP CONTAINS THE CHARACTER DEFINED AS
THE ESCAPE CHARACTER USED FOR
EDITING CONSOLE INPUT.
EXTENDED COLOR AND EXTENDED HILIGHT FLAG BYTES
0570 1392 Character 1 VMDEXVMO VM OUTPUT Valid only in the base
VMDBK THE FOLLOWING EQUATES APPLY
TO THE EXTENDED COLOR AND
EXTENDED HILIGHT FLAG BYTES.
00000000 VMDEXNON X'00' VMDEXNON NONE
00000010 VMDEXBLI X'10' VMDEXBLI BLINKING
00000020 VMDEXREV X'20' VMDEXREV REVERSE VIDEO
00000040 VMDEXUND X'40' VMDEXUND UNDERSCORE
000000F0 VMDEXHGH X'F0' VMDEXHGH MASK TO ISOLATE
EXTENDED HILIGHTING.
00000000 VMDEXDEF X'00' VMDEXDEF DEFAULT
00000001 VMDEXBLU X'01' VMDEXBLU BLUE
00000002 VMDEXRED X'02' VMDEXRED RED
00000003 VMDEXPIN X'03' VMDEXPIN PINK
00000004 VMDEXGRE X'04' VMDEXGRE GREEN
00000005 VMDEXTUR X'05' VMDEXTUR TURQUIOSE
00000006 VMDEXYEL X'06' VMDEXYEL YELLOW
00000007 VMDEXWHI X'07' VMDEXWHI WHITE
0000000F VMDEXCOL X'0F' VMDEXCOL MASK TO ISOLATE
EXTENDED COLOR
0571 1393 Character 1 VMDEXINR INPUT REDISPLAY Valid only in the
base VMDBK
00000000 VMDEXNON X'00' VMDEXNON NONE
00000010 VMDEXBLI X'10' VMDEXBLI BLINKING
00000020 VMDEXREV X'20' VMDEXREV REVERSE VIDEO
00000040 VMDEXUND X'40' VMDEXUND UNDERSCORE
000000F0 VMDEXHGH X'F0' VMDEXHGH MASK TO ISOLATE
EXTENDED HILIGHTING.
00000000 VMDEXDEF X'00' VMDEXDEF DEFAULT
00000001 VMDEXBLU X'01' VMDEXBLU BLUE
00000002 VMDEXRED X'02' VMDEXRED RED
00000003 VMDEXPIN X'03' VMDEXPIN PINK
00000004 VMDEXGRE X'04' VMDEXGRE GREEN
00000005 VMDEXTUR X'05' VMDEXTUR TURQUIOSE
00000006 VMDEXYEL X'06' VMDEXYEL YELLOW
00000007 VMDEXWHI X'07' VMDEXWHI WHITE
0000000F VMDEXCOL X'0F' VMDEXCOL MASK TO ISOLATE
EXTENDED COLOR
0572 1394 Character 1 VMDEXINA INPUT AREA Valid only in the base
VMDBK
00000000 VMDEXNON X'00' VMDEXNON NONE
00000010 VMDEXBLI X'10' VMDEXBLI BLINKING
00000020 VMDEXREV X'20' VMDEXREV REVERSE VIDEO
00000040 VMDEXUND X'40' VMDEXUND UNDERSCORE
000000F0 VMDEXHGH X'F0' VMDEXHGH MASK TO ISOLATE
EXTENDED HILIGHTING.
00000000 VMDEXDEF X'00' VMDEXDEF DEFAULT
00000001 VMDEXBLU X'01' VMDEXBLU BLUE
00000002 VMDEXRED X'02' VMDEXRED RED
00000003 VMDEXPIN X'03' VMDEXPIN PINK
00000004 VMDEXGRE X'04' VMDEXGRE GREEN
00000005 VMDEXTUR X'05' VMDEXTUR TURQUIOSE
00000006 VMDEXYEL X'06' VMDEXYEL YELLOW
00000007 VMDEXWHI X'07' VMDEXWHI WHITE
0000000F VMDEXCOL X'0F' VMDEXCOL MASK TO ISOLATE
EXTENDED COLOR
0573 1395 Character 1 VMDEXSTA STATUS AREA Valid only in the
base VMDBK
00000000 VMDEXNON X'00' VMDEXNON NONE
00000010 VMDEXBLI X'10' VMDEXBLI BLINKING
00000020 VMDEXREV X'20' VMDEXREV REVERSE VIDEO
00000040 VMDEXUND X'40' VMDEXUND UNDERSCORE
000000F0 VMDEXHGH X'F0' VMDEXHGH MASK TO ISOLATE
EXTENDED HILIGHTING.
00000000 VMDEXDEF X'00' VMDEXDEF DEFAULT
00000001 VMDEXBLU X'01' VMDEXBLU BLUE
00000002 VMDEXRED X'02' VMDEXRED RED
00000003 VMDEXPIN X'03' VMDEXPIN PINK
00000004 VMDEXGRE X'04' VMDEXGRE GREEN
00000005 VMDEXTUR X'05' VMDEXTUR TURQUIOSE
00000006 VMDEXYEL X'06' VMDEXYEL YELLOW
00000007 VMDEXWHI X'07' VMDEXWHI WHITE
0000000F VMDEXCOL X'0F' VMDEXCOL MASK TO ISOLATE
EXTENDED COLOR
0574 1396 Character 1 VMDEXCPO CP OUTPUT Valid only in the base
VMDBK
00000000 VMDEXNON X'00' VMDEXNON NONE
00000010 VMDEXBLI X'10' VMDEXBLI BLINKING
00000020 VMDEXREV X'20' VMDEXREV REVERSE VIDEO
00000040 VMDEXUND X'40' VMDEXUND UNDERSCORE
000000F0 VMDEXHGH X'F0' VMDEXHGH MASK TO ISOLATE
EXTENDED HILIGHTING.
00000000 VMDEXDEF X'00' VMDEXDEF DEFAULT
00000001 VMDEXBLU X'01' VMDEXBLU BLUE
00000002 VMDEXRED X'02' VMDEXRED RED
00000003 VMDEXPIN X'03' VMDEXPIN PINK
00000004 VMDEXGRE X'04' VMDEXGRE GREEN
00000005 VMDEXTUR X'05' VMDEXTUR TURQUIOSE
00000006 VMDEXYEL X'06' VMDEXYEL YELLOW
00000007 VMDEXWHI X'07' VMDEXWHI WHITE
0000000F VMDEXCOL X'0F' VMDEXCOL MASK TO ISOLATE
EXTENDED COLOR
0575 1397 Bitstring 1 VMDTTAB TERMINAL TAB CHARACTER
0576 1398 Bitstring 1 VMDBRKKY USER DEFINED BREAK-IN BY CP KEY
0577 1399 Bitstring 1 * RESERVED FOR FUTURE IBM USE
0578 1400 Address 4 VMDPFUNC Address oF PFUNC block, which
contains pointers to the retrieve
buffer and PF key definitions
057C 1404 Address 4 VMDPCBUF putchar() buffer address
IPL Simulation status Region
0580 1408 Dbl-Word 8 VMDIPLNM DEVICE NUMBER in EBCDIC or Named
Saved System (NSS) name from the
last IPL. IF VMDIPDEV is set this
is the four-digit IPL device
number left justified; otherwise,
this is the NSS name left
justified and padded with blanks.
0588 1416 Signed 4 VMDICCPV DASD ADDRESS OF THE SAVED GUEST
PAGE THAT IS BEING USED FOR THE
IPL SIMULATOR FOR A PAGEABLE
GUEST.
058C 1420 Signed 4 VMDIADDR GUEST REAL ADDRESS OF IPL
SIMULATOR WITHIN GUEST STORAGE.
0590 1424 Bitstring 1 VMDIPLST GUEST IPL FLAGS AND STATUS
Serialized by the master
processor
1... .... VMDIPSSL X'80' VMDIPSSL
Store-status-on-load mode enabled
Valid for the base VMDBK only
.1.. .... VMDIPLAC X'40' VMDIPLAC IPL is active
Valid for the base VMDBK only
.... 1... VMDFIPSV X'08' VMDFIPSV INDICATES THAT THE
IPL SIMULATOR CURRENTLY RESIDES
IN A PAGE OF GUEST STORAGE. THE
GUEST PAGE HAS BEEN SAVED BY CP
DURING THE IPL.
.... .1.. VMDIPDEV X'04' VMDIPDEV Indicates that the
last IPL was done by device
number
.... ..1. VMDIPLOG X'02' VMDIPLOG An asynchronous
XAUTOLOG command requires that
the IPL statement be verified by
the IPL processor Valid for the
base VMDBK only
.... ...1 VMDIPVMI X'01' VMDIPVMI HCPVMI is needed
as the IPL simulator since the
IPL device is a DASD.
0591 1425 Bitstring 1 VMDIPLKY PRESERVES THE STORAGE KEY FROM
THE GUEST PAGE USED FOR THE IPL
SIMULATOR DURING A GUEST IPL.
0592 1426 Signed 2 * RESERVED FOR FUTURE IBM USE
0594 1428 Signed 4 VMDIVPAG IPL simulator Host Virtual
address of Guest page saved while
IPL is in progress.
0598 1432 Bitstring 4 VMDIPGST SAVED IPL PAGE STATUS INFO. SAVED
IPL PAGE STATUS INFORMATION IS
USED TO RESTORE THE GUEST SAVED
IPL PAGE FOLLOWING THE COMPLETION
OF THE IPL SIMULATOR. THE USE OF
THE PAGE BY THE IPL SIMULATOR
SHOULD NOT CHANGE ANY DATA IN THE
PAGE OR THE STATUS OF THE PAGE
UNLESS REQUESTED BY THE BY THE
GUEST USING THE CLEAR OPTION ON
THE IPL COMMAND.
059C 1436 Signed 4 * RESERVED FOR FUTURE IBM USE
05A0 1440 Character 8 VMDLDPRM IPL LOAD PARAMETER. (THIS FIELD
IS ONLY VALID IN A BASE VMDBK).
05A8 1448 Address 4 VMDPROBK POINTER TO USER'S PROTECT BLOCK
05AC 1452 Address 4 VMDIPLCM POINTER TO LAST IPL COMMAND
05B0 1456 Address 4 VMDSYNCH CPEBK pointer indicating a
synchronous AUTOLOG command is
waiting for completion of LOGON
and IPL processing on this target
VMDBK.
05B4 1460 Bitstring 2 * Reserved for future IBM use
05B6 1462 Bitstring 1 VMDCMDOP Command options
1... .... VMDUNDSC X'80' VMDUNDSC Display Underscore
.... ...1 VMDPSWTS X'01' VMDPSWTS PSWTRANS = STORE
.... ..1. VMDPSWTD X'02' VMDPSWTD PSWTRANS = DISPLAY
05B7 1463 Bitstring 1 VMDPROFL PROTECTED APPLICATION FLAGS
1... .... VMDPROAP X'80' VMDPROAP PROT. APPL.
ENVIRONMENT ACTIVE
.1.. .... VMDPROTB X'40' VMDPROTB Activated by time
bomb support
05B8 1464 Signed 4 VMDCAPQ Pointer to CAPBK control block
For Spool group APSS item, No
Serialization, for base vmdbk
05BC 1468 Address 4 VMDLANG ADDRESS OF THE ACTIVE LANGBK
LOGOFF control region
05C0 1472 Signed 4 VMDLGFBK LOGOFF control block Valid in
origin VMDBK only Serialized by
master processor.. for all
updates
05C4 1476 Signed 4 * Reserved
Message Control Region
05C8 1480 Address 4 VMDFIDTE FILEID TABLE ENTRY. Valid in all
VMDBKs.
05CC 1484 Signed 4 VMDPGSPL Total number of pages spooled for
this user. Includes pages spooled
for virtual rdr, prt, pun, cons,
dump and trace files.
05D0 1488 Dbl-Word 8 VMDSLAB Security label for user's VMDBK
05D8 1496 Dbl-Word 8 VMDALTSC Security label of alternate
userid (VMDALTID)
05E0 1504 Bitstring 1 VMDALSYN This byte serializes the VMDALTID
field via compare and swap logic.
1... .... VMDALD4O X'80' VMDALD4O Diagnose X'D4'
controls (owns) VMDALTID field.
..1. .... VMDALAPO X'20' VMDALAPO APPC/VM owns the
VMDALTID field
...1 .... VMDALAPW X'10' VMDALAPW An APPC/VM connect
is waiting to set the VMDALTID
field
05E1 1505 Bitstring 1 VMDSECF Secondary user's functionality
Bit USRFESEC in the USRBK is now
used to determine whether or not
a user is a viable secondary
1... .... VMDUSECO X'80' VMDUSECO This user's
secondary is observer
.1.. .... VMDUSECM X'40' VMDUSECM This user's
secondary has been MAC checked
..1. .... VMDUSECP X'20' VMDUSECP This user's
secondary passed MAC check
...1 .... VMDUSECA X'10' VMDUSECA Audit check for
SCIF done
05E2 1506 Bitstring 1 * (2) Reserved for IBM use
05E4 1508 Signed 4 VMDSECRQ Pointer to SCIF secondary read
request awaiting input by
secondary user.
05E8 1512 Character 8 VMDSECU Userid of the Secondary user.
VMDSECU is valid only in the
origin VMDBK. SCIF (Single
Console Image Facility) allows a
secondary user to provide console
services for a disconnected user.
05F0 1520 Character 8 VMDALTID Userid of an end user. All spool
files created while this file is
not zero, will have this userid
as the originator, rather than
the userid in VMDUSER. Valid only
in base VMDBK. This field is
serialized by the VMDALSYN byte.
05F8 1528 Signed 4 VMDVSRCA (0) Virtual Start Request Counter
Array used to count number of
virtual start requests for a
given device.
00000000 VMDOFCON *-VMDVSRCA Offset to console I/O
count
05F8 1528 Signed 4 VMDVCSCT Count of start requests to the
virtual machine console.
00000004 VMDOFDAS *-VMDVSRCA Offset to DASD I/O
count
05FC 1532 Signed 4 VMDVDSCT Count of virtual I/O requests the
virtual machine has issued to
DASD devices.
00000008 VMDOFOTH *-VMDVSRCA Offset to other I/O
count
0600 1536 Signed 4 VMDVOSCT Count of start requests to
devices not defined in array.
0000000C VMDOFCTC *-VMDVSRCA Offset to CTCA I/O
count
0604 1540 Signed 4 VMDVTSCT Count of start requests to
virtual CTCAs.
00000010 VMDOFUR *-VMDVSRCA Offset to unit record
I/O count
0608 1544 Signed 4 VMDVUSCT Count of start requests to
virtual unit record devices.
060C 1548 Signed 4 VMDX98CT Number of times Diagnose x'98'
was issued by this virtual
machine
0610 1552 Bitstring 1 VMDCMDAU ACI 'Audit' Authorized privilege
classes - byte 0. Serialized by
CFM
1... .... CLASSA X'80' CLASSA CLASS A FUNCTIONS
.1.. .... CLASSB X'40' CLASSB CLASS B FUNCTIONS
..1. .... CLASSC X'20' CLASSC CLASS C FUNCTIONS
...1 .... CLASSD X'10' CLASSD CLASS D FUNCTIONS
.... 1... CLASSE X'08' CLASSE CLASS E FUNCTIONS
.... .1.. CLASSF X'04' CLASSF CLASS F FUNCTIONS
.... ..1. CLASSG X'02' CLASSG CLASS G FUNCTIONS
.... ...1 CLASSH X'01' CLASSH CLASS H FUNCTIONS
0611 1553 Bitstring 1 VMDCMDPR ACI 'Protect' Authorized
privilege classes - byte 0
Serialized by CFM
1... .... CLASSA X'80' CLASSA CLASS A FUNCTIONS
.1.. .... CLASSB X'40' CLASSB CLASS B FUNCTIONS
..1. .... CLASSC X'20' CLASSC CLASS C FUNCTIONS
...1 .... CLASSD X'10' CLASSD CLASS D FUNCTIONS
.... 1... CLASSE X'08' CLASSE CLASS E FUNCTIONS
.... .1.. CLASSF X'04' CLASSF CLASS F FUNCTIONS
.... ..1. CLASSG X'02' CLASSG CLASS G FUNCTIONS
.... ...1 CLASSH X'01' CLASSH CLASS H FUNCTIONS
0612 1554 Bitstring 1 VMDSECU1 Security Flag, serialized by CFM
1... .... VMDDGNAU X'80' VMDDGNAU Audit Diagnose,
Origin VMDBK
.1.. .... VMDDGNPR X'40' VMDDGNPR Protect Diagnose,
Origin VMDBK
..1. .... VMDANYAU X'20' VMDANYAU Audit setting of
the 'ANY' command version
...1 .... VMDANYPR X'10' VMDANYPR Protect setting of
the 'ANY' command version
.... 1... VMDANYMC X'08' VMDANYMC MAC setting of the
'ANY' command version
.... .1.. VMDDGNMC X'04' VMDDGNMC MAC setting of a
diagnose
0613 1555 Bitstring 1 VMDESMID Reserved for ESM use
0614 1556 Signed 4 VMDCSQOP (3) CP command name, or SET operand,
or QUERY operand. Serialized by
CFM.
0620 1568 Signed 4 VMDACIMP address of the user security
extension, or 0 if none exists
0624 1572 Signed 4 VMD9CTAR VMDBK address of the guest CPU
targeted by Diag '9C'
0628 1576 Signed 4 VMDLALTR Time stamp (TOD high order) used
to determine when next to call
the DPPCA timed roll-up routine
(HCPLALTR). This is done about
once a second for each vConfig.
This field is updated in base
VMDBK only.
062C 1580 Signed 4 VMDUNSTK Normal CPEBK PUSH-THRU dequeue
list. Only valid in SYSTEM or
SYSTEMMP VMDBK.
0630 1584 Dbl-Word 8 * RESERVED FOR IBM USE
0638 1592 Address 4 VMDIBM3 Already in use by IBM
063C 1596 Address 4 VMDAPVBK Addr of AP crypto virtual block
valid on all VMDBKs; obtained at
logon/released at logoff requires
no serialization
0640 1600 Signed 4 VMDSHRPT POINTER TO THE USER'S SHRBK CHAIN
0644 1604 Signed 4 * Reserved for future IBM use
0648 1608 Dbl-Word 8 VMDBYVAL The BYUSER ID that logged on this
virtual machine. If there is no
BYUSER ID, this field is binary
zeros. The value of this field is
propagated to VMDBKs on the local
cyclic list. Updated on
reconnect, but not on disconnect.
Serialization: CFM, for updates
only
RESERVED FIELDS FOR INSTALLATION USE
Use the flags in VMDUSKCK and VMDUSRMV to inform
the live guest relocation process how to handle
the VMDUSER1-8 fields during a relocation attempt.
By default, any use of these fields will make a
user ineligible for relocation. If it is desired
that the eligibility check is skipped, set the
appropriate bit(s) in VMDUSKCK. If the value in
a field should be relocated along with the VMDBK,
set the appropriate skip bit and the corresponding
move bit in VMDUSRMV. If any of those flag bits
are turned on, changes to the corresponding
VMDUSER1-8 field must also be made under CFM
serialization.
(THIS AREA IS PERMANENTLY AVAILABLE, BUT MAY
BE MOVED TO ANOTHER OFFSET IN THE BLOCK AT A LATER
RELEASE OF THE SYSTEM.)
0650 1616 Signed 4 VMDUSER1 RESERVED FOR INSTALLATION USE
0654 1620 Signed 4 VMDUSER2 RESERVED FOR INSTALLATION USE
0658 1624 Signed 4 VMDUSER3 RESERVED FOR INSTALLATION USE
065C 1628 Signed 4 VMDUSER4 RESERVED FOR INSTALLATION USE
0660 1632 Signed 4 VMDUSER5 RESERVED FOR INSTALLATION USE
0664 1636 Signed 4 VMDUSER6 RESERVED FOR INSTALLATION USE
0668 1640 Signed 4 VMDUSER7 RESERVED FOR INSTALLATION USE
066C 1644 Signed 4 VMDUSER8 RESERVED FOR INSTALLATION USE
Dispatching Control Region
0670 1648 Signed 4 VMDQFPNT DISPATCH LIST FORWARD POINTER
0674 1652 Signed 4 VMDQBPNT DISPATCH LIST BACKWARD POINTER
THESE POINTERS ALSO USED IN
ELIGIBLE, DORMANT LISTS
0678 1656 Bitstring 1 VMDRSTAT RUNNING BLOCKAGE STATUS. THIS
FIELD CONTAINS FLAGS THAT PREVENT
A DISPATCHED VMDBK FROM BEING
RUN.
.1.. .... VMDCFWT X'40' VMDCFWT THE VMDBK IS IN
CONSOLE FUNCTION WAIT. EITHER A
CONSOLE FUNCTION IS ACTIVE, OR
THE VIRTUAL MACHINE IS WAITING
FOR THE REMAINING VMDBKS IN THE
CONFIGURATION TO ENTER CONSOLE
FUNCTION MODE. IN EITHER CASE,
UNTIL ALL PENDING CONSOLE
FUNCTIONS ARE SATISFIED FOR THE
VIRTUAL CONFIGURATION, THIS BIT
WILL REMAIN SET. THE DISPATCHER
ON FINDING THIS BIT SET WILL NOT
RUN A DISPATCHED VMDBK.
..1. .... VMDSIMWT X'20' VMDSIMWT PERFORMING GUEST
SIMULATION. THIS BIT IS SET WHEN
CP IS SIMULATING SOME HARDWARE
FUNCTION FOR THE GUEST
(INSTRUCTIONS, INTERRUPTS, TIMER
UPDATES). WHEN IN SIMULATION THE
DISPATCHER PREVENTS THE VIRTUAL
MACHINE FROM RUNNING TO AVOID
POTENTIAL CONFLICTS WITH THE
SIMULATION.
...1 .... VMDIOWT X'10' VMDIOWT INSTRUCTION WAITING
FOR I/O STATUS FOR COMPLETION.
(MAY BE CANCELLED WITHOUT LOSS OF
SYSTEM INTEGRITY.)
.... 1... VMDSIMAB X'08' VMDSIMAB An abort exit has
been established for this virtual
CPU. This bit is set by code
generated from the HCPCFMAE SET
macro, when an abort exit is
established. The path which sets
the abort exit is responsible for
clearing the exit via HCPCFMAE
CLEAR, before the virtual CPU
reaches end-op. This field is
tested at end-op to ensure that
the abort exit has indeed been
cleared. If not, a soft abend
will be taken.
0679 1657 Bitstring 1 VMDDLCTL DISPATCH LIST CONTROLS
.1.. .... VMDDSEND X'40' VMDDSEND DISPATCH TIME
SLICE EXCEEDED
..1. .... VMDLIMMV X'20' VMDLIMMV Indicates this
VMDBK should be moved to the
limit-list.
.... 1... VMDIDROP X'08' VMDIDROP USER SHOULD BE
DROPPED FROM THE DISPATCH LIST
IMMEDIATELY
.... .1.. VMDLOVMP X'04' VMDLOVMP VIRTUAL MP
VOLUNTARY DROP OF DISPATCH
PRIORITY BEHIND LOWEST VIRTUAL MP
CPU IN THE DISPATCH LIST
.... ..1. VMDREORD X'02' VMDREORD VMDBK IS TO BE
REORDERED IN THE DISPATCH LIST
.... ...1 VMDRSCEL X'01' VMDRSCEL VMDBK EXCEEDED
LIMITS OF A CONTROLLED RESOURCE.
VMDDLCTX IDENTIFIES THE RESOURCE.
1111 1111 VMDSTKDL X'FF' VMDSTKDL ANY BIT REQUIRES
HCPSTLDL CALL
067A 1658 Bitstring 1 VMDSTATE SCHEDULER/DISPATCHER STATE
IDENTIFICATION
00000063 VMDRVSPN 099 VMDRVSPN REVIEW SUSPENDED.
VMDBK SHOULD BE CHANGED TO
SUSPENDED STATE IF THE C/S WORK
BITS ARE ZERO, ELSE BACK TO
READY. (CODE MUST BE MORE THAN
VMDISPCH.) (VMDISPCH IS ALSO
IMPLIED.)
00000058 VMDRVIDL 088 VMDRVIDL REVIEW IDLE. VMDBK
SHOULD BE CHANGED TO TEST-IDLE
STATE IF THE C/S WORK BITS ARE
ZERO, ELSE BACK TO READY. (CODE
MUST BE MORE THAN VMDISPCH.)
(VMDISPCH IS ALSO IMPLIED.)
0000004D VMDISPCH 077 VMDISPCH VMDBK HAS BEEN
SELECTED BY THE DISPATCHER. THIS
CODE IS ALSO THE LOGICAL VMDBK
DISPATCH LOCK.
00000042 VMDREADY 066 VMDREADY VMDBK IS READY FOR
SELECTION BY THE DISPATCHER WHEN
THE VMDBK IS IN THE DISPATCH LIST
00000037 VMDTIDLE 055 VMDTIDLE TEST-IDLE. VMDBK IS
READY FOR SELECTION BY THE
DISPATCHER BUT SHOULD BE DROPPED
FROM THE DISPATCH LIST WHEN NEXT
SELECTED.
0000002C VMDSUSPN 044 VMDSUSPN VMDBK IS SUSPENDED,
WAITING FOR A (PROBABLY)
SHORT-TERM EVENT TO OCCUR.
00000000 VMDIDLE 000 VMDIDLE VMDBK IS IDLE, NO
WORK AVAILABLE
067B 1659 Bitstring 1 VMDSIMC Simulation wait codes Serialized
by VMDBK dispatch. Valid in all
virtual CPU VMDBKs
00000001 VMDAPPCW 1 VMDAPPCW Virtual CPU is in an
APPC WAIT
067C 1660 Bitstring 1 * RESERVED FOR FUTURE IBM USE
067D 1661 Bitstring 1 VMDDWFLG WORK DISPATCHING CONTROL FLAGS
THIS FLAG BYTE CONTAINS VARIOUS
WORK BITS DICTATING DISPATCHER
ACTIONS. IT IS SERIALIZED BY THE
DISPATCH LOCK.
.1.. .... VMDPPPR X'40' VMDPPPR Process Pending
Page Release
.... 1... VMDDWACO X'08' VMDDWACO VMDBK IS TO BE
DISPATCHED ON AFFINITY CPU ONLY
067E 1662 Bitstring 2 * Reserved for future IBM use
0680 1664 Signed 4 VMDQURCP URGENT CPEBK PUSH-THRU STACK
0684 1668 Signed 4 VMDQIORF IORBK/TRQBK PUSH-THRU STACK
0688 1672 Signed 4 VMDQCPEF CPEBK PUSH-THRU STACK
068C 1676 Signed 4 VMDDFRWK DEFERRED WORK COUNTER
COMPARE-AND-SWAP (C/S) WORK BITS
0690 1680 Signed 4 VMDWRKCS (0) COMPARE-AND-SWAP WORK BITS FIELD
WHEN ACCESSED AS A FULL-WORD. ALL
CHANGES TO THIS WORD MUST USE
COMPARE-AND-SWAP LOGIC. (FIELD
USED BY DSP/STK/DSW ONLY)
(FOLLOWING 4 BYTES CONSTITUTE THE
CONTENTS OF THIS FULL-WORD)
0690 1680 Bitstring 1 VMDWRKCD DISPATCHING/SCHEDULING WORK (BITS
USED BY DSP/STK/DSW ONLY)
1... .... VMDWKETS X'80' VMDWKETS ELAPSED TIME-SLICE
END PENDING
.1.. .... VMDWKHIP X'40' VMDWKHIP HI-PRIORITY
SCHEDULING REQUEST
..1. .... VMDWKMCO X'20' VMDWKMCO MASTER CPU ONLY
DISPATCH REQUIRED
...1 .... VMDWKGRL X'10' VMDWKGRL VMDBK exceeded WSS
Growth Limit
.... 1... VMDWKPRM X'08' VMDWKPRM VMDBK requires
pre-emption from Dispatch List
.... .1.. VMDWKCPX X'04' VMDWKCPX Virtual MP complex
dropped. (Used only in virtual MP
VMDBKs)
.... ..1. VMDWKLCK X'02' VMDWKLCK A user in the
d-list via the "lockshot"
mechanism (see VMDLKSHT) should
go back to the e-list for normal
scheduling.
0691 1681 Bitstring 1 VMDWRKCK EXECUTION-BLOCK STACK STATUS
(BITS USED BY DSP/STK/DSW ONLY)
1... .... VMDWKUCP X'80' VMDWKUCP URGENT CPEBK
STACKED
.1.. .... VMDWKIOR X'40' VMDWKIOR IORBK/TRQBK
STACKED
..1. .... VMDWKCPE X'20' VMDWKCPE CPEBK STACKED
.... 1... VMDWKCPF X'08' VMDWKCPF CPEBK STACKED FOR
CONSOLE FUNCTION
0692 1682 Bitstring 1 VMDWRKCL RESERVED FOR FUTURE IBM USE
(CORRESPONDS TO LOCAL-ONLY WORK
BITS IN VMDWRKLC)
0693 1683 Bitstring 1 VMDWRKCB STACKED WORK CONTROL BITS (USED
BY DSP/STK/DSW/PRG/TSA ONLY)
1... .... VMDWKCFM X'80' VMDWKCFM ENTER HCPCFM FOR
CONSOLE FUNCTION
.1.. .... VMDWKTST X'40' VMDWKTST ENTER HCPTSMRG FOR
TRACE TABLE SAVE (SYSTEM VMDBK
ONLY)
..1. .... VMDWKSIE X'20' VMDWKSIE Force an entry
into interpretive execution mode.
...1 .... VMDWKALE X'10' VMDWKALE Handle an alert
condition. This forces an entry
into HCPALEWB.
.... 1... VMDWKMNI X'08' VMDWKMNI MONITOR IUCV:
initiate event IUCV SENDS for
MONITOR data when a direct call
is not possible or wanted.
(System VMDBK Only)
.... .1.. VMDWKMNX X'04' VMDWKMNX MONITOR IUCV:
initiate frame replenishment for
the MONITOR unused frame list
when a direct call is not
possible or wanted. (System VMDBK
Only)
.... ..1. VMDWKSCI X'02' VMDWKSCI REQUEST XA
SUBCHANNEL I/O INTERRUPT SCAN AND
RUN
.... ...1 VMDRECRT X'01' VMDRECRT Request the latest
certification of a virtual CPU's
primary and secondary address
spaces
LOCAL WORK BITS
0694 1684 Signed 4 VMDWRKLC (0) LOCAL WORK BITS (FOLLOWING 4
BYTES CONSTITUTE THE CONTENTS OF
THIS FULL-WORD) (NO
COMPARE-AND-SWAP CAN BE USED.)
0694 1684 Bitstring 1 VMDWRKLD DISPATCHING/SCHEDULING WORK (BITS
USED BY DSP/STK/DSW ONLY)
1... .... VMDWKETS X'80' VMDWKETS ELAPSED TIME-SLICE
END PENDING
.1.. .... VMDWKHIP X'40' VMDWKHIP HI-PRIORITY
SCHEDULING REQUEST
..1. .... VMDWKMCO X'20' VMDWKMCO MASTER CPU ONLY
DISPATCH REQUIRED
...1 .... VMDWKGRL X'10' VMDWKGRL VMDBK exceeded WSS
Growth Limit
.... 1... VMDWKPRM X'08' VMDWKPRM VMDBK requires
pre-emption from Dispatch List
.... .1.. VMDWKCPX X'04' VMDWKCPX Virtual MP complex
dropped. (Used only in virtual MP
VMDBKs)
.... ..1. VMDWKLCK X'02' VMDWKLCK A user in the
d-list via the "lockshot"
mechanism (see VMDLKSHT) should
go back to the e-list for normal
scheduling.
0695 1685 Bitstring 1 VMDWRKLK EXECUTION-BLOCK STACK STATUS
1... .... VMDWKUCP X'80' VMDWKUCP URGENT CPEBK
STACKED
.1.. .... VMDWKIOR X'40' VMDWKIOR IORBK/TRQBK
STACKED
..1. .... VMDWKCPE X'20' VMDWKCPE CPEBK STACKED
.... 1... VMDWKCPF X'08' VMDWKCPF CPEBK STACKED FOR
CONSOLE FUNCTION
0696 1686 Bitstring 1 VMDWRKLL LOCAL-ONLY WORK BITS
1... .... VMDWKPIN X'80' VMDWKPIN INDICATES A SIE
INTERCEPTION WAS PENDING WHEN SIE
WAS INTERRUPTED.
...1 .... VMDWKRUN X'10' VMDWKRUN INDICATES THAT
WHEN DISPATCHED, HCPRUNU MAY BE
ENTERED FOR THIS VMDBK TO RUN THE
VIRTUAL MACHINE, TAKE A GUEST
INTERRUPTION, ENTER CONSOLE
FUNCTION MODE, OR PERFORM OTHER
GUEST CPU ACTIVITY.
0697 1687 Bitstring 1 VMDWRKLB STACKED WORK CONTROL BITS
1... .... VMDWKCFM X'80' VMDWKCFM ENTER HCPCFM FOR
CONSOLE FUNCTION
.1.. .... VMDWKTST X'40' VMDWKTST ENTER HCPTSMRG FOR
TRACE TABLE SAVE (SYSTEM VMDBK
ONLY)
..1. .... VMDWKSIE X'20' VMDWKSIE Force an entry
into interpretive execution mode.
...1 .... VMDWKALE X'10' VMDWKALE Handle an alert
condition. This forces an entry
into HCPALEWB.
.... 1... VMDWKMNI X'08' VMDWKMNI MONITOR IUCV:
initiate event IUCV SENDS for
MONITOR data when a direct call
is not possible or wanted.
(System VMDBK Only)
.... .1.. VMDWKMNX X'04' VMDWKMNX MONITOR IUCV:
initiate frame replenishment for
the MONITOR unused frame list
when a direct call is not
possible or wanted. (System VMDBK
Only)
.... ..1. VMDWKSCI X'02' VMDWKSCI REQUEST XA
SUBCHANNEL I/O INTERRUPT SCAN AND
RUN
.... ...1 VMDRECRT X'01' VMDRECRT Request the latest
certification of a virtual CPU's
primary and secondary address
spaces
FEATURE AFFINITY MASKS:
0698 1688 Signed 4 VMDRPFTR REQUIRED PROCESSOR FEATURE MASK
069C 1692 Signed 4 * Reserved for future IBM use
06A0 1696 Address 4 VMDSSHBK Ptr to share settings block
(SSHBK) valid in all VMDBKs
06A4 1700 Signed 2 VMDDEDCA CPU ADDRESS OF DEDICATED CPU IF
VMDDEDFG.VMDISDED FLAG IS ON.
06A6 1702 Bitstring 1 VMDDEDFG DEDICATION FLAGS
1... .... VMDISDED X'80' VMDISDED This VMDBK has a
real CPU dedicated to it.
06A7 1703 Bitstring 1 VMDCMODE Virtual Configuration Mode
VMDCMODE valid in all VMDBKs
1... .... VMDCMESA X'80' VMDCMESA ESA390 / GENERAL
virtual configuration mode
.1.. .... VMDCMLIN X'40' VMDCMLIN Linux virtual
configuration mode
..1. .... VMDCMVM X'20' VMDCMVM VM virtual
configuration mode
...1 .... VMDCMCF X'10' VMDCMCF CF virtual
configuration mode
06A8 1704 Address 4 VMDADSV Actual Dispatch Vector. For each
VMDBK in a Dispatch Vector,
indicates the address of the
Dispatch Vector that the VMDBK is
currently in. For users who
aren't currently in a Dispatch
Vector, the contents of this
field are zeros. This field is
serialized by the scheduler lock.
06AC 1708 Signed 2 VMDHDSV Home Dispatch Vector For each
VMDBK in the system, indicates
Dispatch Vector to which this
VMDBK currently has soft
affinity. It is a displacement
into the list of Dispatch Vectors
of the vector this user should be
kept in. This field is meaningful
even for users who aren't
currently active or in the
Dispatch List to indicate what
Dispatch Vector they SHOULD be
put in when they become "ready",
or are added to the Dispatch
List. It is not necessarily the
Dispatch Vector the VMDBK is
CURRENTLY in (see the VMDADSV
field), it's the one it would
PREFER to be in. This field is
serialized by the scheduler lock.
00000007 VMDHDVSH 7 Number of bits a PFXINDEX value
must be shifted left to become a
VMDHDSV value.
06AE 1710 Signed 1 VMDTIDCT Current value of test-idle
tolerance or zero if test-idle
processing is not to be used for
this VMDBK. This field is used by
test-idle processing. It is
serialized by either the
scheduler lock exclusive or a
share of the scheduler lock plus
the VMDBK's home DSVBK lock.
06AF 1711 Bitstring 1 VMDALEFG Alerting Flags. This byte
contains reasons why a VMDBK is
unable to field "passthrough"
interruptions. When this byte is
non-zero, the VMDBK is considered
"interruption ineligible". This
field is significant in all V=F
VMDBKs, is serialized by the
Dispatch Lock.
1... .... VMDALEW X'80' VMDALEW Virtual CPU is in
enabled wait
.1.. .... VMDALVSI X'40' VMDALVSI VMDBK is in V/SIE
mode
..1. .... VMDALUDI X'20' VMDALUDI Virtual CPU is
either not I/O interruption
capable (370 AP) or is "usually
disabled" for I/O interruptions
in CR6.
06B0 1712 Signed 2 VMDCPUDS HOST CPU ADDRESS ON WHICH USER
WAS LAST DISPATCHED
06B2 1714 Signed 2 VMDCPULS CPU address of the last processor
on which this VMDBK was run. This
is sometimes set to all FFs to
indicate thread soft affinity
should not skip it.
06B4 1716 Signed 4 VMDALECT Alerting counter. This is the
number of VMDBKs in the virtual
configuration which are able to
field "passthrough" interruptions
(also called "I/O interruption
eligible"). This corresponds to
the number of virtual CPUs which
have zero values in VMDALEFG. A
-1 in this field means that
alerting is being enabled or
disabled for the zone. This field
is significant only in a base V=F
VMDBK, is serialized by
compare-and-swap.
06B8 1720 Signed 8 VMDTSLIC DISPATCH (MINOR) TIME SLICE
VMDTTIME and VMDVTIME decrease over time and are
initialized to:
- 0 for the SYSTEM and SYSTEMMP VMDBKs
- PFXTMMAX for all other VMDBKs
06C0 1728 Signed 8 VMDTTIME SESSION TOTAL CPU TIME USED
06C8 1736 Signed 8 VMDVTIME SESSION VIRTUAL CPU TIME USED
06D0 1744 Signed 8 VMDSUSCK TOD CLOCK WHEN USER WAS MARKED
SUSPENDED
06D8 1752 Signed 8 VMDLPRTY Limit-list priority (deadline).
06E0 1760 Signed 8 VMDDPRTY DISPATCH LIST SORTING PRIORITY
06E8 1768 Signed 8 VMDVTZPT Delta from VMDVTIME used by CP to
compute guest CPU timer when
Expedite-Timer processing is
active.
Guest I/O Configuration and I/O Status Region
06F0 1776 Dbl-Word 8 VMDVDCLK (2) Configuration lock word for
serializing updates to a user's
virtual device configuration.
Used by ATTACH, DETACH, LINK, and
DEFINE commands. Valid only in
base VMDBK.
0700 1792 Signed 4 VMDCHRSN Pointer for radix tree to virtual
device blocks by subchannel no.
Valid only in base VMDBK.
Serialized by VMDSCNCS.
0704 1796 Signed 4 VMDCHRDN Pointer for radix tree to virtual
device blocks by device number.
Valid only in base VMDBK.
Serialized by VMDSCNCS.
0708 1800 Signed 4 VMDCHC POINTER TO HCPCHCBK
070C 1804 Signed 4 VMDVSPRT ADDRESS OF PRINTER VDEVBK FOR USE
BY DUMP, TRACE COMMANDS
0710 1808 Signed 4 VMDSCNCS Second operand of COMPARE AND
SWAP instruction that will
serialize scan routines for
HCPSCN. Valid only in base VMDBK.
0714 1812 Signed 4 VMDLDDPT Pointer to chain of LDDBKs
VIRTUAL DEVICE COUNTS
0718 1816 Signed 2 VMDLIMDV MAX NUMBER OF VIRTUAL DEVICES
WHICH CAN BE DEFINED BY THE USER
Valid in base VMDBK only
071A 1818 Signed 2 VMDMAXVS HIGHEST VIRTUAL SUBCHANNEL Valid
in base VMDBK only
071C 1820 Signed 2 VMDMAXVD HIGHEST VIRTUAL DEVICE NUMBER
Valid in base VMDBK only
071E 1822 Signed 2 VMDDEVCT COUNT OF DEFINED DEVICES Valid in
base VMDBK only
0720 1824 Bitstring 1 VMDCCWOP GUEST CCW TRANSLATION OPTIONS
.1.. .... VMDFAUTO X'40' VMDFAUTO AUTOPOLL CCW
HANDSHAKE ACTIVE
..1. .... VMDNOP X'20' VMDNOP TRANSFER DATA FOR
NOP CCW'S
...1 .... VMDCHVSP X'10' VMDCHVSP Single path chpid
virtualization enabled for this
userid. Valid in all virtual MP
VMDBKs
0721 1825 Bitstring 1 * Reserved for IBM use GUEST I/O
PASS THROUGH FIELDS
0722 1826 Bitstring 1 VMDIOPF1 REASONS FOR I/O PASS THROUGH
BEING INACTIVE. VALID ONLY IN THE
BASE VMDBK.
1... .... VMDIOPBC X'80' VMDIOPBC I/O PASS THROUGH
IS INACTIVE BECAUSE GUEST USED A
BC MODE PSW
.1.. .... VMDIOPCD X'40' VMDIOPCD I/O PASS THROUGH
IS INACTIVE BECAUSE IOASSIST IS
SET OFF
..1. .... VMDIOPDG X'20' VMDIOPDG I/O PASS THROUGH
IS INACTIVE BECAUSE GUEST ISSUED
DIAG
...1 .... VMDIOPIS X'10' VMDIOPIS I/O PASS THROUGH
IS INACTIVE BECAUSE GUEST
DISABLED A VIRTUAL ISC THAT WAS
GROUPED INTO A REAL DEDICATED ISC
.... .1.. VMDIOPAL X'04' VMDIOPAL I/O PASS THROUGH
IS INACTIVE BECAUSE VIRTUAL
MACHINE IS USING ADDRESS LIMIT
CHECKING
.... ..1. VMDIOPMB X'02' VMDIOPMB I/O PASS THROUGH
IS INACTIVE BECAUSE GUEST
MEASUREMENT BLOCK AREA EXCEEDS
VIRTUAL MACHINE STORAGE SIZE
.... ...1 VMDIOPDS X'01' VMDIOPDS I/O PASS THROUGH
IS INACTIVE BECAUSE THE GUEST IS
IN DCCF
0723 1827 Bitstring 1 VMDIOPF2 I/O PASS THROUGH FLAGS. VALID
ONLY IN THE BASE VMDBK
1... .... VMDIOPOP X'80' VMDIOPOP THE SYSTEM IS
CURRENTLY BEING REMOVED FROM I/O
PASS THROUGH BUT CONDITIONS
CAUSING THE REMOVAL HAVE CHANGED.
THE SYSTEM CAN BE PUT BACK INTO
PASS THROUGH, BUT ALL THE DEVICES
ARE NOT YET OUT OF PASS THROUGH.
WHEN ALL THE DEVICES ARE TAKEN
OUT (COUNT IN VMDIOPNO GOES TO
ZERO), PUT THE SYSTEM BACK INTO
PASS THROUGH.
.1.. .... VMDIOP1T X'40' VMDIOP1T THE SYSTEM WAS IN
I/O PASS THROUGH AT ONE TIME,
ALTHOUGH IT MAY OR MAY NOT BE
CURRENTLY IN I/O PASS THROUGH.
..1. .... VMDIOPM6 X'20' VMDIOPM6 MONITOR THE
GUEST'S USE OF CR 6 TO ENSURE THE
GUEST DOES NOT SELECTIVELY ENABLE
- DISABLE AN ISC WHICH CP DID NOT
DEDICATE TO THE GUEST.
.... 1... VMDIOPEW X'08' VMDIOPEW I/O PASS THROUGH
GUEST HAS ENTERED AN ENABLED WAIT
STATE
.... .1.. VMDIOPIP X'04' VMDIOPIP INITIAL IPL PSW
FOR A 370 GUEST IS BC MODE.
.... ..1. VMDIOPQO X'02' VMDIOPQO QUEUE I/O PASS
THROUGH INACTIVE BECAUSE ASSIST
IS SET OFF
.... ...1 VMDIOPSD X'01' VMDIOPSD SIGA Assist is
Disable
0724 1828 Signed 2 VMDLVSID Last virtual SID assigned
0726 1830 Bitstring 1 VMDIOPST I/O PASS THROUGH STATE. VALID
ONLY IN THE BASE VMDBK.
00000000 VMDIOPSN X'00' VMDIOPSN I/O PASS THROUGH
NOT ACTIVE
00000080 VMDIOPSI X'80' VMDIOPSI I/O PASS THROUGH
BEING INITIALIZED
000000C0 VMDIOPSA X'C0' VMDIOPSA I/O PASS THROUGH
ACTIVE
00000040 VMDIOPSR X'40' VMDIOPSR I/O PASS THROUGH
BEING REMOVED
0727 1831 Bitstring 1 VMDVIOF VIRTUAL I/O FLAGS
1... .... VMDRVRIO X'80' VMDRVRIO V=F Guest in I/O
System reset processing
..1. .... VMDINCFM X'20' VMDINCFM User has system in
configuration mode
...1 .... VMDRDPS X'10' VMDRDPS Resetting
non-preferred DPS capable guest.
.... 1... VMDPCIUC X'08' VMDPCIUC UID checking on
ATT PCIF command DISABLED for
this guest
.... .1.. VMDROPNO X'04' VMDROPNO Do not drop DIALed
devices on reset
0728 1832 Signed 4 VMDIOPGT Preferred guest being kept out of
IOASSIST by this user.
072C 1836 Bitstring 4 VMDIOPRN (0) Reason counter for keeping a
guest out of IOASSIST
072C 1836 Bitstring 1 VMDIOPDL Command with Device Range counter
072D 1837 Bitstring 3 * Reserved for IOASSIST
enhancements
GUEST I/O SIMULATION STATUS
0730 1840 Signed 4 VMDWVDEV ADDRESS OF VDEVBK FOR STATUS
RESPONSE
0734 1844 Signed 4 VMDIOACT NUMBER OF I/O'S OUTSTANDING
0738 1848 Bitstring 1 VMDMIFLG FLAG USED BY MISSING INT HANDLER
1... .... VMDMIHON X'80' VMDMIHON MISSING INTERRUPTS
ARE TO BE HANDLED BY CP FOR THIS
GUEST
.... ...1 VMDDPS X'01' VMDDPS DYNAMIC PATH
SELECTION CAPABLE (VALID ONLY IN
BASE VMDBK AND VALID ONLY FOR XA
MODE GUEST)
0739 1849 Bitstring 1 VMDTIOLP TIO LOOP DETECTION FIELD
.... 1... VMDTIOBZ X'08' VMDTIOBZ TSCH/STSCH BUSY
Indicator
.... .111 VMDTSCBZ X'07' VMDTSCBZ TSCH/STSCH BUSY
Loop Counter Bits
.... ...1 VMDTSCX1 X'01' VMDTSCX1 TSCH BUSY
increment value
.... ..1. VMDTSCWD 2 VMDTSCWD Time in seconds of the
TSCH busy detection interval.
073A 1850 Signed 2 VMDTSCLP TSCH LOOPING TEST DEVICE ADDRESS
073C 1852 Address 4 VMDBLKIO BLOCK I/O CHAIN POINTER
0740 1856 Signed 4 VMDCTSIO Count of requested virtual I/O
starts that weren't counted in
VMDCCSIO (including diag 58 &
98). Includes all devices except
virtual spooling. Adding VMDCTSIO
and VMDCCSIO together gives a
total requested count.
0744 1860 Signed 4 VMDCTRDR COUNT IS MAINTAINED BY SPOOLING
FOR EACH CARD READ. ACCOUNTING
CALCULATES THE NUMBER OF CARDS
READ BY COMPARING IT TO VMDACRDR,
THE VALUE AT THE PREVIOUS
ACCOUNTING. THE INDICATE USER
COMMAND DISPLAYS THE FIELD.
(NOTE: THIS COUNT PERTAINS TO
SPOOLED INPUT ONLY. IT DOES NOT
COUNT CARDS READ FROM DEDICATED
DEVICES.)
0748 1864 Signed 4 VMDCTPCH COUNT OF CARDS OUTPUTTED TO
VIRTUAL SPOOLED PUNCHES. COUNT IS
MAINTAINED BY SPOOLING FOR EACH
CARD PUNCHED. ACCOUNTING
CALCULATES THE NUMBER OF CARDS
PUNCHED BY COMPARING IT TO
VMDACPCH, THE VALUE AT THE
PREVIOUS ACCOUNTING. THE INDICATE
USER COMMAND DISPLAYS THE FIELD.
(NOTES : THIS COUNT PERTAINS TO
SPOOLED OUTPUT ONLY. IT DOES NOT
COUNT CARDS PUNCHED ON DEDICATED
DEVICES.)
074C 1868 Signed 4 VMDCTPRT COUNT OF LINES SPOOLED TO VIRTUAL
PRINTERS. COUNT IS MAINTAINED BY
SPOOLING FOR EACH DATA RECORD
PRINTED. CONTROL OPERATIONS SUCH
AS EJECTS OR SKIPS ARE NOT
COUNTED. ACCOUNTING CALCULATES
THE NUMBER OF RECORDS PRINTED BY
COMPARING IT TO VMDACPRT, THE
VALUE AT THE PREVIOUS ACCOUNTING.
THE INDICATE USER COMMAND
DISPLAYS THE FIELD. (NOTES : THIS
COUNT PERTAINS TO SPOOLED OUTPUT
ONLY. IT DOES NOT COUNT LINES
PRINTED ON DEDICATED DEVICES.)
0750 1872 Signed 4 VMDVDISK Count of virtual I/Os to a V-Disk
0754 1876 Address 4 VMDIPQPT Address of IPQBK. Used only in
base VMDBK.
0758 1880 Signed 4 VMDIOPNO COUNT OF DEVICES TO BE TAKEN OUT
OF I/O PASS THROUGH. VALID ONLY
IN THE BASE VMDBK.
075C 1884 Address 4 VMDIOPBK Address of IOPBK. Used only in a
base VMDBK for a preferred guest.
Serialized by Console Function
Mode (CFM).
0760 1888 Dbl-Word 8 VMDTASIT Temporary save area of an i-ASIT.
It requires instruction
simulation to be changed. It is
not usable after going to ENDOP.
Needs I-stream serialization.
Primarily used in GOTO entry
points (no savearea) which need a
temporary place to build an
i-ASIT. Routines with savearea
should not use this field. Any
other routine that uses this
field must be careful that all
callers and called routines don't
destroy the data.
0768 1896 Dbl-Word 8 VMDPASCE Primary Address-Space-Control
Element Serialized by ASCLOCK
held exclusive (all guest types)
plus VMDPTIL held exclusive (for
V=V guests only)
0768 1896 Signed 4 VMDPASW0 Primary ASCE Word 0
076C 1900 Signed 4 VMDPASW1 Primary ASCE Word 1
0770 1904 Bitstring 16 VMDSVZPSW Saved z/Architecture PSW
Guest prefix mask which is different for a z/Arch
mode guest than it is for an ESA/390 mode guest
due to the different significant bits in the
prefix registers of these types of guests. Set to:
X'FFFFFFFFFFFFF000' for ESA/390 guest
X'FFFFFFFFFFFFE000' for z/Arch guest
0780 1920 Dbl-Word 8 VMDPFXMK Guest prefix mask
0780 1920 Signed 4 VMDPFXHM High half of prefix mask
0784 1924 Signed 4 VMDPFXLM Low half of prefix mask
CFLF user area
0788 1928 Address 4 VMDLFCFG CFLF configuration block address
078C 1932 Bitstring 1 VMDLFUID CFLF User Identification value
078D 1933 Bitstring 1 VMDLFFLG CFLF Flags
078E 1934 Bitstring 2 VMDLFRSV Reserved for IBM use
00000008 VMDLFLEN *-VMDLFCFG lenth of CFLF area
Guest CPU Definition and Status Region Extension
0790 1936 Dbl-Word 8 VMDFASIT Last page translation exception
i-ASIT. Serialized by the
Dispatch Lock. Meaningful (at
times) in every VMDBK in the
local-cyclic list. Does not
survive a failure.
Message Facility Support
0798 1944 Address 4 VMDMSF PTR to Message Facility Block
079C 1948 Signed 4 VMDCHPCN ADDR of Configured CHPID Bit Map
07A0 1952 Bitstring 1 VMDLCKFG CF locking flag
1... .... VMDSHLCK X'80' VMDSHLCK Shared lock on CF
MSFBK
.1.. .... VMDEXLCK X'40' VMDEXLCK Exclusive lock on
CF MSFBK
..1. .... VMDEXDLY X'20' VMDEXDLY Exclusive lock
after delay
07A1 1953 Bitstring 1 VMDYZLFL CFVM flags
1... .... VMDCFUSR X'80' VMDCFUSR CFUSER Virtual
Machine
07A2 1954 Bitstring 1 VMDVPEND Work pending status
07A3 1955 Bitstring 1 * Reserved for future IBM use
07A4 1956 Signed 4 VMDQDIO Number of QDIO Shadow Queues
07A8 1960 Address 4 VMDVEBLK HL address of the HCPVEBLK.
(Vector Environment Block) Valid
only in a BASE VMDBK. Serialized
with CS for creating. See
HCPVEBLK.VEBADDR for HCPRELST
07AC 1964 Address 4 VMDMSVBK HCPMSVBK chain anchor, holding
virtual MAC assignment info.
Valid only in a base VMDBK.
Serialized by HCPMLMGM using CS
to add a new element to the front
of the chain.
VMDBK Chain Pointers Region
07B0 1968 Address 4 VMDCYCLE CYCLIC LIST OF LOGGED ON USERS
Valid only in Origin VMDBK. If
space ever becomes tight in the
VMDBK VMDCYCLE could be merged
with USRCYCLE in the embedded
USRBK.
07B4 1972 Address 4 VMDLCYCL USER-LOCAL CYCLIC LIST
07B8 1976 Address 4 VMDORIG THE ORIGINATING VMDBK. THIS IS
THE ADDRESS OF THE SINGLE VMDBK
ESTABLISHED AT LOGON. VIRTUAL MP
VMDBKS ARE DEFINED FROM THE
ORIGINATING VMDBK. ALL VMDBKS IN
THE LOCAL CYCLIC LIST WILL USE
THIS FIELD TO ADDRESS THE
ORIGINATING VMDBK OF THE LOCAL
CONFIGURATION.
07BC 1980 Address 4 VMDBASE THE ADDRESS OF THE VMDBK OWNING
THE STORAGE AND I/O CONFIGURATION
FOR THE VIRTUAL MP CONFIGURATION.
VMDBASE IS EQUAL TO THIS VMDBK
ADDRESS EXCEPT WHEN THE VMDTYPE
OF THIS VMDBK IS VMDTYPMP.
COMPARE-AND-SWAP CYCLIC LIST HOLD LOCK
07C0 1984 Signed 4 VMDCYCLH VMDBK CYCLIC LIST HOLD STATE:
LOCK VALUE IS THE NUMBER OF
REQUESTS FOR THIS PROTOTYPE VMDBK
TO REMAIN IN THE GLOBAL CYCLIC
LIST (SHARED HOLDS), OR NEGATIVE
ONE (EXCLUSIVE HOLD). THE VMDBK
MAY NOT BE RELEASED FROM THE
GLOBAL CYCLIC LIST UNTIL THIS
FIELD IS ZERO. Valid only in
Origin VMDBK.
07C4 1988 Address 4 VMDADJL Linked list of Adjunct VMDBKs
Based off of SRMADJL, and
serialized with HCPLKADJ, the
adjunct list lock.
07C8 1992 Address 4 VMDVSIVM POINTER BETWEEN RGUEST AND V/SIE
VMDBK (BIDIRECTIONAL).
Monitor Region
07CC 1996 Signed 4 VMDMONDA (0) Monitor status fields. CS logic
will be used on this fullword
except where noted.
07CC 1996 Bitstring 1 VMDMONFA Monitor facilities.
1... .... VMDAMDIR X'80' VMDAMDIR User has the
APPLMON directory option
specified. Set at LOGON. Valid
ONLY in Origin VMDBK. Serialized
by Compare and Swap.
.1.. .... VMDAPBUF X'40' VMDAPBUF User has defined
an application buffer via
DIAGNOSE X'DC'. Buffer is set for
an addr space. Reset across
bounce. Valid ONLY in base VMDBK.
07CD 1997 Bitstring 1 VMDMONST Monitoring status
1... .... VMDMONEU X'80' VMDMONEU User monitored for
events Valid in all VMDBKs.
.1.. .... VMDMONSD X'40' VMDMONSD User NOT being
monitored for sample collection
Valid in all VMDBKs.
..1. .... VMDMONEC X'20' VMDMONEC User monitored for
scheduler events Valid in all
VMDBKs.
...1 .... VMDMONTV X'10' VMDMONTV Last transaction
by this user was trivial Valid in
all VMDBKs.
.... 1... VMDMONSV X'08' VMDMONSV Monitor sever
processing bit Valid in Base
VMDBK.
07CE 1998 Bitstring 1 * Reserved for IBM use
07CF 1999 Bitstring 1 * Reserved for IBM use
07D0 2000 Signed 4 VMDBLKCT Count of SSCH's issued by BLOCKIO
system service (includes both
read and write requests).
07D4 2004 Signed 4 VMDMDCIA Count of SSCH's avoided due to
Mindisk Cache read hit
07D8 2008 Signed 4 VMDHFDAT Pointer to high frequency data -
HCPHFUBK. Serialized by VMDHFLCK
07DC 2012 Signed 4 VMDHFLCK Lock for VMDHFDAT
07E0 2016 Signed 4 VMDQ1SUM MONITOR transaction-end data: Sum
of Q1 events
07E4 2020 Signed 4 VMDQSUMS MONITOR transaction-end data: Sum
of Q0, Q2, and Q3 events
07E8 2024 Address 4 VMDTTABK Pointer to TTABK (Trace instr.
codes in effect for this VMDBK)
07EC 2028 Address 4 VMDTDHBK Pointer to TDHBK (Trace service
Tool Diagnose Header Block)
07F0 2032 Address 4 VMDTODAG Guest real address of TOD Clock
Accounting area Guest Status
Fields
07F4 2036 Signed 4 VMDGSRST (0) Guest status information
07F4 2036 Bitstring 1 * Reserved for IBM use
07F5 2037 Bitstring 1 VMDGSRFG Flag for guest IPL and RESET
status
1... .... VMDGSIPL X'80' VMDGSIPL Guest IPL in
progress
.1.. .... VMDGSRES X'40' VMDGSRES Guest virtual
system RESET in progress
..1. .... VMDGSNSS X'20' VMDGSNSS Guest IPLing an
NSS
07F6 2038 Bitstring 1 * Reserved for IBM use
07F7 2039 Bitstring 1 * Reserved for IBM use
Information area in a locked guest page
07F8 2040 Dbl-Word 8 VMDTODAIR 64-bit real addr of TOD accountng
0800 2048 Address 4 VMDTODAI Logical addr of TOD accounting
0804 2052 Signed 4 VMDTHRCT Count of delays due to throttle
Storage Management Region
0808 2056 Dbl-Word 8 VMDRVMBK (0) Mapping of the STMGT area
Release function defer lock
0808 2056 Dbl-Word 8 VMDRELLK (3) Release-Function defer lock. This
lockword is used to prevent other
functions such as the LOCK
command from running while the
user's pages are being released
(and vice versa). Valid only in
base VMDBK.
0820 2080 Dbl-Word 8 VMDPTIL (3) Page Table Invalidation Lock
This lock is used in the base VMDBK to serialize use
and invalidation of architecturally "attached" DAT
structures associated with the virtual configuration,
including the ASTE, STD or ASCE, and region, segment,
and page tables. A share of VMDPTIL must be held
while any tasks are dispatched which may access the
guest DAT structures implicitly via DAT, whether
actually running the guest under SIE or accessing
guest storage directly from DAT on CP code. When
held shared by other tasks, it indicates to the ALR
tasks that an IPTE instruction is necessary to
invalidate private page table entries; if an ALR task
obtains PTIL exclusive, it need not IPTE to
invalidate page table entries. It must be held
exclusive by any task making destructive changes
(such as invalidating PTEs without IPTE, invalidating
STEs or RTEs, changing attached region, segment, or
page table origins or lengths, changing the ASTE
STD/ASCE or VMDPSTD / VMDPASCE). The dispatcher and
HCPACCES obtain PTIL shared so that implicit accesses
to the guest DAT structures will not occur while
other tasks are making potentially destructive
changes to those structures.
Note that for a vSIE guest, VMDSHDLK also is involved
in locking updates to DAT structures. See VMDSHDLK
for details.
VMDPTIL is much like any other HCPLCK managed lock,
but there are substantial extensions, see the macros
HCPLKPTL, HCPULPTL, and HCPSWPTL for details.
Additionally, the following fields are essentially
logical extensions to VMDPTIL (part of the superset
not managed by HCPLCK).
0838 2104 Signed 4 VMDPTILB Count of bump shares of VMDPTIL
for this virtual configuration.
Valid only in the base VMDBK.
083C 2108 Signed 4 VMDPTILX Count of explicit shares of *ANY*
virtual configuration's VMDPTIL
held by tasks dispatched on this
VMDBK. Valid in all normal vCPU
VMDBKs.
0840 2112 Dbl-Word 8 * (0)
0840 2112 Signed 4 VMDPTSOC Bits 1-31: Count of outstanding
tasks which may lose control but
must be able to re-obtain a
dispatch share of VMDPTIL in
order to release other held
serialization and complete.
Example: in-progress page
translations of private pages by
tasks dispatched on owning
vconfig (includes all private
spaces owned by the vconfig). Bit
0: VMDPTSO0 flag indicating
whether any PTILx
IFHELD=MUSTHAVE, PTEDFR=YES tasks
are queued on VMDPTSOQ waiting on
VMDPTSOC count to go to zero.
Serialized by CS to increment,
decrement to non-zero value, or
to decrement to zero when
VMDPTSO0 is not set and no CPEBKs
are queued on VMDPTSOQ. CSG must
be used on VMDPTSOC and VMDPTSOQ
together to queue a task on
VMDPTSOQ and set VMDPTSO0 in
VMDPTSOC, or to decrement
VMDPTSOC to zero, reset VMDPTSO0,
and harvest the queue of CPEBKs
deferred on VMDPTSOQ. VMDPTSOC
and VMDPTSOQ must be contiguous
with VMDPTSOC on a doubleword
boundary. Valid only in the base
VMDBK.
1... .... VMDPTSO0 X'80' Flag in bit 0 of VMDPTSOC
indicating that there are
exclusive requests queued on
VMDPTSOQ waiting for the count
portion of VMDPTSOC to go to 0.
0844 2116 Signed 4 VMDPTSOQ Queue of CPEBKs of HCPLKPTL
EXCL,IFHELD=MUSTHAVE,PTEDFR=YES
requestors waiting on the count
portion of VMDPTSOC to go to 0.
The high order bit of VMDPTSOC
(VMDPTSO0 flag) must be on when
VMDPTSOQ is non-zero. Serialized
by CSG along with VMDPTSOC. See
VMDPTSOC serialization statements
above. VMDPTSOC and VMDPTSOQ must
be contiguous, with VMDPTSOC on a
doubleword boundary. Valid only
in the base VMDBK.
0848 2120 Dbl-Word 8 * (0)
0848 2120 Signed 4 VMDPTXMC Bits 1-31: Count of exclusive
requests queued for VMDPTIL.
Includes requests queued on both
the VMDPTIL LKWRD LKWQUEUE field
and the VMDPTSOQ queue (waiting
for VMDPTSOC to go to 0). Bit 0:
VMDPTXM0 flag indicating whether
any VMDPTSOC increment tasks are
queued on VMDPTXMQ waiting on
VMDPTXMC count to go to zero.
Serialized by CS to increment,
decrement to non-zero value, or
to decrement to zero when
VMDPTXM0 is not set and no CPEBKs
are queued on VMDPTXMQ. CSG must
be used on VMDPTXMC and VMDPTSOQ
together to queue a task on
VMDPTXMQ and set VMDPTXM0 in
VMDPTXMC, or to decrement
VMDPTXMC to zero, reset VMDPTXM0,
and harvest the queue of CPEBKs
deferred on VMDPTXMQ. VMDPTXMC
and VMDPTXMQ must be contiguous
with VMDPTXMC on a doubleword
boundary. Valid only in the base
VMDBK.
1... .... VMDPTXM0 X'80' Flag in bit 0 of VMDPTXMC
indicating that there are
VMDPTSOC increment requests
queued on VMDPTXMQ waiting for
the count portion of VMDPTXMC to
go to 0.
084C 2124 Signed 4 VMDPTXMQ Queue of CPEBKs of tasks waiting
for VMDPTXMC to go to zero so
that they may increment VMDPTSOC
and proceed with translation. The
high order bit of VMDPTXMC
(VMDPTXM0 flag) must be on when
VMDPTXMQ is non-zero. Serialized
by CSG along with VMDPTXMC. See
VMDPTXMC serialization statements
above. VMDPTXMC and VMDPTXMQ must
be contiguous, with VMDPTXMC on a
doubleword boundary. Valid only
in the base VMDBK.
0850 2128 Signed 4 VMDPTSOE Historical count of CPEBK
enqueues on VMDPTSOQ
(monotonically increasing).
Serialized by CS (HCPCOUNT with
INTERLOCK option).
0854 2132 Signed 4 VMDPTXME Historical count of CPEBK
enqueues on VMDPTXMQ
(monotonically increasing).
Serialized by CS (HCPCOUNT with
INTERLOCK option).
End of VMDPTIL logical extension fields.
0858 2136 Address 4 VMDFSCBK Address of free storage counter
block. Used by the free storage
limit detection function.
085C 2140 Address 4 VMDMPEBK Address minidisk pool extent
block. Located in base VMDBK.
0860 2144 Signed 4 VMDCTFAC Cumulative count of frames
acquired for all private spaces
owned by this user. (Defined in
the base VMDBK only.) Updates
serialized by compare and swap.
Fetching is via atomic
instructions.
0864 2148 Signed 4 VMDCTPFD Cumulative count of page faults
which result in a read from DASD
(single- or multi-page read), for
all private spaces owned by this
user. Valid in base VMDBK.
0868 2152 Signed 4 VMDXSTOR The number of pages in the
Expanded Storage facility
086C 2156 Signed 2 VMDSTLFC "Steal Factor": used by Demand
Scan; typically 1, increased each
time DS skips a guest, so that
when DS does finally scan that
guest, it does so more aggres-
sively to make up for lost time
Valid in the base VMDBK only.
Serialized by single thread of
execution of demand scan.
086E 2158 Signed 2 VMDSTFHW "Steal Factor" high water mark
Valid in the base VMDBK only.
0870 2160 Signed 4 VMDCTISO The number of times an address
space owned by this virtual
configuration was isolated. Valid
in the base VMDBK only.
0874 2164 Signed 4 VMDSHDLK V/SIE SHADOW TABLE LOCK Informal
lock used with VMDINVPG to
serialize shadow table use
against events which obsolete
shadow table contents, such as
page steal or release. vSIE
obtains a share while shadow
tables are in use, then checks
VMDINVPG. Storage management
functions which invalidate guest
page mappings must hold either
VMDPTIL or VMDSHDLK exclusive,
and must set VMDINVPG before
releasing that lock, so that the
next vSIE usage will purge shadow
tables. Valid in base VMDBK only.
00FFFFFF VMDSHALD -1 VMDSHALD INDICATE THE LOCK IS
OWNED BY THE DEMAND SCAN
00FFFFFE VMDSHALF -2 VMDSHALF INDICATE THE LOCK IS
OWNED BY THE FREE STORAGE SCAN
00FFFFFD VMDSHHTF -3 VMDSHHTF Indicate the lock is
owned by the >= 2G available
list manager
00FFFFFC VMDSHREL -4 VMDSHREL Indicate the lock is
owned by the release process
(HCPHPH e.g.)
0878 2168 Signed 4 VMDCTXBK Count of XSTORE blocks used for
host paging for this guest. The
XSTSTATL lock is required to
serialize updates to this field.
Valid in Base VMDBK.
087C 2172 Signed 4 VMDCTSPR COUNT OF SPOOLING PAGE READS
Valid in Base VMDBK.
0880 2176 Signed 4 VMDCTSPW COUNT OF SPOOLING PAGE WRITES
Valid in Base VMDBK.
0884 2180 Signed 4 * (2) Reserved for IBM use
088C 2188 Signed 4 VMDPAGZP Guest page zero host logical addr
if the field is non-zero. This
field is not maintained for a
VMDBK while in Console Function
Mode.
0890 2192 Signed 4 * Reserved for IBM use
0894 2196 Signed 4 VMDMXRVP MAXIMUM RESERVED PAGE COUNT This
field is serialized by the
RSARPGLK in the RSMBK. Please see
the lock's comment in the RSMBK
for usage details.
0898 2200 Signed 4 VMDCTPWT PAGE WAIT COUNT
089C 2204 Signed 4 * Reserved for IBM use. Previous
field is no longer meaningful
(VMDCWSS).
08A0 2208 Dbl-Word 8 * Reserved for IBM use
08A8 2216 Signed 4 VMDMVB2G Number of times page translation
moved a page on behalf of this
user from a frame with address
>= 2G to one < 2G. This
field is only valid in the base
VMDBK.
08AC 2220 Signed 4 VMDCTPPR Count of primary space private
frames that are in pending
release state. If the primary
space is shared, this value will
be zero, because any shared pages
will be released immediately as
if DIAG 10 were used. Valid only
in base VMDBK.
08B0 2224 Signed 4 VMDCTPVR (0) Count of private address space
resident pages in DPA owned by
this virtual machine. Valid only
in base VMDBK. These frames are
< 2G. Serialized by compare
and swap See VMDCTPVG.
08B0 2224 Signed 4 VMDCTSHR Count of shared address space
resident pages in the DPA. Valid
in SYSTEM VMDBK only. Serialized
by compare and swap Frames are
< 2G. See VMDCTSHG.
The following fields, VMDCTPVL/VMDCTPVLA and
VMDCTSHL/VMDCTSHLA, which contain counts of frames
locked in absolute, cannot be relied upon to be
instaneously correct. These counts are modified
by the Delta-Pinned-Page-Count-Array roll-up routine
which harvests the DPPCA counts and rolls them into
these counts at specific times. In between calls,
these counts may not reflect pins that have occurred
or may not reflect unpins that have occurred. Care
must be taken to ensure code that references these
fields has no dependency on instantaneous correctness.
When referencing the PVL counts, the counts can be
forced to be accurate by calling the HCPLALRU DPPCA
rollup routine since PVL counts are private per
user. Since the SHL counts are shared counts kept
in the system VMDBK, calling LALRU still does not
guarantee SHL counts are completely accurate because
LALRU only rolls up DPPCA counts for the R11 user.
Other users may also have outstanding pins/unpins
that are not included in these SHL counts.
08B4 2228 Signed 4 VMDCTPVL (0) Count of locked pages < 2G for
all private spaces owned by this
user. Valid in base VMDBK.
08B4 2228 Signed 4 VMDCTSHL Count of shared address space
locked pages <2G, valid in the
SYSTEM VMDBK only
08B8 2232 Dbl-Word 8 VMDCTPVLA (0) Count of locked pages > 2G for
all private spaces owned by this
user. Valid in base VMDBK.
08B8 2232 Signed 8 VMDCTSHLA Count of shared address space
locked pages >2G, valid in the
SYSTEM VMDBK only
08C0 2240 Signed 4 VMDVUDBK Pointer to the Vestigial User
Data Block (VUDBK). Contains a
null pointer value (0) if no
VUDBK exists. The VUDBK contains
historical data for resources
owned by this user (such as
address spaces) which have been
destroyed. Significant in Base
VMDBKs only, serialized by the
VUDBK lock VMDVUDLK.
08C4 2244 Signed 4 VMDVUDLK Spin lock to serialize access to
the VUDBK anchored at VMDVUDBK.
Significant only in base VMDBKs.
08C8 2248 Bitstring 1 VMDDFLGS Destroy address space flags.
Valid in base VMDBK only.
1... .... VMDESTRY X'80' User ASCBKs are in the
progress of being destroyed. The
ASCBKs have been removed from the
user's ASCBK chain; however, the
storage backing the address
spaces' pages may not be released
yet. NOTE: This flag is inspected
by XSTORE FLUSH Migration. It
wants to make sure that any
XSTORE blocks in the address
spaces being destoyed are
released before it, FLUSH
Migration, completes.
08C9 2249 Bitstring 1 * Reserved for IBM use
08CA 2250 Bitstring 1 VMDPGFLG Paging control flags
...1 .... VMDPWQD X'10' VMDPWQD Tasks waiting for
page wait exit
.... ...1 VMDPZUNV X'01' VMDPZUNV Guest page zero is
unavailable
08CB 2251 Bitstring 1 VMDRSSFG Read Storage Status Flag Byte
1... .... VMDRSSUE X'80' VMDRSSUE An uncorrectable
storage or key error has
occurred. Only valid in base
VMDBK.
08CC 2252 Signed 4 VMDSFORE (0) The cumulative referenced frames
resident when the system shared
frame-owned list was reset. Valid
only on the system VMDBK. Updated
using CS logic.
08CC 2252 Signed 4 * Reserved for IBM use
The following 4 fields (VMDASMMX, VMDASMCT, VMDASTMX, and
VMDASTSZ/VMDGASTP) enforce the users XCONFIG ADDRSPACE
directory control entry limitations. VMDASMCT and VMDGASTP
are serialized by the ASCBK-queue lock (VMDASCLK).
All are valid in the BASE VMDBK only.
08D0 2256 Signed 2 VMDASMMX Maximum number of non-Base
address spaces this user may have
have concurrently. MAXNUMBER from
XCONFIG ADDRSPACE.
08D2 2258 Signed 2 VMDASMCT Current number of non-Base
address spaces owned by this
user.
08D4 2260 Signed 4 VMDASTMX Maximum size in megabytes of all
non-Base address spaces this user
may concurrently own. TOTSIZE
from XCONFIG ADDRSPACE. Note that
this can currently represent up
to 4 Petabytes.
08D8 2264 Dbl-Word 8 VMDGASTP Current size in pages of all non-
Base address spaces owned by this
user.
End of XCONFIG ADDRSPACE directory control fields
08E0 2272 Signed 4 * Reserved for IBM use
08E4 2276 Address 4 VMDPASTE PASTEO is Host Real Address.
Address of ASTE for this virtual
CPU's primary address space.
Significant in all VMDBKs.
Serialized by CFM or istream.
08E8 2280 Dbl-Word 8 VMDPASIT Internal-address-space-identifica
tion token for virtual CPU's
primary address space.
Significant in all VMDBKs.
Serialized by CFM or istream, AND
Dispatch Lock.
08F0 2288 Dbl-Word 8 VMDGPVTP Current number of pages in all
private spaces owned by this
user. When a private space is
made sharable, the number of
pages in the space is subtracted
out of this field. When a shared
space is made private, the number
of pages in the space is added
into this field. Valid in base
VMDBK. Serialized by ASCBK-queue
lock (VMDASCLK).
08F8 2296 Dbl-Word 8 VMDGPRMP Primary address space size in
pages - this is the number of
primary address space virtual
pages that are "owned" by this
user, including normal (defined
storage) pages and any exclusive
segments of imbedded shared
segments (NSSs and DCSSs), but
excluding any imbedded shared
segments. This count does not
change if the primary space is
made shared or isolated. Valid in
base VMDBK. Serialized by Console
Function Mode.
0900 2304 Dbl-Word 8 VMDASCLK (3) Shared/exclusive defer lock to
serialize the chain of ASCBKs
anchored at VMDASCBK. Significant
only in base VMDBKs.
0918 2328 Address 4 VMDASCBK Anchor for chain of ASCBK's for
address spaces owned by this
user. The first ASCBK on the
queue is the user's base address
space. Significant only in base
VMDBKs. Serialized by lock at
VMDASCLK. The chain may also be
inspected with no loss of
control.
091C 2332 Signed 2 VMDACLMX Largest permitted size of user's
access list, in number of
entries. Initialized from
directory entry at logon, static
thereafter. Significant only in
base VMDBKs.
091E 2334 Bitstring 1 VMDSTMFS Miscellaneous STMGT flags
.1.. .... VMDDSRED X'40' VMDDSRED Valid in base
VMDBK only. Demand Scan "Redo"
bit. If on, Demand Scan left off
last time at this guest, and is
going to start again at this
guest the next time it runs.
091F 2335 Bitstring 1 * Reserved for IBM use
0920 2336 Signed 4 VMDVMDWU COUNT OF DOUBLEWORDS OF VMDBK
FREE STORAGE IN USE. Valid in
base VMDBK.
0924 2340 Signed 4 * Reserved for IBM use
VMDBK/SHRBK queue lock (VMDSHRLK)
Lock type: This is a formal shared or exclusive lock
It is only valid in the configuration's base VMDBK.
Resource serialized: This lock manages the SHRBK queue
chained from the VMDBK. The lock will be obtained shared
when scanning the queue and exclusive when adding to, or
deleting from, the queue.
See the general comments in HCPNSUBK COPY file for
detailed Saved Segment or NSS locking information.
0928 2344 Dbl-Word 8 VMDSHRLK (3) VMDBK/SHRBK queue lock This field
is significant only in the base
VMDBK.
Demand Scan Region
All of the counters in this section are valid in the base
VMDBK only and are serialized by single thread of
execution of demand scan unless otherwise indicated.
0940 2368 Signed 4 VMDWASTE Cumulative count of times a page
owned by this guest was
revalidated after it was written
from the aging list. Serialized
by CS.
0944 2372 Signed 4 VMDDSVIS Count of times Demand Scan
visited this guest, including
times the guest was skipped for
serialization (or other) reasons
0948 2376 Signed 2 VMDSKPPT Count of times Demand Scan
skipped this guest because it
couldn't get any form of PTIL
094A 2378 Signed 2 VMDSKPST Count of times Demand Scan
skipped this guest because it
couldn't get the shadow table
lock
094C 2380 Signed 2 VMDSKPUF Count of times Demand Scan
skipped this guest because it
couldn't get the UFO list lock
094E 2382 Signed 2 * Reserved for IBM use
0950 2384 Signed 4 VMDDSPTS Count of times Demand Scan
scanned this guest while holding
PTIL-s
0954 2388 Signed 4 VMDDSPTX Count of times Demand Scan
scanned this guest while holding
PTIL-x
0958 2392 Dbl-Word 8 VMDPTXTM Cumulative amount of time (TOD
format) that Demand Scan has held
PTIL-x on this guest
0960 2400 Signed 4 VMDRQLCK Count of times a page was
requeued to the top of the active
UFO section because it was
locked/pinned
0964 2404 Signed 4 VMDRQSER Count of times a page was
requeued to the top of the active
UFO section because serialization
wasn't able to be obtained
(either page, FRMTE, or SXSTE)
0968 2408 Signed 4 VMDREDOC Count of Demand Scan "Redo's"
that have been done on this guest
during the current visit
096C 2412 Signed 4 VMDDSRSV Count of times Demand Scan could
not move any pages from the UFO
to the Aging List because doing
so would violate the guest's
RESERVED setting
00000168 VMDRVMSZ *-VMDRVMBK Size of the STMGT
section
SCHEDULER REGION
The following data fields are used mostly by the CP
Scheduler to record the progress of this VMDBK through
the scheduling algorithms.
Serialized : All are protected by the Scheduler Lock
with the exception of:
VMDELGST serialized by the Test-and-Set instruction
SCHEDULER ALGORITHM FIELDS:
0970 2416 Dbl-Word 8 * (0)
0970 2416 Signed 4 VMDSHARS (0) A symbol used as a base for
indexing the following two
fields, VMDRELSH and VMDABSSH.
Code depends on these fields each
being fullwords and consecutive
IN THE FOLLOWING ORDER.
0970 2416 Signed 4 VMDRELSH This user's relative share of the
system. Code should be able to
handle a range of 1-32767,
although currently, only 1-10000
is valid.
0974 2420 Signed 4 VMDABSSH This user's absolute share of the
system (all CPUs). The range is
0.01-1.00.
0978 2424 Bitstring 1 VMDSCDF1 Scheduler Flags
.1.. .... VMDLDGDL X'40' VMDLDGDL User remained
loading during entire dispatch
list stay
..1. .... VMDLRGST X'20' VMDLRGST User was
pre-empted due to its large
storage requirement
...1 .... VMDTREND X'10' VMDTREND 'report
TRansaction END'. All VMDBKs in a
user's virtual MP complex are
idle which means that the next
time the complex is moved to the
Eligible List, transaction end
should be checked. (Only set in
the base; will be 0 elsewhere.)
.... 1... VMDQDSPU X'08' VMDQDSPU QUICKDISP User
designation
.... .1.. VMDLIMCS X'04' VMDLIMCS Limited by
consumption method
.... ..1. VMDLIMTH X'02' VMDLIMTH The LIMITHARD
option has been specified for
this user's SHARE. It means the
user is never to receive more
than his SHARE of CPU service
even if that means service will
be wasted. When this flag is not
set, the user has either
LIMITSOFT or NOLIMIT, depending
on whether he has a max-SHARE or
not (see VMDMXSHR). When
LIMITHARD is set, he must have a
max-SHARE.
.... ...1 VMDIOPND X'01' VMDIOPND Some VMDBK(s) in
the virtual-MP complex had I/O in
progress (literally, a VMDBK was
SUSPEND- ed) when the complex was
dropped from the dispatch list.
(Mean- ingful only in the base
and only if VMDTREND is set.)
0979 2425 Bitstring 1 VMDSCDF2 Scheduling flags byte 2
1... .... VMDCONTR X'80' VMDCONTR This is a
continuing transaction
.1.. .... VMDFRDSP X'40' VMDFRDSP User is coming
from dispatch list
..1. .... VMDFRELG X'20' VMDFRELG User is coming
from eligible list
...1 .... VMDFRDRM X'10' VMDFRDRM User is coming
from dormant list
.... .1.. VMDELTOD X'04' VMDELTOD User entered
eligible list prior to TOD clock
being initialized
.... ..1. VMDCKVMP X'02' VMDCKVMP User is a base
VMDBK coming into the eligible
list from the dormant list. For
any non-base virtual MP VMDBKs
already in the eligible list, set
its E-list class to that of the
base and add that non-base into
the E-list class counts
.... ...1 VMDOK2DD X'01' VMDOK2DD Flag to indicate
the VMDBK is being processed by
HCPDSPCH. It is examined by
HCPSTMDV to determine if the
VMDBK can be dropped from the
dispatch list. If it is on, it is
ok to drop the VMDBK.
097A 2426 Bitstring 1 VMDSCDF3 Scheduling flags byte 3.
Serialized by SCHEDULER LOCK held
EXCLUSIVE whenever updates to
these bits are made. Code that
just needs a snapshot can COPY
(Monitor/RLG) or do a TEST
without scheduler lock.
1... .... VMDMXSHA X'80' VMDMXSHA User's max-SHARE
(see VMDMXSHR) is ABSOLUTE, not
RELATIVE.
.1.. .... VMDNMSHA X'40' VMDNMSHA User's normal
SHARE (see VMDSHARS) is ABSOLUTE,
not RELATIVE. (Technically this
flag (VMDNMSHA) is redundant
since the share-type can be
determined by testing to see
which of the two elements of
VMDSHARS is non-zero. The direc-
tion now though should be to move
toward testing this flag rather
than VMDSHARS, with the goal of
eventually reducing VMDSHARS to a
single element (one fullword).)
..1. .... VMDUSMXS X'20' VMDUSMXS The scheduler is
using maximum share value for
scheduling - set for all users
but used only by users with
LIMITHARD shares CPU Pool
limiting flags: (VMDLIMBK points
to the LIMBK)
...1 .... VMDLIMGR X'10' VMDLIMGR VMDBK limited due
to Group limit This VMDBK is on
limit list with VMDTODLM=LIMTODLM
because the group limit was hit
.... 1... VMDLIMSU X'08' VMDLIMSU VMDBK group limit
suspended This VMDBK is being
relocated & is currently in the
quiesce phase so it is exempt
from group limiting at this time.
CPU time consumed while this bit
is on is not included in the CPU
pool's usage. Individual limits
are suspended by manipulating
VMDLIMTH.
.... .1.. VMDINTOT X'04' VMDINTOT VMDBK's share is
included in SRXBK totals for all
logged on users
097B 2427 Bitstring 1 VMDDLCTX Extension for VMDDLCTL -
Identifies a controlled resource
which was exceeded.
1... .... VMDWSSGR X'80' VMDWSSGR WSS Growth Limit
Exceeded
.1.. .... VMDPRMPT X'40' VMDPRMPT User is to be
Pre-Empted
..1. .... VMDCPLXD X'20' VMDCPLXD Complex dropped
(valid only for virtual MP
VMDBKs)
...1 .... VMDESEND X'10' VMDESEND Elapsed Timeslice
End Exceeded
.... 1... VMDVSEND X'08' VMDVSEND Voluntary
Timeslice End
.... .1.. VMDCANLK X'04' VMDCANLK Cancel "lockshot"
for this user and send it back to
the E-list for its regularly
scheduled stay.
097C 2428 Bitstring 1 VMDSACTL Saved copy of VMDDLCTL for later
examination of why user dropped
from the dispatch list
.1.. .... VMDDSEND X'40' VMDDSEND DISPATCH TIME
SLICE EXCEEDED
..1. .... VMDLIMMV X'20' VMDLIMMV Indicates this
VMDBK should be moved to the
limit-list.
.... 1... VMDIDROP X'08' VMDIDROP USER SHOULD BE
DROPPED FROM THE DISPATCH LIST
IMMEDIATELY
.... .1.. VMDLOVMP X'04' VMDLOVMP VIRTUAL MP
VOLUNTARY DROP OF DISPATCH
PRIORITY BEHIND LOWEST VIRTUAL MP
CPU IN THE DISPATCH LIST
.... ..1. VMDREORD X'02' VMDREORD VMDBK IS TO BE
REORDERED IN THE DISPATCH LIST
.... ...1 VMDRSCEL X'01' VMDRSCEL VMDBK EXCEEDED
LIMITS OF A CONTROLLED RESOURCE.
VMDDLCTX IDENTIFIES THE RESOURCE.
1111 1111 VMDSTKDL X'FF' VMDSTKDL ANY BIT REQUIRES
HCPSTLDL CALL
097D 2429 Bitstring 1 VMDSACTX Saved copy of VMDDLCTX. Used in
the same way as VMDSACTL.
1... .... VMDWSSGR X'80' VMDWSSGR WSS Growth Limit
Exceeded
.1.. .... VMDPRMPT X'40' VMDPRMPT User is to be
Pre-Empted
..1. .... VMDCPLXD X'20' VMDCPLXD Complex dropped
(valid only for virtual MP
VMDBKs)
...1 .... VMDESEND X'10' VMDESEND Elapsed Timeslice
End Exceeded
.... 1... VMDVSEND X'08' VMDVSEND Voluntary
Timeslice End
.... .1.. VMDCANLK X'04' VMDCANLK Cancel "lockshot"
for this user and send it back to
the E-list for its regularly
scheduled stay.
097E 2430 Bitstring 1 VMDQSTAT User scheduling status
1... .... VMDHOTRQ X'80' VMDHOTRQ HOT SHOT
scheduling requested
.1.. .... VMDHOTST X'40' VMDHOTST HOT SHOT user
scheduling granted
..1. .... VMDLOADU X'20' VMDLOADU Loading User
designation
...1 .... VMDIABIA X'10' VMDIABIA Interactive Bias
is in effect
.... .1.. VMDLKSHT X'04' VMDLKSHT "Lockshot"
scheduling in effect for this
user. User should go back for an
E-list stay once critical-process
count (VMDCTCRT) drops to 0. Set
only in a Base VMDBK.
.... ...1 VMDNULL X'01' VMDNULL VMDBK should be
destroyed by the scheduler.
097F 2431 Bitstring 1 VMDSLIST Scheduling list definition
00000037 VMDDISPL 55 VMDDISPL User is in the
Dispatch List
00000021 VMDELIG 33 VMDELIG User is in the
Eligible List
0000000B VMDDORM 11 VMDDORM User is in the Dormant
List
00000000 VMDDNULL 00 VMDDNULL User is not in a list
0980 2432 Bitstring 1 VMDELIST Eligible List Class for current
transaction
0981 2433 Bitstring 1 VMDPRVEL Prev E-List Class (before HOTSHOT
0982 2434 Bitstring 2 * Reserved for IBM use
0984 2436 Signed 4 * Reserved for IBM use
0988 2440 Signed 8 VMDEPRTY Eligible List Priority value
0990 2448 Signed 8 VMDPRVEP Prev E-LIST Priority (B4 HOTSHOT
0998 2456 Signed 8 * Reserved for IBM use
09A0 2464 Signed 8 VMDOPRTY A version of VMDDPRTY computed
without considering the presence
of interactive bias.
09A8 2472 Signed 2 VMDSLCNT Count of minor timeslices
completed so far during this
transaction. This field is
protected by the scheduler lock.
09AA 2474 Signed 2 VMDSLCAD VMDSLCNT saved at D-list add
09AC 2476 Signed 4 VMDURRSP User's resource requirement for
storage and paging.
09B0 2480 Signed 4 VMDRTHRU Required throughput while user is
in the Dispatch List, OR expected
throughput for lock or resource
waiter NOT in the dispatch list.
09B4 2484 Signed 8 VMDVTIMD VMDVTIME value from last time
interval value was calculated for
an ESA family guest with SET
370ACCOM ON and SET TIMER ON or
SET TIMER REAL. Serialized by
dispatch lock.
09BC 2492 Signed 4 VMDWSSPR Working Set Size projection
09C0 2496 Signed 4 VMDHOTWS Alternate WSS for HOTSHOT
09C4 2500 Signed 4 VMDRPLIM Working set growth limit. When
the count of frames acquired
reaches this value, it is time to
check in with the scheduler by
calling HCPSTKGL. Valid in base
VMDBK.
09C8 2504 Bitstring 1 VMDELGST A flag byte manipulated by
Test-and-Set indicating whether
or not pages were stolen from a
VMDBK while it was in the
eligible list. The byte is
initialized to X'FF' and set to
X'00' via a MVI when pages are
taken from the VMDBK. The
scheduler will then TS this byte
when it next determines the
VMDBK's priority.
09C9 2505 Bitstring 1 * (2) Reserved for IBM use
09CB 2507 Bitstring 1 VMDLMNDX Index to element of the SRMRTHRU
table. Element is the sum in
which VMDRTHRU is included.
09CC 2508 Signed 4 VMDTLPRS The last Resident Page Count when
the VMDBK was dropped from the
D-List. It is used to calculate a
user's Working Set Factor to
re-calculate the Initial D-List
Priority.
09D0 2512 Signed 4 VMDCCPGR Count of page reads from DASD for
all private spaces owned by this
user. It is calculated from
VMDCTPFD at Add-to-DList, and is
recalculated whenever Dispatch
Priority is recalcu- lated.
Preserved in VMDTLPGR at
Add-to-DList. Valid only in base
VMDBK.
09D4 2516 Signed 4 VMDTLPGR Count of page reads from DASD for
all private spaces owned by this
user, at Add-to-DList. It is set
by copying the value of VMDCCPGR
at that time. Valid only in base
VMDBK.
09D8 2520 Signed 4 VMDPGRTE Paging rate during last D-list
stay
09DC 2524 Signed 4 VMDEDFAC Eligible list delay factor. This
is the actual time the user spent
in the eligible list during its
last stay, expressed as a
multiple of its current elapsed
time slice. This field is valid
only while the user is in the
dispatch list.
MISCELLANEOUS TOD AND ELAPSED TIME RECORDINGS
09E0 2528 Signed 8 VMDESLIC Elapsed Time Slice for D-List
09E8 2536 Signed 8 VMDEQTOD TOD at last D-List entry
09F0 2544 Signed 8 VMDDQTOD TOD at last drop from the D-List
09F8 2552 Signed 8 VMDDTIME Actual time in D-List (last stay)
used to get expansion factor
0A00 2560 Signed 8 VMDETIME Actual time in E-List (last stay)
used to get expansion factor
0A08 2568 Signed 8 VMDEETOD TOD at last E-List entry
0A10 2576 Signed 8 VMDMTTOD TOD at last started transaction
for Monitor
0A18 2584 Signed 8 VMDMPSUS Most-recent VMDSUSCK time in the
MP complex
EVENT COUNTS MAINTAINED FOR THE MONITOR FACILITY:
0A20 2592 Signed 2 VMDCIDLD (0) Count of User Went Idle drops
0A20 2592 Signed 2 VMDCIDL0 for Q0 user drops
0A22 2594 Signed 2 VMDCIDL1 for Q1 user drops
0A24 2596 Signed 2 VMDCIDL2 for Q2 user drops
0A26 2598 Signed 2 VMDCIDL3 for Q3 user drops
0A28 2600 Signed 2 VMDCETSD (0) Count of E-Slice End drops
0A28 2600 Signed 2 VMDCETS0 for Q0 user drops
0A2A 2602 Signed 2 VMDCETS1 for Q1 user drops
0A2C 2604 Signed 2 VMDCETS2 for Q2 user drops
0A2E 2606 Signed 2 VMDCETS3 for Q3 user drops
0A30 2608 Signed 2 VMDCWSGD (0) Count of WSS Growth Limit drops
0A30 2608 Signed 2 VMDCWSG0 for Q0 user drops
0A32 2610 Signed 2 VMDCWSG1 for Q1 user drops
0A34 2612 Signed 2 VMDCWSG2 for Q2 user drops
0A36 2614 Signed 2 VMDCWSG3 for Q3 user drops
0A38 2616 Signed 2 VMDCPRMD (0) Count of Pre-Emption drops
0A38 2616 Signed 2 VMDCPRM0 for Q0 user drops
0A3A 2618 Signed 2 VMDCPRM1 for Q1 user drops
0A3C 2620 Signed 2 VMDCPRM2 for Q2 user drops
0A3E 2622 Signed 2 VMDCPRM3 for Q3 user drops
0A40 2624 Signed 2 VMDCTIDL Count of test idle granted.
0A42 2626 Signed 2 VMDCNTID Count of no test idl granted drop
0A44 2628 Signed 4 VMDLKSDL Total time this user has been in
the dispatch list under LockShot
scheduling. Reset to 0 when Lock
Shot ends (TOD bits 0-31 only)
0A48 2632 Signed 4 VMDCTCRT Counter of critical-processes
this VMDBK is responsible for.
VMDBK must not wait in the
eligible list while this count is
greater than 0. Set only in the
Base VMDBK. Serialized by
COMPARE-AND-SWAP.
0A4C 2636 Signed 4 * Reserved for IBM use
0A50 2640 Signed 4 VMDTRQQS Pointer to scheduling TRQBLOK
VMDTRQQS is serialized with the
scheduler and TRQBK queue locks.
Either one can be held to look at
the field but both must be held
to change it. When getting both
locks the scheduler lock must be
obtained first.
0A54 2644 Signed 4 VMDQ1WSS Smoothed Resident Pgs at Q1 drop.
0A58 2648 Signed 8 VMDESRES Elapsed Time Slice residue. (The
portion of VMDESLIC that has not
yet been used up.)
0A60 2656 Signed 4 VMDLFPNT Limit-list forward pointer.
0A64 2660 Signed 4 VMDLBPNT Limit-list backward pointer.
0A68 2664 Signed 4 VMDLLANC Points to anchor word of the
Limit List
0A6C 2668 Signed 4 VMDMXSHR The VMDBK's max-SHARE. It may be
either ABSOLUTE or RELATIVE; the
VMDMXSHA flag tells which. If it
is RELATIVE it is an integer. If
ABSOLUTE, it is stored as a
fraction of the system, scaled
SHRSCALE. If the user has no
LIMIT it is zero. (See VMDLIMTH.)
0A70 2672 Signed 4 VMDCTSTA Count of times this virtual CPU
has been started by one of the
following methods: -SIGP START
-SIGP RESTART -Begin Command
0A74 2676 Signed 4 VMDCTSTO Count of times this virtual CPU
has been stopped by one of the
following methods: -SIGP STOP
-SIGP STOP AND STORE STATUS -SIGP
INITIAL CPU RESET -SIGP CPU RESET
-STOP Command
0A78 2680 Signed 4 * (2) Reserved for IBM use
VMCF and IUCV region
Serialization:
VMDVMCFL - not needed (valid in VMDBASE VMDBK only)
VMDVMCB - VMDBK VMCF lock
VMDVSEVM, VMDVSTVM, VMDVSUVM - VMDBK VMCF lock
VMDIUCVL - not needed (valid in VMDBASE VMDBK only)
VMDIUCVB - VMDBK IUCV lock
VMDISEVM, VMDISTVM, VMDISUVM - VMDBK IUCV/APPC lock
VMDSVMID - not needed
VMDVMCT - VMDBK VMCF lock
VMDAPPCF - Compare and Swap
VMDSVMWT, VMDSVMW2, VMDRDYCM - These fields are
only changed when running on a VMDBK in the same
virtual configuration. While this does not
provide air tight serialization, that is not
required because the data is only needed by the
monitor and absolute precision is not required by
the monitor.
WARNING: The "saved-segment purge" code path obtains both
VMDVMCFL and VMDIUCVL exclusive. Any changes to
the way these locks are obtained or what they
mean will probably necessitate changes in that
code path. The hierarchy between these locks
for tasks that need to obtain them both for the
same virtual configuration is VMCF first, then
IUCV.
0A80 2688 Dbl-Word 8 VMDVMCFL (3) VMCF lockword semaphore
0A98 2712 Signed 4 VMDVMCB Pointer to chain of VMCBLOKs.
Each VMCBLOK contains data
transfer and status information
used by the virtual machine
communication facility (VMCF).
All message VMCBLOKs are on the
VMCBLOK chain of the base VMDBK.
0A9C 2716 Signed 4 VMDVSEVM Number of times VMCF data was
successfully transferred by this
virtual machine.
0AA0 2720 Signed 4 VMDVSTVM Number of times VMCF data was
successfully transferred to this
virtual machine.
0AA4 2724 Signed 4 VMDVSUVM Number of times VMCF data was not
successfully transferred by this
virtual machine.
0AA8 2728 Dbl-Word 8 VMDIUCVL (3) IUCV lockword semaphore
0AC0 2752 Signed 4 VMDIUCVB Pointer to IUCV block
0AC4 2756 Signed 4 VMDISEVM Number of times IUCV/APPC data
was successfully transferred by
this virtual machine.
0AC8 2760 Signed 4 VMDISTVM Number of times IUCV/APPC data
was successfully transferred to
this virtual machine.
0ACC 2764 Signed 4 VMDISUVM Number of times IUCV/APPC data
was not successfully transferred
by this virtual machine.
0AD0 2768 Character 8 VMDSVMID Userid or CP system service name
for the last successful IUCV,
VMCF or APPC/VM Send for this
virtual machine
0AD8 2776 Signed 4 VMDVMCT Pointer to tail of chain of
VMCBLOKS
0ADC 2780 Signed 4 VMDMAXVF MAXIMUM SINK VALUE FOR VMCF
0AE0 2784 Signed 4 VMDSVMFX Count of times SVM-wait flag was
left on at transaction end and
was reset by the scheduler.
0AE4 2788 Bitstring 1 VMDSVMWT Service virtual machine wait
flag. Valid only in the base
VMDBK.
1... .... VMDSVMWF X'80' VMDSVMWF VMDBK is waiting
for a response from IUCV or VMCF.
Set by IUCV and VMCF when:
a) A VMDBK uses IUCV or VMCF to
communicate with another VMDBK
b) The protocol indicates a
response is expected.
Turned off in normal case when
final response is sent to
originating VMDBK.
Turned off in an error-correction
case by the scheduler. Whenever
a VMDBK begins a new transaction
(by scheduler standards), then if
the VMDBK has not just been
readied to talk to an SVM (see
VMDRDYCM flag, below), the
scheduler assumes some mistake has
been made. (If the VMDBK ever
went idle because it was waiting
on an SVM, it should only have
been readied when that reply was
received. Receiving the reply
would have turned on VMDRDYCM.
No intervening work is expected.
Therefore, if the VMDRDYCM flag
is off, the VMDSVMWT flag should
also be off.) The scheduler will
correct the assumed mistake by
turning off VMDSVMWT. This
precaution is taken in case the
IUCV/VMCF protocol is used in an
unexpected way, causing the
VMDSVMWT flag to not get turned
off in the normal case, in turn
causing Monitor to see many
separate transactions all as one
long transaction.
See HCPSCHTE's prolog for more
info. on how this field is used.
0AE5 2789 Bitstring 1 VMDSVMW2 Back-up byte for VMDSVMWT. Valid
only in the base VMDBK.
1... .... VMDSVMWF X'80' VMDSVMWF VMDBK is waiting
for a response from IUCV or VMCF.
Recorded by the scheduler at
dispatch list drop time so that
at eligible list add time, the
scheduler will know what the
state of the VMDSVMWT flag was
at drop. The scheduler never
tests VMDSVMWT directly; instead
it always tests this backup
copy. (The VMDSVMWT flag could
potentially be turned off
already. If the VMDBK went idle
waiting for an SVM, then the SVM
could send a reply, turning off
VMDSVMWT before readying the
VMDBK to process the reply.)
See HCPSCHTE's prolog for more
info. on how this field is used.
0AE6 2790 Bitstring 1 VMDRDYCM Readied-by/received-interrupt-
Valid only in the base VMDBK.
1... .... VMDSVMWF X'80' VMDSVMWF VMDBK is waiting
for a response from IUCV or VMCF.
from communications flag.
Set by IUCV or VMCF whenever
making an external interrupt
pending in a virtual machine.
Turned off by the scheduler at
every dispatch list drop. Used
to tell the scheduler at add to
eligible list whether or not the
VMDBK is being readied to
continue communication with an
SVM.
See HCPSCHTE's prolog for more
info. on how this field is used.
0AE7 2791 Bitstring 1 VMDAPPCF APPC/VM control flags, Compare
and Swap Serialization. For Base
VMDBK only (all bits)
1... .... VMDCPIBF X'80' VMDCPIBF CP has generated
an IUCVB for this virtual
machine.
.1.. .... VMDIUANY X'40' VMDIUANY IUCV ANY directory
statement found by IUCV DCLBFR
..1. .... VMDIUALL X'20' VMDIUALL IUCV ALLOW
directory statement found by IUCV
DCLBFR
.... 1... VMDUNDET X'08' VMDUNDET Unused virtual
machine detection candidate (this
virtual machine was logged on as
a TSAF private server). Will be
logged off if idle for two
virtual machine detection scans.
Set by TSAF.
.... .1.. VMDUNEXT X'04' VMDUNEXT Unused virtual
machine detection extension. The
next unused virtual machine
detection scan should not logoff
this virtual machine. Set by
TSAF.
0AE8 2792 Signed 4 VMDVGRPT VM Group Block pointer used by
the Group Control System (GCS).
0AEC 2796 Signed 2 VMDSIGID Siginal ID of this VM Group
member.
0AEE 2798 Signed 2 VMDVMETY Last *VMEVENT event type Valid
only in base VMDBK Changes
serialized by console function
mode
00000000 VMELOGON 0 VMELOGON Logon
00000001 VMELOGOF 1 VMELOGOF Logoff
00000002 VMEFAILD 2 VMEFAILD Failure
00000003 VMETIMEO 3 VMETIMEO Logoff timeout
00000004 VMESLEEP 4 VMESLEEP Forced sleep (Forced
disconnect or console read by
disconnected guest but disconnect
timeout is zero)
00000005 VMERUNBL 5 VMERUNBL Runnable
00000006 VMEFSLIM 6 VMEFSLIM Free storage limit
exceeded
00000007 VMEPLXMC 7 VMEPLXMC SSI mode
00000008 VMEPLXSC 8 VMEPLXSC SSI member state
00000009 VMERLOOS 9 VMERLOOS Outbound relocation
started
0000000A VMERLOIS 10 VMERLOIS Inbound relocation
started
0000000B VMERLOOC 11 VMERLOOC Outbound relocation
complete
0000000C VMERLOIC 12 VMERLOIC Inbound relocation
complete
0000000D VMERLOOT 13 VMERLOOT Outbound relocation
terminated
0000000E VMERLOIT 14 VMERLOIT Inbound relocation
terminated
0000000F VMETBOMB 15 VMETBOMB Diag x'288' Timebomb
exploded
00000010 VMEFRDVA 16 VMEFRDVA First RDEV active
00000011 VMEARDVA 17 VMEARDVA Additional RDEV
active
00000012 VMEARDVD 18 VMEARDVD RDEV deactivated -
not last
00000013 VMELRDVD 19 VMELRDVD Last RDEV deactivated
00000014 VMEBRDVA 20 VMEBRDVA Bridge Port RDEV
activated
00000015 VMEBRDVD 21 VMEBRDVD Bridge Port RDEV
deactivated
00000016 VMEMACTO 22 VMEMACTO MAC Address Take-Over
00000017 VMEMACTB 23 VMEMACTB MAC Address Take-Back
00000018 VMEIVLJN 24 VMEIVLJN System Joined IVL
Domain
00000019 VMEIVLLF 25 VMEIVLLF System Left IVL
Domain
00000019 VMELAST 25 VMELAST Last event type
0AF0 2800 Dbl-Word 8 * Reserved for IBM use address
0AF8 2808 Bitstring 1 VMDISFFL VM/CSE Flag byte, Changes to this
flag are serialized on the user's
VMDBK
1... .... VMDISFER X'80' VMDISFER HCPQCT should
bypass error msg, CSE will issue
later
.1.. .... VMDISFSM X'40' VMDISFSM HCPQCN will call
HCPXCMCN to send a msg to the
other systems
...1 .... VMDISFIX X'10' VMDISFIX User is in VM/CSE
input spool file exclusion list
.... 1... VMDISFOX X'08' VMDISFOX User is in VM/CSE
output spool file exclusion list
.... .1.. VMDISFAS X'04' VMDISFAS Processing on an
associated VM/CSE system.
Serialized on Master processor
and System VMDBK
.... ..1. VMDISF08 X'02' VMDISF08 Processing message
response Received from associated
systems.
0AF9 2809 Bitstring 1 VMDSYSRS System reset stacked for end user
breakout on waiting APPC
function. Serialized by
Test-and-Set. Valid only in base
VMDBK.
0AFA 2810 Bitstring 1 * Reserved for IBM use
0AFB 2811 Address 1 VMDVMEFT *VMEVENT failure type Valid only
in base VMDBK when VMDVMETY =
VMEFAILD Changes serialized by
console function mode
00000001 PRODISWT X'01' PRODISWT CP entered;
Disabled wait PSW is provided in
a message in the buffer
00000002 PROEXTIL X'02' PROEXTIL CP entered;
External interrupt loop
00000003 PROPAGER X'03' PROPAGER CP entered; Paging
error
00000004 PROPRGIL X'04' PROPRGIL CP entered;
Program interrupt loop
00000007 PROCPXIL X'07' PROCPXIL CP entered;
Complex interrupt loop
00000008 PROSOFAB X'08' PROSOFAB System soft abend,
abend code is provided in message
in the buffer
00000009 PROCKSTP X'09' PROCKSTP CPU stopped;
Check-stop state entered
0000000A PROPGZDM X'0A' PROPGZDM Page zero damaged
0000000B PROERNOM X'0B' PROERNOM An error occurred
but CP was unable to provide a
message because of a paging error
0AFC 2812 Signed 4 * Reserved for IBM use
POSIX Information
POSIX IDs
0B00 2816 Dbl-Word 8 VMDPXILK (3) PXIBK-chain lockword. Valid only
in the base.
0B18 2840 Address 4 VMDPXIBK Anchor of the PXIBK chain for
this vConfig. Valid only in the
base. Serialized by VMDPXILK.
VMDPQDBA, VMDPESIA and VMDPSIDA indicate
a user's authorization for certain POSIX functions.
They are set at logon time according to the user's
directory settings and the system default settings,
from the POSIXOPT directory statement and the
USER_DEFAULTS system config statement, respectively.
0B1C 2844 Bitstring 1 VMDPXFL1 POSIX flags. Valid in base VMDBK.
Contains flags in the left nibble
that are changed during alternate
userid processing. VMDPQDBA,
VMDPESIA and VMDPSIDA must remain
in the same bit positions as
their counterparts in DVMDPXO1
and SYSUDEF1. VMDPQDBB, VMDPESIB
and VMDPSIDB must remain in the
same bit positions as their
counterparts in the left nibble.
1... .... VMDPQDBA X'80' VMDPQDBA User is allowed to
query others' POSIX database
information. Can be changed due
to alternate userid processing.
.1.. .... VMDPESIA X'40' VMDPESIA exec() is allowed
to change this user's POSIX IDs,
as appropriate. Can be changed
due to alternate userid
processing.
..1. .... VMDPSIDA X'20' VMDPSIDA User is allowed to
set others' POSIX IDs. Can be
changed due to alternate userid
processing.
.... 1... VMDPQDBB X'08' VMDPQDBB User is allowed to
query others' POSIX database
information. This does not change
while the user is logged on.
.... .1.. VMDPESIB X'04' VMDPESIB exec() is allowed
to change this user's POSIX IDs,
as appropriate. This does not
change while the user is logged
on.
.... ..1. VMDPSIDB X'02' VMDPSIDB User is allowed to
set others' POSIX IDs. This does
not change while the user is
logged on.
0B1D 2845 Bitstring 1 VMDPG1LR List of guest page 1 locked
translation reasons using
VMDPG1FR. Serialized by i-stream
or CFM.
1... .... VMDPG1PF B'10000000' VMDPG1PF PFault2 Page
1 lock holder
.1.. .... VMDPG1TX B'01000000' VMDPG1TX
Transactional Execution Page 1
lock holder B'00111111' Reserved
lock holder ids
11.. .... VMDPG1VL VMDPG1PF+VMDPG1TX VMDPG1VL Valid
page 1 lock holder designations
0B1E 2846 Signed 2 VMDPIDCT Count of PIDs currently allocated
to the vConfig. Valid only in the
base. Serialized by VMDPXILK.
0B20 2848 Signed 4 VMDPXCAI (0) POSIX communication area
identification. Zero indicates no
communication area has been
identified to CP. Valid in all
VMDBKs. Serialization: CFM to
set, CFM-or-istream to reference.
0B20 2848 Signed 2 VMDPXCAL Length of vConfig's POSIX
communication area
0B22 2850 Signed 2 VMDPXCAD Displacement of vConfig's POSIX
communication area within each
vCPU's prefix area.
0B24 2852 Signed 4 VMDITDBA Host-logical address of the ITDB
Adjunct information
0B28 2856 Character 8 VMDLMSG Userid of adjunct to get control
STMGT counters.
0B30 2864 Signed 4 * Reserved for IBM use
0B34 2868 Signed 4 VMDCTPVG (0) Count of private address space
resident pages in DPA owned by
this virtual machine which are
>= 2G. Valid only in base
VMDBK. Serialized by compare and
swap. See VMDCTPVR.
0B34 2868 Signed 4 VMDCTSHG Count of shared address space
resident pages in the DPA with
addresses >= 2G. Only valid in
SYSTEM VMDBK. Serialized by
compare and swap. See VMDCTSHR.
0B38 2872 Dbl-Word 8 VMDUFOUSR (0) User private pages frame list.
Valid in user base VMDBKs. Mapped
by UFOHDR DSECT.
0B38 2872 Dbl-Word 8 VMDUFOSHR (8) Shared pages frame list (includes
shared VDisk pages). Valid in
SYSTEM VMDBK only. Mapped by
UFOHDR DSECT. Serialized by
VMDUFOLK via HCPLKUFO/HCPULUFO
0B78 2936 Dbl-Word 8 VMDUFOVDK (8) VDisk private pages frame list.
Valid in SYSTEM VMDBK only.
Mapped by UFOHDR DSECT.
Serialized by VMDUFOLK via
HCPLKUFO/HCPULUFO
PFAULT page fault handshaking area
0BB8 3000 Address 8 VMDGPFAUL GReal @ of z/Architecture guest's
PFAULT handshaking token
0BB8 3000 Signed 4 *
0BBC 3004 Address 4 VMDPFAUL GReal @ of ESA guest's PFAULT
handshaking token
0BC0 3008 Address 4 VMDPPFAR List of page-fault handshaking
pending interrupt blocks (PPFBK)
via PFAULT. AR-qualified and
version 2 host-primary.
Serialized by dispatch lock.
0BC4 3012 Signed 4 VMDPG1FR Host logical addr of V=V
z/Architecture guest's primary
address space page 1. This field
is serialized by CFM or i-stream.
It is set by PFAULT Version 2
processing and zeroed when PFAULT
is canceled. IF this field is
nonzero, other functions running
under CFM or i-stream may use it
for fast access to guest page
one.
0BC8 3016 Signed 8 VMDSELMK PSW selection mask. Bits 0-63 are
significant for z/Arch guest and
bits 0-32 for ESA guest. A '1' in
a bit selects the corresponding
vCPU PSW bit for comparison with
the equivalent bit in the compare
mask. Only used by PFAULT Version
2.
0BD0 3024 Signed 8 VMDCMPMK PSW comparison mask. Only used by
PFAULT Version 2.
0BD8 3032 Signed 8 VMDVOPST Stuff for HCPVINOP/HCPVOP
0BD8 3032 Bitstring 1 VMDVOPOC Operand code to pass to HCPVOP
0BD9 3033 Bitstring 7 * Reserved
IPL Simulation status Region (EXTENSION)
0BE0 3040 Address 4 VMDLLOAD Address of FCLBK for
List-Directed IPL. In base VMDBK
only. Serialized by CFM.
0BE4 3044 Address 4 VMDLDUMP Address of FCLBK for
List-Directed IPL with DUMP In
base VMDBK only. Serialized by
CFM.
0BE8 3048 Address 4 VMDHSA HLA(Sim. HSA for LD-IPL w/ Dump)
0BEC 3052 Signed 4 VMDHSASZ Size of HSA (number of pages)
0BF0 3056 Address 4 VMDPDIPL Address of IPL Parameter List for
Program-Directed IPL. In base
VMDBK only. Serialized by CFM.
0BF4 3060 Bitstring 1 VMDPDSTS Pgm-Directed status flags
1... .... VMDPDIAC X'80' VMDPDIAC Pgm-Directed IPL
is active In base VMDBK only.
Serialized by CFM/CS logic.
.1.. .... VMDPDIRS X'40' VMDPDIRS LD-IPL initiated
by PD-IPL is reset pending
(Diag308 code 1|2) Serialized by
CFM In base VMDBK only.
0BF5 3061 Bitstring 1 VMDPDERR Unique loc ID of last 402 error
0BF6 3062 Bitstring 2 * Reserved for future IBM use
0BF8 3064 Dbl-Word 8 * Reserved for future IBM use
User's UFO list lock
0C00 3072 Dbl-Word 8 VMDUFOLK (6) USER FRAME OWNED LIST SPIN LOCK
ALL DATA ASSOCIATED WITH THE USER
FRAME OWNED LIST CAN ONLY BE
UPDATED BY HOLDING THIS LOCK.
VMDCTFAC is part of that data.
VMDUFOLK is lower in locking
hierarchy than VMDSHRLK.
VMDTTMP, VMDVTMP, VMDTTMS, and VMDVTMS decrease over time
and are initialized to:
- 0 for the SYSTEM and SYSTEMMP VMDBKs
- PFXTMMAX for all other VMDBKs
0C30 3120 Signed 8 VMDTTMP Total virtual and simulation time
while running on a primary CPU
0C38 3128 Signed 8 VMDVTMP Total virtual time consumed while
running on a primary CPU
0C40 3136 Signed 8 VMDTTMS Total virtual and simulation time
while running on a secondary CPU
0C48 3144 Signed 8 VMDVTMS Total virtual time consumed while
running on a secondary CPU
0C50 3152 Dbl-Word 8 * (4) Reserved for IBM use
0C70 3184 Signed 4 * Reserved for IBM use
SCHEDULER FIELDS FOR CPU POOLING SUPPORT
If the system is using the consumption method of
limiting CPU usage (SET SRM LIMITHARD CONSUMPTION)
and CPU affinity is ON for this user, then this
userid is eligible for group limiting as well as
individual limiting (via SET SHARE). Group limits
are set via a defined CPU Pool which users are then
assigned to. If the user is assigned to a CPU Pool,
VMDLIMBK will point to the LIMBK for the pool and
VMDGTIMS will hold this virtual CPU's group
interval start time for the current interval.
0C74 3188 Address 4 VMDLIMBK Pointer to LIMBK for this VMDBK
When this userid is put into a
CPU pool, this pointer is filled
in for all of the user's
principal vConfig VMDBKs (Origin,
MP-VMDBKs) of the virtual CPU
type that can/will charge time to
the CPU Pool. UPDATE serialized
by getting both: - LIMBK CHAIN
LOCK EXCLUSIVE - SCHEDULER LOCK
EXCLUSIVE READ serialized by
getting one held SHARED or
EXCLUSIVE: - LIMBK CHAIN LOCK
(LCPLLCK) - SCHEDULER LOCK
0C78 3192 Signed 8 VMDGTIMS VMDTTIME at the last time this
VMDBK's consumption was charged
to the group. It is initialized
to the user's
VMDTTIME/VMATTIME_PRO when the
user is put into a CPU pool, is
reset to VMDTTIME or VMATTIME_PRO
after every CPU time slice when
the VMDBK's CPU time used is
added to the group total, and is
used to add in the VMDBK's final
time when the user leaves a CPU
pool. This value does not line up
with LIMTODST because the 2
fields are not set at the same
time. (Analogue of VMDTTIMS for
indiv. limit except
VMDTTIMS/VMDTODST always line up)
If MT is enabled, this field
contains prorated core time;
Otherwise, this field contains
raw CPU time. Serialized by
SCHEDULER LOCK held EXCLUSIVE
0C80 3200 Signed 8 VMDTODIL TOD Individual Limit expires.
Since VMDTODLM is used for the
limit list expiration time which
may not be the individual limit,
VMDTODIL remembers the individual
limit (if any) while LIMTODLM
remembers the group limit.
Serialized by SCHEDULER LOCK held
EXCLUSIVE
Fields pertaining to S/370 architecture, but still used
in support of guests with 370ACCOM ON. These were
formerly located in the state description (SIEBK) but are
now located here since the hardware no longer supports
these fields in the state description.
0C88 3208 Dbl-Word 8 VMDITRES Interval timer residue (formerly
SIEHIRES and SIELORES) The
interval timer residue counter is
in the ESA/390 (or S/370) format
of a TOD clock, and contains
guest CPU time which has not yet
been applied to the guest
interval timer. It is used to
collect short increments of CPU
time until 3.333 milliseconds has
been accumulated, at which point
the guest interval timer is
decreased and the residue counter
is reduced by 3.333 milliseconds.
Software uses the residue counter
to collect elapsed time in guest
wait state before applying the
time to the interval timer. This
field is serialized by the
dispatch lock. *** End of S/370
architecture fields
XDISK Performance Tracking Data
All fields in this area are valid only for the base VMDBK.
Serialized :
All fields are updated during processing of CP commands,
so all fields are serialized by console function mode
0C90 3216 Signed 4 VMDLKTOT Count of times user has issued a
LINK command.
0C94 3220 Signed 4 VMDLKPLX Count of times user has consulted
with the SSI due to LINK commands
0C98 3224 Dbl-Word 8 VMDLKTOD Total time spent consulting SSI
for LINK commands
0CA0 3232 Signed 4 VMDDTTOT Count of times user has issued a
DETACH command.
0CA4 3236 Signed 4 VMDDTPLX Count of times user has consulted
with the SSI due to DETACH cmnds
0CA8 3240 Dbl-Word 8 VMDDTTOD Total time spent consulting SSI
for DETACH commands
0CB0 3248 Signed 4 VMDWKTOT Count of times user has issued a
SET WRKALLEG ON command.
0CB4 3252 Signed 4 VMDWKPLX Count of times user has consulted
with the SSI due to SET WRKALLEG
ON command
0CB8 3256 Dbl-Word 8 VMDWKTOD Total time spent consulting SSI
for SET WRKALLEG ON commands
commands
0CC0 3264 Dbl-Word 8 * (4) Reserved for IBM use *** End of
XDISK Performance Tracking Data
USER RELOCATION INFORMATION
and AT Command data that will be mutually
exclusive in its use
Note that the VMDRLLST and VMDRLSRC fields may be
redefined depending on the setting of the
VMDRLFLG.VMDRLLGF and VMDRLFLG.VMDRLSKL flags.
VMDRLLST->VMDRLBYU during logoff on the source
after a successful relocation (VMDRLLGF=ON)
VMDRLLST->VMDRLUSR during logoff of a skeleton
VMDBK due to aborted relocation (VMDRLSKL=ON)
VMDRLSRC->VMDRLDN during logoff on the source
after a successful relocation (VMDRLLGF=ON)
VMDRLSRC->VMDRLSC during logoff of a skeleton
VMDBK due to aborted relocation (VMDRLSKL=ON)
Note also that a number of these relocation-related
fields are defined for use in an AT command VMDBK.
See VMDATORG for the beginning of that redefintion.
These redefinitions work because all four of the
events (active relocation, logoff for successful
relocation, logoff skeleton for aborted relocation
and AT command) are mutually exclusive.
0CE0 3296 Character 8 VMDRLOLG Name of the system/member where
user first logged onto the SSI.
Only filled in during logon so no
special serialization is needed.
(Valid in all vCPUs)
0CE8 3304 Dbl-Word 8 VMDRLLST Time stamp of last relocation of
this user (when it arrived). Only
filled in during the resume on
destination phase of a guest
relocation, so no special
serialization is needed. (Valid
in all vCPUs)
0CE8 3304 Character 8 VMDRLBYU Contains the VMRELOC cmd issuer's
name if VMDRLLGF is on. Only
filled in on the source system
when a guest is about to be
logged off after a successful
relocation, so no special
serialization is needed. (Valid
in all vCPUs)
0CE8 3304 Character 8 VMDRLUSR Contains the userid of the guest
whose relocation failed if
VMDRLSKL is on. Only filled in on
the destination system if a
skeleton VMDBK is about to be
logged off when a relocation
fails to complete, so no sepcial
serialization is needed. (Valid
in all vCPUs)
0CF0 3312 Character 8 VMDRLSRC Source system of last relocation
of this user (where it came
from). Only filled in during the
resume on destination phase of a
guest relocation, so no special
serialization is needed. (Valid
in all vCPUs)
0CF0 3312 Character 8 VMDRLDN Contains the destination node
name if VMDRLLGF is on. Only
filled in on the source system
when a guest is about to be
logged off after a successful
relocation, so no special
serialization is needed. (Valid
in all vCPUs)
0CF0 3312 Character 8 VMDRLSC Contains the source node name if
VMDRLSKL is on. Only filled in on
destination system when a
skeleton VMDBK is about to be
logged off when a relocation
fails to complete, so no special
serialization is needed. (Valid
in all vCPUs)
0CF8 3320 Bitstring 1 VMDSTRLO SET VMRELOCATE flags. Serialized
by CFM.
1... .... VMDRLONA X'80' VMDRLONA SET VMRELOCATE OFF
was specified so a relocation is
not allowed. Relocation is
allowed by default (Valid only in
the origin VMDBK)
.1.. .... VMDVARCH X'40' VMDVARCH When ON this bit
indicates CP is showing the guest
a virtual architecture that is
not the same as the real
architecture of the SSI member on
which it is running (Valid in all
VMDBKs)
0CF9 3321 Bitstring 1 VMDRLFLG Relocation flags -- The bits in
this byte are not serialized by
any formal locking mechanism. All
of these bits are turned on or
off in code that is running at a
time when no other tasks for the
relocation represented by the
RLOBK in VMDRLOBK are executing.
That is, this byte may only be
altered in single-threaded parts
of a guest relocation.
1... .... VMDRLINP X'80' VMDRLINP Relocation of this
user is currently in progress
(Valid only in the origin on the
source. Valid in all vCPUs on the
destination.)
.1.. .... VMDRLOIB X'40' VMDRLOIB If VMDRLINP is on
then this flag indicates if the
relocation is inbound (VMDRLOIB =
ON) or outbound (VMDRLOIB = OFF)
If VMDRLINP is off then this flag
is also off. (Valid only in the
origin on the source. Valid in
all vCPUs on the destination.)
..1. .... VMDRLQUI X'20' VMDRLQUI Virtual machine
has been quiesced for a
relocation. (Valid in all vCPUs
but only on source system)
...1 .... VMDRLSKL X'10' VMDRLSKL Indicates this is
a relocation skeleton VMDBK that
is being logged off because the
relocation will not complete
successfully. (Valid in all vCPUs
on dest system)
.... 1... VMDRLLGF X'08' VMDRLLGF Indicates logging
off on source system after a
relocation. (Valid in all vCPUs
on source system)
.... .1.. VMDSCTXP X'04' VMDSCTXP User security
context hasn't been reestablished
after a relocation. CP turns this
on when an inbound relocation is
started. It is turned off by CP
at guest resume time for a
successful relocation or when the
relocation terminates
unsuccessfully. (Valid only in
the origin VMDBK on the
destination system)
.... ..1. VMDRLSUP X'02' VMDRLSUP Value of VMDAFSUP
from source. (This flag is valid
in all VMDBKs on the destination
system)
.... ...1 VMDLIMDE X'01' VMDLIMDE Virtual machine is
running with limited capability
just prior to being quiesced for
a relocation (valid in all vCPUs)
0CFA 3322 Bitstring 1 VMDRLHFL Relocation history flag.
Serialized by CFM. (Valid in the
base VMDBK only)
1... .... VMDRLRST X'80' A relocation has occurred
for this user since the last
reset clear function for the user
.1.. .... VMDNOQEB X'40' This user was relocated
from a system with QEBSM support
enabled to this system which has
QEBSM support disabled
0CFB 3323 Bitstring 1 VMDRLFNC Count of times a FORCE command
was nullified because of a
relocation in progress. Used to
decide when cancellation of a
relocation is taking too long for
the FORCE command to wait for.
(Valid in the VMDBK corresponding
to the vCPU on which the command
was issued)
0CFC 3324 Address 4 VMDRLOBK Host logical address of the RLOBK
while this virtual machine is
being relocated; that is, when
the VMDRLINP bit is on. Same
serialization as the flag
VMDRLFLG.VMDRLINP since that bit
and this field are updated in the
same code. (Valid in origin VMDBK
only)
0D00 3328 Dbl-Word 8 VMDEPOCH TOD clock difference between
original source system and this
system. Used to form the SIEEPOCH
value. This field is only updated
and used during a guest
relocation. This happens only in
several places during guest state
relocation in code that cannot
run concurrently, so no special
serialization is required. (Valid
in the origin VMDBK only)
0D08 3336 Dbl-Word 8 VMDRLOLK (3) Relocation defer lock. Used to
serialize certain commands with a
relocation of this guest. This is
a shared/exclusive defer lock
maintained using HCPLCK. Commands
that would interfere with an
ongoing relocation must hold a
share of this lock during the
command processing. The
relocation process gets the lock
exclusively until the new RLOBK
is placed on the SYSRLOBKS queue.
(Valid only in the origin VMDBK)
0D20 3360 Address 4 VMDARDBK Pointer (host logical address) to
this guest's ARDBK which is used
to simulate any instructions that
indicate the availability of
architecture facilities.
Serialized by CFM. (Valid in all
VMDBKs)
0D24 3364 Address 4 VMDARDFP Forward pointer (host logical)
for the chain of VMDBKs that are
using the same ARDBK. Serialized
by the RDMLOCK of its relocation
domain. (Valid in all VMDBKs)
0D28 3368 Bitstring 1 VMDRLMON Bits that indicate a flag should
be set in a monitor record
indicating this is the first
record of its type since the
guest was relocated. Serialized
by the monitor cmd lock called
MND_CMD_LOCK.
1... .... VMDD4R3 X'80' VMDD4R3 Tells monitor this
is the first domain 4 record 3
collected since a relocation. LGR
code turns this on before the
relocation ends and monitor turns
it off again. Valid in all
VMDBKs.
.1.. .... VMDD4R4 X'40' VMDD4R4 Tells monitor this
is the first domain 4 record 4
collected since a relocation. LGR
code turns this on before the
relocation ends and monitor turns
it off again. Valid in all
VMDBKs.
..1. .... VMDD10R2 X'20' VMDD10R2 Tells monitor this
is the first domain 10 record 2
collected since a relocation. LGR
code turns this on before the
relocation ends and monitor turns
it off again. Valid only in the
base VMDBK.
The following flags are for installation use and are
used in conjunction with the VMDUSER1-8 fields.
Set the corresponding skip and move bits appropriately
whenever a new value is placed into one of those fields.
By default, relocation eligibility checks verify that
the VMDUSER1-8 fields are not in use and disallow the
relocation if they are in use. Use the flag bits in
VMDUSKCK to indicate to the live guest relocation code
whether eligibility checks should be skipped for each
VMDUSER1-8 field. Use the flag bits in VMDUSRMV to tell
relocation whether to move each VMDUSER1-8 field along
with the VMDBK at relocation time.
Setting the move bit for a field should only be done if
the value is a simple, non-pointer field. If one of
these fields contains a pointer, that pointer will not
be correct on the destination system and must be rebuilt
once the relocation completes. Exit 1231 could
potentially be used to rebuild any data on the
destination system. It is called on the destination
system, during relocation just before the guest is
restarted on the destination.
These two flag bytes (VMDUSKCK and VMDUSRMV) are valid
in all VMDBKs.
SERIALIZED : Any changes to these flag bytes must be
made under CFM serialization. If any
of these flag bits are turned on, then
changes to the corresponding VMDUSER1-8
field must also be made under CFM
serialization.
0D29 3369 Bitstring 1 VMDUSKCK LGR elig check skip flags for
VMDUSER1-8
1... .... VMDUSRS1 X'80' VMDUSRS1 Skip elig check of
VMDUSER1
.1.. .... VMDUSRS2 X'40' VMDUSRS2 Skip elig check of
VMDUSER2
..1. .... VMDUSRS3 X'20' VMDUSRS3 Skip elig check of
VMDUSER3
...1 .... VMDUSRS4 X'10' VMDUSRS4 Skip elig check of
VMDUSER4
.... 1... VMDUSRS5 X'08' VMDUSRS5 Skip elig check of
VMDUSER5
.... .1.. VMDUSRS6 X'04' VMDUSRS6 Skip elig check of
VMDUSER6
.... ..1. VMDUSRS7 X'02' VMDUSRS7 Skip elig check of
VMDUSER7
.... ...1 VMDUSRS8 X'01' VMDUSRS8 Skip elig check of
VMDUSER8
0D2A 3370 Bitstring 1 VMDUSRMV LGR move indication flags for
VMDUSER1-8
1... .... VMDUSRM1 X'80' VMDUSRM1 Move VMDUSER1
during relocation
.1.. .... VMDUSRM2 X'40' VMDUSRM2 Move VMDUSER2
during relocation
..1. .... VMDUSRM3 X'20' VMDUSRM3 Move VMDUSER3
during relocation
...1 .... VMDUSRM4 X'10' VMDUSRM4 Move VMDUSER4
during relocation
.... 1... VMDUSRM5 X'08' VMDUSRM5 Move VMDUSER5
during relocation
.... .1.. VMDUSRM6 X'04' VMDUSRM6 Move VMDUSER6
during relocation
.... ..1. VMDUSRM7 X'02' VMDUSRM7 Move VMDUSER7
during relocation
.... ...1 VMDUSRM8 X'01' VMDUSRM8 Move VMDUSER8
during relocation
0D2B 3371 Bitstring 5 * Reserved for future IBM use ***
End of User Relocation
Information
*** Start of AT redefinition of User Relocation fields
0CE0 3296 Character 8 VMDATORG Contains the system/member where
the AT Command originated from.
Field is only valid in AT Command
VMDBKs (VMDATCMD = on) Only
filled in during the build of the
AT Command VMDBK on the target
system, so no special
serialization is needed.
0CE8 3304 Signed 4 VMDATCNT Contains the count of lines of
data that have been returned from
the current AT Command. Only
Updated when in Console Function
mode when dispatched. Field is
only valid in AT Command VMDBKS
(VMDATCMD = on)
0CEC 3308 Bitstring 1 VMDATSTA At Command Status Byte. The bits
in this byte are serialized by
Console Function mode when
dispatched. Field is only valid
in AT Command VMDBKS (VMDATCMD =
on)
1... .... VMDATPA1 X'80' VMDATPA1 This user has
pressed the PA1 key on
originating system to suppress
long running output
.1.. .... VMDATLIM X'40' VMDATLIM User has reached
the exceeded messages limit for
this AT command
0CED 3309 Bitstring 1 * Reserved for future IBM use
0CEE 3310 Signed 2 VMDATSLT AT command source member slot id.
This field is set at VMDBK
creation time and is never
changed. It is valid in all AT
command VMDBKs
0CF0 3312 Signed 4 VMDATSID Socket handle dedicated to AT
command This field is set at
VMDBK creation time and is never
changed. It is valid in all AT
command VMDBKs *** End of AT
redefinition of User Relocation
fields
0D30 3376 Character 8 VMDACTID Accounting user identification
This field contains the userid to
be put in the accounting records
generated. It is generally the
same as the userid, which is how
it is set when a user logs on. It
is copied when a local VMDBK is
built. It can be changed by an
authorized user issuing a
DIAGnose X'4C'. This is intended
for use by the CMS batch machine.
0D38 3384 Character 8 VMDALGID Userid causing this user's logon
For normal users, this field
contains the user logon
identification. For users
AUTOLOGged by the system at IPL
time, this field contains
'SYSTEM'. For users (X)AUTOLOGged
by other users, this field
contains the userid issuing the
(X)AUTOLOG. For VMDBKs created as
adjunct virtual machines, this
field contains the user
identification of the origin
VMDBK. This field (VMDALGID) is
paired with VMDALGSL.
0D40 3392 Character 8 VMDACTNO User accounting number
SCHEDULER FIELDS (serialized by the scheduler lock)
If the system is using the consumption method of
limiting user's CPU usage (SET SRM LIMITHARD
CONSUMPTION), these fields are used to determine
if it is time to put a VMDBK on the limit list and
for how long.
0D48 3400 Signed 8 VMDTODST TOD at start of the current
limiting interval.
0D50 3408 Signed 8 VMDTTIMS VMDTTIME/VMATTIME_PRO at start of
the current limiting interval. If
MT is enabled, this field
contains prorated core time;
Otherwise, this field contains
raw CPU time.
0D58 3416 Signed 8 VMDTODLM Limit-list expiration TOD. If MT
is enabled, this field is
calculated from prorated core
time; Otherwise, this field is
calculated from raw CPU time.
DSVBK Rebalance and Steal/Needs help fields
0D60 3424 Address 4 VMDVMUBK Pointer to VM CPU Usage Block Set
up when the VMDBK is built and
never changed after that
0D64 3428 Signed 4 VMDCPUCH Count of SIE entries with
SIEIHCPU <> x'FFFF' and
this is a different logical CPU
than the one on which this VMDBK
was last run (i.e. CPU CHanged)
0D68 3432 Signed 8 VMDLSTRN TOD clock value when this VMDBK
last ran on a CPU topologically
equivalent to those associated
with its home DSVBK, or 0 if its
home has changed. Serialized by
either this VMDBK's home DSVBK
lock, or the scheduler lock
exclusive.
0D70 3440 Dbl-Word 8 VMDIOPTR Reserved doubleword for I/O
Multithreading fields
The following VMDxxxxx_MT1 fields:
- Hold the MT1 Equivalent time for the VMDxxxxx raw CPU
time fields and count down just like VMDxxxxx fields.
- Are initialized just like VMDxxxxx raw CPU fields to:
- 0 for the SYSTEM and SYSTEMMP VMDBKs
- PFXTMMAX for all other VMDBKs
- Use the same serialization as their VMDxxxxx raw CPU
time field (scheduler lock exclusive).
- Are relocated with their VMDxxxxx raw time field.
- Are only maintained by CP when PFXCBF <> 0.
If PFXCBF = 0
Then these fields are only set when the userid/VMDBK
is new to this system (ie: the user logs on or
is relocated in or defines another CPU)
Else these fields are updated whenever their VMDxxxxx
raw CPU time field is updated.
Whether CP is maintaining the VMDBK MT1 fields is a
SYSTEM WIDE function and all PFXPG control blocks on
the system MUST agree. Thus ALL PFXPG control blocks
MUST have PFXCBF=0 when the MT1 fields are not
maintained and ALL PFXPG control blocks MUST have
PFXCBF<>0 when the MT1 fields are maintained. The
bit controlling this SYSTEM WIDE function is in each
PFXPG for performance optimization of HCPDSP and the
callers of HCPMTIME macro. A function needing to use
a VMDBK MT1 field can test the PFXCBF value from any
PFXPG to see if it's non-zero.
All other Multithreading fields have been put into the
VMABK pointed to by the VMDVMABK field below.
0D78 3448 Signed 8 VMDTTIME_MT1 Session Total CPU time used in
MT-1 Equivalent time
0D80 3456 Signed 8 VMDVTIME_MT1 Session Virtual CPU time used in
MT-1 Equivalent time
0D88 3464 Signed 8 VMDTTMP_MT1 Total virtual and simulation time
while running on a primary CPU in
MT-1 Equivalent time
0D90 3472 Signed 8 VMDVTMP_MT1 Total virtual time consumed while
running on a primary CPU in MT-1
Equivalent time
0D98 3480 Signed 8 VMDTTMS_MT1 Total virtual and simulation time
while running on a secondary CPU
in MT-1 Equivalent time
0DA0 3488 Signed 8 VMDVTMS_MT1 Total virtual time consumed while
running on a secondary CPU in
MT-1 Equivalent time
VMDVMABK = pointer to Virtual Machine Activity Block
The VMDVMABK field is a pointer to the VMABK which is an
extension of the VMDBK. Whenever a VMDBK is created or
deleted, its VMABK is created or deleted. The VMDVMABK
pointer is set when the VMABK is created and does not
change for the life of the VMDBK/VMABK. ANY field (which
(1) needs to exist PER VMDBK, (2) is not relocated, and
(3) is referenced infrequently or in non-performance
paths) can be put in the VMABK to save space in the VMDBK.
So far the VMABK contains:
- Additional Multithreading fields for PRORATED times.
- Fields used for Multithreading relocation support
when moving between systems that are MT-enabled and
MT-disabled.
- Accounting fields used only when accounting records
are generated or relocation occurs.
0DA8 3496 Address 4 VMDVMABK Pointer to VMABK for this VMDBK.
The VMABK is the Virtual Machine
Activity Block.
0DAC 3500 Signed 4 VMDVSTCT Number of virtual CPUs for this
vconfig that have shadow tables.
This count is maintained only in
the base VMDBK. It equals the
number of VMDBKs for this vconfig
with VMDIPTLH set.
0DB0 3504 Dbl-Word 8 VMDRDHSH Redrive hash value used to detect
the same instance of a DAT
serializing instruction being
redriven.
0DB8 3512 Signed 4 VMDRDRCC Number of times a given instance
of a DAT serializing instruction
has been consecutively redriven.
0DBC 3516 Signed 2 VMDRDSIX Redrive stats index for current
DS instruction or -1 if no
statistics accumulated.
0DBE 3518 Bitstring 2 * Reserved for future IBM use
VMDBK ready delay and dispatch time metrics area
- Serialized by a share of the scheduler lock and an
exclusive hold of the VMDBK's home DSVBK lock or an
exclusive hold of the scheduler lock.
0DC0 3520 Signed 8 VMDTMRDY Timestamp when VMDBK became ready
to run (VMDSTATE=VMDREADY) or 0
if the VMDBK is not ready.
0DC8 3528 Signed 8 VMDTMDSP Timestamp when the VMDBK was
dispatched (VMDSTATE=VMDISPCH) or
0 if the VMDBK is not dispatched.
VMDBK LOCAL FREE STORAGE AREA
This area is managed by HCPFRD as free storage
which is local to the VMDBK. Free storage blocks
allocated from this area are long-term blocks which
are associated only with the user's Base VMDBK.
Note that this area must never cross a page boundary.
Care must be taken in any future increases in size
of overall length of a VMDBK.
Verify that we are at dword alignment.
Local space size is from here to the end of the VMDBK
00000230 VMDLSLEN (4096-(*-VMDBK))
Local space size in dwords
00000046 VMDLSPSZ (VMDLSLEN)/8
Local space
0DD0 3536 Bitstring 1 VMDLSPAC (560) User-local free storage area
00001000 VMDBKLEN (*-VMDBK) Length of VMDBK in
bytes
00000200 VMDBKSIZ (*-VMDBK)/8 SIZE OF VMD BLOCK IN
DOUBLEWORDS S/B 512 DOUBLE WORDS
(X'200')
Redefinition for guest CPU id
0010 16 Dbl-Word 8 VMDCPUID (0) GUEST MACHINE CPU ID (FOR STIDP)
DEFAULTS TO CPUID OF HOST IPLED
CPU, MODIFIED TO SHOW VERSION
CODE X'FF'.
0010 16 Bitstring 1 VMDCPVER GUEST CPU ID VERSION CODE
000000FF CPUIDVM X'FF' CPUIDVM VIRTUAL MACHINE
VERSION CODE
0011 17 Bitstring 3 VMDCPSER GUEST CPU ID SERIAL NUMBER
0014 20 Bitstring 2 VMDCPMOD GUEST CPU ID MODEL NUMBER
0016 22 Bitstring 2 * Reserved
0DD0 3536 Signed 4 VMDLCPTR POINTER TO NEXT CHUNK
0DD4 3540 Signed 4 VMDLCLEN LENGTH OF THIS CHUNK IN BYTES
* * * * N O T E * * *
+++
+
+ THE MAPPING FOR VMDLCPTR AND VMDLCLEN IS ONLY
+ VALID BEFORE HCPFREVM USES THIS AREA. HCPFREVM
+ USES IT'S OWN DSECT (FREMAP) ON THIS AREA WHEN
+ IT IS CHOSEN TO SERVE AS FREE STORAGE.
+
+
+ - WHEN THIS AREA BECOMES ACTIVE (CHOSEN TO BE USED
+ FOR FREE STORAGE) THE MAPPING USED WILL BE AS
+ FOLLOWS:
+
+ ACTIVE FREE STORAGE
+
+ +---------------------------+---------------------------+
+ | FREESIZE (COUNT) | FREEEND (POINTER) |
+ +---------------------------+---------------------------+
+
+
+ - WHEN THE BLOCK IS RETURNED (FRETTED) THE MAPPING USED
+ WILL BE AS FOLLOWS:
+
+ INACTIVE FREE STORAGE
+
+ +---------------------------+---------------------------+
+ | FREEPNT (POINTER)| FRETSIZE (COUNT) |
+ +---------------------------+---------------------------+
+
+++
Re-definition for SYSTEMMP VMDBK only.
The location was chosen so it could be in the
same cache line as the work bits.
0670 1648 Signed 4 VMDSYSMP SYSTEMMP VMDBK work-queue lock
Serialized by Compare-and-Swap.
Redefinition for SYSTEMMP VMDBK only.
These fields are used for indication of low
priority work to be done in the background
when a processor has nothing else to do. The
dispatcher uses these fields to determine when
some of this work is requested and to remember
which piece of work we did last time. The
different types of work are looked at in a
round robin manner each time we enter the
dispatcher and find nothing else to do.
0380 896 Signed 4 VMDLOWWK (0) Low priority DSP work bits.
Update with C/S. These functions
are handled when a processor is
about to enter wait state via
HCPWAIT. This word is only valid
in the System MP VMDBK
(PFXSYSMP).
0380 896 Bitstring 1 VMDLOWW0 Low priority work byte 0
1... .... VMDINI2G X'80' VMDINI2G >= 2G storage
needs to be initialized.
.1.. .... VMDNOOWN X'40' VMDNOOWN No own resources
need to be reclaimed.
..1. .... VMDRCGAL X'20' VMDRCGAL The cleared global
available list needs to be
replenished
...1 .... VMDSXSPM X'10' VMDSXSPM Low priority SXSPM
work exists.
0381 897 Bitstring 3 * Reserved for IBM use
0384 900 Signed 4 VMDLOWRR This field is used to cycle in a
round robin pattern through the
different types of low priority
(background) work that the
dispatcher might be asked to do
when there is nothing else for
this processor to do. This field
contains an index into a table of
routine addresses for doing each
type of low pri work. Each time
the dispatcher finds nothing else
to do, it will start with the low
priority work of the entry in the
table after the one currently
indicated by this field. That is,
this field contains the index of
the last one executed. This field
is serialized by the scheduler
lock
00000008 VMDSYSML *-VMDGGRS Size of the overlay
GUEST SIE (V/SIE) INSTRUCTION SIMULATION AREA
RE-DEFINITION FOR VMDARS, vSIE VMDBK ONLY
(Notes : Vguest general, floating, and access
registers are maintained in the Rguest VMDBK.)
(NOTES : RGUEST IS THE NORMAL GUEST MACHINE LOGGED
ONTO THE SYSTEM. VGUEST IS THE GUEST BEING RUN
VIA THE GUEST SIE (VIRTUAL SIE, V/SIE) INSTRUCTION.)
VMDWGGSD will contain
the Rguest real address, specified as an operand of
the SIE instruction, of the state description in
Rguest storage which describes the Vguest.
0340 832 Dbl-Word 8 VMDWGGSD (0) z/Arch Rguest real address,
0340 832 Signed 4 *
0344 836 Signed 4 VMDWRGSD ESA/390 Rguest real address,
0348 840 Bitstring 1 VMDWMODC COPY OF VMDMODE FROM VIRTUAL
STATE DESCRIPTOR, SIEBK. SINCE
THE VMDMODE IN THE V/SIE VMDBK
WILL BE CHANGED TO REFLECT BOTH
THE VGUEST AND RGUEST MODES.
VMDWMODC IS ESTABLISHED TO
PRESERVE THE VGUEST VMDMODE IN
THE V/SIE VMDBK.
.... 1... SIEVR X'08' SIEVR V=R GUEST (PREFERRED
STORAGE) STORAGE FOR THE V=R
GUEST IS MAPPED SO THAT GUEST
ABSOLUTE ADDRESSES ARE EQUAL TO
HOST ABSOLUTE ADDRESSES.
.... ...1 SIEGPE X'01' SIEGPE This bit signifies
that the guest per enhancement
feature should be used. When set,
guest per enhancement makes it so
that guest PER is always enabled.
This bit overrides bit 1 in the
guest PSW.
0349 841 Bitstring 1 VMDWFLAG VGUEST CONTROL AND STATUS FLAGS
1... .... VMDWUSHD X'80' VMDWUSHD USE SHADOW
TRANSLATE TABLES (USED WHEN
RUNNING A PAGEABLE VGUEST)
.1.. .... VMDWUNRQ X'40' VMDWUNRQ VGUEST UN-RUN IS
REQUIRED
..1. .... VMDWPALB X'20' VMDWPALB Purge of real ALB
is needed: set when purge is
requested; only reset when purge
is either scheduled or actually
performed
...1 .... VMDWPTLB X'10' VMDWPTLB Purge of real TLB
is needed: set when purge is
requested; only reset when purge
is either scheduled or actually
performed
.... 1... VMDWPINT X'08' VMDWPINT Most recent
interception from running VGuest
was a pending interception
.... .1.. VMDWFLCY X'04' VMDWFLCY SIEFLD contains
the host abs address of a copy of
the Vguest facilities list.
.... ..1. VMDWVRDL X'02' VMDWVRDL SIEGVRD contains
the host real address of the
RGuest VRD
034A 842 Bitstring 1 VMDWNTVC COPY OF SIENTVCT FROM VGUEST
STATE DESCRIPTOR. USED TO
DISTINGUISH RGUEST FROM HOST STOP
INTERVENTION REQUESTS.
...1 .... SIEIPWAI X'10' SIEIPWAI Wait/Run bit. When
this bit is set, the state
description is "waiting", and
host intervention is needed to
make it runnable.
.... 1... SIEIPXTC X'08' SIEIPXTC EXTERNAL CALL
INTERRUPTION PENDING
.... .1.. SIEIPSTP X'04' SIEIPSTP SIE stopping
control
.... ..1. SIEIPVIO X'02' SIEIPVIO I/O INTERRUPTION
PENDING
.... ...1 SIEIPEXT X'01' SIEIPEXT EXTERNAL
INTERRUPTION PENDING
034B 843 Bitstring 1 VMDWKEYH Keyop-interception handling
method. WARNING: Logic is
sensitive to the relative values
of these codes (for comparisons
to select subsets)
00000000 VMDKREFL X'00' VMDKREFL Reflect any keyop
interceptions we get
00000001 VMDKBYP X'01' VMDKBYP Simulate RCP Bypass
(also set for preferred VGuest)
00000002 VMDKGRCP X'02' VMDKGRCP Lowest VMDWKEYH
value for which guest RCP bytes
exist
00000002 VMDKRCPA X'02' VMDKRCPA Simulate
RCP-area-based keyop
interpretation
00000003 VMDKSKF X'03' VMDKSKF Simulate SKF
034C 844 Bitstring 1 * Reserved for IBM use
034D 845 Bitstring 1 * Reserved for IBM use
034E 846 Bitstring 1 VMDIBM2 Reserved for IBM use
034F 847 Bitstring 1 * Reserved for IBM use
0350 848 Signed 4 VMDWRCPA KEYOP related controls as
specified by Rguest. (SIERCP from
a 390 Rguest or SIERCPBY for a
zArch Rguest.)
0354 852 Signed 2 VMDWMSEX SI1GMSIZ as specified by Vguest
0356 854 Signed 2 * Reserved for IBM use
0358 856 Bitstring 8 VMDWICEC (0) VGuest original ICs and ECs
0358 856 Bitstring 4 VMDWNTC (0)
0358 856 Bitstring 1 VMDWNTC0
0359 857 Bitstring 1 VMDWNTC1
035A 858 Bitstring 1 VMDWNTC2 Copy of ISK/SSK/RRB intercept
bits from the VGuest SD. These
intercept bits are saved here to
know whether to simulate these
instructions or send them back to
the RGuest as interceptions.
035B 859 Bitstring 1 VMDWNTC3
035C 860 Bitstring 4 VMDWECA (0)
035C 860 Bitstring 1 VMDWECA0
035D 861 Bitstring 1 VMDWECA1
035E 862 Bitstring 1 VMDWECA2
035F 863 Bitstring 1 VMDWECA3
0360 864 Signed 4 * Reserved for IBM use
0364 868 Signed 4 * Reserved for IBM use
0368 872 Dbl-Word 8 * Reserved for IBM use
0370 880 Address 8 VMDWPFXHR Host real addr of VGuest prefix
at last shadow-table validation.
*** WARNING *** May contain
residual data; for debugging and
trap use only
0378 888 Signed 4 * Reserved for IBM use
037C 892 Signed 4 VMDWFLD Rguest real address of Vguest
facilities list.
00000040 VMDAROVL *-VMDARS Length of the overlay
Notes : Host CRs are 64 bits long, and some shadow CR values
may have non-zero high halves (particulary CR1, CR7, and
CR13).
0380 896 Bitstring 128 VMDWSGCRS (0) Shadow host ctrl registers 0-15
0380 896 Signed 8 * Reserved for IBM use (CR0 slot)
0388 904 Signed 8 VMDWSGCR1 (0) Shadow host CR1 (long)
0388 904 Signed 4 *
038C 908 Signed 4 VMDWSCR1 Shadow host ctrl register 1
0390 912 Signed 8 VMDWSGCR2 (0) Shadow host CR2 (long)
0390 912 Signed 4 *
0394 916 Signed 4 VMDWSCR2 Shadow host ctrl register 2
0398 920 Signed 8 * (2) Reserved for IBM use (CR3-4)
03A8 936 Signed 8 VMDWSGCR5 (0) Shadow host CR5 (long)
03A8 936 Signed 4 *
03AC 940 Signed 4 VMDWSCR5 Shadow host ctrl register 5
03B0 944 Signed 8 * Reserved for IBM use (CR6 slot)
03B8 952 Signed 8 VMDWSGCR7 (0) Shadow host CR7 (long)
03B8 952 Signed 4 *
03BC 956 Signed 4 VMDWSCR7 Shadow host ctrl register 7
03C0 960 Signed 8 VMDWSGCR8 (0) Shadow host CR8 (long)
03C0 960 Signed 4 VMDWSGC8H Shadow host CR8 (long) high half
03C4 964 Signed 4 VMDWSCR8 Shadow host ctrl register 8
03C8 968 Signed 8 * (7) Reserved for IBM use (CR9-15)
00000080 VMDSCRSL *-VMDGGRS Length of the overlay
0400 1024 Signed 8 VMDWUTOD TOD CLOCK AT LAST USE OF THIS
V/SIE VMDBK. THIS TIME STAMP IS
USED BY HCPSTP TO RELEASE V/SIE
VMDBKS THAT HAVE NOT BEEN USED
FOR APPROXIMATELY 2 MINUTES.
0408 1032 Signed 8 VMDWRGVT THE RGUEST VMDVTIME, AT THE TIME
THE VGUEST IS RUN, IS SAVED HERE
FOR USE IN ADJUSTING RGUEST
TIMERS AFTER AN EXIT FROM SIE.
0410 1040 Signed 8 VMDWTIME ACCUMULATED CPU TIME IN HOST
EMULATION MODE FOR V/SIE.
0418 1048 Bitstring 16 VMDWGG145 RGuest R14,R15 while in vSIE
mode. vSIE preserves these for
the RGuest per the SIE defn.
0428 1064 Address 4 VMDWSDIR (0) Start of shadow directory anchors
0428 1064 Address 4 VMDWSDAD Address of shadow ALDS directory
042C 1068 Address 4 VMDWSDAL Address of shadow AL directory
0430 1072 Address 4 VMDWSDAS Address of shadow ASTE directory
0434 1076 Address 4 VMDWSDUT Address of shadow RT/ST directory
0438 1080 Address 4 VMDWSDPT Address of shadow PT directory
043C 1084 Signed 4 * Reserved for IBM use
0440 1088 Signed 8 VMDPXUTD (4) Array of TO/TF/TT/TL designators
for shadow "upper" tables (ST,
RFT, RST, and RTT) mapping the
first VGuest prefix page; slots
not used are zeros.
00000020 VMDPXUTDSIZE *-VMDPXUTD
0460 1120 Signed 8 VMDPXPTD "Page-table designation" for the
shadow page table mapping the
first VGuest prefix page.
00000068 VMDVSIL2 *-VMDVSIEO Length of vSIE overlay
END OF GUEST SIE (vSIE) REDEFINITIONS
The following DSECT is used to map user
frame owned (UFO) list fields, which are
serialized by VMDUFOLK via HCPLKUFO/HCPULUFO.
UFO lists are doubly linked lists of FRMTEs.
There are 2 sections of a UFO list.
The active section:
When VMDUFEACT does not point to the
anchor, there is an active section from:
- VMDFR1STG is the First FRMTE on
the active list.
- VMDUFEACT is the Last FRMTE on
the active list.
When VMDUFEACT points to the anchor, there
is no active section. In that case,
VMDFR1STG and VMDUFEACT->FRMFPNTG either
point to the anchor (entire UFO list empty),
or the first FRMTE in the IBR section.
The IBR section:
When VMDUFEACT->FRMFPNTG does not point to
the anchor, there is an IBR section from:
- VMDUFEACT->FRMFPNTG is the first FRMTE on the
IBR section.
- VMDFRLSTG is the last FRMTE in the IBR
section.
When VMDUFEACT->FRMFPNTG points to the
anchor, there is no IBR section. In that
case, VMDRLSTG will point to last FRMTE in
the active section (as will VMDUFEACT) or
the anchor if the entire list is empty.
FRMTEs are added at the front of the list (active
section) or after VMDUFEACT (IBR section).
FRMTEs may be removed from anywhere on the list.
An empty list is represented by all three
pointers pointing to the anchor.
VMDUFEACT must be maintained when adding/removing
a FRMTE to/from the list.
| |