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 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 - 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

 
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