Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of z/VM.

CARBK

Prolog
Control Block Contents
CARBK DSECT
Storage Layout
Cross Reference

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

This information is based on z/VM V3R1.0.
Last updated on 30 Mar 2001 at 08:14:05 EDT.
Copyright IBM Corporation, 1990, 2001