VPCI Back to Index page
 
Prolog 
Control Block Contents 
   VPCI DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  VPCI Prolog Top of page
 
 NAME       : HCPVPCI
 DESCRIPTION: VPCI HASH QUEUE ANCHOR
 DSECT      : VPCI
 FUNCTION   : The Virtual PCI Function block is used to manage
              information associated with a Virtual PCI
              Function dedicated to a guest.
 LOCATED BY : Various queues and tables in the PCIHQ
              (CHCPCIHQ) for each virtual machine's CHCBK
              (VMDCHC):
              - Odered queue anchored at PCIHQHQO
              - PFID hash table anchored at PCIHQPFID
              - General handle hash table anchored at
              PCIHQHNDG
              - Enabled handle hash table anchored at
              PCIHQHNDE
 CREATED BY : ATTACH processing (HCPPCIAF)
 DELETED BY : DETACH (HCPPCIDS) and LOGOFF (HCPPCILG)
              processing
 
 
  VPCI Control Block Content Top of page
 

 VPCI DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure VPCI VPCI HASH QUEUE ANCHOR 0000 0 Address 4 VPCIPTRO ORDERED QUEUE PTR 0004 4 Signed 4 * Reserved 0008 8 Dbl-Word 8 VPCILOCK (3) LOCK WORD BEGIN LIST CLP PCI FUNCTION DATA 0020 32 Bitstring 1 VPCIDVID (2) DEVICE ID 0022 34 Bitstring 1 VPCIVDID (2) VENDOR ID 0024 36 Bitstring 1 VPCICFLG CONFIGURED FLAG BYTE 1... .... VPCICONF X'80' VPCICONF CONFIGURED BIT .... 1... VPCINOTO X'08' VPCINOTO Function being detached 0025 37 Bitstring 1 * (3) RESERVED FOR HARDWARE 0028 40 Address 4 VPCIPFID PCI FUNCTION ID 002C 44 Address 4 VPCIHNDG GENERAL HANDLE 0030 48 Address 4 VPCIHNDE ENABLED HANDLE CAUTION - HCPPCI USES THE RPCI TO MAP FIELDS IN THE VPCI UP TO THIS POINT - CHANGE BOTH BLOCKS IF A CHANGE IS MADE. 0034 52 Address 4 VPCIRPCI POINTER TO RPCI 0038 56 Address 4 VPCIUSER VMDBK ADDRESS OF OWNER 003C 60 Address 4 VPCIECBD Delete ECBBK 0040 64 Bitstring 1 VPCIFC Function Controls .1.. .... VPCIERR X'40' VPCIERR Error State Indicator (fc.E) ..1. .... VPCILSB X'20' VPCILSB Load Store Blocked (fc.L) ...1 .... VPCIEAS X'10' VPCIEAS DMA registered (fc,D) .... 1... VPCIEAI X'08' VPCIEAI Adapter Ints Registered 0041 65 Bitstring 1 VPCINDAS Number of DMAas enabled 0042 66 Bitstring 1 * (2) Reserved 0044 68 Signed 4 VPCIAISB AISB offset 0048 72 Dbl-Word 8 VPCIGAIT GAIT entry Host Abs Address 0050 80 Address 4 VPCIFIB0 FIB BLOCK 0 0054 84 Address 4 VPCIFIB1 FIB BLOCK 1 0058 88 Address 4 VPCIFIB2 FIB BLOCK 2 005C 92 Address 4 VPCIFIB3 FIB BLOCK 3 00000004 VPCINFIB (*-VPCIFIB0)/4 Number of FIBS Copy of function measurement block values needed to compute delta for guest measurement block 0060 96 Bitstring 1 VPCIFFLG Flag bits 0061 97 Bitstring 1 VPCIMFMT Measurement block format .... .... VPCIMF0 X'00' VPCIMF0 Format zero .... ...1 VPCIMF1 X'01' VPCIMF1 Format one .... ..1. VPCIMF2 X'02' VPCIMF2 Format two .... ..11 VPCIMF3 X'03' VPCIMF3 Format three 0062 98 Bitstring 1 * (2) Reserved for IBM use 0064 100 Signed 4 VPCISMPC Sample count 0068 104 Dbl-Word 8 VPCILGCN Load count 0070 112 Dbl-Word 8 VPCISGCN Store count 0078 120 Dbl-Word 8 VPCISBCN Store block count 0080 128 Dbl-Word 8 VPCIRPCN RPCIT count 0088 136 Dbl-Word 8 VPCIFRMS (4) Format specific fields 00A8 168 Character 16 * Reserved for IBM use 00000017 VPCISIZE (*-VPCI+7)/8 SIZE OF VIRTUAL PCI BLOCK Remapping for format specific measurement block fields 0088 136 Dbl-Word 8 VPCIDRCN DMA read count 0090 144 Dbl-Word 8 VPCIDWCN DMA write count 0088 136 Dbl-Word 8 VPCIRBCT Received bytes counter 0090 144 Dbl-Word 8 VPCIPKCT Received packets counter 0098 152 Dbl-Word 8 VPCITBCT Transmitted bytes counter 00A0 160 Dbl-Word 8 VPCITPCT Transmitted packets counter 0088 136 Dbl-Word 8 VPCICWCT Consumed work units counter 0090 144 Dbl-Word 8 VPCIMWUT Maximum work units 0088 136 Dbl-Word 8 VPCITCNT Transmitted bytes counter
 
 
  VPCI Storage Layout Top of page
 
          
*** VPCI - VPCI HASH QUEUE ANCHOR
*
*     +---------------------------+---------------------------+
*   0 |         VPCIPTRO          |///////////////////////////|
*     +---------------------------+---------------------------+
*   8 |                                                       |
*     =                       VPCILOCK                        =
*     |                                                       |
*     +-------------+-------------+------+--------------------+
*  20 |  VPCIDVID   |  VPCIVDID   |:ICFLG|////////////////////|
*     +-------------+-------------+------+--------------------+
*  28 |         VPCIPFID          |         VPCIHNDG          |
*     +---------------------------+---------------------------+
*  30 |         VPCIHNDE          |         VPCIRPCI          |
*     +---------------------------+---------------------------+
*  38 |         VPCIUSER          |         VPCIECBD          |
*     +------+------+-------------+---------------------------+
*  40 |VPCIFC|:INDAS|/////////////|         VPCIAISB          |
*     +------+------+-------------+---------------------------+
*  48 |                       VPCIGAIT                        |
*     +---------------------------+---------------------------+
*  50 |         VPCIFIB0          |         VPCIFIB1          |
*     +---------------------------+---------------------------+
*  58 |         VPCIFIB2          |         VPCIFIB3          |
*     +------+------+-------------+---------------------------+
*  60 |:IFFLG|:IMFMT|/////////////|         VPCISMPC          |
*     +------+------+-------------+---------------------------+
*  68 |                       VPCILGCN                        |
*     +-------------------------------------------------------+
*  70 |                       VPCISGCN                        |
*     +-------------------------------------------------------+
*  78 |                       VPCISBCN                        |
*     +-------------------------------------------------------+
*  80 |                       VPCIRPCN                        |
*     +-------------------------------------------------------+
*  88 |                                                       |
*     =                       VPCIFRMS                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  A8 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  B8
*
*** VPCI - VPCI HASH QUEUE ANCHOR
          
*** Overlay for VPCIFRMS in VPCI
*
*     +-------------------------------------------------------+
*  88 |                       VPCIDRCN                        |
*     +-------------------------------------------------------+
*  90 |                       VPCIDWCN                        |
*     +-------------------------------------------------------+
*  98
*
*** Overlay for VPCIFRMS in VPCI
          
*** Overlay for VPCIFRMS in VPCI
*
*     +-------------------------------------------------------+
*  88 |                       VPCIRBCT                        |
*     +-------------------------------------------------------+
*  90 |                       VPCIPKCT                        |
*     +-------------------------------------------------------+
*  98 |                       VPCITBCT                        |
*     +-------------------------------------------------------+
*  A0 |                       VPCITPCT                        |
*     +-------------------------------------------------------+
*  A8
*
*** Overlay for VPCIFRMS in VPCI
          
*** Overlay for VPCIFRMS in VPCI
*
*     +-------------------------------------------------------+
*  88 |                       VPCICWCT                        |
*     +-------------------------------------------------------+
*  90 |                       VPCIMWUT                        |
*     +-------------------------------------------------------+
*  98
*
*** Overlay for VPCIFRMS in VPCI
          
*** Overlay for VPCIFRMS in VPCI
*
*     +-------------------------------------------------------+
*  88 |                       VPCITCNT                        |
*     +-------------------------------------------------------+
*  90
*
*** Overlay for VPCIFRMS in VPCI
 
 
  VPCI Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
VPCIAISB       0044
VPCICFLG       0024
VPCICONF       0024 80
VPCICWCT       0088
VPCIDRCN       0088
VPCIDVID       0020
VPCIDWCN       0090
VPCIEAI        0040 08
VPCIEAS        0040 10
VPCIECBD       003C
VPCIERR        0040 40
VPCIFC         0040
VPCIFFLG       0060
VPCIFIB0       0050
VPCIFIB1       0054
VPCIFIB2       0058
VPCIFIB3       005C
VPCIFRMS       0088
VPCIGAIT       0048
VPCIHNDE       0030
VPCIHNDG       002C
VPCILGCN       0068
VPCILOCK       0008
VPCILSB        0040 20
VPCIMFMT       0061
VPCIMF0        0061 00
VPCIMF1        0061 01
VPCIMF2        0061 02
VPCIMF3        0061 03
VPCIMWUT       0090
VPCINDAS       0041
VPCINFIB       005C 00000004
VPCINOTO       0024 08
VPCIPFID       0028
VPCIPKCT       0090
VPCIPTRO       0000
VPCIRBCT       0088
VPCIRPCI       0034
VPCIRPCN       0080
VPCISBCN       0078
VPCISGCN       0070
VPCISIZE       00A8 00000017
VPCISMPC       0064
VPCITBCT       0098
VPCITCNT       0088
VPCITPCT       00A0
VPCIUSER       0038
VPCIVDID       0022
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:57:52 EDT.
Copyright IBM Corporation, 1990, 2022