RPCI | Back to Index page

| Prolog Control Block Contents RPCI 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.

RPCI Prolog | Top of page

     NAME       : HCPRPCI
     DESCRIPTION: Real PCI Function Block
     DSECT      : RPCI
     FUNCTION   : The Real PCI Function block is used to manage
                  information associated with a Real PCI Function.
     LOCATED BY : Ordered queue pointer and associated RPCI hash tables.
     CREATED BY : HCPPCINI - Function Initialization
     DELETED BY : HCPPCICL - Delete a PCI Function

RPCI Control Block Content | Top of page

     RPCI DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      RPCI           Real PCI Function Block
    0000    0 Address      4 RPCIPTRO       ORDERED QUEUE PTR
    0004    4 Signed       4 *              Reserved
    0008    8 Dbl-Word     8 RPCILOCK (3)   LOCK WORD
          LIST PCI FUNCTION DATA
    0020   32 Signed       2 RPCIDVID       DEVICE ID
    0022   34 Signed       2 RPCIVDID       VENDOR ID
    0024   36 Bitstring    1 RPCICFLG       State flag byte
              1... ....      RPCICONF       X'80' RPCICONF Configured
              .1.. ....      RPCIPERM       X'40' RPCIPERM Permanent Error
              ..1. ....      RPCIERR        X'20' RPCIERR Error State
              ...1 ....      RPCIBLOK       X'10' RPCIBLOK PCI Function
                                            Blocked
              .... .1..      RPCIUNEN       X'04' RPCIUNEN PCI Function is
                                            unexpectedly in the enabled state
              .... ..1.      RPCIINIT       X'02' RPCIINIT PCI Function
                                            initialized
              .... ...1      RPCIDEAD       X'01' RPCIDEAD Indicates RPCI has
                                            been been scheduled for deletion.
                                            The RPCI has been removed from
                                            the ordered list and all hash
                                            tables. This bit should NEVER be
                                            ON for any live RPCI
    0025   37 Bitstring    1 * (3)          RESERVED FOR HARDWARE
    0028   40 Address      4 RPCIPFID       PCI FUNCTION ID
    002C   44 Address      4 RPCIHNDG       GENERAL HANDLE
    0030   48 Address      4 RPCIHNDE       ENABLED HANDLE
    0034   52 Signed       2 RPCISLCT       Times shadow table count non-zero
                                            at cleanup
    0036   54 Signed       2 RPCISLST       Count of shadow tables not
                                            handled at cleanup
    0038   56 Address      4 RPCIVPCI       POINTER TO VPCI
    003C   60 Address      4 RPCIUSER       Pointer to VMDBK function is
                                            attached to
    0040   64 Address      4 RPCITRC        Address of TRCBK
    0044   68 Bitstring    1 RPCITFLG       Trace flags
              1... ....      RPCIOTRC       X'80' RPCIOTRC Tracing IO for PCI
                                            Function
    0045   69 Bitstring    1 RPCIGPID       Group ID
    0046   70 Bitstring    1 RPCIGFLG       General Use Flags
              1... ....      RPCIDELE       X'80' RPCIDELE RPCI should be
                                            deleted. Used only in HCPPCIDI,
                                            Serialized by RPCI Config lock,
                                            not RPCI lock
    0047   71 Bitstring    1 *              Reserved
    0048   72 Address      4 RPCIFIB0       FIB BLOCK 0
    004C   76 Address      4 RPCIFIB1       FIB BLOCK 1
    0050   80 Address      4 RPCIFIB2       FIB BLOCK 2
    0054   84 Address      4 RPCIFIB3       FIB BLOCK 3
              00000004       RPCINFIB       (*-RPCIFIB0)/4 Number of FIBS
    0058   88 Address      4 RPCICLPQ       CLP PCI Query data
    005C   92 Address      4 RPCICLPG       CLP PCI Query Group data
    0060   96 Address      4 RPCILMBK       HLA of Measurement Block stored
                                            in FIBFMBA
    0064  100 Bitstring    4 RPCIUID        User-Defined Identifier
    0068  104 Dbl-Word     8 RPCIHPIN       # of guest frames pinned
    0070  112 Dbl-Word     8 RPCIPCNT       # of shadow tables in use
    0078  120 Bitstring    1 RPCIPFT        PCI Function Type
              .... ....      RPCIUNC        X'00' RPCIUNC Function type
                                            unclassified
              .... ..1.      RPCIROCE       X'02' RPCIROCE RoCE type function
              .... ..11      RPCIZEDC       X'03' RPCIZEDC zEDC type function
              .... .1.1      RPCIISM        X'05' RPCIISM ISM type function
              .... .111      RPCISIO        X'07' RPCISIO SIO type function
              .... 1...      RPCIRCE        X'08' RPCIRCE RCE type function
              .... 1.1.      RPCICX4        X'0A' RPCICX4 CX4 type function
              .... 1.11      RPCINVME       X'0B' RPCINVME NVMe type function
    0079  121 Bitstring    1 RPCIPORT       PCI Function Port
    007A  122 Character   30 *              Reserved for IBM use
              00000013       RPCISIZE       (*-RPCI+7)/8 SIZE in Dwords
              00000098       RPCIL          (*-RPCI) SIZE in bytes

RPCI Storage Layout | Top of page

    *** RPCI - Real PCI Function Block
    *
    *     +---------------------------+---------------------------+
    *   0 |         RPCIPTRO          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *   8 |                                                       |
    *     =                       RPCILOCK                        =
    *     |                                                       |
    *     +-------------+-------------+------+--------------------+
    *  20 |  RPCIDVID   |  RPCIVDID   |:ICFLG|////////////////////|
    *     +-------------+-------------+------+--------------------+
    *  28 |         RPCIPFID          |         RPCIHNDG          |
    *     +---------------------------+-------------+-------------+
    *  30 |         RPCIHNDE          |  RPCISLCT   |  RPCISLST   |
    *     +---------------------------+-------------+-------------+
    *  38 |         RPCIVPCI          |         RPCIUSER          |
    *     +---------------------------+------+------+------+------+
    *  40 |         RPCITRC           |:ITFLG|:IGPID|:IGFLG|//////|
    *     +---------------------------+------+------+------+------+
    *  48 |         RPCIFIB0          |         RPCIFIB1          |
    *     +---------------------------+---------------------------+
    *  50 |         RPCIFIB2          |         RPCIFIB3          |
    *     +---------------------------+---------------------------+
    *  58 |         RPCICLPQ          |         RPCICLPG          |
    *     +---------------------------+---------------------------+
    *  60 |         RPCILMBK          |         RPCIUID           |
    *     +---------------------------+---------------------------+
    *  68 |                       RPCIHPIN                        |
    *     +-------------------------------------------------------+
    *  70 |                       RPCIPCNT                        |
    *     +------+------+-----------------------------------------+
    *  78 |:IPFT |:IPORT|/////////////////////////////////////////|
    *     +------+------+/////////////////////////////////////////|
    *  80 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  98
    *
    *** RPCI - Real PCI Function Block

RPCI Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    RPCIBLOK       0024 10
    RPCICFLG       0024
    RPCICLPG       005C
    RPCICLPQ       0058
    RPCICONF       0024 80
    RPCICX4        0078 0A
    RPCIDEAD       0024 01
    RPCIDELE       0046 80
    RPCIDVID       0020
    RPCIERR        0024 20
    RPCIFIB0       0048
    RPCIFIB1       004C
    RPCIFIB2       0050
    RPCIFIB3       0054
    RPCIGFLG       0046
    RPCIGPID       0045
    RPCIHNDE       0030
    RPCIHNDG       002C
    RPCIHPIN       0068
    RPCIINIT       0024 02
    RPCIISM        0078 05
    RPCIL          007A 00000098
    RPCILMBK       0060
    RPCILOCK       0008
    RPCINFIB       0054 00000004
    RPCINVME       0078 0B
    RPCIOTRC       0044 80
    RPCIPCNT       0070
    RPCIPERM       0024 40
    RPCIPFID       0028
    RPCIPFT        0078
    RPCIPORT       0079
    RPCIPTRO       0000
    RPCIRCE        0078 08
    RPCIROCE       0078 02
    RPCISIO        0078 07
    RPCISIZE       007A 00000013
    RPCISLCT       0034
    RPCISLST       0036
    RPCITFLG       0044
    RPCITRC        0040
    RPCIUID        0064
    RPCIUNC        0078 00
    RPCIUNEN       0024 04
    RPCIUSER       003C
    RPCIVDID       0022
    RPCIVPCI       0038
    RPCIZEDC       0078 03

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:30:05 EDT.
Copyright IBM Corporation, 1990, 2020