Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

SPFBK

Prolog  

Control Block Contents  
   SPFBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


SPFBK Prolog

 NAME       : HCPSPFBK
 DESCRIPTION: SPOOL FILE DESCRIPTOR (OR CONTROL) BLOCK
 DSECT      : SPFBK
 FUNCTION   : TO CONTAIN SPOOL FILE CHARACTERISTICS, SUCH AS
              CLASS, DISTRIBUTION CODE, SPOOLID, ETC.
 LOCATED BY : (1)  ROUTINES:
              HCPSCSGN - WILL RETURN THE ADDRESS OF THE NEXT SPFBK
              ON THE QUEUE(S) SPECIFIED IN THE CALLERS
              R1.
              HCPSCSNM - WILL RETURN THE ADDRESS OF THE NEXT SPFBK
              WITH THE SPECIFIED FILENAME/FILETYPE ON
              THE QUEUE(S) SPECIFIED BY THE CALLERS R1.
              HCPSCSPF - WILL RETURN THE ADDRESS OF THE SPFBK FOR
              THE SPOOLID SPECIFIED IN THE CALLERS R1.
              (2)  FIELDS:
              SPFPNT   - POINTS  TO THE  NEXT SPFBK ON THE QUEUE.
              IF SPFPNT IS ZERO, IT IS THE LAST FILE.
              SYSOUTQ  - Points to the first SPFBK on the
              output queue.  The first word in the
              SPFBK points to the next SPFBK.  If
              that field is zero, it is the last
              file on the output queue.  The output
              queue consists of printer and punch
              files.
              SYSINQ   - Points to the first SPFBK on the
              input queue.  The first word in the
              SPFBK points to the next SPFBK.  If
              that field is zero, it is the last
              file on the input queue.  The input
              queue consists of reader files.
              SYSDATAQ - Points to the first SPFBK on the
              system data queue.  The first word in
              the SPFBK points to the next SPFBK.
              If that field is zero, it is the last
              file on the system data queue.  The
              system data queue consists of
              NSS/DCSS, IMG, UCR, and NLS files.
              NOTES      :  The SPFBK is also checkpointed in the SPMBKS
              for the corresponding spoolid.
 CREATED BY : HCPDMQSD - WHEN A CP ABEND DUMP READER FILE IS
              OPENED
              HCPSDFON - WHEN A NEW SYSTEM DATA FILE IS CREATED
              HCPSFROP - WHEN A  SPOOL  FILE  IS CREATED BY A REAL
              READER
              HCPSFVOP - WHEN A SPOOL FILE IS CREATED ON A VIRTUAL
              PRINTER OR CARD PUNCH OR A CP ABEND  DUMP
              FILE IS OPEN
              HCPSPZRI - When creating a spool file from a
              tape via the SPXTAPE command
              HCPVDUMP - WHEN A VMDUMP READER SPOOL FILE
              IS OPENED
              HCPWRSST - WHEN THE SYSTEM IS WARM STARTED,
              HCPWRS RECREATES THE SPFBK'S FOR ALL
              SPOOL FILES THAT EXISTED WHEN THE
              SYSTEM WAS BROUGHT DOWN
 DELETED BY : HCPSFSON - IF THERE IS NO DASD OR SYSTEM VIRTUAL
              SPACE WHEN A  SPOOL FILE IS BEING CREATED
              HCPSFRDL - WHEN A  SPOOL FILE  IS TO BE DELETED FROM
              THE SYSTEM
              HCPSPORR - When end of command for SPXTAPE SCAN.
              HCPSPQCT - When end of file for SPXTAPE SCAN.
              HCPSPZRI - When file being loaded from tape
              via the SPXTAPE LOAD command does
              not match criteria or has an error
              condition.
              HCPWRSST - WHEN THE SYSTEM IS WARM STARTED,
              HCPWRS CHECKS TO SEE IF A SPOOL FILE
              CONTAINED ANY DATA. IF IT DIDN'T, IT
              DELETES THE SPFBK
 RELOCATION CONSIDERATIONS : None
 NOTES      : When adding new characteristics to the spool file,
              check if the new characteristics need to be saved
              when dumping and loading from tape (i.e. HCPSXS,
              HCPSPX, HCPSPZ) and when checking for duplicate files
              (HCPSPK).

 

SPFBK Control Block Content


SPFBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SPFBK          SPOOL FILE DESCRIPTOR (OR CONTROL) BLOCK
0000    0 Address      4 SPFFPNT        Pointer to the next SPFBK on
                                        system queue
0004    4 Address      4 SPFBPNT        Pointer to previous SPFBK on
                                        system queue
0008    8 Address      4 SPFPNT         Pointer to next SPFBK on user
                                        queue
000C   12 Signed       4 SPFSYSID       System spool file id number
                                        (unique)
0010   16 Bitstring    1 SPFSTAT        SPOOL FILE STATUS FLAGS
          1... ....      SPFINUSE       X'80' SPFINUSE CLOSED FILE IS IN
                                        USE.
          .1.. ....      SPFOPEN        X'40' SPFOPEN FILE IS OPEN (BEING
                                        CREATED)
          ..1. ....      SPFUHOLD       X'20' SPFUHOLD FILE HAS USER HOLD
          ...1 ....      SPFSHOLD       X'10' SPFSHOLD FILE HAS SYSTEM
                                        HOLD
          .... 1...      SPFKEEP        X'08' SPFKEEP FILE HAS 'KEEP'
                                        OPTION SET
          .... .1..      SPFMSG         X'04' SPFMSG FILE HAS 'MSG'
                                        OPTION SET
          .... ..1.      SPFERRPU       X'02' SPFERRPU PURGE FILE BLOCKS
                                        BUT NOT DASD
0011   17 Bitstring    1 SPFFLAG        SPOOL FILE ACTION FLAGS
          1... ....      SPFPURGE       X'80' SPFPURGE FILE IS TO BE
                                        PURGED
          .1.. ....      SPFEOF         X'40' SPFEOF LAST RECORD
                                        PROCESSED (USUALLY RDR FILES)
          ..1. ....      SPFBKWD        X'20' SPFBKWD BACKSPACE BASED
                                        UPON 'PCNT'
          ...1 ....      SPFFWD         X'10' SPFFWD FWD SPACE BASED UPON
                                        'PCNT'
          .... 1...      SPFSEEN        X'08' SPFSEEN FILE HAS PREVIOUSLY
                                        BEEN SEEN BY DIAGNOSE X'14'
          .... .1..      SPFTAGM        X'04' SPFTAGM 'TAG' MODIFIED
                                        WHILE FILE 'OPEN'
          .... ..1.      SPFBKEOF       X'02' SPFBKEOF BACKSPACE REQUEST
                                        FROM END-OF-FILE
          .... ...1      SPFDPOS        X'01' SPFDPOS FILE IS POSITIONED
                                        AT A LINE WITH DATA ON IT - LAST
                                        CCW WAS 'WRITE NO SPACE'. USED TO
                                        PREVENT TRACE OUTPUT OVERLAY
0012   18 Bitstring    1 SPFTYPE        SPOOL FILE ORIGINATING DEVICE
                                        TYPE
          1... ....      SPFORDR        X'80' SPFORDR CAME FROM REAL
                                        READER
          .1.. ....      SPFOPUN        X'40' SPFOPUN CAME FROM VIRTUAL
                                        PUNCH
          ..1. ..1.      SPFOPRT        X'22' SPFOPRT CAME FROM VIRTUAL
                                        PRINTER
          ..1. ..11      SPFO383        X'23' SPFO383 CAME FROM VIRTUAL
                                        3800 MODEL 3 PRINTER
          ..1. ....      SPFOCON        X'20' SPFOCON CAME FROM VIRTUAL
                                        CONSOLE
          ...1 ....      SPFOSYS        X'10' SPFOSYS SYSTEM CREATED
                                        SPOOL FILE
0013   19 Bitstring    1 SPFQUEUE       SPOOL FILE QUEUE LOCATION
          1... ....      SPFRDRQ        X'80' SPFRDRQ FILE IS ON THE RDR
                                        QUEUE
          .1.. ....      SPFPUNQ        X'40' SPFPUNQ FILE IS ON THE
                                        PUNCH QUEUE
          ..1. ....      SPFPRTQ        X'20' SPFPRTQ FILE IS ON THE
                                        PRINTER QUEUE
          ...1 ....      SPFNSSQ        X'10' SPFNSSQ FILE IS ON THE
                                        NSS/DCSS QUEUE
          .... 1...      SPFIMGQ        X'08' SPFIMGQ FILE IS ON THE
                                        IMAGE LIBRARY QUEUE
          .... .1..      SPFTRFQ        X'04' SPFTRFQ FILE IS ON THE
                                        SYSTEM TRACE FILE QUEUE
          .... ..1.      SPFUCRQ        X'02' SPFUCRQ FILE IS ON THE UCR
                                        QUEUE
          .... ...1      SPFNLSQ        X'01' SPFNLSQ file is on the NLS
                                        queue
          111. ....      SPFSTD         SPFRDRQ+SPFPUNQ+SPFPRTQ SPFSTD
                                        All standard files
          ...1 1111      SPFDATA        SPFNSSQ+SPFIMGQ+SPFUCRQ+SPFTRFQ+S
                                        PFNLSQ SPFDATA SDF
          1111 1111      SPFALLQ        SPFSTD+SPFDATA SPFALLQ All spool
                                        files
0014   20 Bitstring    1 SPFOVER        OVERRIDE FLAGS USED AT 'CLOSE'
          1... ....      SPFORDQ        X'80' SPFORDQ CLOSE FILE 'TO RDR'
                                        QUEUE
          .1.. ....      SPFOPUQ        X'40' SPFOPUQ CLOSE FILE 'TO PUN'
                                        QUEUE
          ..1. ....      SPFOPRQ        X'20' SPFOPRQ CLOSE FILE 'TO PRT'
                                        QUEUE
          .... 1...      SPFSETHO       X'08' SPFSETHO KEEP RDR FILE IN
                                        USERHOLD
          .... .1..      SPFNOPUR       X'04' SPFNOPUR DO NOT PURGE RDR
                                        FILE WHEN CLOSED
          .... ..1.      SPFIGNRK       X'02' SPFIGNRK IGNORE KEEP ON RDR
                                        WHEN CLOSED
          .... ...1      SPFIGNRH       X'01' SPFIGNRH IGNORE HOLD ON RDR
                                        WHEN CLOSED
0015   21 Bitstring    1 SPFSYSTY       SYSTEM DATA FILE FLAG
          1... ....      SPFCPDMP       X'80' SPFCPDMP FILE IS A CP ABEND
                                        DUMP FILE
          .1.. ....      SPFVMDMP       X'40' SPFVMDMP FILE IS A VIRTUAL
                                        MACHINE DUMP (VMDUMP)
          ..1. ....      SPFPPEND       X'20' SPFPPEND FILE IS MARKED FOR
                                        PENDING PURGE
          ...1 ....      SPFVOLAF       X'10' SPFVOLAF VOLUME AFFINITY -
                                        FILE SHOULD BE WRITTEN ON ONE
                                        VOLUME IF POSSIBLE
          .... 1...      SPFNONXT       X'08' SPFNONXT NEXT DATA PAGE
                                        COULD NOT BE OBTAINED
          .... .1..      SPFNORTN       X'04' SPFNORTN Dump file created
                                        with noreturn option
          .... ..1.      SPFSFTDP       X'02' SPFSFTDP File is a soft
                                        abend type file
          .... ...1      SPFSECUR       X'01' SPFSECUR FILE IS A SECURE
                                        NSS/DCSS FILE
0016   22 Bitstring    1 SPFPRTFL       FLAGS FOR ADVANCED FUNCTION
                                        PRINTERS
          1... ....      SPFBEG         X'80' SPFBEG 3800 LOAD CCWS
                                        APPEAR AT BEGINNING
          .1.. ....      SPFANY         X'40' SPFANY 3800 LOAD CCWS
                                        APPEAR THROUGHOUT FILE
          ..1. ....      SPFLDCHR       X'20' SPFLDCHR LOAD WCGM OR
                                        GRAPHMOD CCWS APPEAR
          ...1 ....      SPFFLNEM       X'10' SPFFLNEM FILE IS NOT EMPTY
                                        FLAG
          .... 1...      SPFFLALL       X'08' SPFFLALL FLASH ALL COPIES
                                        OF THE FILE
          .... .1..      SPF5ACCW       X'04' SPF5ACCW File contains
                                        X'5A' CCWs - AFP control
          .... ..1.      SPFFXAB        X'02' SPFFXAB File has an XAB
                                        associated with it
          .... ...1      SPFXFER        X'01' SPFXFER File transferred
                                        flag
0017   23 Character    1 SPFSPCL        SPOOL FILE CLASS
0018   24 Bitstring    1 SPFCOPY        FILE COPY COUNT
0019   25 Bitstring    1 SPFSTCPY       NUMBER OF COPIES AT PRINT START
001A   26 Bitstring    1 SPFPGCPY       PAGE COPY COUNT (USED ONLY FOR
                                        3800)
001B   27 Bitstring    1 SPFMODNO       COPY MOD CHARACTER SET NUMBER
                                        (0-3)
001C   28 Bitstring    1 SPFFLSHC       FLASH COUNT
001D   29 Bitstring    1 SPFDVTYP       Device type of originating device
          1... ....      TYP2700        X'80' TYP2700 TERM - 2700 BISYNC
                                        LINE
          1... 1...      TYPBSC         X'88' TYPBSC TERM - BISYNC LINE
                                        FOR 3270 REMOTE STATION
          .1.. ....      TYPCONS        X'40' TYPCONS TERM - CONSOLE
                                        DEVICE
          .1.. ....      TYP3215        X'40' TYP3215 TERM - 3215 CONSOLE
          .1.. ....      TYP1052        X'40' TYP1052 TERM - 1052 CONSOLE
          ..1. ....      TYPTTY         X'20' TYPTTY TERM - USASCII-8
                                        TELEGRAPH TERMINAL
          ...1 ....      TYPIBM1        X'10' TYPIBM1 TERM - IBM TERMINAL
                                        CONTROL TYPE 1
          ...1 11..      TYPUNDEF       X'1C' TYPUNDEF TERM - TERMINAL
                                        TYPE UNDEFINED
          ...1 1...      TYP2741        X'18' TYP2741 TERM - 2741
                                        COMMUNICATIONS TERMINAL
          ...1 1...      TYP3767        X'18' TYP3767 TERM - 3767 IN 2741
                                        COMPATIBILITY MOD
          ...1 .1..      TYP1050        X'14' TYP1050 TERM - 1050
                                        COMMUNICATIONS TERMINAL
          .... 1...      TYPSDLC        X'08' TYPSDLC TERM - SDLC
                                        Integrated Adapter
          ..1. ....      TYPTELE2       X'20' TYPTELE2 TERM - TELE2
                                        Integrated Adapter
          ..1. .1..      TYPHDLC        X'24' TYPHDLC TERM - HDLC
                                        Integrated Adapter
          ..1. 1...      TYPILAN        X'28' TYPILAN TERM - ILAN
                                        Integrated Adapter
          ..1. 1...      TYPELAN        X'28' TYPELAN TERM - ELAN
                                        Integrated Adapter
          .1.. ....      TYP3270        X'40' TYP3270 GRAF - 3270 GENERIC
                                        DISPLAY STATION
          1... ....      TYP3277        X'80' TYP3277 GRAF - 3277 DISPLAY
                                        STATION
          .1.. ....      TYP3278        X'40' TYP3278 GRAF - 3278 DISPLAY
                                        STATION
          .1.. ....      TYP3178        X'40' TYP3178 GRAF - 3178 DISPLAY
                                        STATION
          .1.. ....      TYP3279        X'40' TYP3279 GRAF - 3279 DISPLAY
                                        STATION
          .1.. ....      TYP3179        X'40' TYP3179 GRAF - 3179 DISPLAY
                                        STATION
          .1.. ....      TYP3180        X'40' TYP3180 GRAF - 3180 DISPLAY
                                        STATION
          .1.. ....      TYP3290        X'40' TYP3290 GRAF - 3290 DISPLAY
                                        STATION
          .1.. ....      TYP3190        X'40' TYP3190 GRAF - 3190 DISPLAY
                                        STATION
          ..1. ....      TYP3271        X'20' TYP3271 GRAF - 3271
                                        CONTROLLER (REMOTE)
          ...1 ....      TYP3275        X'10' TYP3275 GRAF - 3275 DISPLAY
                                        STATION
          .... 1...      TYP3284        X'08' TYP3284 GRAF - 3284 PRINTER
          .... 1...      TYP3286        X'08' TYP3286 GRAF - 3286 PRINTER
          .... 1..1      TYP3287        X'09' TYP3287 GRAF - 3287 PRINTER
          .... 1...      TYP3288        X'08' TYP3288 GRAF - 3288 PRINTER
          .... 1..1      TYP3289        X'09' TYP3289 GRAF - 3289 PRINTER
          .... 1...      TYP3287L       X'08' TYP3287L GRAF - 3287
                                        LOGICAL PRINTER
          .... 1...      TYP3289L       X'08' TYP3289L GRAF - 3289
                                        LOGICAL PRINTER
          .... .1..      TYP2250        X'04' TYP2250 GRAF - 2250 DISPLAY
                                        UNIT
          .... .1..      TYP3250        X'04' TYP3250 GRAF - 3250 DISPLAY
                                        UNIT
          .... .11.      TYP5080        X'06' TYP5080 GRAF - 5080 DISPLAY
                                        UNIT
          ..11 ....      TYPCLUST       X'30' TYPCLUST GRAF - CLUSTER
                                        CTLR (3271 OR 3275)
          .... ..1.      TYPIC          X'02' TYPIC TERM - Integrated
                                        console GRAF - Integrated 3270
          1... ....      TYPRDR         X'80' TYPRDR SPOL - CARD READER
                                        DEVICE
          1... ...1      TYP2501        X'81' TYP2501 SPOL - 2501 CARD
                                        READER
          1... ..1.      TYP2540R       X'82' TYP2540R SPOL - 2540 CARD
                                        READER
          1... .1..      TYP3505        X'84' TYP3505 SPOL - 3505 CARD
                                        READER
          .1.. ....      TYPPUN         X'40' TYPPUN SPOL - CARD PUNCH
                                        DEVICE
          .1.. ..1.      TYP2540P       X'42' TYP2540P SPOL - 2540 CARD
                                        PUNCH
          .1.. .1..      TYP3525        X'44' TYP3525 SPOL - 3525 CARD
                                        PUNCH
          ..1. ....      TYPPRT         X'20' TYPPRT SPOL - PRINTER TYPE
                                        DEVICE
          ..1. ...1      TYP1403        X'21' TYP1403 SPOL - 1403 PRINTER
          ..1. ..1.      TYP32XX        X'22' TYP32XX SPOL - 3203 OR 3211
                                        PRINTER
          ..1. .11.      TYP3203        X'26' TYP3203 SPOL - 3203 PRINTER
          ..1. ..1.      TYP3211        X'22' TYP3211 SPOL - 3211 PRINTER
          ..1. 1...      TYP3800        X'28' TYP3800 SPOL - 3800 PRINTER
          ..1. ..11      TYP3262        X'23' TYP3262 SPOL - 3262 PRINTER
          ..1. .1..      TYP4245        X'24' TYP4245 SPOL - 4245 PRINTER
          ..1. 1..1      TYP4248        X'29' TYP4248 SPOL - 4248 PRINTER
          ..1. .1.1      TYP3820        X'25' TYP3820 SPOL - 3820 PRINTER
                                        - dedicated only
          ..1. .111      TYPAFP1        X'27' TYPAFP1 SPOL - AFP1 PRINTER
                                        - dedicated only
          ..1. 1.1.      TYPVAFP        X'2A' TYPVAFP SPOL - VAFP PRINTER
                                        - simulated only
          ...1 ....      TYPSYS         X'10' TYPSYS SPOL - SYSTEM VIRT
                                        DEVICE FOR DUMPS
          ...1 ....      TYP3420        X'10' TYP3420 TAPE - 3420 TAPE
                                        DRIVE
          ..1. ....      TYP3430        X'20' TYP3430 TAPE - 3430 TAPE
                                        DRIVE
          .1.. ....      TYP3480        X'40' TYP3480 TAPE - 3480 TAPE
                                        DRIVE
          .1.. ..1.      TYP3424        X'42' TYP3424 TAPE - 3424 TAPE
                                        DRIVE
          .1.. .1..      TYP9348        X'44' TYP9348 TAPE - 9348 TAPE
                                        DRIVE
          1... ....      TYP3422        X'80' TYP3422 TAPE - 3422 TAPE
                                        DRIVE
          1... ...1      TYP3490        X'81' TYP3490 TAPE - 3490 TAPE
                                        DRIVE
          1... ..11      TYP3590        X'83' TYP3590 TAPE - 3590 TAPE
                                        DRIVE
          .1.. ....      TYP3330        X'40' TYP3330 DASD - 3330 DISK
                                        STORAGE FACILITY
          ..1. ....      TYP3340        X'20' TYP3340 DASD - 3340 DISK
                                        STORAGE FACILITY
          ...1 ....      TYP3350        X'10' TYP3350 DASD - 3350 DISK
                                        STORAGE FACILITY
          ...1 ...1      TYP3350C       X'11' TYP3350C DASD - 3350 4 X 8
                                        PAGING STORAGE
          ...1 ..1.      TYP3350D       X'12' TYP3350D DASD - 3350 4 X 4
                                        PAGING STORAGE
          .... 1...      TYP2305        X'08' TYP2305 DASD - 2305 FIXED
                                        HEAD STORAGE FACILITY
          .... .1..      TYP3380        X'04' TYP3380 DASD - 3380 DISK
                                        STORAGE FACILITY
          1... ..1.      TYP3390        X'82' TYP3390 DASD - 3390 DISK
                                        STORAGE FACILITY
          1... ....      TYP3375        X'80' TYP3375 DASD - 3375 DISK
                                        STORAGE FACILITY
          .... ..1.      TYP3370        X'02' TYP3370 DASD - 3370 DISK
                                        STORAGE FACILITY
          1... ...1      TYP9345        X'81' TYP9345 DASD - 9345 DISK
                                        STORAGE FACILITY
          ..1. ...1      TYP9332        X'21' TYP9332 DASD - 9332 FBA
                                        Direct Access Storage
          ..1. ..1.      TYP9335        X'22' TYP9335 DASD - 9335 FBA
                                        Direct Access Storage
          ..1. .1..      TYP9336        X'24' TYP9336 DASD - 9336 FBA
                                        Direct Access Storage
          ..1. 1...      TYPFBA         X'28' TYPFBA DASD - Generic FBA
                                        DAS
          .1.. ....      TYP9033        X'40' TYP9033 SWCH - 9033 Switch
                                        device
          1... ....      TYP9032        X'80' TYP9032 SWCH - 9032 Switch
                                        device
          ..1. ....      TYP2032        X'20' TYP2032 SWCH - 2032 FICON
                                        Switch device
          1... ....      TYPCTCA        X'80' TYPCTCA SPEC - CHANNEL TO
                                        CHANNEL ADAPTER
          1... ....      TYP3088        X'80' TYP3088 SPEC - 3088
                                        MULTISYSTEM CHANNEL COMMUNICATION
                                        UNIT
          .1.. ....      TYP3704        X'40' TYP3704 SPEC - 3704
                                        PROGRAMMABLE COMMUNICATION
                                        CONTROL UNIT
          .1.. ....      TYP3705        X'40' TYP3705 SPEC - 3705
                                        PROGRAMMABLE COMMUNICATION
                                        CONTROL UNIT
          ..1. ....      TYPOSA         X'20' TYPOSA SPEC - Open Systems
                                        Adapter (OSA)
          ...1 ....      TYPFCP         X'10' TYPFCP SPEC - Open FCP
                                        Adapter (FCP)
          .... ..1.      TYP3851        X'02' TYP3851 SPEC - MSS MASS
                                        STORAGE COMMUNICATOR
          .... 1...      TYP3890        X'08' TYP3890 SPEC - 3890
                                        DOCUMENT PROCESSOR
          .... ..11      TYPALIAS       X'03' TYPALIAS SPEC - PAV Alias
          .... ...1      TYPUNSUP       X'01' TYPUNSUP SPEC - DEVICE
                                        UNSUPPORTED BY * THE VM/ 370
                                        MIGRATION AID
          .... ..1.      TYPDYNIO       X'02' TYPDYNIO VCM - Dynamic I/O
          .... ...1      TYPMSGF        X'01' TYPMSGF VCM - Message
                                        Facility
001E   30 Bitstring    1 SPFPGLEN       PAPER LENGTH
001F   31 Bitstring    1 SPFPSFF        Flags for Print Services Facility
          1... ....      SPFCVING       X'80' SPFCVING File is BEING
                                        convertd (can be stoppd)
          .1.. ....      SPFCVTD        X'40' SPFCVTD File has BEEN
                                        convertd (cannot delete)
          ..1. ....      SPFCVTDX       X'20' SPFCVTDX File has been
                                        converted on ANOTHER system in
                                        the VM/CSE complex. (Do not
                                        select this file for conversion)
          ...1 ....      SPFBTS         X'10' SPFBTS 3800 BTS specified
          .... 1...      SPFORDD        X'08' SPFORDD File just been
                                        ordered
          .... .1..      SPFDLPRG       X'04' SPFDLPRG FILE IN THE DELETE
                                        PURGE QUEUE
          .... ..1.      SPFDPRD        X'02' SPFDPRD One or more data
                                        pages read
          .... ...1      SPFCMPRS       X'01' SPFCMPRS Blanks compressed
0020   32 Signed       2 SPFSPID        User spool file id number (not
                                        unique)
0022   34 Signed       2 SPFDEV         REAL OR VIRTUAL NUMBER OF DEVICE
                                        PROCESSING FILE
0024   36 Signed       2 SPFPCNT        PAGE CNT FOR FWD OR BKWD SPACE
0026   38 Signed       2 SPFLRECL       LENGTH OF SPOOL FILE RECORDS
0028   40 Signed       4 SPFRCNT        TOTAL NUMBER OF LOGICAL RECORDS
002C   44 Signed       4 SPFSTART       ASA OF FIRST SPMBK FOR THE FILE
0030   48 Dbl-Word     8 SPFCLKOP       TOD (FULL) AT 'OPEN' TIME
0038   56 Signed       4 SPFCLKCL       TOD HIGH ORDER WORD AT 'CLOSE'
                                        TIME
          0000003C       SPFCFLDS       * START OF CHARACTER FIELDS
003C   60 Character    4 SPFFLASH       FORMS OVERLAY (FLASH) NAME
0040   64 Character    8 SPFUSER        USER IDENTIFICATION OF FILE OWNER
0048   72 Character    8 SPFDIST        DISTRIBUTION CODE
0050   80 Character    8 SPFORIG        USER IDENTIFICATION OF FILE
                                        ORIGINATOR
0058   88 Character    8 SPFFINAM       FILE NAME
0060   96 Character    8 SPFFITYP       FILE TYPE
0068  104 Character    8 SPFUFORM       USER FORM NAME
0070  112 Character    8 SPFOFORM       OPERATOR FORM NUMBER
0078  120 Character   16 SPFCHARS (0)   LENGTH ATTRIBUTE TO CLEAR CHAR
                                        SETS
0078  120 Character    4 SPFCHAR0       CHARACTER SET NAME - FIRST
007C  124 Character    4 SPFCHAR1       CHARACTER SET NAME - SECOND
0080  128 Character    4 SPFCHAR2       CHARACTER SET NAME - THIRD
0084  132 Character    4 SPFCHAR3       CHARACTER SET NAME - FOURTH
0070  112 Bitstring   20 SPFSHA1S       This is a 20 Byte SHA-1 sum that
                                        is calculated for NSS/DCSS spool
                                        files when they get saved. Live
                                        guest relocation eligibility
                                        checks use this field to ensure
                                        that matching NSS/DCSS exist on
                                        the source and destination
                                        systems. We ORG over SPFOFORM and
                                        SPFCHARS (two otherwise unused
                                        fields) instead of creating new
                                        ones because the SPXTAPE command
                                        already backs up these fields and
                                        restores them for us. This gives
                                        the end user a method for backing
                                        up and restoring an NSS/DCSS that
                                        keeps the checksum intact.
0084  132 Bitstring    4 *              (Remainder of SPFCHARS)
0088  136 Character    4 SPFFCB         FCB NAME OR LINES/INCH
008C  140 Character    4 SPFCMOD        COPY MODIFICATION MODULE NAME
0090  144 Character    8 SPFDEST        Destination value
          0000005C       SPFBLANK       *-SPFCFLDS Length to set to
                                        blanks
0098  152 Signed       4 SPFDPCNT       Count of data pages (SPDBKs)
009C  156 Signed       4 SPFXLEN        Length of the XAB if any
00A0  160 Dbl-Word     8 SPFSHPPS (0)   Cross System Extensions fields
00A0  160 Bitstring    1 SPFSYQIX       System which currently has this
                                        SPFBK locked
00A1  161 Bitstring    1 SPFORGIX       System which created this file
00A2  162 Bitstring    1 SPFSHPST       Spool file status
          1... ....      SPFLOKED       X'80' SPFLOKED File locked by a
                                        system in this CSE complex
          .1.. ....      SPFLCLOK       X'40' SPFLCLOK Local lock (Diag
                                        14)
          ..1. ....      SPFSIGOP       X'20' SPFSIGOP (Like CSFSIGOP)
                                        File changed; PSF- converted
                                        files must be purged
          ...1 ....      SPFCWQ         X'10' SPFCWQ File changed or
                                        locked (by Original system) while
                                        waiting for the lock
          .... 1...      SPFLENQ        X'08' SPFLENQ Lock request in
                                        process
          .... .1..      SPFQLOKD       X'04' SPFQLOKD (Parm to SFR.DL):
                                        the spool queue is locked. Do not
                                        unlock (except for SFR001)
          .... ..1.      SPFDELX        X'02' SPFDELX File deleted
                                        externally to this system
                                        (Usually by the Originating
                                        system)
          .... ...1      SPFFCBXT       X'01' SPFFCBXT EXTENDED FCB IS
                                        IMBEDDED
00A3  163 Bitstring    1 SPFBBITS       Broadcast bits. Systems which
                                        have a copy of this SPFBK
00A4  164 Signed       2 SPFOSPID       Previous owner's spid before
                                        TRANSFER
00A6  166 Bitstring    1 SPFCVTAT       ID of system which converted the
                                        file
00A7  167 Bitstring    1 SPFSHTDN       SHUTDOWN OPEN FILE FLAG
          1... ....      SPFQRDR        X'80' SPFQRDR PUT FILE ON RDRQ AT
                                        INITIALIZATION
          .1.. ....      SPFQPUN        X'40' SPFQPUN PUT FILE ON PUNQ AT
                                        INITIALIZATION
          ..1. ....      SPFQPRT        X'20' SPFQPRT PUT FILE ON PRTQ AT
                                        INITIALIZATION
          ...1 ....      SPFINITP       X'10' SPFINITP INDICATE INIT
                                        PROCESSING NEEDED
          .... 1...      SPFSRCID       X'08' SPFSRCID Diagnose X'F8'
                                        originating node and and userid
                                        are stored in the first SPMBK of
                                        the file
00A8  168 Bitstring    2 SPFCCW         Max CCW data length in file
00AA  170 Signed       2 SPFFCBLN       MAX LOAD FCB CCW LENGTH
00AC  172 Bitstring    1 SPFSTATS       SPOOL FILE STATUS FLAG
          1... ....      SPFINEL        X'80' SPFINEL File is ineligible
                                        due to MAC failure
          ...1 ....      SPFNOSEL       X'10' SPFNOSEL File could not be
                                        opened by *SPL
00AD  173 Bitstring    1 SPFGFLAG       General flags
          1... ....      SPFRDEOF       X'80' SPFRDEOF File has been read
                                        to EOF
          .1.. ....      SPFTSUSE       X'40' SPFTSUSE File is
                                        temporarily in use by the system
                                        for CHANGE/TRANSFER system to
                                        close a new file
          ..1. ....      SPFNOESM       X'20' SPFNOESM File is excluded
                                        from ESM checking
          ...1 ....      SPFCLDST       X'10' SPFCLDST Monitor CLOSE DIST
                                        when SPOOL CONT
          .... 1...      SPFIMFCB       X'08' SPFIMFCB Spool file has
                                        imbedded Load FCB CCWs
          .... .1..      SPFRESVP       X'04' SPFRESVP File on 'reserved'
                                        purge queue
          .... ..1.      SPFCLSDP       X'02' SPFCLSDP FILE has not
                                        completed processing on
                                        originator. Delay purging
00AE  174 Bitstring    2 *              Reserved for IBM use
00B0  176 Character    8 SPFSCLAB       SECLABEL OF THE SPOOL FILE
00B8  184 Character    8 SPFXFEE        User identification of previous
                                        file owner
          000000C0       SPFEND         * End of SPFBK - size in bytes
      SPFBK IS IMBEDDED IN SPMBK. IT MAY NOT EXCEED 24 DWORDS.
          00000018       SPFSIZE        (*-SPFBK+7)/8 SIZE IN DOUBLE
                                        WORDS
        Sizing for main storage
        The following fields are defined for the in-storage
        SPFBK's only, and are not saved in the SPMBK when the
        SPFBK is checkpointed.
00C0  192 Signed       4 SPFSPABK       Address of SPABK (not saved in
                                        SPMBK)
00C4  196 Signed       4 SPFRESVC       Reserved count - the file
                                        definition in main storage and
                                        the file data on DASD cannot be
                                        deleted until this count goes to
                                        zero. Used by SPXTAPE to insure
                                        valid SPFBK addresses until
                                        command completes
          00000019       SPFDSIZE       (*-SPFBK+7)/8 Double word size
                                        for GETST
        Redefinitions
002C   44 Bitstring    2 SPFCYL         Cylinder of 1st SFPAGMAP for DUMP
002E   46 Bitstring    1 *              Page of 1st SFPAGMAP for DUMP
002F   47 Bitstring    1 SPFVOLIX       Volume of 1st SFPAGMAP for DUMP
        Verify inter-related fields have been kept in synch.
        Note also that these values must also match the
        flags defined in the VSPBK for the VSPQFLG field.

 

SPFBK Storage Layout

          
*** SPFBK - SPOOL FILE DESCRIPTOR (OR CONTROL) BLOCK
*
*     +---------------------------+---------------------------+
*   0 |         SPFFPNT           |         SPFBPNT           |
*     +---------------------------+---------------------------+
*   8 |          SPFPNT           |         SPFSYSID          |
*     +------+------+------+------+------+------+------+------+
*  10 |:STAT |:FLAG |:TYPE |:QUEUE|:OVER |:SYSTY|:PRTFL|:SPCL |
*     +------+------+------+------+------+------+------+------+
*  18 |:COPY |:STCPY|:PGCPY|:MODNO|:FLSHC|:DVTYP|:PGLEN|:PSFF |
*     +------+------+------+------+------+------+------+------+
*  20 |  SPFSPID    |   SPFDEV    |  SPFPCNT    |  SPFLRECL   |
*     +-------------+-------------+-------------+-------------+
*  28 |         SPFRCNT           |         SPFSTART          |
*     +---------------------------+---------------------------+
*  30 |                       SPFCLKOP                        |
*     +---------------------------+---------------------------+
*  38 |         SPFCLKCL          |         SPFFLASH          |
*     +---------------------------+---------------------------+
*  40 |                       SPFUSER                         |
*     +-------------------------------------------------------+
*  48 |                       SPFDIST                         |
*     +-------------------------------------------------------+
*  50 |                       SPFORIG                         |
*     +-------------------------------------------------------+
*  58 |                       SPFFINAM                        |
*     +-------------------------------------------------------+
*  60 |                       SPFFITYP                        |
*     +-------------------------------------------------------+
*  68 |                       SPFUFORM                        |
*     +-------------------------------------------------------+
*  70 |                       SPFOFORM                        |
*     +---------------------------+---------------------------+
*  78 |         SPFCHAR0          |         SPFCHAR1          |
*     +---------------------------+---------------------------+
*  80 |         SPFCHAR2          |         SPFCHAR3          |
*     +---------------------------+---------------------------+
*  88
*
*** SPFBK - SPOOL FILE DESCRIPTOR (OR CONTROL) BLOCK
          
*** Overlay for SPFOFORM in SPFBK
*
*     +-------------------------------------------------------+
*  70 |                                                       |
*     =                       SPFSHA1S                        =
*     |                           +---------------------------+
*  80 |                           |///////////////////////////|
*     +---------------------------+---------------------------+
*  88 |          SPFFCB           |         SPFCMOD           |
*     +---------------------------+---------------------------+
*  90 |                       SPFDEST                         |
*     +---------------------------+---------------------------+
*  98 |         SPFDPCNT          |         SPFXLEN           |
*     +------+------+------+------+-------------+------+------+
*  A0 |:SYQIX|:ORGIX|:SHPST|:BBITS|  SPFOSPID   |:CVTAT|:SHTDN|
*     +------+------+------+------+------+------+------+------+
*  A8 |   SPFCCW    |  SPFFCBLN   |:STATS|:GFLAG|/////////////|
*     +-------------+-------------+------+------+-------------+
*  B0 |                       SPFSCLAB                        |
*     +-------------------------------------------------------+
*  B8 |                       SPFXFEE                         |
*     +---------------------------+---------------------------+
*  C0 |         SPFSPABK          |         SPFRESVC          |
*     +---------------------------+---------------------------+
*  C8
*
*** Overlay for SPFOFORM in SPFBK
          
*** Overlay for SPFSTART in SPFBK
*
*                                 +-------------+------+------+
*  28 ...                      2C |   SPFCYL    |//////|:VOLIX|
*                                 +-------------+------+------+
*  30
*
*** Overlay for SPFSTART in SPFBK

 

SPFBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SPFALLQ        0013 FF
SPFANY         0016 40
SPFBBITS       00A3
SPFBEG         0016 80
SPFBKEOF       0011 02
SPFBKWD        0011 20
SPFBLANK       0090 0000005C
SPFBPNT        0004
SPFBTS         001F 10
SPFCCW         00A8
SPFCFLDS       0038 0000003C
SPFCHARS       0078
SPFCHAR0       0078
SPFCHAR1       007C
SPFCHAR2       0080
SPFCHAR3       0084
SPFCLDST       00AD 10
SPFCLKCL       0038
SPFCLKOP       0030
SPFCLSDP       00AD 02
SPFCMOD        008C
SPFCMPRS       001F 01
SPFCOPY        0018
SPFCPDMP       0015 80
SPFCVING       001F 80
SPFCVTAT       00A6
SPFCVTD        001F 40
SPFCVTDX       001F 20
SPFCWQ         00A2 10
SPFCYL         002C
SPFDATA        0013 1F
SPFDELX        00A2 02
SPFDEST        0090
SPFDEV         0022
SPFDIST        0048
SPFDLPRG       001F 04
SPFDPCNT       0098
SPFDPOS        0011 01
SPFDPRD        001F 02
SPFDSIZE       00C4 00000019
SPFDVTYP       001D
SPFEND         00B8 000000C0
SPFEOF         0011 40
SPFERRPU       0010 02
SPFFCB         0088
SPFFCBLN       00AA
SPFFCBXT       00A2 01
SPFFINAM       0058
SPFFITYP       0060
SPFFLAG        0011
SPFFLALL       0016 08
SPFFLASH       003C
SPFFLNEM       0016 10
SPFFLSHC       001C
SPFFPNT        0000
SPFFWD         0011 10
SPFFXAB        0016 02
SPFGFLAG       00AD
SPFIGNRH       0014 01
SPFIGNRK       0014 02
SPFIMFCB       00AD 08
SPFIMGQ        0013 08
SPFINEL        00AC 80
SPFINITP       00A7 10
SPFINUSE       0010 80
SPFKEEP        0010 08
SPFLCLOK       00A2 40
SPFLDCHR       0016 20
SPFLENQ        00A2 08
SPFLOKED       00A2 80
SPFLRECL       0026
SPFMODNO       001B
SPFMSG         0010 04
SPFNLSQ        0013 01
SPFNOESM       00AD 20
SPFNONXT       0015 08
SPFNOPUR       0014 04
SPFNORTN       0015 04
SPFNOSEL       00AC 10
SPFNSSQ        0013 10
SPFOCON        0012 20
SPFOFORM       0070
SPFOPEN        0010 40
SPFOPRQ        0014 20
SPFOPRT        0012 22
SPFOPUN        0012 40
SPFOPUQ        0014 40
SPFORDD        001F 08
SPFORDQ        0014 80
SPFORDR        0012 80
SPFORGIX       00A1
SPFORIG        0050
SPFOSPID       00A4
SPFOSYS        0012 10
SPFOVER        0014
SPFO383        0012 23
SPFPCNT        0024
SPFPGCPY       001A
SPFPGLEN       001E
SPFPNT         0008
SPFPPEND       0015 20
SPFPRTFL       0016
SPFPRTQ        0013 20
SPFPSFF        001F
SPFPUNQ        0013 40
SPFPURGE       0011 80
SPFQLOKD       00A2 04
SPFQPRT        00A7 20
SPFQPUN        00A7 40
SPFQRDR        00A7 80
SPFQUEUE       0013
SPFRCNT        0028
SPFRDEOF       00AD 80
SPFRDRQ        0013 80
SPFRESVC       00C4
SPFRESVP       00AD 04
SPFSCLAB       00B0
SPFSECUR       0015 01
SPFSEEN        0011 08
SPFSETHO       0014 08
SPFSFTDP       0015 02
SPFSHA1S       0070
SPFSHOLD       0010 10
SPFSHPPS       00A0
SPFSHPST       00A2
SPFSHTDN       00A7
SPFSIGOP       00A2 20
SPFSIZE        00B8 00000018
SPFSPABK       00C0
SPFSPCL        0017
SPFSPID        0020
SPFSRCID       00A7 08
SPFSTART       002C
SPFSTAT        0010
SPFSTATS       00AC
SPFSTCPY       0019
SPFSTD         0013 E0
SPFSYQIX       00A0
SPFSYSID       000C
SPFSYSTY       0015
SPFTAGM        0011 04
SPFTRFQ        0013 04
SPFTSUSE       00AD 40
SPFTYPE        0012
SPFUCRQ        0013 02
SPFUFORM       0068
SPFUHOLD       0010 20
SPFUSER        0040
SPFVMDMP       0015 40
SPFVOLAF       0015 10
SPFVOLIX       002F
SPFXFEE        00B8
SPFXFER        0016 01
SPFXLEN        009C
SPF5ACCW       0016 04
TYPAFP1        001D 27
TYPALIAS       001D 03
TYPBSC         001D 88
TYPCLUST       001D 30
TYPCONS        001D 40
TYPCTCA        001D 80
TYPDYNIO       001D 02
TYPELAN        001D 28
TYPFBA         001D 28
TYPFCP         001D 10
TYPHDLC        001D 24
TYPIBM1        001D 10
TYPIC          001D 02
TYPILAN        001D 28
TYPMSGF        001D 01
TYPOSA         001D 20
TYPPRT         001D 20
TYPPUN         001D 40
TYPRDR         001D 80
TYPSDLC        001D 08
TYPSYS         001D 10
TYPTELE2       001D 20
TYPTTY         001D 20
TYPUNDEF       001D 1C
TYPUNSUP       001D 01
TYPVAFP        001D 2A
TYP1050        001D 14
TYP1052        001D 40
TYP1403        001D 21
TYP2032        001D 20
TYP2250        001D 04
TYP2305        001D 08
TYP2501        001D 81
TYP2540P       001D 42
TYP2540R       001D 82
TYP2700        001D 80
TYP2741        001D 18
TYP3088        001D 80
TYP3178        001D 40
TYP3179        001D 40
TYP3180        001D 40
TYP3190        001D 40
TYP32XX        001D 22
TYP3203        001D 26
TYP3211        001D 22
TYP3215        001D 40
TYP3250        001D 04
TYP3262        001D 23
TYP3270        001D 40
TYP3271        001D 20
TYP3275        001D 10
TYP3277        001D 80
TYP3278        001D 40
TYP3279        001D 40
TYP3284        001D 08
TYP3286        001D 08
TYP3287        001D 09
TYP3287L       001D 08
TYP3288        001D 08
TYP3289        001D 09
TYP3289L       001D 08
TYP3290        001D 40
TYP3330        001D 40
TYP3340        001D 20
TYP3350        001D 10
TYP3350C       001D 11
TYP3350D       001D 12
TYP3370        001D 02
TYP3375        001D 80
TYP3380        001D 04
TYP3390        001D 82
TYP3420        001D 10
TYP3422        001D 80
TYP3424        001D 42
TYP3430        001D 20
TYP3480        001D 40
TYP3490        001D 81
TYP3505        001D 84
TYP3525        001D 44
TYP3590        001D 83
TYP3704        001D 40
TYP3705        001D 40
TYP3767        001D 18
TYP3800        001D 28
TYP3820        001D 25
TYP3851        001D 02
TYP3890        001D 08
TYP4245        001D 24
TYP4248        001D 29
TYP5080        001D 06
TYP9032        001D 80
TYP9033        001D 40
TYP9332        001D 21
TYP9335        001D 22
TYP9336        001D 24
TYP9345        001D 81
TYP9348        001D 44

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:22:24 EDT.
Copyright IBM Corporation, 1990, 2011