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 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 V4R3.0. Last updated on 30 Apr 2002 at 17:41:01 EDT.
Copyright IBM Corporation, 1990, 2002