Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SPDBK
Control Block Contents
SPDBK DSECT
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. RELOCATION CONSIDERATIONS : None
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
Copyright IBM Corporation, 1990, 2011