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