[ -
IBM System/3 Model 15
System Control Programming Concepts and Reference Manual
Program Number 5704-SC2
GC215162-1 File No. 33-36
t*
--\ ---a a a a a a o a a a a a a a a a a a a a o a a a a a o a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a o a a a a a a o o a o o a a a a
aaaa aaaoaa aaoa
aoaa aaaaaaaaaao
aoaaaaooaaaaaaaaaaa
oaaaoaaaaaa aaaoaa
aaaooaaaaa aaoaa
oaoooaaa aaoa
oaoooa
a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a o a o a a a a a a a a a a a a a o a a a a a a a a a a a o a a a a a a a a a a a a o a a a o o a a a a a a a a o a a a a a a a a
a a a a a a a o a a a a a o a a a a
a a a a a o a a a a o a a a a a a a a a a a a a a o a a a a a a a a a a a a o o o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a
a o o a a a a a a a a a aoaaaa
a a a a a a a a
a a a a a a a a
a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a o a o a a a a a a a a a a a a o o a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a o a a o a a a a a
Preface
This manual provides programmers with the information . IBM SystemB 3741 Reference Manual, GC21'51 13 needed to run programs on the IBM System/3 Model 15
and to use the system service programs for doing jobs o IBM System/3 Model 15 User's Guide to Spooling, such as preparing disks for use or updating system GC21'7632
libraries. See How To U* This Manual for additional
information. o IBM System/3 Model 15 System Control Prognmming
Mrcros Reference Manual, GC21-7608
R€lated Publications . IBM Syshm/3 Overlay Linkage Editor Reference Manual, G C 2 1 - 7 5 6 1
o l8M System/3 Model l5 lntroduction,GC2l-5094
o IBM SystemB Multiline/Multipoint Binary Synchronas o IBM System/3 Disk Concept and Planning Guide, Communications Refercnce Manual, GC21-7573
GC21-7571
/Vofe.' Information about the system control program . tBM Systan/3 Modet l5 Operator's Guide, GC21-5075 (Program Number 5704-SCl) is in the IBM System/S
Model 15 System Control Programming Reference Manual, o IBM SystemR Model 15 System Generation Reference GC21'5O77 '
Manual, GC21-7616
e IBM SystemB Model l5 System Mewges, GC21-5076 . IBM System/3 Communications Control Program
Mesages Manual, GC21 -51 70
. IBM System/3 Communications Control Program System Reference Manual, GC21 -7 620
Second Edition (September 1978)
This is a major revision of , and obsoletes, GC21-5162-0 and technical newsletter GN21 -5550.
Because the changes and additions are extensive, this publication should be reviewed in its entirety.
Changes are periodically made to the information herein; before using this publication in connection with the operation of IBM systems, refer to the latest IBM System/3 Bibliography, GC20-8080 for the editions that are applicable and current.
Use this publication only for the purposes stated in the Preface.
Publications are not stocked at the address below. Requests for copies of I BM publications and for technical information about the system should be made to your IBM representative or to the branch office serving your locality.
This publication could contain technical inaccuracies or typographical errors. Use the Reader's Comment Form at the back of this publication to make comments about this publication. lf the form has been removed, address your comments to IBM Corporation. Publications, Department 245, Rochester, Minnesota 55901. IBM may use and distribute any of the infor- mation you supply in any way it believes appropriate without incurring any obligation what- ever. You may, of course, continue to use the information you supply.
@Copyright International Business Machines Corporation 1976. 1978
HOW TO USE THIS MANUAL MODEL 15D INTRODUCTION PART 1. OCL STATEMENTS
INTRODUCTION TO OCL STATEMENTS
W h a t i s O C L ?
O C L a n d t h e J o b S t r e a m O r g a n i z a t i o n o f P a r t 1 C o d i n g R u l e s
T y p e s o f I n f o r m a t i o n G e n e r a l C o d i n g R u l e s Statement Length
S T A T E M E N T D E S C R I P T I O N S A S S I G N S T A T E M E N T
B S C A S T A T E M E N T C A L L S T A T E M E N T C O M P I L E S T A T E M E N T D A T E S T A T E M E N T
F I L E S T A T E M E N T ( S I N G L E V O L U M E D I S K F I L E S } F I L E S T A T E M E N T ( M U L T I V O L U M E D t S K F I L E S } F I L E S T A T E M E N T ( S I N G L E V O L U M E T A P E F T L E S }
7-Track Considerations Tape File Statement Summary
Combinations of 7-Track Specifications
F I L E S T A T E M E N T ( M U L T I V O L U M E T A P E F I L E S ) F I L E S T A T E M E N T { M U L T I P L E T A P E V O L U M E S }
Prepositioned Tapes (SEONUM-X on the FILE Statementl
Restrictions on the Use of Multif ile Tapes Standard Labeled Files
Nonstandard Labeled Files U n l a b e l e d V o l u m e s
R E E L P a r a m e t e r o n F I L E S t a t e m e n t
F I L E S T A T E M E N T ( D E V I C E IN D E P E N D E N T F I L E S } H A L T S T A T E M E N T
IMAGE STATEMENT
Characters from the System Input Device Characters from the Source Library I N C L U D E S T A T E M E N T
J O B S T A T E M E N T
L O A D A N D L O A D * S T A T E M E N T LOG STATEMENT
N O H A L T S T A T E M E N T
PAUSE STATEMENT
P R I N T E R S T A T E M E N T
PUNCH STATEMENT
R E A D E R S T A T E M E N T R U N S T A T E M E N T
SWITCH STATEMENT
/& STATEMENT /. STATEMENT
r ( C O M M E N T } S T A T E M E N T S
t x
x i
PART 2. SYSTEM CONCEPTS AND FACILITIES P R O G R A M F A C I L I T I E S
S y s t e m / 3 M o d e l 1 5 P r o g r a m m i n g S u p p o r t
Pag€ of GC21 -51 62-1 lssued 28 Septembor 1979 By TNL: GN21-5674
Contents
2-1 2-3 2-3 24 24 24 2-5 2A 28 2-9 2-11 2-11 2-11 2-11 2 - 1 2 2-13 2-13 2-15 2-15 2 - 1 6
2-18.2 2 - 1 9 2-20 2-20 2-21 2-21 2-21 2-22 2-22 2-23 2-2s 2-24 2-25 2-25 2-25 2-26 2-26.1 2-26.1 . 2-26.1
2-2t 2-29 2-30 2-31 2-32 2-33 2.35 2-39 241 242 242 243 1 - 1
1 - 3 1 - 3 1 - 3 '14 1 4 1 4 1 4 1 - 6 1 - 8 1-21 1-23 1-24 1-25 1 - 2 7 1-29 1-40 1-45 1-52 1-53 1 - U 1 - 5 5 1-57 1-58 1 -58 1-59 1 - 6 1 1 - 6 1 1-62 1-63 1 - 6 5 '| -66 1 - 6 7 1 - 6 7 1 - 6 9 1-71 1-75 1-79't-42 1-84 1 - 8 5 1-88 1 - 9 1 'l-92 1 - 9 3 1 - 9 5 1-96 1-99 1 - 1 0 0
Program Concepts S o u r c e P r o g r a m s Object Modules Load (lodules
P r o g r a m a n d P a r t i t i o n S i z e s Greater Than 48K Programs E x t e r n a l B u f f e r s
F I L E F A C I L I T I E S F i l e D e f in i t i o n
F i l e O r g a n i z a t i o n F i l e P r o c e s s i n g F i l e C r e a t i o n F i l e L o c a t i o n
A u t o m a t i c F i l e A l l o c a t i o n F i l e S e r v i c e s
Scheduler Work Area F i l e S h a r i n g
S o u r c e L i b r a r y Object Library Library Locations S t o r i n g P r o g r a m s
Sample Statements Procedures
E x a m p l e
Nested Procedures Cataloging to an Active Library
User Considerations S Y S T E M F A C I L I T I E S I n i t i a l P r o g r a m L o a d ( l P L ) P r o g r a m E x e c u t i o n
Compatible Access Methods for File Sharing 2-17
D T F ( D e f i n e t h e F i l e l 2 - 1 7
S D T F ( S h a r e D e f i n e t h e F i l e ) 2 - 1 7
FSOE (File Share Clueue Elementl 2-18.1
Fife Share Area 2-18.1
Doubly-Defined Files 2-18,1
C o n s i d € r a t i o n s a n d R e s t r i c t i o n s
G e n e r a l R e s u l t s W h e n t h e 2 o r 3 Option is Selected for a Message
W o r k F i l e s
M a i n S t o r a g e R e q u ir e m e n t s R P G I I
COBOL F O R T R A N
C C P / D i s k S o r t Basic Assembler O v e r l a y L i n k a g e E d i t o r L a r g e I n d e x F i l e s M u l t i v o l u m e D i s k F i l e s M u l t i v o l u m e T a p e F i l e s M u l t i f i l e T a p e V o l u m e s N u l l F i l e s o n T a p e
Programmi ng Considerations L I B R A R Y F A C I L I T I E S L i b r a r y D e f i n i t i o n
Job and Step Processing 244
/. STATEMENT
Contents iii
P a g e of GC21-S162_1 lssued 28 September 197g B y T N L : cN21-5674 External Indicators System Severity Codes Job Stream Example Multiprogramming
O p e r a t i n g in a-Muttiprogramming Environment' M u l t i p r o g r a m m i n g Considerations a n d
Restrictions
Sharing Access to Added Reco;ds' . : . . _ M u l t i p r o g r a m m i n g Examples
Date Support System Date Partition Dare I n t e r v a l Timer System lnput Device System Log Device System Print Device . System Punch Device System History Area S p o o l i n g
Checkpoint/Restart . I n q u i r y P r o g r a m .
System Integrity ,
Automatic Message Restart (Unit Record nestart) Unit Record Restart (System Generation
O p t i o n )
.. .Extended Restart (System Generation Option) ' Main Storage Usage
248 248 248 2-52 2-53 2-57 2_s9 2-60 2€3 2-63 2-63 2-63 2-64 2-65 2-66 2-66 2-66 2-67 2-68 2-69 2€9 2-70 2-70 2-70 2-71 3-1 3-3 3-3 34 3-6 3-6 3-7 3-7 3-9 3-9 3 - 1 0 3 - 1 0 3 - 1 0 3 - 1 1 3 - 1 1 3 - 1 2 3 - 1 3 3 - 1 3 4-1 4-3 44 44
4-5 4-6
4-22.1 4.22.1 4-22.1 +22.1 4-22.1 4-22.1 4-22.1 4.22.1 4-22.1 4-22.2 4-22.2 4.22,2 +22.2 4-22.2 4-22.2 4-22.2 4-23 4-23 A L T E R N A l - E T R A C K A S S I G N M E N T
PROGRAM_$ALT Program Description Control Statement Summary Parameter Summary
4-7 4-7 4-7 4€
Parameter Descriptions 4€
PACK Parameter
C o n d i t i o n a l Assignment U N I T P a r a m e t e r V E R I F Y P a r a m e t e r ASSIGN Farameter U n c o n d i t i o n a l Assignment
. 4 € 4€
4€
4a 4-9 4-9 4 . 1 0 4 - 1 0 4-10 4 . 1 0 4-11 4-12 4-12 4-12 4 - 1 3 4-14 4-14 4-14 4-14 4-14 4-14 4-14 4 - 1 5 4 - 1 5 4-17 + 1 7 4-17 4 - r 8 4-20 4-22 E x a m p l e s
O C L C o n s i d e r a t i o n s
P R O G R A M - - $ B U I L D Program Description
C o n d i t i o n a l Assignment Unconditional Assignmenr
Messages for Alternate Track Assignment A L T E R N A T f : T R A C K R E B U T L D
Control Statement Summary
Parameter and Substitute Data Summary Parameter ancl Substitute Data Descriptions
PACK Parameter U N I T P a r a m e t e r T R A C K P e r r a m e t e r LENGTH |tarameter
DISP (Displacementl parameler PART 3. DISK STORAGE
DIRECT ACCESS STORAGE
Substitute Data OCL Considerrations E x a m p l e s
S i m u l a t i o n Area Reassignment
N u m b e r of Simulation Area Assignments M a i n D a t a Areas
D i s k S p a c e Allocation
Considerations and Restrictions 3340 Direct Access Storage Facility 3344 Direct Access Storage S i m u l a t i o n Areas
Inrerchanging Data Modules (3340) A c c e s s i n g S i m u l a t i o n Areas A s s i g n i n g S i m u l a t i o n Areas
C O N F I G U R A I O N R E C O R D P R O G R A M -
$ C N F I G Program Description
Changing the Configuration Record Control Statenrent Summary Parameter Surnmary
Alternate Tracks
File Processing Considerafl ons C y l i n d e r 0 F o r m a t
Considerations and Restrictions I n i t i a l P r o g r a m Load (lpL)
PART 4. SYSTEM SERVICE PROGRAMS
INTRODUCTION
Programming ConsiOerations _ Control Statements
Writing Control Statements for System Service Programs
P a r a m e t e r Descriptions .
AUTHORT:ZEp"r"-"t"rtOCOpVi
: : : : :
PUNCH Pararneter (AUTST, AUTWT) Pl Parameter {SIZE)
C A R D P a r a m e t e r (D E F C N ) Code-Area Parameter (ASNpx) CYL Pararneter (SpCyL) D Parameter (TSTAMpt'
D A T E P a r a r n e t e r ( F O R M A T ) .
. : . : : : : oEVtCE Parameter (LOGPx, sYtNx,
SYPCx, SYpRx)
EJECT or NOEJECT pararn."r. tf_OCiri . : : : ERASEparameter(OCOpy)
. . : : : . E X T E N D E O p a r a m e t e r ( R E A D Y )
. : : . FORM Parametor (DEFFN)
FS Parameter (SIZE) HALT Paranreter (HLTpx) HALT Paranreter (SHAI I Parameter {TSTAM;i
I D E L E T E p a r a m e t e r t i r V p e t .
. : : : : : : M Parameter (SpOpT)
OCL Parameter (BLANK) PACK paramet"i tcnil6f '
:llllJ.p:rameter(AUrii,aJrwrr' . : . : :
4-22 4-22 4-22 4-22 4.22
C o d i n g R u l e s
END Control Statement
Placement of Control Sratements in the Job Stream
Special Meaning of Capital 't"tt"rr,
wumbers, and Special Characters
Device Codes . .
44 4-5 4-5 4-5
P 2 P a r a m e t e r (S I Z E )
Pago of GC21-5162-1 lssued 28 Soptemb€r 1979 By TNL: GN21-5674 P3 Parameter (SIZE)
R A T I O P a r a m e t e r ( F S H A R E ) R E A D P a r a m e t e r (n U T S T ) R E T A I N P a r a m e t e r (M E S S A G ) ROPTY Parameter (OCOPY) S E O U E N C E P a r a m e t e r (P R lO R l T Y l S H A R E P a r a m e t e r (C O N S O L ) S H A R E P a r a m e t e r ( F S H A R E ) S Y S P a r a m e t e r (S I Z E ) TRACKS Parameter (SHA) TRACKS Parameter (SPEXT) U N I T P a r a m e t e r (S P D S K I C o n s i d e r a t i o n s a n d R e s t r i c t i o n s O C L C o n s i d e r a t i o n s
E x a m p l e s
COPY/DUMP PROGRAM_$COPY
Program Description
COPYPACK .
C O P Y F I L E
Control Statement Summary Parameter Summary P a r a m e t e r D e s c r i p t i o n s
F R O M a n d T O P a r a m e t e r s ( C O P Y P A C K ) P A C K I N a n d P A C K O P a r a m e t e r s
( C O P Y P A C K )
C O P Y P A C K C o n s i d e r a t i o n s O U T P U T P a r a m e t e r (C O P Y F I L E ) D E L E T E P a r a m e t e r ( C O P Y F l L E l
R E O R G ( R e o r g a n i z e ) P a r a m e t e r ( C O P Y F I L E ) L E N G T H P a r a m e t e r (C O P Y F I L E )
K E Y a n d P K Y P a r a m e t e r s ( S E L E C T ) R E C O R D P a r a m e t e r s ( S E L E C T ) F l L E P a r a m e t e r (S E L E C T )
L E N G T H a n d L O C A T I O N P a r a m e t e r s ( K E Y ) D A T A M G M T P a r a m e t e r (O U T D M )
F R O M P a r a m e t e r (A C C E S S ) C Y L I N D E R P a r a m e t e r ( A C C E S S I S E C T O R P a r a m e t e r (A C C E S S ) T R A C K P a r a m e t e r (A C C E S S ) R E C L P a r a m e t e r (A C C E S S ) D I S P P a r a m e t e r (A C C E S S I C o p y i n g M u l t i v o l u m e F i l e s
M a i n t a i n i n g P r o p e r V o l u m e S e q u e n c e N u m b e r s
M a i n t a i n i n g C o r r e c t R e l a t i v e R e c o r d N u m b e r s
D i r e c t F i l e A t t r i b u t e s
C o p y i n g M u l t i v o l u m e I n d e x e d F i l e s T a p e F i l e C o n s i d e r a t i o n s
D i s k e t t e F il e C o n s i d e r a t i o n s C a r d I n o u t C o n s i d e r a t i o n s C a r d O u t p u t C o n s i d e r a t i o n s F ile Recovery Considerations O C L C o n s i d e r a t i o n s E x a m p l e s
DUMP/R ESTOR E PROGRAM_$DCOPY
P r o g r a m D e s c r i p t i o n Control Statement Summarv P a r a m e t e r S u m m a r y Parameter Descriotions
F R O M a n d T O P a r a m e t e r s ( C O P Y P A C K ) P A C K P A T A M E I E T ( C O P Y P A C K } S Y S T E M P a r a m e t e r (C O P Y P A C K ) B A C K U P P a r a m e t e r (C O P Y P A C K ) D u m p / R e s t o r e C o n s i d e r a t i o n s
O C L C o n s i d e r a t i o n s
F l L E S t a t e m e n t C o n s i d e r a t i o n s Messages
E x a m p l e s
f o r D U M P / R E S T O R E F I L E S t a t e m e n t : F r o m D i s k t o T a p e Control Statements
F I L E S t a t e m e n t : F r o m T a p e t o O i s k C o n t r o l S t a t e m e n t : F r o m D i s k t o D i s k e t t e C o n t r o l S t a t e m e n t : F r o m D i s k t o T a p e P r o g r a m m i n g C o n s i d e r a t i o n s
F I L E D E L E T E P R O G R A M - $ D E L E T Program Descriptron
D e l e t i n g F i l e s
F r e e i n g S p a c e o n a n A r e a C o n t r o l S t a t e m e n t S u m m a r y P a r a m e t e r S u m m a r y P a r a m e t e r D e s c r i D t i o n s
P A C K P a r a m e t e r U N I T P a r a m e t e r L A B E L P a r a m e t e r D A T E P a r a m e t e r D A T A P a r a m e t e r O C L C o n s i d e r a t i o n s E x a m p l e s
D e l e t i n g O n e o f S e v e r a l F i l e s H a v i n g th e Same Name
F r e e i n g A l l o c a t e d B u t U n u s e d S p a c e o n a n A r e a F I L E C O M P R E S S P R O G R A M - $ F C O M P
Program Description M o v e a n d C o p y F u n c t i o n s
M o v e F u n c t i o n C o p y F u n c t i o n
B a c k u p a n d R e s t o r e F u n c t i o n s B a c k u p F u n c t i o n
R e s t o r e F u n c t i o n C o n t r o l S t a t e m e n t S u m m a r y P a r a m e t e r S u m m a r v P a r a m e t e r D e s c r i p t i o n
F R O M a n d T O P a r a m e t e r s ( C O P Y F I L E ) P A C K I N a n d P A C K O P a r a m e t e r s ( C O P Y F I L E S ) C O M P R E S S P a r a m e t e r (C O P Y F I L E S )
F R O M P A T A M E I E T ( T A P E F I LES}
T O P a r a m e t e r (T A P E F I L E S ) L A B E L P a r a m e t e r (T A P E F I L E S I P A C K P a r a m e t e r ( T A P E F I L E S ) S E O N U M P a r a m e t e r s ( T A P E F I LESI C O M P R E S S P a r a m e t e r (T A P E F I L E S ) C o n s i d e r a t i o n s a n d R e s t r i c t i o n s
F i l e S t a t e m e n t C o n s i d e r a t i o n s a n d R e s t r i c t i o n s ( B a c k u p and Restore)
O C L C o n s i d e r a t i o n s E x a m p l e s
S Y S T E M H I S T O R Y A R E A D I S P L A Y P R O G R A M - $ H I S T
P r o g r a m D e s c r i p t i o n C o n t r o l S t a t e m e n t S u m m a r y P a r a m e t e r S u m m a r y P a r a m e t e r D e s c r i p t i o n s
H I S T O R Y P a r a m e t e r O C L C o n s i d e r a t i o n s E x a m p l e s
D I S K I N I T I A L I Z A T I O N P R O G R A M _ $ I N I T P r o g r a m D e s c r i p t i o n
T y p e s o f I n i t i a l i z a t i o n 4-23
4-24 4-24 4-24 4-24 4-24 4-24.1 4-24.1 4-24.1 4-24.1 4-24.1 4-24.1 4-24.1 4.24.2 4-25 4-27 4-27 4-27 4-27 4-29 4-31 4-34 4-34 4-34 4-34 4-34 4-36 4-36 4-36 4-36 4-37 4-37 4-37 4-37 4-37 4-37 4-37 4-38 4-38 4-38 4-38 4-38 4-38 4-38 4-38 4-39 4-39 440 4-41 4-41 4-41 442 4-62 4-62 4-62 4-63 4-63 4-63 4-64 4-64 4-U 4-65
4-65 4-65 4€6 4-66 4-67 4-67 4-68 4-69 4-70 4-70 4-71 4-71 4-71 4-71 4-72 4-73 4-74 4-74 4-74 4-74 4-74 4-74 4-75 4-75 4-75 4-77 4-74 4-78 4.78 4.78 4-78 4.79 4-79 4-79 4-80 4-80 482 4-82 4-82 4-a2 4-82 4-82 4-82 4-82 482 4-83 4-83 4-83 484 4.84 4-93 4-93 4-94 4-94 4-94 4-9.
4-94 4-97 4-100 4-100 4-100 4 - 1 0 1 C o n t r o l S t a t e m e n t S u m m a r y
C o n t e n t s
PaSe of cC2t-S162-l lssued 28 September 1979 By TNL: cN21-5674 Parameter Summary
Parameter Descriptions . 4'102 $MAINT-copy FUNcrtoN
TYPE Parameter (UlNl 4-103 Uses
UNIT parameter 4_103 Control St"t"."nt Srrn;";u .
V E R | F Y P a r a m e t e r . 4 . 1 o 4 R e a d e r - t o - L i b r a r y
,1fi:ffff,",rurur ry i;iij:;l$i::
PACK Parameter (voLi 4-104 Librarv-to-Library
l,""lll?ff:::TI:'.,,,Hl;,iviu . iiii t_ ::,#::;,"#I"ffi:f:,JA
OLDPAcK t.r"-"i", iu6ii . . i 19: Parameter summary
l-lff LibraryDirectories . : . . . : . .
o C L C o n s i d e r a t i o n s . . $ - | U 5 L i b r a r y D i r e c t o r i e s
Examples . . . 4'106
Source and object Library Directories
p r i - - , . , f - : ^ : ^ r : -
4-128 4-128 4-129 4-129 4 - 1 n 4-129 4-1 30 4 - 1 3 1 4-131 4-132 4-1 35 4-1 35
"JJ'Jfl:Jlll'l1iH;l.I*ovor,-",...:i-ji!-jIfi"il,:]::i"|.,iI,",.
M€ss:rses for Disk rnitiarization . : . : ;-1; ,*:,;t;:J;:'ttlJ,*
; f f ' , * . " T l [ ' . H P R o G R A M _ $ K L E A N . ' 4 - 1 o 8 L e n g t h o f N a m e . . . . :: .
OCL Considerations . . 4-log Restricted Names
F I L E AND VOLUME LABEL.DISPLAY 4 _ 1 0 8
^ a . n , r l " r nrith the Same Name
P R O G R A M - $ L A B E L R e t a i n T Y P e s
Program Description . . 4'109 Tempora ry Entries
l'rogram Description r' I uv t empora ry Entries
S t o r a g e R e q u i r e m e n t s 4 . 1 0 9 P e r m a n e r | t E n t r i e s C o n t r o l Statement Surn."ru .
_ 4 - i 0 9 S i m u l a t i o n A,rea Verification .
;::il:,::3:lffi,:?il:, s,"*-"n,i i.ll3 "'l'.:::,:;:1,[;T,,". : .
U N f T p a r a m e t e r . . 4 _ 1 1 1 F i l e _ t o - L i l b r a r y
L A B E L p a r a m e t e r 4 _ 1 1 1 L i b r a r y - t o _ F i l e
S O R T p a r a m e t e r 4 _ l l l L i b r a r y _ t o - L i b r a r y
E n t i r e Contents of VTOC 4 - 1 1 1 L i b r a r y - t o _ p r i n t e r a n d / o r Card M e a n i n g of VToc tntormation : 1 1 ' . $ M A I N T - D E L E T E F U N c r t o N
F i f e l n f o r m a t i o n Only 4 ' 1 1 3 U s e s
E x a m p l e 4 - 1 1 5 C o n t r o l s t a t e m e n t Summary
printins vroc rnro..'",.ion ro. r*o pires : . . i-llB ;:;li::"ji.fiil:f*:,":,.:,
il.tJ#J"Sil;:|^-:t PRoGRAM-SMAINr 4-117 $MArNr-MODrFy FUNcrroN . . .
I f - - ^ . ^ : - , - 4 ' 1 1 7 U s e s
. 4 _ 1 3 5 4 _ 1 3 5 4 - 1 3 5 4 _ 1 3 5 4 - 1 3 5 4 - 1 3 5 4 - 1 3 6 4-136 4 - 1 3 6 4_1 36 4-137 4_137 4-137 4 - 1 3 8 4-1 38 4 - 1 3 9 4-146 4-146 4_146 4-147 4-148 4-149 4-149 4-149 4-1 50 4 - 1 5 1 4-152 4-1 53 4 - 1 5 3 4-1 53 4 - 1 5 3 4-154 4-1 55 4_1 56 4-167 4-167 4-168 4-171 4-176 4-176 4-176 4-176 4-176 4-176 4-176 4-176 4-176 4-176 4-177 4-177 4-177
use of Disk space a'| | t vses
o r g a n i z a r i o n o r i r , i , s " " t i o , , - ' . . .
i : l i : : : ; f f T ; ? J : : : : f f ; : : f " , . . . :
$MAINT_ALLOCATE FUNCTION
Uses rer surnmary
conrrorstatements,.,",y . . . . : . . . i.lll ffi1il?:;?,frXiliT,,i,i:T[,i""
Considerations and Restrictions
. .
P a r a m e t e r s u m m a r y l - l ] : : " t t .
Parameter Descripttns . 4'120 Considerations; and Restrictions
TO parameter . . 4-121 Control Statenrent Summary
3?#J::;::"::*:*:"'""'"" : i::i #n':::il:ffiI
s v q r F M o ^ _ ^ _ ^ ^ ^ - 4 _ 1 2 1 $ M A I N T _ E X I \ M P L E S
SYSTEM parameter
xrsronv;";;;;;, 4.121 spool FILE oopy pRocRAM_gocopy
WORK parameter 4-122 Program Description
'ACKO parameter . 4_122 Control Staternent Summary
using the Allocate run"tio, 4-123 Parameter summary
creatins, sour"" iiu."..1,1rou^q._ir,'o",) '
. . iirri t"."#Jil
f;;El:::;::"r^"rt
C h a n g i n g t h e s i z e o f ( R e a | | o c a t i n g ) a S o u r c e P a r a m e t e r D e s c r i p t i o n s _ C o P Y P R T o . . . ' . L i b r a r y ( S O U R C E - n u m b e r )
.
F O R M S N O p a r a m e r e r . J O B N p a r a m e t e r
D e l e t i n g a Source Library (soURcEo)
4 _ 1 2 s S T E p N p a r a m e t e r R e o r g a n i z i n g a s o u r c e Library (sOURCE-R) . : 4 _ 1 2 6 L E N G T H p a r a m e t e r creating an object Library (oBJECr-numberl
. 4-126 REMOVE parameter
Changing the size of (Realtocating) L i b r a r y ( O B J E C T - n u m b e r l . an object . ' . 4 - 1 2 7 ouTpuT parameterF l L E p a r a m r : t e r D e f e t i n g an Object Library (OBJECT-o) . . . 4 _ 1 2 7 H E A D E R p a r a m e t e r R e o r g a n i z i n g a n O b j e c t Library (OBJECT_R) . 4 _ 1 2 7 S T o p p a r a m e t e r
/ ,
compress in ptace (oelecr_ {R l\
\ - - - ' I n u m u e ' f / 4 - 1 2 7
P a r a m e t e r D e s c r i o t i o n s - C O P Y P C H O U N I T P a r a m e t e r
C A R D N O P a r a m e t e r J O B N P a r a m e t e r S T E P N P a r a m e t e r R E M O V E P a r a m e t e r OUTPUT Parameter F I L E P a r a m e t e r H E A D E R P a r a m e t e r STOP Parameter
Parameter Descriotions-COPYR DRO U N l T P a r a m e t e r
R E C L P a r a m e t e r I N P U T P a r a m e t e r F I L E P a r a m e t e r K E Y P a r a m e t e r L O K E Y P a r a m e t e r H I K E Y P a r a m e t e r L O B E C P a r a m e t e r H I R E C P a r a m e t e r O U T P U T P a r a m e t e r J O B N P a r a m e t e r P A R T I T I O N P a r a m e t e r R E M O V E P a r a m e t e r
Parameter Descriptions-COPYCTR L F I LE Parameter
P a r a m e t e r D e s c r i p t i o n s - D I S P L A Y U N I T P a r a m e t e r
O U T P U T P a r a m e t e r F I L E P a r a m e t e r O Parameter
P a r a m e t e r D e s c r i p t i o n s - R E S T O R E F I L E P a r a m e t e r
J O B N P a r a m e t e r S T E P N P a r a m e t e r F O R M S N O P a r a m e t e r C A R D N O P a r a m e t e r S T O P P a r a m e t e r OUTPUT Parameter UN lT Parameter
Parameter Descriptions-COPYO O Parameter
F R O M P a r a m e t e r TO Parameter J O B N P a r a m e t e r STEPN Parameter R E M O V E P a r a m e t e r P A R T I T I O N P a r a m e t e r P R I O R I T Y P a r a m e t e r
F O R M S N O a n d C A R D N O P a r a m e t e r P a r a m e t e r D e s c r i p t i o n s - A U T H O R I Z E
LIST Parameter
Parameter Descriotions-CLASSI FY P R O G R A M P a r a m e t e r U N I T P a r a m e t e r . CLASS Parameter L I B R A R Y P a r a m e t e r PACK Parameter
S p o o l F i l e C o n s i d e r a t i o n s a n d R a s t r i c t i o n s F I L E R e q u i r e m e n t s
P a r t i t i o n S i z e R e q u i r e m e n t s
C o p y t h e E n t i r e S p o o l F i l e ( C O P Y S P I Copy Selected Job Steps from the Print
Oueue (COPYPRTO
Copy Selected Job Steps from the Punch O u e u e ( C O P Y P C H O I
Page of GC21 -51 62-1 lssued 28 September 1979 B y T N L : G N 2 1 ' 5 6 7 4 Copy Jobs To or From the Reader Oueue
(COpyRDRo) . 4-192
Read Control Statements from a File
(coPYcrRL) 4-194
Copy a Display of the Status of the Spool
Oueues (DISPLAY) 4-194
4-195 4-195 4-196 4-196 Restore Print or Punch Queue Records From a
F i l e (R E S T O R E ) 4-177
4-177 4-177 4-177 4-177 4-177 4-174 4-178 4-178 4-174 4-178 4-',t78 4-174 4-178 4-179 4-179 4-179 4-179 4-180 4-1 80
Copy Selected Job Steps t o A n o t h e r ( C O P Y O ) C H A N G E T H E A U T H O R I Z
F r o m O n e S p o o l F i l e F I L E ( A U T H O R I Z E } A u t h o r i z a t i o n F i e l d s
C r e a t e A u t h o r i z a t i o n R e c o r d 4 - 1 9 6 ' 2
Change Authorization Record 4-196'2
Defete Authorization Record 4'196'2
A S S T G N A C L A S S N U M B E R T O A
P R O G R A M { C L A S S I F Y } 4-196.3
4-196.5 O C L C o n s i d e r a t i o n s
4-1 80 4-1 80 4-1 80 4 - 1 8 0 4 - 1 8 1 4 - 1 8 1 4 - 1 8 1 4 - 1 8 1 4 - 1 8 1 4 - 1 8 1 4 - 1 8 1 4-'t82 4-182 4-142 4-182 4-142 4-182 4-142 4-182 4-182 4-1t|:t 4-1 83 4-1 83 4-1 83 4-1 83 4 - 1 8 3 4-1 83 4-1 83 4-1 83 4-1 83 4-183 4-183 4 - 1 W 4-184 4-184 4 - 1 U 4-184 4 - 1 U 4 - 1 U 4-184 4-18r'.
4-184 4-184.1
4-190
E x a m p l e s 4 - 1 9 6 ' 5
4-202.1 4-202.2 4-202.2 4-202.3 4-203 4-203 4-203 4-204 4-205 4-206 4-206 4-204 4-208 4-209 4-210 4-210 4-21',1 4-212 U s i n g th e S p o o l F i l e C o p y P r o g r a m U n d e r C C P
Program Request U s e r A u t h o r i z a t i o n
U s i n g th e S p o o l F i l e C o p y P r o g r a m fr o m a T e r m i n a l Responding to Error Messages
Placing Jobs on the Reader Oueue from a T e r m i n a l
D i s p l a y i n g th e S p o o l O u e u e s CCP Assignment Set
H o w t o R e q u e s t $ O C O P Y F r o m a T e r m i n a l E x a m p l e s
C o n s i d e r a t i o n s f o r T e r m i n a t i n g t h e S p o o l F i l e Copy Program Under CCP
R E C O V E R I N D E X P R O G R A M _ $ R I N D X Program Description
F i l e l d e n t i f i c a t i o n O C L C o n s i d e r a t i o n s
C o n s i d e r a t i o n s a n d R e s t r i c t i o n s E x a m p l e s
R E A S S I G N A L T E R N A T E T R A C K P R O G R A M _ $ R S A L T
Program Description 4-212
Control Statement SummarY 4'212
Parameter Summary Parameter Descriptions
U N I T P a r a m e t e r P A C K P a r a m e t e r
4-213 4-213 4-213 4-213 4-216 4-2'.t6 4-217 4-219 4-222 4-222 4-222 4-222 4-222 4-222 4-222 4-222 4-222 4-222 4-222 4-222 4-223 4-223 4-223 4-223 S T M U L A T I O N A R E A P R O G R A M _ $ S C O P Y
P r o g r a m D e s c r i p t i o n Control Statement Summary Parameter Summary
Parameter Descriotions-COPYAR EA F R O M a n d T O P a r a m e t e r s P A C K P a r a m e t e r
A R E A P a r a m e t e r T O N A M E P a r a m e t e r S Y S T E M P a r a m e t e r Parameter Descriptions-CLEAR
F R O M P a r a m e t e r PACK Parameter A R E A P a r a m e t e r C L R N A M E P a r a m e t e r
l D P a r a m e t e r TYPE Parameter
Parameter Descriptions-N EWNAM E TO Parameter
PACK Parameter
C o n t e n t s v i i
P a g e o f G C 2 1 - 5 1 6 2 - 1 lssued 2g September 1979 B y T N L : G N 2 t - 5 6 7 4
A R E A p a r a m e t e r lD Parameter S Y S T E M p a r a m e t e r C L R N A M E p a r a m e t e r Parameter Descriptions_COpy lpL
FROM and TO parameters . .
PACK parameter T O N A M E p a r a m e t e r P a r a m e t e r D e s c r i p t i o n s _ N A M ES
P R I N T p a r a m e t e r Parameter Descriptions-MOV;
F R O M and TO parameters P A C K p a r a m e t e r
A R E A p a r a m e t e r T O N A M E p a r a m e t e r OCL Considerations E x a m p l e s
T A P E I N I T I A L T Z A T I O N P R O G R A M _ $ T I N I T Program Description
.Control Statement Summary Parameter Summary
AP-PENDIX (occ) C. OPERATOR CONTROL COMMANDS OCC Summary
Information About Syntax lllustrations
A P P E N D I X E. TRANSACTION LOGGING_
$ T R L O G
A P P E N D I X D . S U 8 R 1 5 - L I B R A R Y E N T R Y R E T R I E V A L S U B R O U T I N E
D - l L i n k i n g S U B R T S w i t h R p c i l
. . . D _ 2
Linking SUBR l S with Assembler . D-5
Errorldentification
. . . : . . D_6
4-223 4-223 4-223 4-223 4-223 4-223 4-223 4_223 4-224 4-224 4-224 4-224 4-224 4-224 4-224 4_225 4-225 4-233 4-233 4-234 4-235 4-236 4-236 4-236 4-237 4-239 4-239 4-240 4-240 4-241 4-24.1 4-241 4-241 4-241 4-241 4-241 4-242 4-242
A - l B - l B - 1 B 4 B 4 B € B-7 B-7 B-7 B-7 B-7 8-8
I N F O R M A T I O N
c-1 c-1 c - 1
L o a d i n g $TRLOG C o n t r o i l i n g $TRLOG .
A P P E N D I X F. PROGRAM REFERENCE O C L Considerations
P r i n t o u t of Volume Label
Program Description
Using Transaction Loggi ng Tape Considerations
' Operating Considerations Programming Considerations
E - 1 E-1 E - 1 E - 1 E-2 E-2 E-2
Messages for Tape Initialization
I:1i,"n of Votume Label Information . .
l:: .To" SUMMARY PRoGRAM_grvEs
. F _ l
Error Logging Format O C L C o n s i d e r a t i o n s
VTOC SERVICE PROGRAM_$WVTOC
Program Description Control Statement Srrnrn"ry P a r a m e t e r S u m m a r y Parameter Descriptions
PACK parameter U N l T p a r a m e t e r O C L Considerations Examples
APPENDIX A. IBM SYSTEM/3 STANDARD
CHARACTER SET
A P P E N D I X B. CALCULATING F I L E SIZE Data Area Track Requirements
i n d e x Area Track Requirements T r a c k Usage for Index Fiies C o r e I n d e x
C a l c u l a t i n g File Sizes (Main Data nr""t_
S u m m a r y
D e t e r m i n i n g the Number of Tracks in a ' S e q u e n t i a l or Direct File
D e t e r m i n i n g the Number of Tracks in an I n d e x e d File (Main Data Area)
D e t e r m i n i n g the Number of Tracks o i O O t ' T r a c k I n d e x
C o n v e r t i n g Cylinder/Track to Track NumOe, Converting Track Number of Cylinder/Track
P a g e o f G C 2 1 - 5 1 6 2 - 1 lssued 28 September 1979 B y T N L : G N 2 1 - 5 6 7 4
How to Use This Manual
This publication contains four parts. Part 1 describes PART 3 Operation Control Language (OCL) statements, Part 2
describes the system concepts and facilities, Part 3 describes Refer to Part 3 if you want to know about:
the format of a 3340 and 3344 volume, and Part 4 de-
scribes the system service programs. o The format and storage capacity of a 3340 or 3344 v o l u m e
P A R T 1 o S i m u l a t i o n a r e a s
Refer to Part 1 if you want to know: o Main data areas
o What an OCL statement is o Alternate tracks
o What each OCL statement is used for (function) o Cylinder 0 format . Where each OCL statement is placed in relation to others
and when it is needed (placement) PART 4
. How each OCL statment must be coded (format) Refer to Part 4 if you want to know about:
o What each OCL statement must contain (contents) o Which system service programs are supplied with the system
PART 2 o The function of each system service program
Refer to Part2if you want to know about: o The operational control language (OCL) statements and control statements applicable to each system service
o Model 15 programming concepts program
o Files and file services
A P P E N D I X E S o Library facilities and concepts
Refer to the appendixes if you want information about:
a System operation overview
o Standard System/3 character set o M u l t i p r o g r a m m i n g a n d s p o o l i n g o v e r v i e w
o Calculation of file sizes o System control program facilities
o Operator control commands (OCC)
o H o w t o r e t r i e v e l i b r a r y e n t r i e s w i t h S U B R 1 5 o How to log transactions
| . tnoiuiOual programs associated with SCP (system control I progtamming 5704-SC2)
How to Use This Manual ix
This page is intentionally left blank.
System/3 Model 15D features a processing unit that allows the attachment of a 3340 Direct Access Storage Facility and a 3344 Direct Access Storage. With a 3340A2 and 334482, the maximum online disk storage is approximately 506 megabytes.
When compared to a System/3 Model 15A, Model 158, or Model 15C, the Model 15D has a faster instruction cycle time for certain non-l/O instructions. The purpose of the faster cycle time is to complement the requirements of the enhanced programming su pport.
System/3 Model 15D is supported by a multiprogramming system control program (Program Number 5704-SC2) that resides on a simulation area of a direct access storage device.
It provides functions that are not available on other System/3 models.
Three program partitions are supported. The scheduling and controlling of programs in the partitions is controlled by operation control language (OCL) statements and operator control commands (OCC). See Appendix C for a summary of the commands.
Greater online library capacity is available because each partition can directly access three unique simulation areas a n d s h a r e s a c o m m o n s i m u l a t i o n a r e a ( t h e IP L a r e a ) . Simu- lation areas are assigned by the user; reassignments for simulation areas other than the IPL area require an appro- priate OCL statement. (More information about simulation a r e a s i s in c l u d e d i n P a r t 3 o f t h i s m a n u a l . )
Input job streams are made up of jobs and job steps. A job i s o n e o r m o r e L O A D / R U N o r C A L L / R U N s e q u e n c e s grouped together to execute in sequence and perform a specific function. A job step is one LOAD/RUN or CALL/RUN sequence. A JOB OCL statement must be used to group job steps together to form a job. See Part 2 for a discussion of jobs and job steps.
Model 15D lntroduction
As the system processes an input stream, jobs are processed in job mode. Job steps not contained within a specified job are processed, by the system, in step mode. See Part 2 for a discussion of job and step mode.
Program support provides a spooling function for certain input and output operations. Spooling places jobs from the input stream in a special area on disk called a reader queue.
Jobs are transferred from disk by spooling to the partitions as required for execution.
Printed and/or punched output is placed in queues on disk during execution of job steps. Printing or punching to the associated devices is performed by spooling. Spooling pro- v i d e s g r e a t e r f l e x i b i l i t y d u r i n g j o b scheduling a n d r e m o v e s many l/O device conflicts between partitions. See Part 2 for more information on spooling.
Support for directly attached 3741 Data Station/Program- mable Work Station is similar to that for a card reader or card punch. In this manual, unless otherwise noted, refer- ences to card l/O also apply to the directly attached 3741.
M o d e l 1 5 D I n t r o d u c t i o n
Part 1. OCL Statements
O C L S t a t e m e n t s 1 ' 1
W H A T I S O C L ?
Operation Control Language (OCL) is one means of com- municating with the system. Operator control commands (OCC) are another means of communicating with the system. See Appendix C for a summary of OCC. You must provide a set of OCL statements for each program you want to run. Based on the information supplied in these state- ments, the system loads and executes your programs or performs system service functions.
Y o u c a n s u p p l y O C L s t a t e m e n t s i n f o u r w a y s : ( 1 ) b y punching the statements into cards. which are then read by the system; (2) by using the CRT/Keyboard to key the statements directly into the system; (3) by keying the statements onto a diskette, which is then read by the sys- tem; (4) by using procedures.
After the system reads a set of OCL statements for a pro- gram, it runs the program. When the program ends, the system reads the next set of statements and runs that pro- gram. This cycle is repeated until all OCL statements have been read and the corresponding programs have been run.
The running of your program is controlled by system con- trol programs. System control programs must be in main storage before your jobs can be run. These programs must be located in simulation areas.
A p r o c e d u r e c a l l e d i n i t i a l p r o g r a m l o a d ( l P L ) in i t i a t e s t h e loading of selected system control programs. IPL must be performed by the operator after the system power-on sequence. Other system control programs are brought into main storage, as required, during program loading and execution.
lntroduction to OCL Staternents
OCL and the Job Stream
The OCL statements you supply form the basis of the job stream. lf your program requires data from the system input device (the device used to read OCL statements), the data must follow the corresponding OCL. The lob stream can contain programs and program data as well as OCL s t a t e m e n t s . ( F i g u r e 1 - ' l s h o w s a n in p u t jo b s t r e a m . ) You can also store sets of OCL statements for your pro- grams outside the iob stream in a source library on disk.
These sets are called procedures. You can instruct the system to merge procedures into the job stream, which eliminates recoding frequently-used statements. (See Procedures in Part 2 of this manual.)
Data
O C L
F i g u r e 1 - 1 . ! n p u t J o b S t r e a m
OCL Statements for First Program
- DATE Statement (optional if e n t e r e d a t I P L o r v i a a D A T E
occ).
OCL Statements for 17
Second Program fu
7 o"rufor First
l n t r o d u c t i o n t o O C L S t a t e m e n t s 1 - 3
O R G A N I Z A T I O N O F P A R T 1 Part I is divided into:
o Coding Rules - Defines the general contents of the OCL statements and explains the rules for writing the state- ments.
. Statement Descriptions - Explains the functions, format, and contents of each OCL statement, and where each statement may be used in the iob stream.
o Statement Examples - Presents and explains a job stream containing most of the OCL statements.
C O D I N G R U L E S Types of Information
OCL statements contain, at most, two types of informa- tion: a statement identifier and parameters. The statement identifier distinguishes one statement from another; the parameters supply additional information. The following example shows the format of an OCL statement.
ldentifier I Parameter 1, Parameter 2, ..., Parameter n
Sbtement ldentifiers
Every OCL statement needs one of these statement identi- fiers:
Parameters
Some statements need parameters; others do not (see Statement Descriptions for an explanation). Parameters can be either codes or data. A code is a word or group of characters that has a certain meaning. Data is information s u c h a s th e n a m e s , l o c a t i o n s , a n d le n g t h s o f f i l e s o n d i s k .
(See Staternent Descriptions for data and code restrictions o n p a r a m e t e r s . ) I n t h e f o l l o w i n g e x a m p l e , P R O G 2 i s th e n a m e o f a n R P G ll o b j e c t p r o g r a m , a n d F 1 i s a 5 4 4 4 u n i t code that is assigned to a simulation area. PROG2 is a data parameter and F1 is a code parameter.
Some statements require certain words in parameters to tell one parameter from another. The words are called key- words. Parameters containing keywords are called keyword p a r a m e t e r s . ( l n t h e f o l l o w i n g e x a m p l e . N A M E - M A S T E R , P A C K - V O L I , a n d U N I T - R 1 a r e k e y w o r d p a r a m e t e r s . N A M E , P A C K , a n d U N I T a r e k e y w o r d s . M A S T E R a n d VOLl are data parameters. R1 is a code parameter.) A hyphen is always required between the keyword and the code or data parameter.
General Coding Rules
In Part 1 of this manual. the numbers that appear above statement formats and examples indicate the card columns or line positions occupied by the statements. In statement formats, special characters (such as lll and words written in capital letters represent information that must be used exactly as shown. Words written in small letters (such as code, program-name, and unit) represent information that y o u m u s t s u p p l y .
A S S I G N BSCA C A L L C O M P I L E D A T E F I L E H A L T
I M A G E J O B
LOAD LOG N O H A L T P A U S E P R I N T E R
P U N C H R E A D E R R U N S W I T C H
/&
* (asterisk) The word LOAD is an example of a statement identifier.
Special Meaning of Capital Letters, Numberc, and Special Characterc
Capitalized words and letters. numbers. and special charac- ters have special meanings in OCL and statement descrip- t i o n s .
Words or letters that are not capitalized indicate that you m u s t s u p p l y a v a l u e t h a t a p p l i e s t o t h e jo b y o u a r e d o i n g . The values that can be used are listed in the oarameter s u m m a r i e s .
Braces { } and brackets [ ] sometimes appear in param- eters shown in statement summaries and parameter sum- maries. They are not part of the parameter; they simply indicate a choice of values to complete the parameter. You rzust choose one of the values surrounded by braces; you may choose a parameter surrounded by brackets or omit that parameter entirely. Underscoring of one value enclosed by braces indicates the default. lf you specify the keyword of a parameter, you must complete the parameter by supplying the code or data even though a default is indi- cated.
F o r e x a m o l e :
( 8 0 t l
1 ; I I means that if you do not specify this
\ - /J parameter, the system will select RECL-96. lf you specify the keyword RECL, you must also supply one of t h e v a l u e s ( 8 0 o r 9 6 ) . -
means that you must specify either R E T A I N - T o r R E T A I N - P . o [,BLKL-block length] means that the block length
parameter may be omitted e n t i r e l y .
Statement$ Beginning with //
The rules for coding the statements are as follows (the term p o s i t i o n r e f e r s t o e i t h e r r e c o r d c o l u m n o r l i n e p o s i t i o n ) : o The // must be placed in positions 1 and 2. The *,
/&.
and /. statements are exceptions and must start in posi- tion 1. (See Statement Dxcriptions for *.
l&,and I.
statements. )
a There must be one or more blanks between the // and the word that forms the statement identif ier (DATE, R U N , C A L L , e t c . ) . E x c e p t i o n s a r e th e J O B s t a t e m e n t , which must have a jobname immediately following the //, and the LOAD statement. which may have a stepname immediately following the //.
o There must be one or more blanks between the end of the statement identifier and the first parameter.
r lf you need more than one parameter, use a comma to separate them. No blanks are allowed within or between parameters. For the exception to this rule, see the des- cription for the HIKEY parameter under FILE State' ment (Multivolume Disk Files). Anything following the first blank after the last parameter is considered a comment (see Commentsl .
o lf you are writing keyword parameters, place the key- word first, and use a hyphen to separa::e the keyword from the code or data parameter.
r lf the parameter is not a keyword parameter, write the parameters in the order in which they are discussed in t h i s m a n u a l .
. [ * . . , - .
. R E r A r N . { ; }
l n t r o d u c t i o n t o O C L S t a t e m e n t s 1 - 5
( l n t h e f o l l o w i n g e x a m p l e , t h e s t a t e m e n t i d e n t i f i e r s a r e L O A D a n d F I L E . T h e p a r a m e t e r s a r e P R O G l , R 1 , N A M E - M A S T E R , U N I T - R 1 , a n d P A C K - V O L 1 . )
Statement Length
OCL statement length is as follows:
Device Number of Characters
M F C U M F C M 1442 2501
CRT/Keyboard 3741
Continuation
The only OCL statements that may exceed 80 or g6 charac- t e r s , i n c l u d i n g b l a n k s a n d c o m m e n t s , a r e F I L E , C O M P I L E , P U N C H , a n d P R I N T E R . O t h e r w i s e , e a c h r e c o r d y o u u s e must not exceed 80 or 96 characters. (Data for the IMAGE statement requires continuation for the cards or lines con- taining the chain image characters, but the data follows different continuation rules. See IMAGE Statement under Sta temen t Desc ri p ti on s f or more i nf ormation. )
The continuation rules are as follows:
o There must be a comma after the last parameter in every record except the last parameter in the OCL statement.
The comma, followed by a blank, tells the system that the statement is continued in the next record.
o Each new record must begin with a /lin positions 1 and 2 .
a There must be one or more blanks between the // and the first parameter in the record. (See HIKEy parameter under FILE Statement IMultivolume Disk Files] for the e x c e p t i o n t o t h i s r u l e . )
The following illustration is an example of the continuation ru les:
96 80 80 80 96 96
1 €
CommenB
Your statements can include comments in the following places:
. Fof lowing the llin any statement beginning with //.
The comment must begin in position 3 immediately following the //. You can use up to 8 characters without blanks. There must be one or more blanks between the comment and the word forming the statement identif ier.
( l n the following e x a m p l e , t h e w o r d B I L L I N G is th e comment.) Comments of this type, when used in a JOB or LOAD statement, are treated as jobname and step- name, respectively.
o After the last parameter. There must be one or more blanks between the last parameter and your comment.
The comment can be any combination of characters except dashes. lf the statement is continued in sub- sequent records. you can place comments after the last parameter in any of the records.
a After statements without parameters. There must be one or more blanks between the statement identif ier and your comment. Examples of statements without param- e t e r s a r e : / & , / / P A U S E , a n d // R U N .
ln addition to writing comments within your OCL state- ments, you can include entire records of comments. The OCL comment statement is provided for that purpose (there must be an * in position 1 followed by the comment). For more information about the comment statement, refer to
* ( Co m men ts ) Sta te men ts unde r Sfafem en t Desc r i p t i ons.
The following is an example of a comment statement:
Spooling and Multiprogramming Considerations All OCL statements can be used in a spooled input job stream, and all can be used in any partition.
I V O f C . ' T h E D A T E . I M A G E , L O G , P R I N T E R , P U N C H . R E A D E R , a n d /. O C L s t a t e m e n t s r e q u i r e s p e c i a l c o n s i d e r a - tion when used in a spooled input job stream.
l n t r o d u c t i o n t o O C L S t a t e m e n t s 1 - 7
Statement Descriptions Figure 1-2 gives the f unction, placement, and restrictions o n u s e f o r e a c h O C L s t a t e m e n t . F i g u r e 1 - 3 d e s c r i b e s t h e The following information is given separately for each oCL contents of the ocL statements and is meant for reference s t a t e m e n t i n t h i s s e c t i o n : o n l y . w h e n u s i n g F i g u r e l - 3 , r e m e m b e r t h a t w o r d s w r i t t e n
in small letters, such as filename or value, require a choice o Function of the statement on your part, depending on the functions you want the
statement to perform. Capitalized parameters must be I Placement of the statement in regard to other statements, coded along with the data or code parameter. (Figure 1-3
and the circumstances under which the statement is shows which parameters are available.) needed
l f y o u a r e n o t f a m i l i a r w i t h a n e n t r y , o r y o u d o n o t k n o w o Format of the statement when to use or omit it, refer to the proper statement in the
remainder of this section.
o Contents of the statement (explaining the parameters that can be used in the statement)
. Spooling considerations for each statement
1 - 8
Statement Function
Placement
Coding Notes Statement Appears
In Job Stream
Statement Appears In a Procedure // ASSIGN Allows reassign-
ment of a5444 u n i t c o d e ( R 1 , F 1 , R 2 , F 2 ) t o a s i m u l a t i o n a r e a .
Anywhere among the OCL statements
Must precede the RUN s t a t e m e n t ( i f R U N i s u s e d ) .
System pack ( R 1 o r F l ) c a n n o t be reassigned.
// BSCA Changes the BSCA l i n e n u m b e r .
Must follow LOAD or CALL statement and precede the RUN statement.
Must follow the LOAD statement and precede the RUN statement (if
R U N i s u s e d ) .
None
II CALL ldentifies pro- cedure to be merged into job stream and disk containing the source library from which to read the procedure
M u s t p r e c e d e t h e R U N statement. Must follow the JOB statement when the system is operating in job mode.
Must precede the RUN s t a t e m e n t ( i f RUN is u s e d ) .
1 . lf found in a pro- cedure, indicates nested procedures.
No more than nine levels of nested procedures allowed Must not be be- tween LOAD and R U N o r C A L L a n d R U N . 2 .
/ / C O M P I L E Supplies informa- tion about the program to be compiled or assembled to the c o m p i l e r a n d th e linkage editor.
Must follow LOAD or CALL statement and precede the RUN statement.
Must follow the LOAD statement and precede the RUN statement ( i f R U N i s u s e d ) .
O n l y o n e C O M P I L E statement allowed per job step.
II DATE Changes system date and parti- tion dates.
Changes parti- tion date for job.
Changes parti- tion date for step.
Must precede the first JOB. CALL, or LOAD statement.
M u s t fo l l o w th e J O B statement and precede a LOAD statement (either before the first step or between steps).
Must follow the LOAD or CALL statement and precede the RUN.
N o t a p p l i c a b l e
Before LOAD statement.
After LOAD and before R U N .
None
None
Cannot be entered if DATE was used to change partition date for job.
II FILE Supplies informa- tion about a file to the system.
Must follow LOAD or CALL statement and orecede the RUN statement.
Must follow the LOAD statement and precede the RUN statement ( i f R U N i s u s e d ) .
Required for every new file created and for existing files being used.
P a g e o f G C 2 1 - 5 1 6 2 - 1 lssued 28 September 1979 B y T N L : G N 2 1 - 5 6 7 4
Figure 1-2 {Part I of 5}, Table of OCL Statements
S t a t e m e n t D e s c r i P t i o n s 1 ' 9
Coding Notes Statement Appears
In Job Stream // HALT I nstructs system
t o h a l t w h e n program ends;
cancels the effect o f n o h a l t m o d e .
Anywhere among the OCL statements.
Must precede the RUN statement (if RUN is u s e d ) .
/ / I M A G E Tells the system to replace the chain-image area with characters indicated in the data records that are read from the system input de- vice or read from t h e s o u r c e li b r a r y .
Anywhere among the OCL statements.
Must precede the RUN s t a t e m e n t ( i f R U N is u s e d ) .
R e q u i r e d if t h e p r i n t e r c h a i n h a s been changed.
1 . l f s y s t e m s e r v i c e program control statements follow t h e R U N s t a t e - m e n t in t h e s o u r c e m e m b e r . t h e y a r e placed in the SWA and read from there by the system service program.
2 . M u s t n o t b e b e t w e e n C A L L a n d R U N . / / I N C L U D E l d e n t i f i e s t h e
e n t r y i n t h e source library that contains the OCL state- ments to be merged into the job stream.
Allows you to run related job steps together to ensure they are run s e q u e n t i a l l y .
Anywhere among the OCL statements.
M u s t p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is u s e d ) .
//jobname JOB Must precede the first
L O A D o r C A L L state.
m e n t fo r a j o b .
Cannot be used in a procedure.
Places a partition i n j o b m o d e . R e - q u i r e d w h e n e v e r s p o o l i n g is a c t i v e . // LOAD
or //stepname
LOAD
l d e n t i f i e s t h e program to be r u n a n d in d i c a t e s the disk that con.
tains the object l i b r a r y f r o m w h i it is to be loaded.
lVlust precede the RUN s t a t e m e n t . M u s t fo l l o w t h e J O B s t a t e m e n t w h e n the system is operating i n j o b m o d e .
M u s t p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is u s e d ) .
Figure 1-2 (Part 2 of 5). Table of ocl statem€nts
1 - 1 0
Statement Function
Placement
Coding Notes Statement Appears
In Job Stream
Statement Appears In a Procedure // LOAD *
o r //stepname
L O A D -
I nd icates that a f t e r t h e R U N statement is processed, the object program w i l l b e l o a d e d from the system i n p u t d e v i c e o r f r o m t h e f i l e indicated on the s p e c i f i e d u n i t .
M u s t p r e c e d e t h e R U N s t a t e m e n t . M u s t fo l l o w t h e J O B s t a t e m e n t w h e n t h e s y s t e m i s o p e r a t i n g i n j o b m o d e .
M u s t p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is used). Object program w i l l b e r e a d f r o m t h e s v s t e m i n p u t d e v i c e .
A LOAD * program cannot be loaded if a n o t h e r L O A D * Program (with over- l a y s ) i s e x e c u t i n g i n a n o t h e r p a r t i t i o n .
// LOG Changes the device u s e d fo r d i s p l a y - ing system messages and controls page ejection before E J a n d E S a n d after EJ.
Anywhere among the O C L s t a t e m e n t s .
M u s t p r e c e d e t h e R U N s t a t e m e n t s ( i f R U N is u s e d ) .
A p p l i e s o n l y t o t h e p a r t i t i o n i n w h i c h i t was entered.
/ / N O H A L T I nstructs system t o c o n t i n u e w i t h - o u t s t o p p i n g w h e n a p r o g r a m ends and/or sets t h e s e v e r i t y l e v e l o f h a l t s .
Anywhere among the O C L s t a t e m e n t s .
M u s t p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is u s e d ) .
N o n e
/ / P A U S E C a u s e s O C L processing to stop i n o r d e r t o g i v e t h e o p e r a t o r ti m e to perform a f u n c t i o n . O p e r a - tor must restart O C L p r o c e s s i n g .
A n y w h e r e a m o n g th e O C L s t a t e m e n t s .
M u s t p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is u s e d ) .
T h i s is t h e o n l y O C L s t a t e m e n t d i s p l a y e d o n t h e C R T .
/ / P R I N T E R E n a b l e s y o u t o d e s c r i b e t h e f u n c t i o n s p e r - f o r m e d b y t h e s y s t e m p r i n t d e v i c e a n d c o n t r o l o p t i o n s r e l a t e d to p r i n t s p o o l i n g .
A n y w h e r e a m o n g t h e O C L s t a t e m e n t s .
M u s t p r e c e d e t h e R U N s t a t e m e n t ( i f R U N is u s e d ) .
N o n e
Figure 1-2 (Part 3 of 51. Table of OCL Statements
S t a t e m e n t D e s c r i p t i o n s 1 - 1 1
