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.2.0 Last updated on 24 Jun 2020 at 09:31:42 EDT.
Copyright IBM Corporation, 1990, 2020