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

#### SPDBK

Prolog

Control Block Contents
SPDBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SPDBK Prolog

     NAME       : HCPSPDBK
     DESCRIPTION: SPOOL FILE DATA PAGE BLOCK
     DSECT      : SPDBK
     FUNCTION   : CONTAINS THE  ACTUAL SPOOL FILE DATA, AND THE
                  ASSOCIATED CCW'S TO PROCESS THAT INFORMATION.
     LOCATED BY :
                  (1) LOCATED IN SYSTEM VIRTUAL STORAGE BY:
                  SPAVSPD  - ANCHOR FOR THE CURRENT SPDBK
                  (2) LOCATED ON DASD BY:
                  SPADSPD  - THE ASA (DASD ADDRESS) OF THE SPDBK
                  CURRENTLY IN VIRTUAL STORAGE.
                  SPAASA   - 1 TO 16 ASA'S SPECIFYING THE DASD
                  ADDRESSES OF THE CURRENT SET OF
                  SPDBK'S.  THIS LIST IS COPIED
                  FROM THE SPMBK.
                  SPMASA   - MASTER LIST OF ALL THE SPDBK'S
                  NEEDED TO COMPRISE A SPOOL FILE.
     CREATED BY :
                  (1) CREATED IN SYSTEM VIRTUAL STORAGE BY:
                  HCPSFROP - WHEN A SPOOL FILE IS OPENED AND
                  SENT TO A REAL OUTPUT DEVICE.
                  HCPSFSON - WHEN A SPOOL FILE IS OPENED FOR
                  CREATION.
                  HCPSFVOP - WHEN A SPOOL FILE IS OPENED FOR
                  READING BY A VIRTUAL READER.
                  (2) CREATED ON DASD BY:
                  HCPVSPPW - WRITES THE SPDBKS TO DASD (FOR ALL
                  TYPES OF SPOOL FILES).
                  HCPRSPEX - REWRITES THE FIRST SPDBK WITH TAG
                  DATA IN IT FOR SPOOL FILES
                  CREATED BY REAL CARD READERS.
                  HCPSFVCL - REWRITES THE FIRST SPDBK WITH TAG
                  DATA IN IT FOR SPOOL FILES
                  CREATED BY VIRTUAL PRINTERS AND
                  PUNCHES.
     DELETED BY :
                  (1) DELETED IN SYSTEM VIRTUAL STORAGE BY:
                  HCPSFRCL - WHEN A SPOOL FILE CREATED ON A REAL
                  CARD READER IS CLOSED.
                  HCPSFVCL - WHEN A SPOOL FILE CREATED ON A
                  VIRTUAL PRINTER OR PUNCH IS
                  CLOSED.
                  HCPSFSON - WHEN AN ERROR OCCURS OPENING A
                  SPOOL FILE FOR CREATION.
                  (2) DELETED ON DASD BY:
                  HCPRSPIO - WHEN AN SPDBK CREATED ON A REAL
                  CARD READER NEVER GETS DATA.
                  HCPSDFCL - WHEN THE LAST SPDBK ALLOCATED FOR
                  A SYSTEM DATA FILE NEVER GETS
                  DATA.
                  HCPSFRDL - WHENEVER A SPOOL FILE IS DELETED.

#### SPDBK Control Block Content

#### SPDBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SPDBK          SPOOL FILE DATA PAGE BLOCK
    0000    0 Dbl-Word     8 SPDOPNTM       TOD (FULL) WHEN FILE WAS OPENED
    0008    8 Signed       4 SPDASPID       System spoolid for this file
    000C   12 Signed       2 SPDARCNT       NUMBER OF LOGICAL RECORDS IN THIS
                                            PAGE
    000E   14 Signed       2 *              RESERVED FOR FUTURE IBM USE
              00000010       SPDHDRSZ       *-SPDBK SIZE OF SPDBK HEADER
    0010   16 Dbl-Word     8 SPDATA (509)   CCW'S AND ASSOCIATED DATA
    0FF8 4088 Dbl-Word     8 SPDASNS        ENDING SENSE CCW FOR THE PAGE
              00000200       SPDASIZE       (*-SPDBK+7)/8 BLOCK SIZE IN
                                            DOUBLEWORDS
              THE FOLLOWING REDEFINITION IS FOR THE TAG RECORD
              (CCW'S AND TEXT) WHICH APPEAR IN THE FIRST DATA
              RECORD OF THE FIRST DATA PAGE ONLY.  FOLLOWING
              THE TAG RECORD, RESERVED SPACE IS TAKEN TO INSURE
              THE FIRST DATA PAGE WILL NOT HOLD MORE THAN THE
              FIRST VM/SP SPLINK.
    0010   16 Dbl-Word     8 SPDTGCCW (2)   TAG CCWS
    0020   32 Character    1 SPDTAG (136)   TAG TEXT
              ...1 ...1      SPDTGSIZ       136/8 SPDTGSIZ TAG RECORD SIZE IN
                                            DW'S
    00A8  168 Signed       2 SPDTAGOL       Original tag record length
    00AA  170 Signed       2 SPDRESVD (19)  RESERVED FIELD TO INSURE THE DATA
                                            IN THE 1ST SPDBK DOES NOT EXCEED
                                            WHAT WILL FIT IN THE FIRST VM/SP
                                            SPLINK, IN CASE THE TRANSLATION
                                            IS MADE
              000000C0       SPDSKIP        *-SPDATA OFFSET TO 1ST DATA CCW
                                            IN 1ST DATA PG
    00D0  208 Dbl-Word     8 SPDP1D (0)     ADDRESS OF 1ST DATA CCW IN 1ST
                                            DATA PG

#### SPDBK Storage Layout

    *** SPDBK - SPOOL FILE DATA PAGE BLOCK
    *
    *     +-------------------------------------------------------+
    *   0 |                       SPDOPNTM                        |
    *     +---------------------------+-------------+-------------+
    *   8 |         SPDASPID          |  SPDARCNT   |/////////////|
    *     +---------------------------+-------------+-------------+
    *  10 |                                                       |
    *     =                        SPDATA                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * FF8 |                       SPDASNS                         |
    *     +-------------------------------------------------------+
    *1000
    *
    *** SPDBK - SPOOL FILE DATA PAGE BLOCK

    *** Overlay for SPDATA in SPDBK
    *
    *     +-------------------------------------------------------+
    *  10 |                       SPDTGCCW                        |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  20 |                                                       |
    *     =                        SPDTAG                         =
    *     |                                                       |
    *     +-------------+-----------------------------------------+
    *  A8 |  SPDTAGOL   |                                         |
    *     +-------------+                                         |
    *  B0 |                                                       |
    *     =                       SPDRESVD                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *
    *** Overlay for SPDATA in SPDBK

#### SPDBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SPDARCNT       000C
    SPDASIZE       0FF8 00000200
    SPDASNS        0FF8
    SPDASPID       0008
    SPDATA         0010
    SPDHDRSZ       000E 00000010
    SPDOPNTM       0000
    SPDP1D         00D0
    SPDRESVD       00AA
    SPDSKIP        00AA 000000C0
    SPDTAG         0020
    SPDTAGOL       00A8
    SPDTGCCW       0010
    SPDTGSIZ       0020 11

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:06:34 EDT.
Copyright IBM Corporation, 1990, 2008