CHABK | Back to Index page

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

CHABK Prolog | Top of page

     NAME       : HCPCHABK
     DESCRIPTION: CHPID activity block
     DSECT      : CHABK
     FUNCTION   : Contains CHPID activity to be used by Monitor
     LOCATED BY : SYSCHAAD (indexed by chpid number)
                  There can be 256 chpids on an LPAR. At CP I/O initialization time,
                  a 1024-byte area of storage will be obtained and SYSCHAAD will
                  be the pointer to this storage.  This storage will be a table
                  which can hold 256 HCPCHABK addresses.  The current use for these
                  entries is for FCP chpids associated with EDEVICEs.  However,
                  allowing room for 256 HCPCHABK addresses will allow this to be
                  extensible in the future for FCP chpids not associated with
                  EDEVICEs.
     CREATED BY : VARY ON of an EDEVICE or SET EDEVICE ADD PATH
                  the first time a chpid is used for an online
                  EDEVICE path
     DELETED BY : The CHABK is never deleted once it is created.
                  The actvity information is cleared when the
                  chpid is no longer in use by an online EDEVICE
                  path.
     SERIALIZED : The CHASLOCK should be held exclusive when updating the
                  CHABK with data obtained from the hardware and held
                  shared by Monitor when obtaining data from the CHABK.
                  The following counters are serialized using compare
                  and swap and have no relation to the data serialized by
                  CHASLOCK:
                  CHANMPTH
                  CHALIFSQ
     RELOCATION CONSIDERATIONS : None

CHABK Control Block Content | Top of page

     CHABK DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      CHABK          CHPID activity block
    0000    0 Dbl-Word     8 CHASLOCK (6)   Spin lock for CHABK
    0030   48 Dbl-Word     8 CHAUTIME       Timestamp of the most recent
                                            CHABK update
    0038   56 Signed       4 CHANMPTH       Number of online EDEV paths using
                                            this chpid
    003C   60 Signed       4 *              Reserved for future IBM use
    0040   64 Bitstring    1 CHACHPID       CHPID number
    0041   65 Bitstring    3 *              Reserved for future IBM use
    0044   68 Character    4 CHAPRTYP       Port type
    0048   72 Dbl-Word     8 CHAINPRQ       Cumulative number of read
                                            requests since chpid activitaion
    0050   80 Dbl-Word     8 CHAOUTRQ       Cumulative number of write
                                            requests since chpid activitaion
    0058   88 Dbl-Word     8 CHAINPMB       Cumulative number of megabytes
                                            read since chpid activation
    0060   96 Dbl-Word     8 CHAOUTMB       Cumulative number of megabytes
                                            written since chpid activation
    0068  104 Dbl-Word     8 CHARESET       Seconds since last channel reset
    0070  112 Signed       4 CHASCALL       Number of calls to gather data
    0074  116 Bitstring    4 *              Reserved for future IBM use
    0078  120 Dbl-Word     8 CHASTIME       Time to gather data across SIC
                                            calls
    0080  128 Signed       4 CHASERRS       Number of times SIC encountered
                                            error
    0084  132 Signed       4 CHASMPLS       Cumulative count of samples
    0088  136 Bitstring    1 CHAPROCU       An integer value in the range 0
                                            to 100, indicating the overall
                                            utilization of the processor in
                                            the FCP Channel in percent (%)
    0089  137 Bitstring    3 *              Reserved for future IBM use
    008C  140 Signed       4 CHAPROCS       Cumulative sum of processor
                                            utilization
    0090  144 Dbl-Word     8 CHAPROCQ       Sum of squares of processor
                                            utilization
    0098  152 Bitstring    1 CHABUSUT       An integer value in the range 0
                                            to 100, indicating the overall
                                            utilization of the bus in the FCP
                                            Channel in percent (%)
    0099  153 Bitstring    3 *              Reserved for future IBM use
    009C  156 Signed       4 CHABUSSM       Cumulative sum of bus utilization
    00A0  160 Dbl-Word     8 CHABUSSQ       Sum of squares of bus utilization
    00A8  168 Bitstring    1 CHAADAPU       An integer value in the range 0
                                            to 100, indicating the overall
                                            utilization of the FCP Channel
                                            adapter in percent (%)
    00A9  169 Bitstring    3 *              Reserved for future IBM use
    00AC  172 Signed       4 CHAADAPS       Cumulative sum of adapter
                                            utilization
    00B0  176 Dbl-Word     8 CHAADAPQ       Sum of squares of adapter
                                            utilization
    00B8  184 Bitstring   72 *              Reserved for future IBM use
              00000100       CHABKBSZ       (*-CHABK) Length of CHABK in
                                            bytes
              00000020       CHABKDSZ       (*-CHABK+7)/8 Length in
                                            doublewords

CHABK Storage Layout | Top of page

    *** CHABK - CHPID activity block
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       CHASLOCK                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  30 |                       CHAUTIME                        |
    *     +---------------------------+---------------------------+
    *  38 |         CHANMPTH          |///////////////////////////|
    *     +------+--------------------+---------------------------+
    *  40 |:CHPID|////////////////////|         CHAPRTYP          |
    *     +------+--------------------+---------------------------+
    *  48 |                       CHAINPRQ                        |
    *     +-------------------------------------------------------+
    *  50 |                       CHAOUTRQ                        |
    *     +-------------------------------------------------------+
    *  58 |                       CHAINPMB                        |
    *     +-------------------------------------------------------+
    *  60 |                       CHAOUTMB                        |
    *     +-------------------------------------------------------+
    *  68 |                       CHARESET                        |
    *     +---------------------------+---------------------------+
    *  70 |         CHASCALL          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  78 |                       CHASTIME                        |
    *     +---------------------------+---------------------------+
    *  80 |         CHASERRS          |         CHASMPLS          |
    *     +------+--------------------+---------------------------+
    *  88 |:PROCU|////////////////////|         CHAPROCS          |
    *     +------+--------------------+---------------------------+
    *  90 |                       CHAPROCQ                        |
    *     +------+--------------------+---------------------------+
    *  98 |:BUSUT|////////////////////|         CHABUSSM          |
    *     +------+--------------------+---------------------------+
    *  A0 |                       CHABUSSQ                        |
    *     +------+--------------------+---------------------------+
    *  A8 |:ADAPU|////////////////////|         CHAADAPS          |
    *     +------+--------------------+---------------------------+
    *  B0 |                       CHAADAPQ                        |
    *     +-------------------------------------------------------+
    *  B8 |///////////////////////////////////////////////////////|
    *     =///////////////////////////////////////////////////////=
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    * 100
    *
    *** CHABK - CHPID activity block

CHABK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    CHAADAPQ       00B0
    CHAADAPS       00AC
    CHAADAPU       00A8
    CHABKBSZ       00B8 00000100
    CHABKDSZ       00B8 00000020
    CHABUSSM       009C
    CHABUSSQ       00A0
    CHABUSUT       0098
    CHACHPID       0040
    CHAINPMB       0058
    CHAINPRQ       0048
    CHANMPTH       0038
    CHAOUTMB       0060
    CHAOUTRQ       0050
    CHAPROCQ       0090
    CHAPROCS       008C
    CHAPROCU       0088
    CHAPRTYP       0044
    CHARESET       0068
    CHASCALL       0070
    CHASERRS       0080
    CHASLOCK       0000
    CHASMPLS       0084
    CHASTIME       0078
    CHAUTIME       0030

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