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 RELOCATION CONSIDERATIONS : 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 CAROPEN - Open path function 00000002 CARTRMIT 2 CARTRMIT - Transmit request 00000003 CARDEACT 3 CARDEACT - Deactivate request 00000004 CARCLOSE 4 CARCLOSE - Close request 00000005 CARFRTRG 5 CARFRTRG - Release TRGBK request 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 -------------- ---- ----- 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
Copyright IBM Corporation, 1990, 2011