FCABK | Back to Index page

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

FCABK Prolog | Top of page

     NAME       : HCPFCABK
     DESCRIPTION: FCP device activity block
     DSECT      : FCABK
     FUNCTION   : Contains FCP dvice activity to be used by Monitor
     LOCATED BY : RDEVFCAB
     CREATED BY : VARY ON of an EDEVICE or SET EDEVICE ADD PATH
                  the first time an FCP device is used for an
                  online EDEVICE path
     DELETED BY : The FCABK is never deleted once it is created.
                  The actvity information is cleared when the
                  FCP device is no longer in used by an online
                  EDEVICE path.
     SERIALIZED : The FCASLOCK should be held exclusive when updating the
                  FCABK and held shared when obtaining data from the FCABK.
     RELOCATION CONSIDERATIONS : None

FCABK Control Block Content | Top of page

     FCABK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      FCABK          FCP device activity block
    0000    0 Dbl-Word     8 FCASLOCK (3)   LKWRD for FCABK
    0018   24 Dbl-Word     8 FCAUTIME       Timestamp of the most recent
                                            FCABK update
    0020   32 Signed       4 FCANMPTH       Number of paths using this FCP
                                            device
    0024   36 Signed       4 *              Reserved for IBM use
    0028   40 Address      4 FCACHABK       Pointer to CHABK
    002C   44 Signed       2 FCARDEV        FCP device number
    002E   46 Bitstring    2 *              Rserved for future IBM use
    0030   48 Character    4 FCAPRTYP       Port type
    0034   52 Signed       4 *              Reserved for future IBM use
    0038   56 Dbl-Word     8 FCAINPRQ       Cumulative number of read
                                            requests since chpid activitaion
    0040   64 Dbl-Word     8 FCAOUTRQ       Cumulative number of write
                                            requests since chpid activitaion
    0048   72 Dbl-Word     8 FCAINPMB       Cumulative number of megabytes
                                            read since chpid activation
    0050   80 Dbl-Word     8 FCAOUTMB       Cumulative number of megabytes
                                            written since chpid activation
    0058   88 Dbl-Word     8 FCARESET       Seconds since FCP device
                                            activation
    0060   96 Dbl-Word     8 FCALATEN       Aggregate channel/fabric latency
    0068  104 Dbl-Word     8 FCABUFOF       Number of buffer overflow
                                            conditions
    0070  112 Dbl-Word     8 FCASTIME       Time to gather data across SIC
                                            calls
    0078  120 Signed       4 FCASCALL       Number of calls to gather data
    007C  124 Signed       4 FCASERRS       Number of data calls that failed
    0080  128 Signed       4 *              Reserved for future use
    0084  132 Signed       4 FCASMPLS       Cumulative count of samples
    0088  136 Signed       2 FCAQDPTH       Number of buffers in use
    008A  138 Bitstring    2 *              Reserved for IBM use
    008C  140 Signed       4 FCAQDSUM       Cumulative buffers in use
    0090  144 Dbl-Word     8 FCAQDSQR       Sum of squares buffers in use
    0098  152 Dbl-Word     8 FCAQSECS       Total time in microseconds
                                            requests queued in container
    00A0  160 Bitstring   64 *              Reserved for IBM use
              000000E0       FCABKBSZ       (*-FCABK) Length of FCABK in
                                            bytes
              0000001C       FCABKDSZ       (*-FCABK+7)/8 Length in
                                            doublewords

FCABK Storage Layout | Top of page

    *** FCABK - FCP device activity block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       FCASLOCK                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  18 |                       FCAUTIME                        |
    *     +---------------------------+---------------------------+
    *  20 |         FCANMPTH          |///////////////////////////|
    *     +---------------------------+-------------+-------------+
    *  28 |         FCACHABK          |  FCARDEV    |/////////////|
    *     +---------------------------+-------------+-------------+
    *  30 |         FCAPRTYP          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  38 |                       FCAINPRQ                        |
    *     +-------------------------------------------------------+
    *  40 |                       FCAOUTRQ                        |
    *     +-------------------------------------------------------+
    *  48 |                       FCAINPMB                        |
    *     +-------------------------------------------------------+
    *  50 |                       FCAOUTMB                        |
    *     +-------------------------------------------------------+
    *  58 |                       FCARESET                        |
    *     +-------------------------------------------------------+
    *  60 |                       FCALATEN                        |
    *     +-------------------------------------------------------+
    *  68 |                       FCABUFOF                        |
    *     +-------------------------------------------------------+
    *  70 |                       FCASTIME                        |
    *     +---------------------------+---------------------------+
    *  78 |         FCASCALL          |         FCASERRS          |
    *     +---------------------------+---------------------------+
    *  80 |///////////////////////////|         FCASMPLS          |
    *     +-------------+-------------+---------------------------+
    *  88 |  FCAQDPTH   |/////////////|         FCAQDSUM          |
    *     +-------------+-------------+---------------------------+
    *  90 |                       FCAQDSQR                        |
    *     +-------------------------------------------------------+
    *  98 |                       FCAQSECS                        |
    *     +-------------------------------------------------------+
    *  A0 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  E0
    *
    *** FCABK - FCP device activity block

FCABK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    FCABKBSZ       00A0 000000E0
    FCABKDSZ       00A0 0000001C
    FCABUFOF       0068
    FCACHABK       0028
    FCAINPMB       0048
    FCAINPRQ       0038
    FCALATEN       0060
    FCANMPTH       0020
    FCAOUTMB       0050
    FCAOUTRQ       0040
    FCAPRTYP       0030
    FCAQDPTH       0088
    FCAQDSQR       0090
    FCAQDSUM       008C
    FCAQSECS       0098
    FCARDEV        002C
    FCARESET       0058
    FCASCALL       0078
    FCASERRS       007C
    FCASLOCK       0000
    FCASMPLS       0084
    FCASTIME       0070
    FCAUTIME       0018

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