SPDBK Back to Index page
 
Prolog 
Control Block Contents 
   SPDBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  SPDBK Prolog Top of page
 
 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.
 RELOCATION CONSIDERATIONS : None
 
 
  SPDBK Control Block Content Top of page
 

 SPDBK DSECT Top of page
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 Top of page
 
          
*** 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 Top of page
 
 
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 7.3.0 Last updated on 22 Jun 2022 at 15:56:12 EDT.
Copyright IBM Corporation, 1990, 2022