| |
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure SPTBK SPTAPE and SPXTAPE 'Spool to Tape'
Command parameters: function and devices
0000 0 Signed 4 SPTV1ST First vdev in range of drives
0004 4 Signed 4 SPTVLAST Last vdev in range
0008 8 Character 4 SPTCMDOP Command option - DUMP, LOAD, SCAN
000C 12 Character 4 SPTCVDV1 First vdev, in character
00000004 SPTSINGL *-SPTCVDV1 Length for single vdev
0010 16 Character 1 SPTCDASH Dash, if range
0011 17 Character 4 SPTCVDV2 Last vdev, in character
00000009 SPTRANGL *-SPTCVDV1 Length for a range of
vdevs
00000015 SPTDEVRL *-SPTV1ST Length for all command
vdev info
0015 21 Character 3 * Reserved
Command statistics
0018 24 Dbl-Word 8 SPTTOD Time command was issued
0020 32 Dbl-Word 8 SPTTMIGO Time I/O started
0028 40 Dbl-Word 8 SPTTMEND Time I/O completed
0030 48 Signed 4 SPTCARTC Cartridge/reel count
0034 52 Signed 4 SPTFILCT Count of files completed for cmd
0038 56 Signed 4 SPTPAGCT Count of DASD spool file pages
003C 60 Signed 4 SPTLINTV Last heartbeat interval
0040 64 Signed 4 SPTSPLOV Count of overhead maps and XABs
0044 68 Signed 4 SPTPGCNT Count of pages sent to tape
File and Task Queues
0048 72 Signed 4 SPTTKTQ Queue of Tkts (files) ready to go
004C 76 Signed 4 SPTTKTQC Count of Tkts requiring DASD serv
and or waiting for other segments
0050 80 Signed 4 SPTTAPQ Queue of tape drive control blks
0054 84 Signed 4 SPTTMQ Q of tape mgrs waiting for work
The SPTTMQ queue is protected by
dispatch lock
0058 88 Signed 4 SPTDASDQ Q of DASD rdrs waiting for pages
The SPTDASDQ queue is protected
by dispatch lock
005C 92 Signed 4 SPTPRIWK DASD rdrs waiting for active file
The SPTPRIWK queue is protected
by dispatch lock
Tasking
0060 96 Signed 4 SPTDTSKS Count of outstanding DASDIO tasks
0064 100 Signed 4 SPTDTSKA Count of active DASDIO tasks
These two values may differ due
to end/cancel/start time delay
0068 104 Signed 4 SPTTTSKS Count of outstanding TAPEIO tasks
If SPTTTSKW=SPTTTSKS and no tkts
or FLSPIDS, then we're done
006C 108 Signed 4 SPTTTSKW Count of waiting TAPEIO tasks
0070 112 Signed 4 SPTMAIN Hold CPEBK to resume SPX mainline
after all the cmd I/O completes
0074 116 Signed 4 SPTDCSLK Count of number of open DCSS that
require the DCSS lock exclusive
0078 120 Signed 4 SPTSDFTK Queue of SDF tkts that have their
symbolic lock locked. There will
be only one lock request locked
for any name, no matter how many
instances of the name are open at
the same time.
Resource Balancing
007C 124 Signed 4 SPTTDCNT Tape drive count
0080 128 Signed 4 SPTDTDRV DASD tasks allocated by tape drv
0084 132 Signed 2 SPTQTCNT Counter for END or CANCEL ...
processing to know when the ...
master processor should be
made... available to other tasks
0086 134 Signed 2 * Reserved
0088 136 Signed 4 SPTPLMAX Maximum page count available
008C 140 Signed 4 SPTPLUSE Pages reserved by SPXTAPE
0090 144 Signed 4 SPTALCWT Count times DASD waiting for pool
0094 148 Signed 4 SPTQMPTY Count times no file avail to tape
0098 152 Signed 4 SPTFILWT Count times tape waiting on file
009C 156 Signed 4 SPTCQUOR Pages in a quorum - even into 960
00A0 160 Signed 4 SPTSQUOR Size of quorum in bytes
00A4 164 Signed 4 SPTSHARE Share of storage allowed
00A8 168 Signed 4 SPTDPOOL Pool pages allocated by tape drv
List of files to dump
00AC 172 Signed 4 SPTFLSPT Address of first FLSPT
00B0 176 Signed 4 SPTCFLS (0) Address/offset of current FLSPT
00B0 176 Signed 4 SPTCLIST Current file list block
00B4 180 Signed 4 SPTCFENT Offset to next file
00B8 184 Signed 4 SPTCFEND Address of last FLSPT entry + 4
00BC 188 Signed 4 SPTFLSPL Address of last FLSPT used for
APPENDing
00C0 192 Signed 4 SPTRSPT Address of related SPTbk that
contains the CMD and selection
parameters. For DUMP it is the
SPTbk that the top FLSPIDS were
selected with. For LOAD/SCAN it
is the one that selected the last
file from tape For all cmds, in
the case where disposition is not
APPEND, it will point to this
SPTbk. In the case of subsequent
cmds that add files to the active
list of selected files, it will
point to the pseudo SPTbk that
was used to select the files.
00C4 196 Signed 4 SPTBLKSC Sum of SPFDPCNT for all selected
files
00C8 200 Signed 4 SPTRSPTC Count of files chosen for dump
due to the selection criteria in
this SPTBK (TKT Count). It is
incremented when a file is added
to the FLSPT. It is usually
decremented at EOV processing
when a file's TKTBK is freed.
When decremented to zero the
pseudo SPTBK will be freed.
00CC 204 Signed 4 SPTLPSPT Head of queue of pseudo SPTbks
that are used by LOAD/SCAN for
selecting files from tapes. The
selection criteria in the main
SPTBK and all the pseudo SPTbks
on this queue are checked against
all files.
00D0 208 Signed 4 SPTDUSPT Pointer to SPT used in selecting
queue to check files for NODUP
Command Summary Log VDEV address
00D4 212 Signed 4 SPTLOGVD Vdev for LOG pseudo output cons
Console output lock
00D8 216 Dbl-Word 8 SPTCONLK (3) Keep multi-line output together
This cmd only - others interfere
Get_A_File lock
00F0 240 Dbl-Word 8 SPTGTFLK (3) Lock held exclusive while a file
is chosen from the FLSPT and held
until dumping begins
Interval between Progress Reports (Heartbeats)
0108 264 Signed 4 SPTRPINT Prog Report Interval (in seconds)
Dynamically calculated maximum number of system virtual
pages to which SPXTAPE will attempt to limit itself.
010C 268 Signed 4 SPTMXSVP Target maximum number of system
virtual pages for spool files not
associated with active tape write
tasks. When processing those
kinds of spool files, we will add
(512 * SPTTDCNT) to this value.
Some reserved fields
0110 272 Signed 4 * Reserved for future IBM use
0114 276 Signed 4 * Reserved for future IBM use
0118 280 Bitstring 3 * Reserved for future IBM use
011B 283 Bitstring 1 SPTSSEG Saved Segment/System flag
1... .... SPTLDOK X'80' SPTLDOK NSS/DCSS was loaded
via the System VMDBK
.1.. .... SPTVMGRP X'40' SPTVMGRP NSS is part of a
VMGROUP
..1. .... SPTSPTQ X'20' SPTSPTQ SNTBK is on the
SPTape SNTBK Q
011C 284 Bitstring 1 SPTCFLG Compaction Flags
1... .... SPTCOMP X'80' SPTCOMP Compaction mode
.1.. .... SPTNOCMP X'40' SPTNOCMP Non-compaction
mode
011D 285 Bitstring 1 SPTAFLG ACTION FLAGS
1... .... SPTDUMP X'80' SPTDUMP PROCESSING SPTAPE
DUMP COMMAND
.1.. .... SPTLOAD X'40' SPTLOAD PROCESSING SPTAPE
LOAD COMMAND
..1. .... SPTSCAN X'20' SPTSCAN PROCESSING SPTAPE
SCAN COMMAND
...1 .... SPTCOPY X'10' SPTCOPY ALLOW COPY FILES
(OF ORIGINALS OWNED BY ANOTHER
SYSTEM IN THIS CSE COMPLEX) TO BE
DUMPED
.... 1... SPTDONE X'08' SPTDONE DONE PROCESSING
SPTAPE LOAD SPID
.... .1.. SPTAUDIT X'04' SPTAUDIT Process RACF Audit
requests
.... ..1. SPTDFWK X'02' SPTDFWK VMDDFRWK was
incremented to prevent user from
logging off
.... ...1 SPTSPX X'01' SPTSPX Processing an
SPXTAPE command
011E 286 Bitstring 1 SPTQUEUE QUEUE FLAGS
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
011F 287 Bitstring 1 SPTOFLG OPERATION FLAGS
1... .... SPTSTOP X'80' SPTSTOP STOP PROCESSING
1... .... SPTEND X'80' SPTEND END request-STOP but
for SPXTPE
.1.. .... SPTCAN X'40' SPTCAN CANCEL PROCESSING
..1. .... SPTPUR X'20' SPTPUR PURGE FILES AFTER
DUMPING THEM TO TAPE
...1 .... SPTLEAVE X'10' SPTLEAVE LEAVE UPON
COMPLETION WITHOUT POSITIONING
TAPE
.... 1... SPTRUN X'08' SPTRUN REWIND AND UNLOAD
TAPE UPON COMPLETION
.... .1.. SPTREW X'04' SPTREW REWIND TAPE UPON
COMPLETION
.... ..1. SPTSTPED X'02' SPTSTPED SPTAPE STOPPING
HAS BEGUN
.... ...1 SPTCANED X'01' SPTCANED SPTAPE CANCELLING
HAS BEGUN
.... ...1 SPTAPPND X'01' SPTAPPND SPXTAPE in APPEND
disposition SPTCANED is not used
by SPXTAPE
0120 288 Bitstring 1 SPTPFLG PROCESSING FLAGS
1... .... SPTPCLAS X'80' SPTPCLAS SPOOL FILES ARE TO
BE PROCESSED BY CLASS
.1.. .... SPTPFORM X'40' SPTPFORM SPOOL FILES ARE TO
BE PROCESSED BY FORM
..1. .... SPTPSPID X'20' SPTPSPID SPOOL FILES ARE TO
BE PROCESSED BY SPOOL ID
...1 .... SPTPUID X'10' SPTPUID SPOOL FILES ARE TO
BE PROCESSED BY USERID
.... 1... SPTPUHLD X'08' SPTPUHLD USERHOLD FILES ARE
TO BE PROCESSED
.... .1.. SPTPSHLD X'04' SPTPSHLD SYSTEM HOLD FILES
ARE TO BE PROCESSED
.... ..1. SPTPNOH X'02' SPTPNOH NOHOLD FILES ARE TO
BE PROCESSED
.... 111. SPTPXHLD SPTPUHLD+SPTPSHLD+SPTPNOH
SPTPXHLD Any hold status
.... ...1 SPTPDEST X'01' SPTPDEST Spool files are to
be processed by DESTination value
0121 289 Bitstring 1 SPTTFLG TAPE MODE FLAG
1... .... SPT800 X'80' SPT800 USE MODE 800 BPI FOR
SPTAPE DUMP
.1.. .... SPT1600 X'40' SPT1600 USE MODE 1600 BPI
FOR DUMP
..1. .... SPT6250 X'20' SPT6250 USE MODE 6250 BPI
FOR DUMP
...1 .... SPT38K X'10' SPT38K USE MODE 38K BPI FOR
DUMP TO 3480 TAPE SUBSYSTEM
DEVICE
.... 1... SPTXF X'08' SPTXF Use Mode XF for Dump
to 3480 with Data Compaction and
Auto-Blocking feature
.... .1.. SPT3490B X'04' SPT3490B Use Mode 3490B for
Dump to 3490 in basic mode
.... ..1. SPT3490C X'02' SPT3490C Use Mode 3490C for
Dump to 3490 in 3490 Data
Compaction mode
0122 290 Bitstring 1 SPTRESOR RESOURCE ALLOCATION FLAGS
1... .... SPTSDFRS X'80' SPTSDFRS Set if an SDF is
reserved for SPTAPE
.1.. .... SPTDPGLK X'40' SPTDPGLK SET IF A SPDBK HAS
BEEN LOCKED
..1. .... SPTSDLBK X'20' SPTSDLBK SET IF AN SDLBK IS
BEING USED
.... 1... SPTOFILE X'08' SPTOFILE SET IF A SPOOL
FILE IS OPEN
.... .1.. SPTSPFBK X'04' SPTSPFBK SET IF AN SPFBK IS
BEING USED
.... ..1. SPTFRM X'02' SPTFRM SET IF A TRANSLATION
FRAME IS BEING USED.
.... ...1 SPTWRTTN X'01' SPTWRTTN Data has been
written to the tape for this file
0123 291 Bitstring 1 SPTMFLG MISCELLANEOUS FLAGS
1... .... SPTINUSE X'80' SPTINUSE THE 'INUSE' STATUS
OF THE SDF BEING DUMPED
.1.. .... SPTCSTOP X'40' SPTCSTOP SET IF SPTAPE
PROCESSING CAN BE STOPPED
..1. .... SPTURSTD X'20' SPTURSTD IF THE SPTAPE USER
IS A CLASS E AND NOT CLASS D USER
...1 .... SPTVMXA X'10' SPTVMXA THE FILE BEING
PROCESSED WAS DUMPED BY A VM/XA
SPTAPE DUMP
...1 .... SPTSPID2 X'10' SPTSPID2 Remember that SPID
was specified SPTVMXA is not used
by SPXTAPE
.... 1... SPT1PRO X'08' SPT1PRO TO INDICATE AT
LEAST ONE FILE HAS BEEN
PROCESSED.
.... 1... SPTALL2 X'08' SPTALL2 Remember that ALL
was specified SPT1PRO is not used
by SPXTAPE
.... .1.. SPTFORM2 X'04' SPTFORM2 REMEMBER THAT FORM
WAS SPECIFIED (EVEN IF ONLY FORM
*)
.... ..1. SPTCLAS2 X'02' SPTCLAS2 REMEMBER THAT
CLASS WAS SPECIFIED (EVEN IF ONLY
CL * )
.... ...1 SPTDEST2 X'01' SPTDEST2 Remember that DEST
was specified
0124 292 Bitstring 1 SPTXFLG Flags for extended version
1... .... SPTMULTD X'80' SPTMULTD Mult drives
assigned, for msgs
..1. .... SPTCMEND X'20' SPTCMEND LOAD command
complete
.1.. .... SPTACTIV X'40' SPTACTIV SPXTAPE active.
Used to differentiate on Cmd
errors if devices or files were
added to an active SPTBK or not
...1 .... SPTABORT X'10' SPTABORT Command aborted
for internal reasons-e.g. out of
spool space
.... 1... SPTSOMER X'08' SPTSOMER Some file had an
error of some kind recorded in
the log for at least one volume
.... .1.. SPTNODUP X'04' SPTNODUP If on, do not
LOAD/SCAN any file that would
duplicate a file already on the
system.
.... ..1. SPTPRVOK X'02' SPTPRVOK Privilege class
for cmd is OK
.... ...1 SPTRPI X'01' SPTRPI Prog Report Interval
specified
0125 293 Bitstring 1 * Reserved for future IBM use
SPXTAPE command line
0126 294 Signed 2 SPTCMDL Length of cmd txt
0128 296 Character 1 SPTCMD (132) Save copy of original cmd line
00000084 SPTCMLEN *-SPTCMD Length saved
SPTAPE only fields
01AC 428 Address 4 SPTXFRM ADDRESS OF THE FRAME FOR SPOOL
FILE BLOCK TRANSLATIONS
01B0 432 Address 4 SPTSDL ADDRESS OF THE SDLBK FOR LOADS
01B4 436 Signed 4 * Reserved
01B8 440 Character 8 SPTSDFNM FILENAME OF THE LOCKED SDF
01C0 448 Dbl-Word 8 SPTTODLD SAVE DUMP TOD FOR LOAD
01C8 456 Character 8 SPTUSER USERID OF SPTAPE COMMAND ISSUER
01D0 464 Character 8 SPTFORM FORM NUMBER OF REQUESTED FILES
01D8 472 Character 8 SPTUID USERID OF THE FILE OWNER WHOSE
FILES ARE TO BE PROCESSED
01E0 480 Character 8 SPTCLASS USER SELECTED CLASSES
01E8 488 Dbl-Word 8 SPTDEST DEST selected to be dumped
01F0 496 Signed 2 SPTFSPID STARTING SPID IF SPID RANGE
01F2 498 Signed 2 SPTLSPID ENDING SPID IF SPID RANGE
01F4 500 Character 8 SPTFN File name pattern for selection
with wild cards
01FC 508 Character 8 SPTFT File type pattern for selection
with wild cards
0204 516 Character 4 SPTDVNUM REAL NUMBER OF TAPE DRIVE IN HEX
0208 520 Dbl-Word 8 SPTRESP (8) ROOM TO BUILD SPTAPE RESPONSES
0248 584 Dbl-Word 8 SPTWRK (12) WORK SPACE FOR SPTAPE MODULES
000002A8 SPTRSPE * End of area to be remapped
02A8 680 Address 4 SPTIORBK ADDRESS OF IORBK IN USE
02AC 684 Address 4 SPTSHRBK SHRBK address of NSS/DCSS that is
being dumped.
SPXTAPE Remap of SPTRESP and SPTWRK
000002B0 SPTBEND * End of current SPTBK
0208 520 Signed 2 SPTRSPAL Length of response
020A 522 Character 158 SPTRSPA Response message area
SPXTAPE Response Codes
00000000 SPTHEART 0 Heartbeat *
00000004 SPTEOTAP 4 End-of-tape response *
00000008 SPTEOVDV 8 Device complete *
0000000C SPTEOCMD 12 Command complete *
00000010 SPTSINT 16 Command initiated *
00000014 SPTWAIT 20 Command Waiting *
SPXTAPE Log Message Codes
00000000 SPTLOGHD 0 TAP Logfile open and header
00000004 SPTLOGFI 4 Logfile file entry
00000008 SPTLOGCL 8 Logfile close
0000000C SPTLOGMS 12 Logfile insert arb message
00000010 SPTLOGOC 16 Command Summary Logfile open
and write header
00000014 SPTLOGCM 20 Log cmd in Summary log
SPXTAPE Console Message Codes - keep in sync w HCPSPKMS.
Messages with no substitution data can be added without
any further changes
Messages which need substitution data processing must
reserve a 'processing code' number with HCPSPKMS to
identify the routine.
00000000 SPTMNSUB 0 No message sub - just msg# in
R0
00000004 SPTMINV 4 0003.01 - invalid option
00000008 SPTMISPI 8 0008.01 - invalid spoolid
0000000C SPTMRANG 12 0009.01 - invalid range
00000010 SPTMSUB 16 Message sub, msg# R0 subdata
R1
00000014 SPTMNSUP 20 1903.01 - vdev not supported
00000018 SPTMFINV 24 1836.02 - function invalid
0000001C SPTMBDEV 28 1901.01 - vdev invalid
00000020 SPTMNCNF 32 1902.01 - vdev not in config
00000024 SPTMNACT 36 1904.01 - not active w SPXTAPE
00000028 SPTMTIO 40 1838.01 - tape read I/O error
0000002C SPTMFERR 44 various - hold set on file
00000030 SPTMBADF 48 1840.01 - can't read ctl info
00000034 SPTMRDXR 52 1841.01 - can't read XAB's
00000038 SPTMRDER 56 1842.01 - can't read data
pages
0000003C SPTMASGN 60 1909.01 - Assigned to userid
00000040 SPTMTWER 64 1844.01 - tape write error
00000044 SPTMUCAN 68 1845.01 - User canceld device
00000048 SPTMICMD 72 1905.01 - Conflicting commands
0000004C SPTMBTAP 76 1847.01 - Incorrect rec on
tape
00000050 SPTMNOSP 80 1845.01 - No spool
space..cancel
00000054 SPTMDCAN 84 1850.01 - vdev
CANCELed/Detached
00000058 SPTMXTRA 88 0003.02 - Extra options
0000005C SPTMIRNG 92 0009.01 - invalid spid range
00000060 SPTMCNOP 96 0013.01 - Conflicting option
00000064 SPTMISDR 100 Msg sub of drive
00000068 SPTMINOP 104 1013.xx - Invalid operand
0000006C SPTMRODV 108 1014.01 - Dump to R/O device
00000070 SPTMCONF 112 1915.01 - Conflict w/ active
cmd
00000074 SPTMFSKP 116 1916.01 - Log that file
skipped
00000078 SPTMSHRD 120 1917.01 - Multiuser dev
attached
0000007C SPTMSENC 124 1917.02 - Mix of encryption
End of the SPTBK
00000056 SPTSIZE (*-SPTBK+7)/8 SPTBK SIZE IN
DOUBLEWORDS
| |