| Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. | 
CARBK
Control Block Contents  
   CARBK DSECT
Cross Reference (Contains links to field and bit definitions)
CARBK Prolog
 NAME       : HCPCARBK
 DESCRIPTION: ISFC CP Application Request/Response
              parameter list
 DSECT      : CARBK
 FUNCTION   : Pass information between a CP application and the
              ISFC CP application mailbox.
 LOCATED BY : For outbound requests, HCPAAKIQ Queue anchor.
              For requests waiting for an OPEN to complete, TRGPNDOQ.
 CREATED BY : A CP application wishing to communicate with the
              CP mailbox or by the CP mailbox when
              information is to be delivered to a CP application.
 DELETED BY : ISFC CP application mailbox.
 SERIALIZED : None
 NOTES      :
              The CARBK parameter list holds the information related
              to a specific CP application mailbox function.
              It may contain a pointer to a string of PGEBKs that
              represent pages of data to be transmitted.
              The ACTIVATION function returns to the application
              the size of a reserved area at the begin of each
              data page. The actual data is stored below the
              reserved area.
              NOTES      : The size of the reserved area on the first
              data page is larger than the reserved area
              on subsequent data pages.
    +---------------+
    | CARBK         |
    |               |
    |               |    +------------+
    | A(PGEBK.1) ------->| PGEBK.1    |
    |               |    |  Virt.Addr |
    |               |    |  Real.Addr ------------------>*
    |               |    |  A(PGEBK.n)|---               |
    +---------------+    +------------+  |               V
                                         |  +---------------------+
                                         |  | reserved area       |
                                         |  |- - - - - - - - - - -|
                                         |  | Data contained in   |
                                         |  | this page frame...  |
                                         |  |                     |
                                         |  |                     |
                                         |  +---------------------+
                                         |
                                         V
                                   +------------+
                                   | PGEBK.n    |
                                   |  Virt.Addr |
                                   |  Real.Addr |
                                   +------------+
CARBK Control Block Content
CARBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      CARBK          ISFC CP Application
                                        Request/Response
0000    0 Character    8 CARAPPLT       Target CP application
0008    8 Character    8 CARNODET       Target node name
0010   16 Character    8 CARAPPLS       Source CP application
0018   24 Character    8 CARNODES       Source node name
0020   32 Signed       2 *              Reserved (path id)
0022   34 Bitstring    1 CARFUNC        Function request code
          00000001       CAROPEN        1 - Open path function
          00000002       CARTRMIT       2 - Transmit request
          00000003       CARDEACT       3 - Deactivate request
          00000004       CARCLOSE       4 - Close request
          00000005       CARFRTRG       5 - Release TRGBK request
          00000000       *
0023   35 Bitstring    1 CARFLAGS       Flag byte:
0024   36 Address      4 CARNEXT        Pointer to next CARBK on queue
0028   40 Signed       4 CARAHND        Handle for obtaining ACTBK
                                        address
002C   44 Address      4 CARACTBK       ACTBK address
0030   48 Address      4 CARTRGBK       TRGBK address
0034   52 Address      4 CARPGECH       PGEBK chain
0038   56 Dbl-Word     8 * (2)          Reserved
          00000009       CARSIZE        (*-CARBK+7)/8 Size, in
                                        doublewords, of CARBK
CARBK Storage Layout
          
*** CARBK - ISFC CP Application Request/Response
*
*     +-------------------------------------------------------+
*   0 |                       CARAPPLT                        |
*     +-------------------------------------------------------+
*   8 |                       CARNODET                        |
*     +-------------------------------------------------------+
*  10 |                       CARAPPLS                        |
*     +-------------------------------------------------------+
*  18 |                       CARNODES                        |
*     +-------------+------+------+---------------------------+
*  20 |/////////////|:FUNC |:FLAGS|         CARNEXT           |
*     +-------------+------+------+---------------------------+
*  28 |         CARAHND           |         CARACTBK          |
*     +---------------------------+---------------------------+
*  30 |         CARTRGBK          |         CARPGECH          |
*     +---------------------------+---------------------------+
*  38 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  48
*
*** CARBK - ISFC CP Application Request/Response
CARBK Cross Reference
Symbol Dspl Value -------------- ---- ----- * 0022 00000000 CARACTBK 002C CARAHND 0028 CARAPPLS 0010 CARAPPLT 0000 CARCLOSE 0022 00000004 CARDEACT 0022 00000003 CARFLAGS 0023 CARFRTRG 0022 00000005 CARFUNC 0022 CARNEXT 0024 CARNODES 0018 CARNODET 0008 CAROPEN 0022 00000001 CARPGECH 0034 CARSIZE 0038 00000009 CARTRGBK 0030 CARTRMIT 0022 00000002
Last updated on 6 Jun 2001 at 11:51:24 EDT.
Copyright IBM Corporation, 1990, 2001