|
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
SPABK
Control Block Contents
SPABK DSECT
Cross Reference (Contains links to field and bit definitions)
SPABK Prolog
NAME : HCPSPABK
DESCRIPTION: SPOOL FILE ALLOCATION BLOCK
DSECT : SPABK
FUNCTION : TO CONTAIN A RECORD OF SYSTEM RESOURCES
ALLOCATED TO A SPOOL FILE WHILE IT IS ACTIVE,
EITHER BEING CREATED OR PROCESSED ON THE
DESTINATION DEVICE. THESE RESOUCES INCLUDE
ASA ALLOCATION AND RESERVED CP VIRTUAL PAGES.
LOCATED BY : RSPSPA - FOR A SPOOL FILE ACTIVE ON A REAL
SPOOLING DEVICE
VSPSPA - FOR A SPOOL FILE ACTIVE ON A VIR-
TUAL SPOOLING DEVICE
ASPSPABK - FOR A SPOOL FILE ACTIVE FOR *SPL
CREATED BY : HCPSFSON - WHEN OPENING A NEW SPOOL FILE FOR
CREATION
HCPSFSOR - WHEN OPENING A NEW SPOOL FILE FOR
READING
HCPSFSOW - WHEN OPENING A NEW SPOOL FILE FOR
WRITING
DELETED BY : HCPSFRCL - WHEN PROCESSING IS COMPLETE FOR A
SPOOL FILE ACTIVE ON A REAL SPOOL
DEVICE, AND THE FILE IS TO BE
PURGED
HCPSFPCN - WHEN A NEW OR UPDATED SPOOL FILE
IS CLOSED
HCPSFPCR - WHEN A SPOOL FILE OPEN FOR READING
IS CLOSED
HCPSFPON - WHEN AN ERROR OPENING A NEW SPOOL
FILE IS ENCOUNTERED
HCPSFPOR - WHEN AN ERROR OPENING A SPOOL FILE
FOR READING IS ENCOUNTERED
HCPSFPOW - WHEN AN ERROR OPENING A SPOOL FILE
FOR WRITING IS ENCOUNTERED
SPABK Control Block Content
SPABK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SPABK SPOOL FILE ALLOCATION BLOCK 0000 0 Signed 2 SPALCCW DISPLACEMENT TO WHERE LAST CCW WAS PUT 0002 2 Signed 2 SPANCCW DISPLACEMENT OF WHERE TO PUT NEXT CCW 0004 4 Signed 4 SPADNUM RELATIVE SPDBK NUMBER BEING PROCESSED 0008 8 Signed 2 * RESERVED FOR FUTURE IBM USE 000A 10 Signed 2 SPAPNUM RELATIVE PAGE NUMBER OF CURRENT SPMBK 000C 12 Signed 4 SPARCNT NUMBER OF LOGICAL RECS PROCESSED SO FAR 0010 16 Signed 2 SPAPDSP WHERE TO GET(PUT) NEXT 16 ASA'S 0012 18 Signed 2 SPALCNT NO. LOGICAL RECS. LEFT THIS PAGE 0014 20 Address 4 SPAVSPM VIRTUAL ADDRESS OF THE SPMBK 0018 24 Signed 4 SPADSPM DASD ADDRESS OF THE SPMBK 001C 28 Address 4 SPAVSPD VIRTUAL ADDRESS OF THE SPDBK 0020 32 Signed 4 SPADSPD DASD ADDRESS OF THE SPDBK 0024 36 Signed 4 SPAASA (16) 16 ASA'S OF SPDBK'S (SPOOL FILE DATA) 00000040 SPAMAPSZ *-SPAASA SIZE OF ASA MAP AREA 0064 100 Bitstring 1 SPAIOFLG IO PENDING FLAG 1... .... SPAIOACT X'80' IO ACTIVE - CANNOT START ANOTHER BUF .1.. .... SPAREADY X'40' NEXT BUFFER READY TO GO 0065 101 Bitstring 1 SPAFLAG General flags 1... .... SPACPXAB X'80' Checkpoint XAB's at close .1.. .... SPAVLSID X'40' Validate sysid in SFNDX ..1. .... SPAFULL X'20' Buffer to hold ASA's is full 0066 102 Bitstring 1 * (2) RESERVED FOR FUTURE IBM USE 0068 104 Dbl-Word 8 SPAEXP (4) 3800 EXPANSION BUFFERS FOR LONG DATA 0088 136 Signed 4 SPAXABS (8) Slots for XAB ASAs 00000020 SPAXABLN *-SPAXABS Length of the XAB ASA area 00000015 SPASIZE (*-SPABK+7)/8 BLOCK SIZE IN DOUBLEWORDS 0004 4 Bitstring 1 * Zeros: SPADNUM can't be this big 0005 5 Bitstring 1 SPADNUMO One zero bit and 3 overflow bits .... .1.. SPADNUM3 X'04' Overflow bit 3 .... ..1. SPADNUM2 X'02' Overflow bit 2 .... ...1 SPADNUM1 X'01' Overflow bit 1 0006 6 Signed 2 SPADNUMH Halfword DNUM value for RSPBK 0068 104 Dbl-Word 8 SPAEXPA (2) TWO EXPANSION SLOTS FOR BUFFER A 0078 120 Dbl-Word 8 SPAEXPB (2) TWO EXPANSION SLOTS FOR BUFFER B ...1 .... SPAXBOFF SPAEXPB-SPAEXP OFFSET TO B SECTION OF SPAEXP 0068 104 Dbl-Word 8 SPAEXPVF (0) VIRTUAL PAGE / REAL FRAME PAIR 0068 104 Signed 4 SPAEXPV VIRTUAL PAGE ADDRESS, MUST BE FIRST 006C 108 Signed 4 SPAEXPF REAL FRAME ADDRESS, MUST FOLLOW VPAGE .... 1... SPALSLOT L'SPAEXPVF LENGTH OF A SLOT FOR CLEAR
SPABK Storage Layout
*** SPABK - SPOOL FILE ALLOCATION BLOCK
*
* +-------------+-------------+---------------------------+
* 0 | SPALCCW | SPANCCW | SPADNUM |
* +-------------+-------------+---------------------------+
* 8 |/////////////| SPAPNUM | SPARCNT |
* +-------------+-------------+---------------------------+
* 10 | SPAPDSP | SPALCNT | SPAVSPM |
* +-------------+-------------+---------------------------+
* 18 | SPADSPM | SPAVSPD |
* +---------------------------+---------------------------+
* 20 | SPADSPD | |
* +---------------------------+ |
* 28 | |
* = SPAASA =
* | +------+------+-------------+
* 60 | |:IOFLG|:FLAG |/////////////|
* +---------------------------+------+------+-------------+
* 68 | |
* = SPAEXP =
* | |
* +-------------------------------------------------------+
* 88 | |
* = SPAXABS =
* | |
* +-------------------------------------------------------+
* A8
*
*** SPABK - SPOOL FILE ALLOCATION BLOCK
*** Overlay for SPADNUM in SPABK
*
* +------+------+-------------+
* 0 ... 4 |//////|:DNUMO| SPADNUMH |
* +------+------+-------------+
* 8
*
*** Overlay for SPADNUM in SPABK
*** Overlay for SPAEXP in SPABK
*
* +-------------------------------------------------------+
* 68 | SPAEXPA |
* | |
* +-------------------------------------------------------+
* 78 | SPAEXPB |
* | |
* +-------------------------------------------------------+
* 88
*
*** Overlay for SPAEXP in SPABK
*** Overlay for SPAEXP in SPABK
*
* +---------------------------+---------------------------+
* 68 | SPAEXPV | SPAEXPF |
* +---------------------------+---------------------------+
* 70
*
*** Overlay for SPAEXP in SPABK
SPABK Cross Reference
Symbol Dspl Value -------------- ---- ----- SPAASA 0024 SPACPXAB 0065 80 SPADNUM 0004 SPADNUMH 0006 SPADNUMO 0005 SPADNUM1 0005 01 SPADNUM2 0005 02 SPADNUM3 0005 04 SPADSPD 0020 SPADSPM 0018 SPAEXP 0068 SPAEXPA 0068 SPAEXPB 0078 SPAEXPF 006C SPAEXPV 0068 SPAEXPVF 0068 SPAFLAG 0065 SPAFULL 0065 20 SPAIOACT 0064 80 SPAIOFLG 0064 SPALCCW 0000 SPALCNT 0012 SPALSLOT 006C 08 SPAMAPSZ 0024 00000040 SPANCCW 0002 SPAPDSP 0010 SPAPNUM 000A SPARCNT 000C SPAREADY 0064 40 SPASIZE 0088 00000015 SPAVLSID 0065 40 SPAVSPD 001C SPAVSPM 0014 SPAXABLN 0088 00000020 SPAXABS 0088 SPAXBOFF 0078 10
Last updated on 5 Jun 2001 at 16:41:08 EDT.
Copyright IBM Corporation, 1990, 2001