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' CAPSVPEN Sever pending
              .1.. ....      CAPIDLE        X'40' CAPIDLE Service machine is
                                            idle
              ..1. ....      CAPDEFLT       X'20' CAPDEFLT Default criteria
              ...1 ....      CAPVIRT        X'10' CAPVIRT 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' CAPSCHNG Change selection
                                            criteria
              .1.. ....      CAPSCVT        X'40' CAPSCVT Select file to
                                            convert (else prt)
    003F   63 Bitstring    1 CAPSFLGY       Select criteria flag
              1... ....      CAPW5A         X'80' CAPW5A Select files with
                                            X'5A' CCWs
              .1.. ....      CAPWO5A        X'40' CAPWO5A Select files
                                            without X'5A' CCWs
              ..1. ....      CAPCVTD        X'20' CAPCVTD Select converted
                                            files
              ...1 ....      CAPNOTCV       X'10' CAPNOTCV Select files NOT
                                            converted
              .... 1...      CAPNO38        X'08' CAPNO38 Select files with
                                            NO 3800 CCWs
              .... .1..      CAPBEG38       X'04' CAPBEG38 Select file w
                                            beginning 3800 CCWs
              .... ..1.      CAPANY38       X'02' CAPANY38 Select file w 3800
                                            CCWs anywhere
              .... ...1      CAPSPECF       X'01' CAPSPECF 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' CAPRDR 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 V6R1.0. Last updated on 18 Feb 2010 at 08:27:32 EDT.
Copyright IBM Corporation, 1990, 2008