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.3.0 Last updated on 22 Jun 2022 at 15:47:57 EDT.
Copyright IBM Corporation, 1990, 2022