Text preview for : GC21-7661-5_IBM_System3_OverlayLinkageEditorReferenceManual_Sep78.pdf part of IBM GC21-7661-5 IBM System3 OverlayLinkageEditorReferenceManual Sep78 IBM system3 GC21-7661-5_IBM_System3_OverlayLinkageEditorReferenceManual_Sep78.pdf



Back to : GC21-7661-5_IBM_System3_O | Home

aaaa aaaa
aaaa aaaa
aaaaaaoaaoaoaaaaaa
aaaaaaaaaoaaaoaaao
aaaaaaaetaeaaoaaca
a a o a aaaa o a a a o aa c a o
aaaa acoa
aaaa ccaa
aa
aa
aa
.O
ao
ag aa
ao OO
aa aa
oa aa
oa aa
aa aa
aa a
aa
o
aaa


IBMSystem/3
Overlay
Linkage
Editor
Manual
Reference


ProgramNumbers:
5702-SC1(Models8 and 10)
s703-SC1 (Model6)
5704-SC1(Model15)
5704-SC2(Model15)
aaaa acaao
5705-SC1 (Model 121
aaoaa oaaaaao
aaaaaa aaaaaaaoa
aaaaaaa aaaaaaeaaaa
oaaaaaa aaoaoaoacaa
aaaa aaaa aoaa
o9aa aaac oooa
aoaa aaaa aoaa
aaaaoaaaSaca aaooaa
aoaaaoaaacaa aaaaaa
aaaaaaaaao caaaa
aaaaaaaa aaoa
aoaaoa




aaaa aaaa
aaaa aaaa
aaaaaaoaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaa a a a a aaaaaaoaaa
aaaaoaaaaaaoaaaaoa
aoao aaaa aaaa
aaaa aaaa aaaa
oaaa aaaa aaaa
aoaoaa oaaa aaaaaa
aaaaaa aaaaaa
aaaaaa aaaaaa
aaaaaa aaaaaa




GC21-7561-5
File No. 53-31
aaao aoaoaa
aaaaa aaaaaa
aaaaaa aaoaaa
oooaaaa aaaaao
aaaaaaa oaaa oaaa
aaaa oaaaa aaao
aaaa oaaaaa aaaa
aaao aaaaaooaaaa
oaaaaaaa aaaaaaaoaaa
aaaaaaaaoao aaaoaa
aaaaaaaaaa aaaaa
aaaaoooa aaaa
oaoaaa
Preface




The Overlayl-urkageEditor is a part of the IBM System/3 System/3 ModelS
Model l5 System ControlProgram (Program Number
5704-SCl),and is a separately orderablefeatureof the The System/3 Model8 is supported Systemi3Model l0
by
IBM System/3Model 10 Disk System(Feature 602616027), Dsk Systemcontrol programrning program
and products.
IBM System/ilModell2 (Feature60261602j).and IBM the The faciliticsdescribed this publicationfor the Mc,del10
in
System/3 Model 6 (Feature 601I /6012). This manualpro- are alsoapplicable the Model 8, althoughthe Model 8 is
to
videsreference inforrnation for programmers using the not referenced.It shoulCbe noted that not all devicr:s
and
OverlayLinkageEditor capabilities System/3. This man-
of featureswhich are available the Model 10 are available
on
ual is intenderl experienced
for progranmers who plur to on the Model 8. Therefore,Model 8 usersshouldbe familiar
linkcdit their own objectmodules ratherthanhavethe with the contentsof IBM Systemf Model 8 Introdu,ction,
3
ianguage tranr;lators(assemblers contpilers)do the
and G C 2 1 - 51 4 .
1
link+diting.



Note: In this publicationtherearesomereferencesto
supportof 64K bytesof main storage.A Systeml3Model
10 with a 64K processing is available
unit only asan RPQ.
Your IBM Marketing Representative provideinforma-
can
tion about this.



Sixth Edition (September
1978)

T h i s i s a r n a j o r r e v i s i o n o f . a n d o b s o l e t e sG C l 2 l - 7 5 6 1 4 a n d t e c h n i c a l n e w s l e t t e r s
cN21-5406 and (]N21-5585. changcs or aclciitionso the tcxt and illustrations are t
i n d i c a t e d b y a v e r r t i c alli n e t o t h o l e f t o 1 ' t h c c h a n g c o r a d d i t i o n .

This edition appniesto thc System/3 progran.lversions listcd belrw and to all subsequenr
vcrslons and moclifications until othcrwise indicated in ncw editions or technical news-
l e1t e r s .

Version Modifications Program Number Feature Number Model

ls 0 5 702-SC I 6026,6027 8,10
15 0 57 0 3 - S C
l 6010,6011 4,6
6 0 5704-SC1 6 0 3 3 , 6 0 7 0 , 6 0 71 s A .1 s B 1 s C
1 ,
3 0 s704-sc2 601r,6012 isD
4 0 5705-SC1 6070,6071 t2
changes are periodically made to the specifications herein; before using this publication
in connection with the operation of IBM systems, refer to the latest IBM system13
Bibliography, GC20-8080, for the editions that are applicable and current.

Use this publication only for the purposes stated in the heface.

Publications are not stocked at the addressbelow. Requestesfor copies of IBM publi-
cations and for technical information about the system should be made to your IBM
representativeor to the branch office serving your locality.

This publication could contain technical inaccuracies or typographical errors. Address
your comments about this publication to IBM Corporation, pub[cations, Department
2 4 5 , R o c h e s t e r ,M i n n e s o t a5 5 9 0 l . I B M m a y u s e a n d d i s t r i b u t e a n y o f t h e i n f o r m a t i o n
j'ou supply in any way it believes appropriate without incurring any obligation
whatever
You may, of course, continue to use the information you supply.

O C o p y r i g h t I n t e r n a t i o n a l B u s i n e s sM a c h i n e sC o r p o r a t i o n 1 9 ' 1 1 , 1 9 ' : . 2 , 1 g 7 3 , 1 9 7 4 ,
1974.1975.19't8
Contents




INTRODUCTION I APPENDIX A. MESSAGES 38
System Configuration 3
himary Storage Requirements APPENDX B. OBJECTMODULES
J 13
Secondary StorageRequirements 3 HeaderRecord 13
Error Halts J External Symbol List (ESL) Records . 13
Changesin Load Module Size 3 Text-Relocation Directory (RLD) Records 11
End Record 45
USINGTHE OVERLAY LINKAGE EDITOR
Cornpiler Entry APPENDIX C. PERFORMANCEIMPROVEMENTS 17
UserEnty
OCL Staternents 4 GLOSSARY , 19
Control Statements
Parameter Summary o INDEX . 'st
Storage Map t2

OVERLAYS . 13
Overlay Areas l3
Root Area l3
User Overlay Area l3
System Overlay Area 14
Co-resident Area T4
Assigning Overlays l4
Control Statements and Object Modules . 15
Determining Which Modules Can Be Overlaid l6
Link-Edit Start Addresses 16
Load Module Entry Point l8
Overlay Area Size i8
lncluding Overlay Areas in the Root l8
Using the Group Statement 18
M e m o r y R e s i d e n t O v e r l a y s( M o d e l 1 5 O n l y ) 19
Supewisor Support for Memory Resident Overlays . . 19
Using Memory Resident Overlay with Communicatrons
Control hogramming . l9
Memory Resident Overlay Propgam Execution - 20
E.recution of the MOVE Technique f l

Execution of the REMAP Technique . 22
E)Q\MPLES . L)
Examples I through 5 LJ
E x a m p l e s6 a n d 7 27
Example 6 (frigure 12) 27
Lxample 7 29
E x a m p l e s8 t h r o u g h 1 1 30
Example 8 3l
Example 9 32
Example l0 JJ
E x a m p l e1 1
E x a m p l e s1 2 a n d 1 3 35
Example 12 35
Lxample l3 36
Introduction




Unkageeditor processing necessary
is following the assem_
bly or compilation of any program. The output of a lan-
guagetranslator(assembler compiler.y calledan object
or is
module(seeFigure1). An objectmodulecannotbe run
asa program until it is link-editedinto a load module. Ob_
ject modulesand load modulescan resideon cardsor in
the
object library on disk (seeFigure2).




Source
Obiect Load
Program
Module Modu le




Figure 1. Preparing a Source Program for Execution




Introduction
_ {bject Library_D,.Eclgry-
_
Permanent ntries
E
' O L i b r a r VE n t r i e s
. B LibraryEntries



Temporary Entries
- O Library Entries
- R LibraryEntries




T h e O l i b r a r y e n t r i e sa r e l o a d m o d u l e s . T h e y a r e l o a o e d
by the LOAD OCL statement.

T h e R l i b r a r y e n t r i e sa r e o b j e c t m o d u l e s t h a t m u s t b e
link-editedinto a load module before theV can be loadeo.




Figure2. Format of Object Library




The OverlayUnkageEditor provides cornpiler
a entry and The userentry allowsthe userto link-editIBM Systern/3
a userentry. The compilerentry provides following
the BasicAssembler objectmodules and objectmodules built
functions: by other language into load modules.Tireuser
translators
caninfluence determination overlays
the of himselfor he
. Punches into cardsand/or catalogs into the objectlibrary can allow the OverlayLinkageEditor to determine the
on a disk the output objectmoduleof a language trans- overlay structure.The load modules can be punched in.to
lator suchasIBM Systenr/-3 FORTRAN,COBOL,Basic cardsand/orcataloged into an objectlibrary on disk.
A s s e m b l e a.n dM o d e l1 5 R P Gl l .
r

o Link-editsthe output of language translators suchas
I B M S y s t e m i F O R T R A N ,C O B O La n dM o d e l l 5
3
RPGII into a load moduleand punches load the
lnoduleinto cardsandior catalogs into an object
it
library on disk. The assigning modulesto overlay
of
segments determined
is automatically the Overlay
by
LinkageEditor.
SYSTEM ONFIGURATION
C PRIMARY TORAGE EOUIREMENTS
S R

For informationconcerning minimum system
the config- The prirnarystorage
requirements the executionof the
for
urationfor OverlayLinkageEditor and additional
devices OverlayLinkageEditor areaslollows:
supported. one of the followingpublications. appro-
see as
priatefor your System/3model: Systeml3Model MainStorage
. IRM S.r,stemfModels4, 6,8. 10, ontl l2 System
3 Models and 6
4 1K
Generation RelbrenceManual,GC2l-5126 Models and l0
8 1K
M o d e ll 2 8K
o IBM Svsteml3 Model I5 System GenerationReJbrenc.e
M o d e l1 5 l0K
Irfanual.
GC2I-7616

IBM S,t,steml3
Model 4 Introduction, GC2l-5146 S E C O N D A R Y T O R A G E E O UR E M E N T S
S R I

IBM Systemf Model6 Inftoductktn, GA2l-9122
3 The OverlayLinkageEditor requires tracksin the object l0
l i b r a r y . F o r e x e c u t i o nw o r k s p a c e u s tb e a v a i l a b la s
. m e
IBM Systeml3Model 8 Introductittr, GC2l-5114 follows:

IBM Systemf Model I2 Introcluctioir,GC2l-5 l l6
3 3340
5444 5445 5444
IBM S.vstemf Model I5 Introduction, GC2l-5094
3 Simulation Area Main Data Area
M o d e l s4
and 6 X

Models 8
X
and 1O


M o d e l1 2 X

Model 15 X X X X




This spacecan be specified the useror allocated the
by by
OverlayI inkageEditur (seeindexentry: OCL statements).



E R R O RH A L T S

Haltsare issued with system halt messages SYSLOGfor
on
e r r o rc o n d i t i o n s . f t h e l o g i s o f f , a s e c o n de v e lh a l t i s
l l
r s s u e do l ' u l l yd e fi n e t h e e r r o rc o n d i t i o n M o d e l s , l 0
t ( 6
D i s kS y s t e r n .n d l l ) .
a


C H A N G E SN L O A D M O D U L ES I Z E
I

Changes madeto the Ove rlay LinkageLditor l'rom release
t o r e l e a sm a y c a u s c h a n g en t h e s i z eo f t h e o u t p u t l o a d
e c i
m o d u l e rF o r e x a n r p l e , p r o g r a ntlh a t l r t si n 4 K o n o n e r e -
. a
l e a s e a y n o t f l t i n 4 K o n t h en e x t r e l e a s e .
m




lntroduction 3
Usingthe OverlayLinkageEditor




This sectiondescribes compilerand userentries the
rthe to OCL Statements
OverlayLinkageEditor and the storage map printedby thc
OverlayUnkageEditor to infornr the userof the srrucrure Thc fbllorvirig
OCL starernents examples loadingthc
are of
'[he
oi-lrisprogrant. input objectntodules usecl both
by OverlayLinkageEditor via thc usercntry:
cntrieso1'the Overlay.Linkage Editor are described
in
AppendixB. M o d e l 1 0 D i s k S y s t e m ,M o d e l ' ! 2 , a n d M o d e l 1 5

/ / L O A D $ O L l N K , u n i t( u n i tc a n b e R 1 , F l , R 2 , o r F 2 )
COMPILER NTRY
E ( I h e s el w o F I L E s t i l t e -
II FILE NAME $SOURCE . 1
m e n t sa r e o p t i o n a la n d
t
The cortrpiler ntrv to the OverlayLinkagcEditor is usecl
e are standardFl LE s1:ate
!I FILE NAME_$WORK, ' ,
by language translators punchand/orcatalog
to their out- ,f -"nt, usedby the
put objcct niodules (otrjectmodules described Ap- compilers.)
arc in i/ RUN
p en d i x l 3 ) . L a n g r r a g ea n s l a r o r s u c ha s t B M S v s t e r l / - l
tr ,
F O R T R A N .C I O B O La n d R P GI l ( M o d e lt 5 o n l y ) ,c a n
.
Model 6
a l s os p c c i f y i n k - e d i t i n gT l i e O v e r l a y i n k a g e d i t o r
l . L E
t h e nl i n k - e d i t sl r eo i r j e c t n o d u l en r o a l o a d m o d u l e
t r i O1OLOAD NAME_ $OLINK
a n d p u n c h e s n d / o rc a t a l o gt h e l o a dr l o d u l e .
a s 0 11 uNlr ( R 1, F 1 , R 2 , o r F 2 )
O 2 OF I L E NAME_ $SOURCE \
Whenthc usercrlrnpiles object moduleand inrmecliately
an I { T h e s et w o F l l _ E
l i n k - e i l s i t i n t o a l o a dr n o d u l e i a t h e c o m p i l e r n t r y .h e |
d v e
\ s t a t e m e n t sa r e
t : l n i n f l u e n c el i c d c t e r r n i n a t i oo f o v e r l a y o n l i rb y s p e c i -
t n s O 3 OF I L E NAME_ $WORK { o p t i o n a ta n d a r e
1 , v i n t h c c a t e g o r y f t l h t o b j e c tn t o d u l e c l nt h c c o r n p i l e r
g o s I s t a n d a r dF l L t
I
i n p u t . F o r t h e O v e r l a y i n k a g cr c l i l r rn r e t h o d f ' d e t c r -
L s t a t e m e n t su s e , l b V
l r o 't t h e c o m p i l e r s . )
nrining overlaystructure, indcx cntry: deterntining
see MODIFY
oYerlq) nndulas.
RUN


U S E RE N T R Y T h e ( ) v e r i a y l - i n k a g cE d i t o r r e q u i r e sf r o n t 1 0 t o 3 0 t r a c k s
o f d i s k s p a c e . F I L E s t a t c r n c n t s h o u l d b e s u p p l i c df o r
s
'fo l a r g c p r o g r a m s 2 5 K o r r n o r e , o r i 1 ' t h c p a r t i t i o n s i z et h a t
( )
usctlte OverlayLinkageEditor,the userntustsupply:
t h e O v e r l a v l - i n k a g cE d i t o r i s c u r r e n t l y i n . i s 2 5 K o r m o r e .
. OperationContnrl l_;inguage
(OCL) statemcnts l l t h c t w o l j l [ - E s t a t c r n e n t s r e s u p p l i e d ,t h e y r n u s t b b t h e
a
s a r i l ea s t h e s t a n d a r dF I L E s t a t e n t c n t s s e b y t h e c o r n p i l e r s .
u d
o O v e r l a y L i n k a g c 'E d i t o r C o n t r o l s t a t e m e n t s T h c O v e r i a y L i n k a g e l r d i t o r w i l l t l n d d i s k s p a c ei f F I L [ r
s t a t c n r e n t s r e l l o l s u p p l i c c l .S l t a c cw i l l b c a s s i g n e d n F l
a o
. M o d u l c s t o b e l i n k c ' d( d c s c r i b e i n A p p e n d i r B )
d i f t h c r c i s a m i n i n r u r r ro 1 ' l 0 t r a c k s a v a i l a b l e e v e n t h o u g h
(
l 0 t r a c k s m a y n o t b e s u f t l c i e n t l b r a l a r g ep r o g r a m ) . l 1 '
t h e r n i n i m u r ns p a c ei s n o t a v a i l a b l e n F l , s p a c ew i l l b e
o
assigncd n R l. o

Y o u r n a y s a v et i m e i f y o u s u p p l y F I L E s t a t e r n e n t so p l a c e
t
the fiies optimally(see Appendix C.,Perlbrmance Improve-
n r e n t s \ ' . l b rt h e M o d e l 1 5 , f i l e s s h o u l d b e p l a c e do n a
5 4 4 5 d i s k d r i v e ( o r 3 3 4 0 r n a i n d a t a a r e a )f o r b e s t p e r f o r -
m a n c e . F I L E s t a t e n t e n t s a n a l s o b e s u o p l i e dt o e n s u r e
c
that the Overlay Linkage E,ditor has adequate work space
to completethe link-edit.

T l r e O C L s t a t e n r e n l s a n b e e n t e r e c I ' r o n tt h e s y s t e mi n p u t
c l
device r.rrcalled front the procedure librarv.
Control Statements

OverlayLinkageEditor control statemeltscanbe entered
from the systcminput dcviceor from the procedure
library.
The typesof controlstarements arc:

1. P H A S Es t a t e m e n to p t i o n a l ) .
(

2. OPTIONSstatement
(optional).

3. iNCLUDE statements and/orobjectmodules card
in
form (required).The first objectmoduleencountered
(eitherin cardform or indicated an INCLUDE card)
on
will be the mainlineroutine.

4. GROUPstatemenr
(optional).

5. C A T E G O R Y t a t e m e n to p t i o n a l ) .
s (

6. EQUATEstatemenr
(optional).

1. E N D s t a t e m e n tr e c l u i r e d ) .
(

Control Statament Su mmary



Use Control Statements


D e f in e / / p H A SN A M E - n a m e . U N r r - c o d e . p U lN C H -
E
{ Nt o} , R E r A r N{-* f
l : {' , *o ^"
, .' ,"r" ' .o o " J * . * , " " r r , t , * , - o - { I E l }
Load
Module*
i,| i;,;"",""
i*o /
D e f in e / / O P T IO N S U P A C K - c o d e , C O R E - a n n K , L E V EL - n n n , E N T R y _ t a b e t ,
Environment ArrR-xxx,MAt (::l
r!u i
<

t il,3:'J
Def ine Ob.jecr i / I N C L U D E N A M E - n a m e ( o r ' n a m e , n a m e., . . n a m e , ) , U N l T - c o d e
Modules

Group Object / / G R O U P N A M E - n a m e ( o r ' n a m e , n a m e ,.. . n a m e ' ) , A R E A - U S E R
Modules
Together
anStorage

Change // CATEGORY NAME-name (or'name,name. . . name'),VALUE-nnn
,
Category
of Object
Module

E qu a t e //EOUATEOLDNAME-name(or'name,name,...name'),NEWNAME-name(or,name,name,...name,l
Module
Names

End of // END
Control
Statements




.RLD- o n r yr o M o d e 1 5
r
{l5t } "oo,'",
Using the Overlay Linkage Editor 5
Parameter
Summary
The lbllowingis u discussion thc paranreters eachof
of lirr
t h e c o n t r o ls t a t e n l e n t s . r e n t h e r ei 's a c l e f a u lv a l u e u r
W t f
a p a r a m e t e rh e d e f a u l t a l u e s u n d e r l i n c d .
t. v i

PHASEStatement
T h e P H A S Es t a t c r n e n tp e c i t i ets e n a r n e n d d e s t i n a t i o n
s h a
o f t h c 'l o a dm o d u l e . 1 1t'l i e P H A S Ls t a t e r n e ns o n r i t t e d .
, it
t l i e l o a d m o c l u l es a s s i g n etd e s a n t c a n l ea st h e n r a i n l i n e
i h n
routine(seeindcx cntr,"-:IIVCZ UDI')statr:tttt'll/and is
c a t a i o g ea sa t e n l p o r a r . yn t r y i n t l i e o h j c c tl i b r a r yt ; 1 ' t l i e
d e
p r o g r a np a c k .
r

t'I { s
( s*x'u"uu')
I ; v r sI
/ i P H A S E N A I \ i l E -n a m e , U N l T c o d e , P U N C H ,REr A' !NF ;'
1 , L I NK A D D
)u '( f n l ( x'"u"u' ) i*;i
NAME- name The name that tlrc load module has rn the r:biect library directory. lf the NAME
p a r a m e t e r i s n o t s u p p l i e d , t h e l o a d m o d u l e a s s u m e st h e N A M E o f t h e m a i n l i n e
routine. The nanre can be from one to six charactersionq and can contain anV
combination of SVstem/3 characters except bla'rks, commas, quotes, or perlods.
The first character must be alphabetic.


U N IT - c o d e D r s kw h e r e t h e l o a d m o d u l e i s p l a c e d . P o s s i b l e o d e sa r e R 1 , F 1 , R 2 , a n d F 2
c
l f n e i t h e rt h e U N I T o a r a m e t e r o r t h e P U N C H p a r a m e t e r s s p e c i f i e d t h e l o a d
n i ,
m o d u l e i s p u t o n t h e p r o g r a mp a c k .

PUNCH-
1N"o", I
t
Specifieswhether to punch the load module. lf not supplied, the default is NO.
The load module can be both punched into cards and put in the object li[rary by
specifying both UNIT and PUNCH parameters.




RETATN-P
{r) Specifieswhether the load module rs to be cataloged as a temporary or permanent
i i entry in the object library directorv. RETAIN R m e a n s r e p l a c e a n e x i s t a n ge n t r y
with the same name. The RETAIN type of the new module is P. lf no entry
exists with the same name, the new entrV is added with a permanent designation
{ P ) . l f R E T A I N i s n o t s p e c i t r e d ,T r s t h e d e f a u l t . l f R E T A I N P o r R i s s p e c i f i e d ,
all previous temporarV modules are deleted f rom the library. lf this parameter is
specified with PUNCH YES, the retain code rsspecified on the COPY card that
is puncheci wrth the module.


S p e c i f i e s t h e i i n k - e d i t s t a r t a d d r e s s , w h i c h i s t h e a d d r e s s a s s i g n e dt o t h e f i r s t b y t e o f t h e
l_:_
LIN KADD--< S+X'aaaa' link edited load module. On the Model 15, if S is specified, the start addressis X'4OO0',
|. . . a a a a
A
. An absolute address can be specifiei by coding X'aaaa', where aaaa is an absolute address.
S+X'aaaa' is coded to specify the end of the supervisor plus an absolute address. lf this
parameter is not coded, S is assumed. lf the start address plus the number of bytes in
the program exceeds X'FFFF', the program is link-edited to start at X'O0O0'. (The
System Control Program IProgram Number 5704-SC2] is link-edited to the Iargest
possible multiple of 2K.) This parameter does not atfect the loading of the load module
(see index entrv: link-edit start addresses\.

S p e c i ife sw h e t h e ra p r o g r a mw i l l b e p r o d u c e dw i t h T e x t ' R e l o c a t i o nD i r e c t o r y
RLD- r e c o r d s( R L D s ) . l f t h i s p a r a m e t e r s n o t s u p p l i e d , E S i s t h e d e f a u l t . T h i s
i Y
{p } p a r a m e t e a p p l i e so n l v t o t h e M o d e l 1 5 .
r
OPTIONSStatement

The OPTIONS statement describes load moduleand
the
specifies locationof userobjectrnodules the type
the and
of linkage editor output. If the entireOPTIONS staterrrent
or any of the pararneters ornitted.the defaults
are given
areused.


/ i O P T IO N S U P A C K - c o d e , C O R E - a n nK , L E V E L - n n n , E N T R y - t a b e t , A T T R - x x x , M A p -
YES
NO I
XREF f
UPACK-code D i s k w h e r e u s e r m o d u l e s t o b e l i n k - e d i t e dc a n b e f o u n d . l f U p A C K i s n o t
s p e c i f i e d ,t h e l i n k a g ee d i t o r l o o k s f o r t h e u s e r m o d u l e s o n t h e p a c k t h a t t h e
O v e r l a y L i n k a g e E d i t o r i s o n . T h i s k e y w o r d i s u s e dw h e n t h e O v e r l a y L i n k a g e
E d i t o r b e r f o r m sA U T O L T NK .

CORE-annK S t o r a g e i z et h e l o a d m o d u l e h a sa v a i l a b l eo r e x e c u t i o n , l f s p e c i f i e d t, h e
s f
d r r e c t o r ye n t r y c o n t a i n st h i s s i z ee v e nt h o u g h t h e a c t u a is i z er e q u i r e db y
t h e l o a d m o d u l e i s l e s s . l f n o t s p e c i f i e dt,h e c u r r e n tp a r t i t i o n s i z ei s u s e d
t o d e t e r n r n e w h e n o v e r l a y sa r e r e q u i r e d a n d t h e d i r e c t o r y e n t r y c o n t a i n s
t h e a c t u a l l o a d m o d u l e s i z e . T h i s p a r a r n e t e ri s n e e d e do n l y i f t h e p a r t i t i o n
s r z ea t e x e c u t i o nw i l l b e d i f f e r e n tf r o m w h a t i t i s a t l i n k - e d a tt i m e .
a = increments f 1/4 K o
A - 1 1 4o r 2 5 6 b y t e s
H - 1 1 2o r 5 1 2 b y t e s
f - 314or 768 bytes
0 ., zero bvtes

nn - 1K increments

E x a m p f e : Q O 4 K- 1 l 4 K + 4 K = 2 5 6 + 4 0 9 6 = 4 3 5 2 b v r e s

LEVEL nnn N u m b e r t h a t i s p l a c e di n t h e l e v e le n t r y i n t h e o b j e c t d i r e c t o r ye n t r y . D i f f e r -
e n t m o d i f i c a t i o n l e v e l so f l o a d m o d u l e sc a n b e a s s i g n e d i f f e r e n t l e v e l v a l u e s .
d
The maximum value for nnn is 255. Default value is 0O1. except for
l o a d m o d u l e sg e n e r a t e d V t h e f o l l o w i n g f M o d e 1 5 D c o m p i l e r s :
b l

5704-RG2,RPGil - 253r
5704-CB2,COBOL 2541
5704-F02,FORTRAN ..2551


ENTRY-label A n e n t r y p o i n t o r m o d u l e N A M E o f a n i n c l u d e dm o d u l e . D e f a u l t a st h e e n t r v
p o i n t o f t h e m a i n l i n er o u t i n e .




I I f a c o n r p i l c r r c t l u es t c r i R t o d u l e i s
link-cditcd usins the leve I
p a r a { n r t e r o f a n o t h e r c o r r r p i l c r .c r r o l l c ( ) u st i n l r ' / d a t c i n l i r r n t a t i o n
rvill bc printcd in thc nrodulc dircctorl' listing.

I t a l c v c l v a l u e o 1 0 0 0 t h r o u g h 2 5 2 i s u s e d .t h c t i n r e / d a t c i n f ' o r -
n t a t i o n w i l l n o t b c p r i n t c d i n t h c r n o d u l c d i r i : c t o r 1 ,l i s t i n r .




L l s i n gt h e O v e r l a y L i n k a g e E d i t o r
ATTR-xxx or A t t r i b u t e s o f t h e m o d u l e b e i n g l i n k - e d i t e d . l f A T T R i s n o t s o e c i fi e d , n o a t t r i b u t e s a r e
'xxx,xxx,,..
assr gnect.
xxx' x x x = I N O - I n q u i r y . T h i s p r o g r a m c a n b e r u n i n e i t h e r p r o g r a m l e v e l a n d d e d i c a t e st h e u s e
of the Inquiry key (PA1 key on Model i5) to its program level (normally used
to start processing).
I E V * l n q u i r y E v o k i n g . T h i s p r o g r a m c a n r u n o n a d e d i c a t e ds y s t e m o r i n l e v e l 1 o f a
D P F s y s t e m . I n a D P F s y s t e mt h e I n q u i r y k e y ( o r t h e R O L L O U T c o m m a n d
i n t h e S y s t e m C o n t r o l P r o g r a m I P r o g r a m N u m b e r 5 7 0 4 - S C l l ] i s d e d i c a t e dt o
t h e I E V p r o g r a mi n l e v e r ' ! . T h e I n q u i r y k e y i s n o r m a l l y u s e dt o c a u s et h e I E V
program to be rolled out to allowanother program to run. Usingthe System
C o n t r o l P r o g r a m { P r o g r a mN u m b e r 5 7 0 4 - S C 1 , t h e I E V p r o g r a m c a n r u n i n
)
e i t h e r p a r t i t i o n ,b u t c a n b e r o l l e d o u t o n l y w h e n r u n n i n gi n p a r t i t i o n 1 . T h i s i s
n o t s u p p o r t e d b y t h e S y s t e m C o n t r o l P r o g r a m ( P r o g r a mN u m b e r 5 7 0 4 - S C 2 ) .
D E D - D e d i c a t e d . I n a D P F s y s t e m ,t h i s p r o g r a m m u s t r u n w i t h t h e o t h e r p r o g r a m
levelinactive. This is not supportedby the SystemControl Program (Program
Number 57o4-SC2).
S R Q - S o u r c e R e q u i r e d . T h i s p r o g r a m r e q u i r e st h e a l l o c a t i o n o f t h e $ W O R K a n d
$SOURCE files. $SOURCE must be filled either f rom the system input device
o r a s o u r c e l i b r a r y . A n y p r o g r a m w i t h t h e S R O a t t r i b u t e w i l l b e l o a d e d ,a n d
r e l o c a t e d ,t o t h e n o r m a l l o a d p o i n t p l u s 1 O b y t e s .
D F M - D e f e r r e d M o u n t . T h i s p r o g r a m a c c e p t sm o u n t i n g o f p a c k s d u r i n g i t s e x e c u t i o n .
S I D - S Y S I N D e d i c a t i o n . T h e s y s t e m i n p u t d e v i c em u s t b e d e d i c a t e dt o t h i s p r o g r a m .
The deviceis released t end of job. a
CPR -Checkpoint RestartProgram.
D S R - D i r e c t S o u r c e R e a d . T h i s p r o g r a m c a n h a v ea / / C O M P I L E s t a t e m e n ta n d a
n o - s o u r c e - r e q u i r ea t t r i b u t e . S Y S I N d e d i c a t i o n c a n a l s o b e r e l e a s e d y p r o g r a m
d b
a n d n o t h a v e t h e s o u r c e - r e q u i r e d t t r i b u t e . T h e p r o g r a m a c c e s s et h e s o u r c e
a s
librarvitself"
M R O - M e m o r y R e s i d e n tO v e r l a y R E M A P P r o g r a m ( M o d e l 1 5 ) . W h e n s p e c i f i e d ,t h e
p r o g r a m e x e c u t e st h e s e g m e n t si n t h e r e s i d e n ta r e a i t s e l f .
M O V - M e m o r y R e s i d e n tO v e r l a y M O V E P r o g r a m ( M o d e l 1 5 ) . W h e n s p e c i f i e d ,t h e
p r o g r a m r e t a i n st h e s e g m e n t i n t h e r e s i d e n ta r e a b u t e x e c u t e st h e s e g m e n t i n
t h e c o n v e n t i o n a lo v e r l a v f e t c h a r e a .

Notes:
1. CPR and IEV aremutuallvexclusive n all models. o
2 . I N O a n d I E V a r e m u t u a l l y e x c l u s i v e n M o d e l s6 , 8 , 1 0 , a n d 1 2 .
o
3. MRO, MOV, lEV, and CPRaremutuallyexclusive n Model 15. o
4 . A c h e c k p o i n t / r e s t a r tp r o g r a m c a n n o t h a v e e x t e r n a l b u f f e r s ( 5 7 O 4 - S C 2 ) .

l f A T T R i s n o t s p e c i fi e d , n o a t t r i b u t e s a r e a s s i g n e d .


Type of printer output during link-edit:

JFI
ril::'' Y E S = A s t o r a g em a p a n d m e s s a g ea r e p r i n t e d . l f M A P i s n o t s p e c i f i e d ,Y E S i s a s s u m e d ,
N O = N o s t o r a g em a p o r m e s s a g ea r e p r i n t e d .
s
s

x R E F = A s t o r a g er r n p , c r o s s - r e f e r e n cles t , a n d m e s s a g ea r e p r i n t e d .
i s
M S G = O n l y m e s s a g ea r e p r i n t e d .
s
INCLUDE Statement

-fhe / / G R O U PN A M E - - r r a m e ,R E A U S E R
A
I N C L U D E s t a t e m e n rs p e c i f i c s h i c h o b j e c t m o c l u l c sa r e
w
t o b e i n c l u d e di n t h c 'l o a d m o d u l e . M u l t i p l e n r o c l u l cn a t r r e s The name of a module that should be assigned
to the user area or the names of the obJect
r n a y b e s u b n t i t t e do n ( ) l t c I N C L L I D I : s t a t e n t e n t . T h e t i r s r
module5 that must all be rn storageat the sante
o b j e c t m o d u l e n a m c d o n a n l N ( ' L U D E s t a t e r r r e r r lr r ea d
o t irne.
f ' r o r nt h e S Y S I N d e v i c ei s t h e r n a i n l i n cr o u t i n c . I f a r n o c l u l e
n a m e i s n o t l o u n d o n t h e U N I T s p e c iife c l . l r a l t l l w i l l
a A R E A . , U S ER It the modules named in thts statement are
r e s u l t . B y t a k i n g a z er o o p t i o n , r l r c p r o g r a l l w i l l d o I l l n d a s s r q n e dt o a n J v e r l a y , t h e y w r l l b e a s s r g n e d

o n t h e n e x l n t o d u l e n a r n ei n t h e s t a t c n l e n t . E i t l t er a n to the user overlay area. lt a list of narnes
( ' n a m e , n a m e . . .. ' ) i s u s e d w i t h A R E A - U S E R ,
I N C L U D E s t a t e r n e n t r a n o b . j e t r n o d u l ei n c a r c lt ' o n r r
o c
the named modules are grouped rfr the user
n r u s t b e s r r p p l t e d s i n p u t t o t l r c O v e r l a yL i n k a g e L , c l i t o r .
a overlay area. To force muitrple modules to
the user area wrthout grouping them togelher.
s p e c i f y e a c h m o d u l e n a m e o n a s g p a r a t eG R O U p
/ / I N C L U D E N A M E - n a m e ,U N t T _ c o d e statement.


NAME- name Name{s) of the objecr modutels) ro be
or includt:d in tfris proqram.
NAM E-'name, CATEGORY Statement
name, . name

T h c C A T E ( I O R Y s t a t e r n e n rs u s c d 1 o r c r n p o r a r i l yc h a n g c
i
U N IT - c o d e Disk unit where obJect module ls located.
t h e c t t c g ( ) r y v a l u c ( p r i < t r i t y )o f o b i e ' c tn r o t l u l c s . B e c a u s e
It omitted, will default to the program pack
t h c p r i o r i t y o 1 ' a nr . r b j c c r r r o d u l ci n t l u er r c c st h e p l a c e n e n t
t r
o f t h e t r t o d u l ci n l o a r r o v e r l a y .t h c u s c r c a n d e l e g a t c h e t
m o d u l e t o a d i l l ' c r , : n ts e q l l t e n lb y c h a r r g i n gh c c a t e g o r y
l
GROUP Statement v a l u e . T h c c a t c g o r yv a l u c o f t h c n r o d u l c i s c l r a n g e d n l y o
lor thislink-edit.
-fhe
G R O U P s t a t e m e n tc a n b e u s e dt o s p e c i f ya n u r n b c r o f '
o b j e c t r n o d u l e st h a t t i ) e u s e r w i s h e st o g r o u p t o e c t h c r i n
s t o r a g e . T h c u s c r n t a v d e s i g l r tj s o w n u v c r l l y s l r u c t u r c .
I CAUTION
b a s e co n h i s k n o w l e d g co 1 ' t h c o b j c c t r n o c l u l s b c i n g I i n k -
l e A p r o g r a r r f ' a i l u r cr r r a yr e s u l t l r o n t c h a n g t n g h c p r i o r i t y o f
l
e d i t ed , t o o b t a i n m o r c c f f i c i e n t l o a d i n go l ' o v c r l a y s c g n t c l t r s a s y s t c n tm o d u l c ( S l i x x x x l l o d u l c ) r r r a c o n t p i l c l o b j c c t
T h e s em o d u l c s a r e p u t i n t o t h c s a n r e v e r i a y s c g l l l e n to r
o r n o d u l c . C o n r p i l c ro b j c c t n l o d u l c sa r e r n o d u l c s u s L r a l l y
(
p a r t l y i n a n i t v c r l a vs e g m e n ta n d p a r l l r , , i l rl l r c r o o r s c q l l e l t r . S x x x x x ) l h a t a r e i n c lu d c d i n t h c l o a c