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

CAPBK

Prolog  

Control Block Contents  
   CAPBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


CAPBK Prolog

 NAME       : HCPCAPBK
 DESCRIPTION: Connection Block for Advanced Printers
 DSECT      : CAPBK
 FUNCTION   : Represents an IUCV connection between a PSF
              Virtual Machine and *SPL, and holds data and
              workspace for process requests.
 LOCATED BY : SYSCAPQ - Anchor for system chain in SYSCM
              VMDCAPQ - Anchor for user chain in VMDBK
 CREATED BY : CONNECT processing
 DELETED BY : SEVER processing
 SERIALIZED :
              SYSCAPLK:  Protects the queue pointers and constant
              path information.
              CAPSYSNX, CAPUSRNX, CAPPATH, CAPNAME
              CAPPLOCK:  Protects the variable path information:
              CAPSTAT, CAPASPQ (including the ASPBK
              pointers and contents), CAPRDOUT, and
              all the SELECT fields.

 

CAPBK Control Block Content


CAPBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      CAPBK          Connection Block for Advanced
                                        Printers
0000    0 Address      4 CAPSYSNX       Pointer to next CAPBK on system q
0004    4 Address      4 CAPUSRNX       Pointer to next CAPBK on VMDBK q
0008    8 Dbl-Word     8 CAPNAME        'PSF-printer-name'
0010   16 Signed       2 CAPPATH        Path ID
0012   18 Bitstring    1 *              Reserved
0013   19 Bitstring    1 CAPSTAT        Status flag
          1... ....      CAPSVPEN       X'80' Sever pending
          .1.. ....      CAPIDLE        X'40' Service machine is idle
          ..1. ....      CAPDEFLT       X'20' Default criteria
          ...1 ....      CAPVIRT        X'10' Connect type VIRTUAL
0014   20 Address      4 CAPASPQ        Active spool file queue
0018   24 Signed       4 CAPRDOUT       Count of *SPL READ's outstanding
001C   28 Address      4 CAPVMDBK       VMDBK address
0020   32 Dbl-Word     8 CAPPLOCK (3)   Lock for the path resources
0038   56 Bitstring    1 * (6)          Alignment for selection buffer
003E   62 Bitstring    1 CAPSELEC (0)   Current file selection criteria
003E   62 Bitstring    1 CAPSFLGX       Select action flag
          1... ....      CAPSCHNG       X'80' Change selection criteria
          .1.. ....      CAPSCVT        X'40' Select file to convert
                                        (else prt)
003F   63 Bitstring    1 CAPSFLGY       Select criteria flag
          1... ....      CAPW5A         X'80' Select files with X'5A'
                                        CCWs
          .1.. ....      CAPWO5A        X'40' Select files without X'5A'
                                        CCWs
          ..1. ....      CAPCVTD        X'20' Select converted files
          ...1 ....      CAPNOTCV       X'10' Select files NOT converted
          .... 1...      CAPNO38        X'08' Select files with NO 3800
                                        CCWs
          .... .1..      CAPBEG38       X'04' Select file w beginning
                                        3800 CCWs
          .... ..1.      CAPANY38       X'02' Select file w 3800 CCWs
                                        anywhere
          .... ...1      CAPSPECF       X'01' Select specific file
                                        (user/spid)
0040   64 Signed       4 CAPCLASS       Classes
0044   68 Signed       4 CAPFLASH       Flash name
0048   72 Dbl-Word     8 CAPOFORM       Operator form name
0050   80 Dbl-Word     8 CAPDEST (4)    Destination values
0070  112 Dbl-Word     8 CAPOWNER       Spool file owner
0078  120 Signed       2 CAPSPID        Spool file ID
007A  122 Signed       2 CAPCONCT       Connection count for rdrs
007C  124 Bitstring    1 CAPRDRFL       Reader notification flag
          1... ....      CAPRDR         X'80' Connection for reader
                                        notification
007D  125 Bitstring    1 * (3)          Reserved
          00000042       CAPSELSZ       *-CAPSELEC End of selection
                                        criteria
          00000010       CAPSIZE        (*-CAPBK+7)/8 Size in double
                                        words

 

CAPBK Storage Layout

          
*** CAPBK - Connection Block for Advanced Printers
*
*     +---------------------------+---------------------------+
*   0 |         CAPSYSNX          |         CAPUSRNX          |
*     +---------------------------+---------------------------+
*   8 |                       CAPNAME                         |
*     +-------------+------+------+---------------------------+
*  10 |  CAPPATH    |//////|:STAT |         CAPASPQ           |
*     +-------------+------+------+---------------------------+
*  18 |         CAPRDOUT          |         CAPVMDBK          |
*     +---------------------------+---------------------------+
*  20 |                                                       |
*     =                       CAPPLOCK                        =
*     |                                                       |
*     +-----------------------------------------+------+------+
*  38 |/////////////////////////////////////////|:SFLGX|:SFLGY|
*     +---------------------------+-------------+------+------+
*  40 |         CAPCLASS          |         CAPFLASH          |
*     +---------------------------+---------------------------+
*  48 |                       CAPOFORM                        |
*     +-------------------------------------------------------+
*  50 |                                                       |
*     =                       CAPDEST                         =
*     |                                                       |
*     +-------------------------------------------------------+
*  70 |                       CAPOWNER                        |
*     +-------------+-------------+------+--------------------+
*  78 |  CAPSPID    |  CAPCONCT   |:RDRFL|////////////////////|
*     +-------------+-------------+------+--------------------+
*  80
*
*** CAPBK - Connection Block for Advanced Printers

 

CAPBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
CAPANY38       003F 02
CAPASPQ        0014
CAPBEG38       003F 04
CAPCLASS       0040
CAPCONCT       007A
CAPCVTD        003F 20
CAPDEFLT       0013 20
CAPDEST        0050
CAPFLASH       0044
CAPIDLE        0013 40
CAPNAME        0008
CAPNOTCV       003F 10
CAPNO38        003F 08
CAPOFORM       0048
CAPOWNER       0070
CAPPATH        0010
CAPPLOCK       0020
CAPRDOUT       0018
CAPRDR         007C 80
CAPRDRFL       007C
CAPSCHNG       003E 80
CAPSCVT        003E 40
CAPSELEC       003E
CAPSELSZ       007D 00000042
CAPSFLGX       003E
CAPSFLGY       003F
CAPSIZE        007D 00000010
CAPSPECF       003F 01
CAPSPID        0078
CAPSTAT        0013
CAPSVPEN       0013 80
CAPSYSNX       0000
CAPUSRNX       0004
CAPVIRT        0013 10
CAPVMDBK       001C
CAPWO5A        003F 40
CAPW5A         003F 80

This information is based on z/VM V4R1.0.
Last updated on 5 Jun 2001 at 13:01:16 EDT.
Copyright IBM Corporation, 1990, 2001