|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
SPDBK
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 00000011 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 = * | | * +-------------------------------------------------------+ * D0 | | * = SPDP1D = * | | * +-------------------------------------------------------+ * *** Overlay for SPDATA in SPDBK
SPDBK Cross Reference
(contains links to field and bit definitions)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 00000011
Last updated on 3 Aug 1999 at 12:33:57 EDT.
Copyright IBM Corporation, 1990, 1999