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