Appendix I. Use of the UPSI Statement to Override the End-of-File Record
Appendix 1. Processing Multi-Volume Files on Disk
To process multi-volume files on disk# at least two disk packs with different volume serial numbers are needed. The maximum number of disk packs is not limited. Since the file-to-file utility programs process only sequential disk files, the disk packs may be processed on-line (disk packs are mounted simultaneously on different disk drives and processed one after the other) or off-line (after a disk pack has been processed a halt occurs, the old pack is removed, and the new one is mounted on the same drive), or both on-line and off-line.
As a rule# off-line processing is not possible with the disk drive to which the symbolic device address SYSRES has been assigned, since the utility program needs the label information stored on SYSRES via the job-control program.
If you want to process multi-volume files on one disk drive, the label informa-tion on each disk pack has to be identical.
The job can be run by means of the card-resident system; if you use the
disk-resident system, at least the first and the last disk pack must be a system disk pack.
Whenever you want to process multi-volume files, you only have to provide the label information via XTENT statements supplied with the job-control statements
(See Appendix A).
On-line processing
Figure 47 shows several examples of how to prepare the job-control statements for multi-volume processing when using four disk drives on-line. The first job
(CLRDSK) clears the tracks of four disk packs with the volume serial numbers PAYRL1 through PAYRL4 (as specified in the XTENT statements). Only the volume serial number of the first volume to be processed has to be s·tated in the DLAB statement, since the volume sequence number will automatically be increased by the utility program when the disk packs are changed.
With the second job (CARDSK) first all specified extents on SYSOPT (disk drive 1) are filled with data# then those on SYS002 (disk drive 2), and so on until all data is stored on disk or the specified extents are completely filled.
The third job (DSKDSK) transfers data on four disk packs to different extents on the same packs. Here again data is processed in the sequence of the specified XTENT st.atements.
The symbolic device addresses
SYS002-SYS004 need only be assigned if the disk drives are actually being used.
However, i t is not possible to have an extent on SYS004 without having assigned SYS002 and SYS003 to disk drives. The same applies to SYS005-SYS007 if the DSKDSK program is used. You can process the disk packs in any order, i.e.# you may specify an extent on the disk pack mounted on SYS003 and afterwards another on SYSOPT or SYSIPT, respectively.
Off-line processing
If i t is necessary to process a multi-volume multi-volume, sequentially organized file consisting of more disk packs than disk drives are attached to the system, the disk packs must be changed during processing.
Figure 48 gives an example of how to fill in the job-control statements for this problem. Here only one disk drive is necessary; each time the program reaches the end of all extents of the appropriate disk pack i t tries to open the extents on the next disk pack of the same drive.
Since the volume serial number does not agree, the program comes to a halt indicat-ing that the volume serial number does not match with the volume serial number speci-fied in the appropriate XTENT statement.
Now the next volume can be mounted on the disk drive and the job will be continued.
Figure 47. On-line CLRDSK Processing (Part 1 of 3)
Appendix J. processing Multi-Volume Files on Disk • 91
I 2 3 4 5 , 7 • , 10 II 12 13 14 15 " 17 II 19» 2122 2324 2526 2721 :lflO 3132 3334 3536 3731 39<10 4142 4344 4546 47. 49150 51 52 5354 5556 51. ".0 6162 6364 65"
..,.
"70 71 n 13 74 7576 7771 7910I I JOB C,A RD S~ CoR EA TE A IHU ILIT I · YO JIM E-. IF I I.E OIN D1 Is K loIN - L INE I I AS SGN 5~ 50 PT X I le~ i I DI~ PQ 1M AA~ Olu
rrp
UT UN lIlT SI:4 Iso PT ill I15K
DR tv E11
, I Als SGN S~
S. 1.12-
X Iali
l21 DiSAL
TieRN
ATE OIU Tip UT UN II tr !~I\I ~~ ~n ~I ISK Dill I V E 2.I I AS .SGN Sy 516
1'19
X,s.
~, ~I~ ~L TIE AN A7 Eou
IrP UT UN II h' sl~ ~It) 1~3toI
ISIt< DIR I V E 9I I ~Ic; ~GN ,. u ~ ... 1"4
x' 8i
~ 1 tD.9 IAIL 1- TE OU Tip IUT UN 11 tT sl~ lsi. IdliltnI
SK DR II v E 4, I V olL b'Y SO PIT UO UT IF I ll~ t.lIA ll~ UO IUT
I I DL IAe ' p A~ IRO LI- f1 I.E 1 9 Ibe 1 p AY RL i I X
1ft 1/1 ~ 1 G9 311) tb El9 3~5 I .. I ....
... '
I I XT ENT !
11&'
1 1~11b & It;,.111
til1/66 1'114 61.l9
'p Aly RL 1 I sl~ Iso PT I I XT ENT 1 I •• 21. lib Itt 9 1•••
tb16
i I.t .16~ I p Aly RIL if ) 151~ Islo PTI I XT EINT 1
••
13 Itt. 65••
tb ~tb" "
.Iltlg lip AI:i ~L '2' ISY sid62
I I XT EHT !
••
14lib.
9tb$"
~ ltb 1162. 16ltbl9
I p A!J RL 2 \ 151~ 51i fl1I I XT ENT 1 • lb. Is I~tb &S (bdJ
•
Itt tb " I., ifill 1:1 .• _ .... I" 'P A~R 3 I IsI~51, .j
I I l\.T leNT 1 •• 6 .... Itt 1 IdlI2 tbltb 19 ' P A~ IIH ,3 \ !slY 51/6 IJ9 III I I XT )(T 'ENT ENT 1 j 'Ib; ~~8 '1 Ilbi6 ... 65 ...
.i' ...
lib • I~ i I .. " '1'4 .ltb9 ... I- 'Ip ) P AH~ AY RL Iii' 'I' slY 5~ 51. sllfJdill
164I I EX EC
I I
uc.
D TR FF As ( 8 Itt 18~) Is & ( Ie"
l'216fJ
I I END
r"
-1 2 3 4 5 6 7 • , -10 II -12 -13 -14 -15 " -17-1. 19» 21 22 2324 2526 273 ~lO 3132 3334 3536 3731 39<10 4142 4344 4546 47. 4950 5152 5354 5556 51. ~.o 6162 63[64 65"
..,. "70
71 n 173 74 75 76 7771 179 10Figure 47. On-line CARDSK Processing (Part 2 of 3)
12 3 4 5 , 7 I , 10 11 121 314 151 617 111920 21 22 2324 2526 2721 2930 3132 3334 3536 3731 3940 4142 4344 4546 47.
• Iso
5152 5354 5554 57. 59.0 '162 4344 IS"
'"'
.. lI» 7172 73 74 7S 7' 7771 "10I I
IJ
OB DS KD 5KC.O
pyA
IJ.lULrr
I - VO LU ME -I~ I l E- ON IDI 51( ON -L I HEI I lAS SGN S~ 51 prr )( 1 Ai 11 I D3 PR rlH A'L'4 IN PUT UN IT Sly Is I pIT IDl 15K ,DR I v!~ 1 I I lAS SGIN 5 ". ... I"'i .. X 1 B/I) 12' [),g IA'l T lIN PUT UN lIT .\.'.\.2
!Dr
IslK ,DI2 1 V,E 2I I 'A& SGIN S~ S. I.~ 'lIB 3 I 1D~ ~IL It:K ~TE IN PUT UN
lIT
II!! I ... .. In ~1 SK :DR IVE 3 ...I I
AS
IS(;IN SY sib 11b~ )( I Bf) 4' D3 IA TIE ,AN AITIE 1 N PUT UN ItT Siv Ie. It /filII Dr SK DR IVE"
-I -I AS S t;IN &~ S OPT )( 1
8"
t I lDs PR 11M 'A ~ [OIJ TP UT ,UN IIIT
«:.1\1 1r.1'\ :J:lT IDJ SIK !DR t ViE 1I I AS SGN S XIS 2 I J)~ AL 7E RN ATE 10 IJ TP UT UN IT sl~
s.
!dl5 IDr SK IDQ r viE 12I I AS ISGN .s~
s eo x \ e
31 lDIlAL
TE RN 'AT!E OU TPur
UN ItT sl:iSI" 1.&
"II SK DR r viE' l].-I .-I AS ISGN ~:l &
li
7 XIS " I ~3 AL. Ire IJ:lNATe
Ou TP UT UN IT 5Y51. 1.7
"1 ,5K tnA lVE IIII I VOl. SlY 51 PT It IN ,FII LE INA HIe: U J N
II , 2H
lAlf3
I c~ ~~ RIOlJ. L IFr L,E 1,961e
tip A::J RL 1 IIfllm ~f 69 ~,615 'lib dJldJ ,L I
.-I .-I ~T lENT 1 lib 1 li6 5 :dJ
,.7
411& d9 'p IAIY RL 1 I S!I 51 PTI I XT IEiNT 1 i. 2
lib
9I.
fbl0Ij;
21, d9 I pA:Y
IRL 1 I S:1 is I PT I Ix,.
EIN T J. !~:. 3 1~lb5 ~'07
14~ dlQ I p ~I~ IRL12
1 5'js
l6 ttt
I I' XT ~NT '1
1m
4 169Itl
16 1~ 21~ ,~9 Ip IA:~ IRIL 2 ) Sl~ Sit (62 I I I I )CIT ENT XT SN"T 1 1•
dJ i5 16Ilb
dJ9 15 dJI' IdJ
I. 111111,6
I 21m II' VI :i9 I p I:p
IA~ Aly IRL RL I~ I~ I , Sy S~ !5!~si. '3
;3I I
l(rr
ENT 1• &n ""
c.1: 1II"la 1111",,,,.
I";;'Q 'p Al'JR" I
1 .... 1" 1 ... 1 ... .i. 4 I I XT ENT 1 iJ Is!.
- Ie
tie 2.1. 169 I p AI~ RL " I Sl~ Isl~'"
I I .,OL S~ 5 o PIT ~o UT FI LE NA HE luO uh'
II I DL AlB 'P A1RI0 I, ,8 ,Ar I< Ip FI LIE ,ON DJ SK lip ~I!I RL t 1
1.161-
&8"1,
169 1316S,
I ... ,.&. I.&. ,II I XT EN~ 1
'1'1
121>
2dl1/1)19
I p Aj R'I L I 5~ so PTI I XT ENtr 1
•
2 16 ID lIP KPlD I? il1 I? t6 69 I,., A~ IRL It. ) 511s_t
1._5 I I XT EINT J. If) tblg Itt :{ Q(t1m
dJ;1J III~Ib"o
10 A~ IRL l31 S~ stt 1d!1~I I itT IEIMT 1 I. tbu id)l .&. 2." 126 169 I !A.~ IRI' ~ I 5~ ~d 1 • . 1'7 I , EX ~C
, I un In iTc FiF A-
Il
e~ 2.1fJid
)B·
lIB.,
~1 6:611" 1 2 3 4 5 , 7 I 9 10 11 12 13 14 15 16 17 II " 20 21 2223 2425 lENt£> 2627 2129
»
31 3233 3435 3637 3139 40 41 4243 4445 4647 41. 5051 5253 5455 5457 .. 1St .061 6243 4465 ~67 41" lI» 71 72173 7475 7,77 71179 10Figure 47. On-line DSKDSK Processing (Part 3 of 3)
Appendix J. Processing Multi-Volume Files on Disk • 93
I 2 3 • 5 6 7 • 9 10 \I 12 13 I. 15 16 17 ,. \920 2122 23 2. 2526 2721 2930 313:2 333' 3536 3731 39«1 " .2 ~
..
.s .. <17,48 .,SO 51 52 53S. 5556 5151 596O 6162 63" 4566 6168 6910 l1n 73 7. 7576 7778 7980I I JOB TA Pin SK C.Q El/I. TE A MU LT 'I -V 0 LU HE 1='1 LE ON 7 Dl Sl~ PA C'K.~
I I AS SGN Sly SO PT )(. \ B.' 2' ~3
pU
-rll=l UT UN IT sy Iso PT IiI IC,K DR IV E 12 10lF F-LI NE' t I V Oh &~ SO PT WO UT IF! Lie NA HE UO utrI I DL ~8 I p A'Y RO L~ FI LE 19
bl9
lP AY RL 1 I ~ItI!i~ [0 i 6B 31(bo~ 7ib 3165
, ..
;.1". I ... A.'"iP'
I I XT lENT l. ~If>l. I~i~ 65 ~0 b I; 1 ItI! 2-01b9 ' P AY QL 1 I ~~ 50 PT 1 tPtb 2 !Ib'ib &5
mit
tblib {
Itbl2 ,Ib tb 9 I P A~ RiL .2 ' 151~ 510 PT 1 tb~3 'ib If> &5 aJt/J tb Idl1 It/) 2 'ib tb 9 , P 'A~ RL 3' 5:1 50 PT 1 (1) 1.1" ItIJ~ ID5 tbaJ Ib IdH 1~'1. ~. d> 9 IpAi
RL :" I Sl SO PT 1 ~fb l5 'lbd> 65 tblt tb lib 1 lib 2 4>tb9 I p Ay RL 15 I 5~ SO PT 1.eD
:m:ib :1b'1 dd Ii I" ... 1.01.1.-"''''
n I, , P !A ~ RL bl ,15 ~s OPT 1 ,Ib til 7 101d1 id> 9 Ibm tb Idlm '2.ldI lbd 9, Ip AY RL 6 '. 1& y SO PT 1 l{j c} 9 1;lm 25 1~6 dJ Id dJ 35 ~ 4>9 Ip IA~ RL L6 I S~ 50 pr 1 :IP.IP 9 1 . . . , , , 1.1. IdJ1 ~12 tlJlbg \P A:i RL '1 I S !is OPTI I AS SGN S~ SI PT X,
'Ie
l' IT 2 ,)( Ie. 8' p~IM
AR~ IN IpUT uN r T TA P,E DRrVe
I I As 56:N sl~ SIO tb
If
~ \ 178 '2' tT2 X I e. B I AL rE ,;IN IAr E IN PUT Nltr TIA I~IEDR I viE
I I VOL. sly Is I PiT
urN
I I TP LAB IP AY RO LL 1='1 LE ITA pe TA PE :i> i
l.dI
Id> L Icb cbt/J1
Ibdl $1 1411 i6e 31~,~ 69 316 6'( I EX lee
I I
u,
D TC F.F A:. : ( 8 cb 2.1 61~ ) B= Ics
tb '2. 1bliP )
I I E"IND
1 2 3 • 5 6 7 • , 10 11 12 13 ,. 15 \6 17 11 1920 21 22 23~ 2526 2721 2930 313:2 333' 3536 3731 39«1 " .2 ~
..
.s .. <17'-.,so 5152 53S. 5556 5151 5'1.0 61 62 63" 4566 6168 6910 71 n 73" 7576 7778 '79 eoFigure 48. Off-line Processing
Alternate Track Area. An area of three information in System/360. Every byte consists of 8 bits, each having a value of
Data Display. Printed byte-for-byte rep-resentation of a logical record or block. description is printed.
Data Record. See Logical Record.
Default Value. The operand value. assumed by a program when the value is omit·ted from a control statement.
EBCDIC. (Extended Binary Coded Decimal Interchange Code). A specific set of 8-bit codes standard throughout System/360.
GIDssary
Hexadecimal. A character representation for a set of four bits. The values 0-15 are represented by the digits 0-9 and the alphabetic characters A-F.
Input. Data to be processed by a computer program. See also Output.
Inter-Block Gap. A blank space on magnetic tape that separates physical records.
I/O Area. An area (portion) of main (or pri.nt) job-control statements, and identify the requested prog~am phase.
Job-Control Statement. Anyone of the control st.atements in the input stream that identifies a job or defines its require-ments and options.
Label. A physical identification record on magnetic tape or disk.
Logical Record. A record identified from the standpoint of its content, function, and use rather than its physical attri-butes. It is meaningful with respect to the information i t contains. (Contrasted with Physical Record).
Mnemonic. A contraction or abbreviation whose characters are suggestive of the full expression.
Operand. The representation of a value that must be supplied to define a selective function to the program.
Output. The resultant data produced by a computer program. See also Input.
Pack. A storage t.echnique whereby two digits or one digit and sign are stored per byte.
Packed Decimal. See Pack.
Physical Record. A record identified from the standpoint of the manner or form in which i t is stored and retrieved; that is~
one that is meaningful with respect to access. <Contrasted with Logical Record).
Reblock. To change the format of a file so that a different number of logical records comprises one physical record. See Block.
Record. A general term for any unit of data that is distinct from all others when considered in a particular context.
System Disk Pack. The disk pack on which your disk-resident system is stored.
Tapemark. A special symbol that can be read from or written on magnetic tape.
Used to recognize the end of a file or file segment, and to segregate the labels from data.
Unblock. To change the format of a file so that a physical record comprises only one logical record. See Block.
Unpack. Storage technique whereby one digit, with or without sign~ is stored per byte .•
User Routine. A routine supplied by the user and incorporated into a utility pro-gram as a modification.
Utility Control Statement. A record that contains information to tailor a utility program to the requirements of the problem program.
Volume. That portion of a single unit of storage medium that is accessible to a single read/write mechanism. For example, a reel of magnetic tape for an IBM 2415 magnetic tape drive.
Volume Table of Contents (VTOC). A number of records on a disk pack, composed of disk file labels, specifying extents of, and identifying all files on the pack.
Zoned Decimal. See Unpack.
A= ( input) •••••••••••••••••••••••••••••• 10 A=(n"m) ., ••••••••••••••••••• 16,,21,,27,,31,,43 A= (n,. n) • • • • • • • • • • • • • • • • • • '. • • • • • • • • • • • 37 Alternate-Track Assignment Utility
program ••••••••••••••••••••••••••••••• 56
Defective track •••••••••••• - 48,49.54,,56,,57 DELET statement •• '. • • • • • • • • • • • • • • • • • • • •• 63 Initialize-Disk Utility program •••••••• 48 Inquiry program ••••••••••••••.•••••••••• H
Print format . . . .
Print span •••••••••••••• 0 • • • • • • • • • • • • • •
primary initialization •••••••••••••••••
Printer output ••••••••.•••••••••••••••• Secondary initialization •••••••••••••••
sector ... 10 . . . .
Sector pulse ~ •••••••••.••••••••••••••••
sequence-checking •••••••••••••••• G • • • • •
Sequence number-field ••••••••••••••••••
sequence-numbering ••••••••••••••••••••.
User initialization switches ••••••••••.
User routine reference points •••••••••.
User labels ••••••••••••••.•••••••••••••
Utility control statements •••••••••.
Utility-Modifier statement
Alternate-track assignment •••••••••••
Card-to-Disk ••••••••••••••••••••••••. Volume-label creation ••••••••••••••••••
Volume-label statement •••••••••••••••••
Volume Table of Contents ••••••••••