Text preview for : GC21-7608-2_System3_Model15_SCP_macros_reference_manual_Mar80.pdf part of IBM GC21-7608-2 System3 Model15 SCP macros reference manual Mar80 IBM system3 GC21-7608-2_System3_Model15_SCP_macros_reference_manual_Mar80.pdf
Back to : GC21-7608-2_System3_Model | Home
aaaa aaaa
aoaa aaaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaoaaaaaa
aaaaaaaaoaaaaaaaaa
a a a a o a a a a a a a aaa a a a
aaaa aaaa
aaaa aaaa
aaaa aaaa
aaaa aaaa
aaaaaaaaaaoaa aa aaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaa aaaa aaaa
aaaa aaaa aaao
aaao aaaa -aaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaa
aaaaaa aaaaaa
aaaa aaaa
IBM System./3 Model 15
System ControlProgramming
Macros
Reference
Manual
aaaa aaaaa
aaaaa aaaaaaa
aaaaaa aaaaaaaaa
aaaaaaa aaaaaaaaaaa
aaaaaaa aaaaaaaaaaa
aaaa aaaa aaaa
aaaa aaaa aaaa
aoaa aaaa aaaa
aaaaaaaaaaaa aaaaaa
aaaaaaaaaaaa aaaaaa
aaaaaaaaaa aaaaa
aaaaaaaa aaaa
aaaaaa
aaaa aaaaa
aaaaa aaaaaaa
aaaaaa aaaaaaaaa
aaaaaaa aaaaaaaaaaa
aaaaaaa aaaaaaaaaaa
aaaa aaaa aaaa
aaaa aaaa aaaa
aaaa aaaa aaaa
aaaaaaaaaaaa aaaaaa
aaaaaaaaaaaa aaaaaa
aaaaaaaaaa aaaaa
aaaaaaaa aaaa
aaaaaa
aaaa
aaaa
aaaaaaa
aaaaa
aaa aa
aaaaaaa
aaaa
aaaa
aaaa
aaaa
aaaa
aaaaaa
aaaaaa
aaaaaa
aaaaaa
aaaa aaaa
aaaa aaaa
aaaaaaaaaaaaaaaaaa
aaaaaaoaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaa
aaaaaaaaaaa
aaaaaaaaaaa
aaaaaaaaoaa
aaaaaaaaaaa
aaaaaaaaaaa
aaaa aa a aaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaaaaaaaaaaaaaaaaa
aaooaaaaaaaaaaaaaa
aaaa aaaa
aaaa aaaa
GC21-7608-2
F i l eN o . 5 3 - 3 6
P a g eo f G C 2 1- 7 6 0 8 - 2
l s s u e d2 9 S e p t e m b e r 1 9 7 8
By TNL: GN21-5649
Preface
Thismanua|describesthemacrcrinstrttcttcrtts1rtrlvic1t,ci|lisl..saiiii,i..i]i()ql;ir,|.;l-1i,'.,;\ri|l!i
the IBM System/3 Moclel 15. The publrc,riirrr:;i ir,tcnue,,j t;iiri-;
f o r p e r s o n s w h o a r e p r o g r a m r n i n g i n t h e i J a s i cA s s e m b l e r
L a n g u a g eo r i t s e q u i v a l e n t a r r d w h o a r e i a n i i i t d t w i i t , t i r c .r i l t : : . . 1 ' 1 , t ,. . , [ r ; - , , / t i e r ir ] i . i i ) , - - , ) t - o p e nT F ( D e f i r r e
D
concept of macro instructions and syslr:ii lrrograrn:'niitti l n r ; : , i , .1 i j i l r , t r . i l L j l u r . ; k s 1 , 1, s r r r a r j o o i r : .a r r r {t l r s k d e v i c e s ,
f r 1
f o r t h e I B M S v s t e m / 3 4 o d e l5 .
N 1
T h e f o l l o w i n g t o p i c s a r e d i s c u s s e il
F { e i at i : r l l " u i . : i r c a t r t n s
o Coding macro instructiotrs
r :.tt:;{ : . . , i i r ; a . a i , ( i ri r i, r r : ; i l i li , r 1 . ,irr i a r r r , r w i l ! { . l i r r : i t r r c i
; il
'i3SCr-ti;,;:.
: , l ) i r . j ! i j t i . i : , r . , 5 , ' 1 j i ' r : . . - r ,i r l d l L i . t i :
o D e s c r i p t i o n s f t l r e v a i t o u sl n a c r o r f t : i r , , 1 c l i ( , r ] : .
o
t ;i- i:'t l,,r5i1':;1 ,) it,:s't,,1{.t::g.',',/;if:; i;elf:fellCe MeftUal,
a OCL necessary to call the frracio llr{)crsi/rrr. ,}i.- j; /\iil
o Error conditions detected by the rlacro i)rOccs:(ri qt i5ltli ,.:,,,,stx;i::J frts:it:! 1i. iiystel; (',ntroi Frogrammtng
i i t J i : i ; ' t : : : :4 , ! a r t * a l i : . P r , , ' j a r i i i \ l r r ; c e r 5 7 0 4 S i , 1 .
: ;
t:'.'2 1-'Lt)'i I
t !!:!i/l :)v j!-,,.)!t :: lvlr:Jt'i .:\ .','r''\refi) l.of:trt:l Pfoglratntning
Ct;rt: ','.'t;is atrt! f-le:r.:rutr:,t ltllanuai i.i, P1691ut Nirrnbel.
'1
3 / ! )) :,i. , j i-r{l:.r :, i { i:l
T h i r d E d i t i o n( D e c e m b e r9 7 6 )
1
't'-'c!irriLiii
T h i s i s a m a j o r r e v i s i o n o f , a n d o b s o l C t e s ,G C l 2 l - 1 6 0 8 I a r r r ; l \ . i - o ! ! \ i e l i!1i
:
G N 2 1 - 5 3 5 3 a n d G N 2 1 - 5 4 3 2 . I n f o r n r a t i o n h a s b c e n a { l d . r , jr , r : i u L ' p , i I S C i r
5 7 O 4 - S C 2 a s w e l l a s S C P 5 7 O 4 - S C 1 . C h a n g e s t o 1 . , : , { , r , i r i r ' r ( , , r i ' t i i i n s . . r r 1':f r i l l i ' r r r r
1
by a vertical line.
T h i s e d i t i o n a p p l i e s t o v e r s i o r ' f , J s ,m t . ) l c r i r a t o r r 0 0 o l J l r i r i i - i i . V$ y : t i - , r r . j
f f u l o r , ] , . r: ,
'
S y s t e t n C o n t r o l P r o g r a m 5 7 0 4 - S C l , t o v e r s i c ) r r O l . r r ; c c i i i r i r t i , r r ; C O r : 1r t i ' i i \ i ' l l
t
S y s t e m l 3 M o d e l 1 5 S y s t e m C o n t r o l P r o g r a n r 5 7 O 4 S C : l . r ' r r il r ; , r l i 5 \ r l ] ! e q u i i , : r
versions and modifications until otherwrse ir'drcJted rrlr"!'!,'{rrir.,r., :r Teci,r,r.,,'
newslette rs.
j
C h a n g e s a r e p e r i o d i c a l l y n t a d e t o t i r r r J p c c i l i c ; ) t i o n s f t r r ' : i r ' i ) e r :r ' : u i r r i l i i i i :
p u b l i c a r i o n i n c o n n e c t i o n w i t t r t ! r e o p e r a t i o n c l ! 8 f u i : , ; ' , r r : ' , r , : J , i ! i . ) r ir ' i i '
IBM System/3 Bibliography, { . - r C 2 O ' B l i S t i -o r T t ,
i L j r l - i . r : r ,:i ,i ri i.aiJI.):i.r.irl
and current.
Use this publication only ior the ltliri)oses stalfj(l ilr ti:t .,, ,,,,
P u b l i c a l i o n s a r e n o t s t o c k e ( j a t t h e a d d r e s s L . l i U w [ : l d r r , i , , \ 1 :i;{ ) i { . , - jjr, . . j r ! U i \ l : : , ! j l ) r ,
c a t i o n s a n d f o r t e c h n i c a l i n f o r m a t i o n a b o u t t t r e s y s l e i n , i r o r i r r j' i r i rf r r : r { . lri , . ! . . r r i i i l l i r i
j
representattve Or tO the branch olfice servinll V.rur ti)0airi!
T h i s p u b l i c a t i o n c o u l t J c o n t a r n t e c h i i i c a l i n a c r . u r , , r c r e : . li r t l i : r j r f l , n r j . i j r , r r f i - ) : , , : t , i .
Reader's Comment Form at the back of this pul:lri:att(l1t .) ffl:tirc i)ir,i|,,,,ri itl.)i,.,, !
this publication. l f t h e f o r m h a s b e e n r e t n i u v u r i , a r j d r e r : , y r . ; r ; : i , . i r r l : r f, i , t l
r ril\il
Corporation, Publicatrons, Department 245, Uochester. ,\linrrri(.,i.r ij5:l,J; ! r : i i , ,: i r , : j vr j r r i l
l
a r r d d i s r . , b u t e a n v o f t h e i n f o r m a l - i o i t y o u j u l - ! p i , / n a i i y w a v r t b e t r e v c 5r r ; : , l 1 i i j i ) . r i i i r .
i
w i t h o u t I n c u r r i r l g a n y o b l i g a t i o n w h a i c v e r . Y o u r n . : : y , . . ,iio ! i r 5 c . c o r i i i T r u , t ! i r : , . ,, , ' "
r
information you supplV.
O C o p y r i g h t I n t e r n a t i o n aB u s i n e s M a c h i n e s o r p o r , : 1 r , ; ; t / ' l
l s C ,. t t i : i ! r .i , j . / r j
Contents
CHAPTER: TNTRODUCTTON
1 I CHAPTER 3: OCL AND SAMPLE PROGRAM
Writing Macro Instructions
63
OCL for Macro Processor 63
SystemConfiguration 4 S a m p l eP r o g r a m .
M a c r o I n s t r u c t i o n sP r o v i d e o
63
4 P u r p o s eo f t h e S a m p l e P r o g r a m 63
Termination of the sample Program 63
CHAPTER 2: MACRO INSiRUCTION STATEMENTS 1 Macro InstructionsUsed in the Sample program
P r o g r a m m i n gC o n s i d e r a t i o n s
66
7
S y s t e m S e r v i c e sM a c r o s 7 A P P E N D I XA : E R R O R I N F O R M A T T O N 67
S y s t e m R e a d e rS u p p o r t o
System Log Support I A P P E N D I XB : D E F I N E T H E F t L E C O N T R O L
G e n e r a lS C P S u p p o r t 12 BLOCKS 68
Input/Output Support
22
Generall/O Support A P P E N D I X : I N P U T / O U T P UB L O C K S
C T
22 106
C a r d D e v i c eS u p p o r l 28 D i s kI n p u t / O u t p uB l o c k
t 106
PrinterSupport Timer Input/Output Block.
33 111
D i s k D e v i c eS u p p o r t ?q
3 7 4 1 D e v i c eS u p p o r t 48 A P P E N D I X D : M A C R O I N S T R U C T I O NS U M M A R Y
T a p e D e v i c eS u p p o r r 49 CHART 112
D e v i c eI n d e p e n d e n g u p p o r r
t 5b
CRT/Keyboard 58 INDEX 119
DisplaySupport 58
Program Function Key Support 61
Chapter1: Introduction
A macroinstruction a source is statement that causes O p e r a n d s p e c i f yt h e a v a i l a b l e e r v i c e s n d o p t i o n s . T h e
s s a
generation a predetermined of assembler
of set statements operands must start in column 14, and are written as
e a c h i m e t h e m a c r oi n s t r u c t i o ns u s e d .T h e M o d e l1 b S v s t e m
t i follows:
Control Program provides macroinstructions which oer-
form both system services input/outputdevicesupport.
and . Each operand consistsof a keyword followed bv a dash
B y u s i n g h e s e a c r oi n s t r u c t i o n s , u c a np e r f o r mb o t h
t m yo and a parameter.
system and input/outputoperations with less coding.
o C o m m a ss e p a r a t e h e o p e r a n d s ; o b l a n k ss h o u l d b e
t n
F i g u r e1 i s a n o v e r v i e w f t h e o p e r a t i o n f t h e m a c r o
o o left between operands.
processor. The OCL statements usedto call the macro
processor explainedin Chapter3: OCL and Sample
are o Keywords - those shown in capital letters - are coded
Program. exactly as shown. The keyword part of each operand
must correspond to one of the keywords in tne macro
i n s t r u c t i o nd e s c r i p t i o n .
W RI T I N G M A C R OI N S T R U C T I O N S
. The parameter part of the operand must immediately
You codemacroinstructions follows:
as follow the dash.
S t a r ti n g -
Parameters those shown in lowercaseletters - indicate
C o l u m n1 72 i n f o r m a t i o n y o u m u s t s u p p l y . S o m e o p e r a n d sa r e n o t
Name Operation Operands Continuation r e q u i r e d . T h e s eo p t i o n a l o p e r a n d s r e i n d i c a t e db y
a
Symbol Macro No operands Any nonblank e n c l o s i n g h e o p e r a n dw i t h i n b r a c k e t s I K E y W O R D -
t
or blank n am e or one or more c h a r a c t e ri f parameterl .
separated y
b c o n t i n u a t i o ni s
coTl mas b e i n gu s e d
An option list for a keyword parameter is specified as
follows:
T h e n a m e f i e l d c a n c o n t a i n a n y v a l i d a s s e m b l e lra n g u a g e KEYWORD-A/B/C
s y m b o l i c n a m e b e g i n n i n gi n c o l u m n 1 . T h e n a m e i s
assigned the first byte of generatedcode. Since rne name
to T h i s l i s t i n d i c a t e s h a t t h e k e y w o r d h a st h e o p t i o n s
t
i s o p t i o n a l , i t i s s h o w n e n c l o s e di n b r a c k e t s . A , B , o r C . T h e s ea r e t h e o n l y v a l i d o p t i o n s f o r t h e
keyword parameter.
T h e d e s i r e dm n e m o n i c o p e r a t i o nc o d e ( m a c r o i n s t r u c t i o n
n a m e ) m u s t a p p e a ra s s p e c i f i e di n t h e m a c r o i n s t r u c t i o n When the options Y/N are givenin a macro instruction.
d e s c r i p t i o n . T h e o p e r a t i o nc o d e m u s t s t a r t i n c o l u m n g . Y indicatesa yes response,N indicatesa no response.
Keyword
o T h e o p e r a n d sm a y b e w r i t t e n i n a n y o r d e r . l f a x e y
word is not specified, he default valueis used. A
t
default value is selectedfor optional keywords that are
N A M E - m o d u l e[ , F t N D l a d d ' r e s s jP A C K
L o m i t t e d . T h e d e f a u l t v a l u e i s i n d i c a t e di n t h e m a c r o
-,
i n s t r u c t i o nd e s c r i p t i o nb y a l i n e u n d e r t h e d e f a u l t o p t i o n .
F o r e x a m p l e ,I K E Y - A / B / C ] i n d i c a t e s h e o p t i o n A i s
t
Operand Optional Default Option the defaultvalue.
Operand Value List
In t r o d u c t i o n
This is your program.
It includes acro
m
statements.
----l / x*
- \ _ \-:
a Ihis indicateshe begirrrring
t
, ofthenextjob.
\
\ -This indicates
the end of your job.
I B M S y s t e m / 3 o d e l1 5
M
MacroProcessor (gMPXDV)
The macro processorreadssource state-
m e n t s f r o n r e i t h e r t h e s y s t e mi n p u t d e -
Load the macro processor $MPXDV). ( v i c e o r a s o u r c el i b r a r v .
O C L c a n b e e n t e r e dt h r o u g h t h e
s y s t e m i n p u t d e v i c eo r c a l l e df r o m
A l l v a l i da s s e m b l es t a t e m e n t a n d
r s
t h e p r o c e d u r el i b r a r y .
c o m m e n t sa r e p l a c e di n $ S O UR C E .
M a c r o s t a t e m e n t s r e l i s t e di n
a
$ S O U R C E ,p r e c e d e d y a n
b
asterisk nd followed by the
a
m a c r oe x p a n s t o n .
M a c r o e x p a n s i o ns t a t e m e n t s r e
a
m a r k e d ( b y t h e m a c r o p r o c e s s o r )n
i
p o s i t i o n9 6 i n g S O I . J R C E n d i n d i -
a
c a t e d o n t h e a s s e m b l yl i s t i n g b y a
p l u ss i g n ( + ) p r e c e d i n gh e e x p a n -
t
sioq statement.
I n v a l i d s t a t e m e n t s r e f l a g g e da n d
a
p l a c e di n $ S O U R C E .
y'
Statements placedin
$ S O U R C E a r e u s e da s
s o u r c ei n p u t t o a n
assembler.
Figure 1. Macro Processor verview
O
z
N o o p e f a t t ' . i : , r ; . r i t [ ] " l ; ; , u , . ; i l t r : r i ) r . . r , , i . , 1r(.to l r J r , , r r , r I !i r:,,i,
t i n U a t i \ ) n i s r r : q u i r e t l , c . ) l i l i i t i r ' / 2 , n r i s t a : ( r t - r ' 1 . . , i:,r u ; , l . , l a : , l i
:r
C h a l ' d C l e ra t t d i l i e i a : { u y r , , , . r r , r t , r r i , i } ( ; l , l i . ' r . i : . ; ri ; i r . :
rt
COmll.Ia An , - ; 1 i , l r ; ' l i i{ : a f r i t i i i , c r i : i ( t t , r i r i , r r r r r l ; l i t t r ! t t { l ! ) i t
[ h e r i c . < 1l i r l t ' I l l u t ) t : i : r . : 1 , r rr,)t i\ )] l r , ' f } r , i ! , ' . r r : l l l ! l - . i i lt i t l r s i
begin in colilinn l4- F o r i 1 l | e ) ( i r ; , t i r i r, ) f i ; \ ) | | i t n t t . r l i t r t t r ( ] a l i i l U .
see Figure 2.
C 0 r l r r t t e n t s i ' l r t s l b r j s e p a i n i . e d i t i . , r , rt ! r , ; . , r , u t d , ( ; i l r { j ( f i t i . r l a
b y a t l e a s t L i ) ] el ) i i t r l k S [ ; . 1L ] a ; ( ) , i r i i ( ; i i i . ,: , , - i t i i - i o i. , i;,r r s r l i l r u
r 1
f i e t w g g t to t r t l r a i r c i{sJ r id ' - i l r i l t t t u i i d a . r r lrr r : _ i t r ; . , i ) r r . F l l q i J r C
3 s i ' r o r r ue X a m p l r 1 ) t r i o t i t l t J ! , t : L i t , r : (w r I l ] t i r r r i j ; i :r i t s r i l i , . l
s J
t i o r l s . O f l t i l e a s s e n t l . ' i el r s t i t l g a ! i c o r i r { i l { i r i l o . r ; 1 , , '
a , !
g e i l L ' r a t r i ( c ( , i j C t l t e l i l 5 t i i l r t i i i . ) \ /t i i t j t i r . l i ; f r -l,l r ( j r . i j : r i ) ! t i J
j
[ - r e q i t i;r t j o l d t i l i l 4 f i . A r r / i . ( ] l t r i l t ( , , . i tr: , r I l i i i r r l ! u l ) e t j i ) t ] -
t e i ' i t i Ji t t C O I U n ) ! r s 4 r i t r i i . J i r / i
{J l d i i i t t r r r i i : ;, , r ;t i r i r ,t i r , j
r i g r] i .
K " 5 ',, l
I ii
r i
1i f
I
"i-lo 6 s
1
t s Y -lul i
.tf]. r1
I
ir l1
F i r , j u r 2 U.
F igu;e ,l
lntroductiorr 3
S Y S T E MC O N F I G U R A T I O N
5704
T h e m i n i m u n t s y s t e mc o n f i g u r a t i o nf o r u s i n gt h e M o d e l
15 scl I SC2
m a c r o si s :
Minimum l--rsaT-rse i-,sc*T*,sD
5444DiskStoraseDrive, I x | | f_-
5 4 1 5 P r o c e s s i n g n i t w i t h a t l e a s t4 g K b y t e s o f m a i n
U ModerA2 | I i
srorage. 3 3 4 C D i r e c t A c c e s s S t o|r a s e | X I X I X
F a c i i , t yM o d e lA 2
.
I
o 3277 Display Station Model 1 with Feature Optional
4632. I
T h i s c o m p r i s e s h e I B M S y s t e m / 3M o d e l 1 5 C R T / K e y
t 5 4 4 4D i s kS t o r a g D r i v e ,
e I X
Model A3
b o a r d , u s u a l l yr e f e r r e dt o i n t h i s m a n u a l a s t h e C R T /
5 4 4 5 D i s k S t o r a g e ,I r / o d e l s1 , 1 X
Keyboard.
2,and3 I I I i
3340DirectAccessStoi a-r;e I
r X i X I Xl
l . D i s k S t o r a g eD e v i c e . F a c i l i t y ,M o d e l s8 1 a n d 8 2
| | | |
3344DirectAccessStorase, x'
| | I I
o Moclel 42
A s y s t e mi n p u t d e v i c e .
. 'Mutually
1 4 0 3P r i n t e M o d e l , 5 , o r N 1 .
r 2 exclusive
T h e f o l l o w i n g n p u t a n do u t p u td e v i c ea r es u p p o r t e d :
i s The macro processooperates ndercoirtrol of the lBlVl
r u
System/3 Model 15 Systeni Control Program.
. 5 4 2 4M u l t i - F u n c t i o C a r dU n i t ( M F C U )M o d e lA 1 o r
n
A . 2 , 1 4 4 2 a r dR e a d u n c hM o d e l6 o r M o d e l7 , o r
C p
2 5 6 0 M u l t i - F u n c t i o C a r dM a c h i n e M F C M )M o d e lA 1
n ( M A C R O I N S T R U C T I O N SP R O V I D E D
or 42.
T h e m a c r o i n s t r u c t i o n sp r o v i d e d b y t h e M o d e l 1 b S y s t e m
. 1 4 0 3P r i n t e M o d e 2 , 5 , o r N 1 .
r l C o n t r o l P r o g r a m( S C P )a n d t h e f u n c t i o n s t h e y p e r f o r m a r e
s h o w n i n F i g u r e4 .
. 3 2 7 7 D i s p l a y t a t i o nM o d e l1 w i t h F e a t u r e u m b e r
S N
4 6 3 2 ( C R T / K e y b o a r dT.h i sd e v i c e a nb e u s e db o t h
) c A l l m a o o s y o u w a n t t o u s e m u s t b e i n t h e s o u r c el i b r a r y o r r
a st h e s y s t e mn p u td e v i c e n d t h e s y s t e mo gd e v i c e .
i a l the prograrn pack or the system pack. The progiam pack is
the disk pack f rorrr in"rhich macro processoris loacjed.
the
. 3 4 1 0 / 3 4 1 1 a g n e t i T a p eS u b s y s t e m o d e l1 , 2 , o r 3 .
M c M T h e s y s t e mp a c k i s t h c d i s k p a c k f r o r nw h i c h i r i r t i a lp r o g r a f i r
l o a d ( l P L ) i s p e r f o r m e C .l { o t e t h a t t h e m a c r o p r o c e s s o a n c t
r
o 2 5 0 1 C a r d R e a d e rM o d e l A 1 o r M o d e l l P [ - c o r l e m a y b e o n t h c s a m ep a c k .
A2
3284 Printer Y o u m a y w a n t t o c l e e t e s o n r er l r a c r oi n s t r u c i r c r i s i o n r
l l
y o u r l i b r a r y t o r e d u c et f i t , a m o u i r t o f t l i s k s p a c er e q u i r e r _ l
3741 Dala Station Model 1 or Z or progranrmahle or-k f o r t h e r n a c r oi n s t r u c t i o n s .F o r .i n s t a r r c ei,f y o u r s y s t e m
W
Station Model 3 or 4. d o e sn o t i n c l u d et h e 3 4 i i l i 3 4 l 1 M a g r r e t i c - a p e u b s y s t t r r r r .
1 S
the tape macro inslruclions vyoult.l of nr_, be use to yor_t.
a D i s k S t o r a g eR e q u i r e m e n t s . Y o u c a n d e l e t e m a c r o l l s l r . u l : t i o l l s r i l n i y o u r l i t : ra r i b , , ,
f
u s i n gt h e l i b r a r y m a i n t e r r a n c itet i l i r y p r o g r a m ,$ M A l N l - .
i
Device Type Supported
SystemReacier $RLST G e n e r a t er e a d e rp a r a m e t e rl i s t
$ RL S D O f f s e t si n r e a d e rp a r a m e t e rl i s t
$READ L i n k a g et o s y s t e m r e a d e r
SystemLog $LWTO G e n e r a t ep a r a m e t e rl i s t f o r W T O o r W T O R
SLIVISG G e n e f a t ep a r a m e t e rl i s t f o r h a l t m e s s a g e n s y s t e m I o g
o
$LOG L i n k a g et o s y s t e m l o g
$ LO G D O f f s e t si n l o g p a r a m e t e rl i s t
G e r r e r aS C P
l $ROLL R o l l o u t / r o l l i n l i n k a g e( 5 7 0 4 - S C i O n l y )
$ F IN D Find a directoryentry
$LOAD Loada module
SFTCH L o a d a m o d u l e a n d p a s sc o n t r o l
$XCTL L r : a da m o d u l e a n d e x c h a n g e o n t r o l
c
$ T RL G e n e r a t e t r a n s l a t ep a r a m e t e rl i s t
a
btr{ttJ G e n e r a t e t r a n s l a t et a b l e
a
$TRAN G e n e r a t e n i n t e r f a c et o t h e t r a n s l a t er o u t i n e
a
$SNAP S n a pd u m p m a i n s t o r a g e
SDATE R e t r i e v es y s t e md a t e
STIOB G e n e r a t ei m e r I O B
t
$SiT S e t i n t e r v a lt i m e r
STOD R e t u r n t i m e o f d a y a n d s y s t e md a t e
$ Rt T R e t u r na m o u n t o f t i m e l e f t i n t i m e r i n t e r v a l
$EOJ End of job
General/O $ALOC A l l o c a t e d i s k s p a c eo r d e v i c e
$OPEN Prepare n l/O device
a
L
$CI< G e n e r a t e c h e c k li s t
a
$ C HK C l r e c kf o r l / O c o m p l e t i o n f o r B S C A o p e r a t i o n s
$CLOS P r e p ae a d e v i c e o r t e r m i n a t i o n
r f
$DTFO D T F o f f s e t sf o r a l l d e v i c e s
$COMN Generate quates
e
$DTFC D e f i n et h e f i l e f o r a c a r d d e v i c e
$GETC C o n s t r u c ta c a r d G E T i n t e r f a c e
$PUTC C o ns t r u c t a c a r d P U T i n t e r f a c e
$GPC C o ns t r u c t a G E T o r a P U T i n t e r f a c e o a c a r d f i l e
t
Figure 4 (Part 1 of 2). Macro Instructions
I n t r o d u c t io n
-."*"**--T-
I nstrriction
Device fype Supported Niriire i titrr:1ir',,
Printr:
r $DTFP i ) , : r f i n' : l ! i;j{. { )L
$ P UT P ( l o r t 5 i it r i r t I i , r i , r f e
Di s l < $DTFt)
$ G EI t ) ,,1c-frr.r)
;
$PUTI) tltor-i:rr .
$r(]Bf)
$IOED t-lirl,.t--;r,r riiii
[
$RDi)
$ W RT D
$WAIT
$DTFI
$ G F - ft
SPUI
$RDT
$WRff
$CI LT
$wil
D e v i c eI n d e p e n d e n t $D-rFI i ) e i ' l r r e. r l i g y j r ' 31 1 , 1 j , ' 1 ; 1 ) r r . fi t l er r t
Fl
$GETI ( l t ' , r r s t r ; r . ta l ( ' v i r - pi I r r l r . ) p r r : y 1 1 ! oF '1 1r I r t e t . f a c e
G1i
$ P UT I I : r r il , : ri '; r : ' t : 1i i o v i r - pi t t d a t , e r r li : , r i 1! ) 1 . . 1i-n t e r f a c e
f
( l RT / l ( e v b o a id
I
$D I trs i l , ' l , r ; . : l r r ', ; , . i r : i j f r ' I
$GEIS lli:|]1;ittr.'r :r,virnlt,i rli. I ;itt.,,l:la.r
I
$PLrs i : : . , c i ij ,r, llfl!l:!Jl r r , i p r: r -
$PGS ,r:.lr.reijto C RT/l{e',' ltoal I
SCOEP a n I i ) / . I - a r nI L r r i c ' t i o nk e y r e q u e s t
$ P Ft < Y
$PI i
3741 $[]rrK
$ G ET K
i l . ' I , r , . ,: i , irr l, ,
( : i l r l s t r ( , i ,r a , J i / l ' l
1 , . , ,l
{:tl: l trrteri'acp
I
I
I
$PU K
T : r r r ; 1 r , ,I
i4| i'lit,lr' "L{'., I
J
Frgure 4 (Part 2 of ?). Macro Instructtons
Chapter 2. Macro lnstruction Statements
Y o u c o d e m a c r o i n s t r u c t i o n s t og e n e r a t e b l o c k o f
a 2. T h e c o d e g e n e r a t e d y t h e m a c r o si s a s s i g n e da b e r s ,
b l
a s s e m b l es t a t e m e n t s h a t p e r f o r m a c e r t a i nf u n c t i o n . S o m e
r t w h i c h b e g i nw i t h t h e d o l l a r s i g n ( $ ) . T o a v o i d d u p l i
f u n c t i o n s m a y b e t h e s a m ee a c h t i m e t h e y a r e u s e d ,o t h e r s c a t e l a b e l e r r o r s ,y o u s h o u l d n o t u s et h e d o l l a r s i g n
m a y b e m o d i f i e d b y s p e c i f y i n gd i f f e r e n t o p e r a n d s .T h i s a s t h e f i r s t c h a r a c t e ro f a l a b e l .
c h a p t e re x p l a i n st h e S v s t e m / 3 M o d e l 1 5 m a c r o i n s t r u c t i o n s
in detail.
S Y S T E M S E R V I C E SM A C R O S
T h e m a c r o i n s t r u c t i o n s r e g r o u p e d i n t h i s c h a p t e ra c c o r d -
a
i n g t o t h e f u n c t i o n st h e y p e r f o r m : B y u s i n gs y s t e ms e r v i c e s a c r o i n s t r u c t i o n s y o u c a n c o m -
m ,
m u n i c a t ew i t h t h e M o d e l 1 5 s y s t e mc o n t r o l p r o g r a m .
o System services
T h e s em a c r o i n s t r u c t i o n sc a n d o t h e f o l l o w i n q :
. Input/output support
o R e a d r e c o r d sf r o m t h e s v s t e mi n p u t d e v i c e .
Input/output supportmacro instructions refurther a
d i v i d e d a c c o r d i n gt o t h e d e v i c es u p p o r t e d . o Log and write error messages.
o D e t e r m i n et h e l o c a t i o n o f a n o b j e c t m o d u l e o n d i s k .
P R O G R A M M I N GC O N S I D E R A T I O N S
. O b t a i n o b j e c t m o d u l e sf r o m d i s k a n d l o a d t h e m i n t o
W h e n y o u u s et h e m a c r o p r o c e s s o y o u s h o u l d r e m e m b e r
r m a r ns t o r a g e .
the following restrictions:
o P a s s o n t r o l t o m o d u l e si n m a i n s t o r a g e .
c
1. T h e g e n e r a t e d o d e f o r s o m e m a c r o i n s t r u c t i o n su s e s
c
r e g i s t e r1 ; t h e g e n e r a t e d o d e f o r o t h e r m a c r o i n s t r u c -
c a T e r m i n a t et h e c u r r e n t j o b .
t i o n s u s e sr e g i s t e r . Y o u s h o u l d s a v et h e c o n t e n t so f
2
t h e r e g i s t e r s e db y t h e g e n e r a t e d o d e b e f o r e i s s u i n g
u c T h e s y s t e ms e r v i c e s a c r o i n s t r u c t i o n s r e d i v i d e d i n t o
m a
t h e m a c r o i n s t r u c t i o n ;o t h e r w i s e , h e c o n t e n t sa r e
t threegroups:
d e s t r o y e d . T h e s em a c r o i n s t r u c t i o n s s e r e g i s t e r1 :
u
1. S y s t e m e a d em a c r oi n s t r u c t i o n s ,h i c hp r o v i d e
r r w
$PFKY s u p p o r t n dl i n k a g eo t h e s y s t e m e a d efru n c t i o n .
a t r
$PFKT
$RDD $ RE A D
$TRAN $ RL S D
$WAIT $ RL S T
$WRTD
2. S y s t e m o gm a c r oi n s t r u c t i o n s ,h i c hp r o v i d e u p p o r t
l w s
m
T h e s e a c r oi n s t r u c t i o nu s er e g i s t e2 :
s r a n d l i n k a g eo s y s t e mo gf u n c t i o n s .
t l
$ALOC $GETT $PUTS $LMSG
$CHK $GPC $PUTT $LOG
$CLOS $LOAD $RDT $LOGD
$CTLT $LOG $READ $LWTO
$DATE $OPEN $ RI T
$FIND $PGS $SIT
$FTCH $PUTC $TOD
$GETC $PUTD $WRTT
$GETD $PUTI $WTT
$GETI $PUTK $XCTL
$GETK $PUTP
$GETS
Macro lnstruction Statements I
Pageof GC21-7608-2
lssued28 March 1980
By TNL: GN21-5700
3. G e n e r a l C P a c r o n s t r u c t i o nw h i c hp r o v i d e
S m i s, T o c a l l t h e s y s t e mr e a d e r y o u m u s t d o t h e f o l l o w i n g :
,
l i n k a g t o s y s t e mu n c t i o n s .
e f
1. U s et h e S R L S T m a c r ot o c o n s t r u c t p a r a m e t e lrt s t a s
a
$DATE i l r p u t t o t h e s y s t e m r e a d e rr o u t i n e .
$EOJ
$FIND 2. U s et h e S R L S D m a c r o i n s t r u c t i o n o e s t a b l i s h r l u a t e s
t e
$FTCH f o r t h e s y s t e m r e a d e rp a r a m e t e r i s t .
l
$LOAD
$ R O L L( 5 7 0 4 - S C 1 l y )
on 3. l s s u e h r .S R E A D m a c r o i n s t r u c l r o r r .
t
$ RI T
$SIT T h e $ R E A D m a c r og e n e r a t ets e c o d et o l o a d t h e p a r a m e t e r
h
SSNAP l i s t a d d r e s sn t o r e g i s t e 2 , s e t t h e o p e r a t i o n o d e ,c a l l t h e
i r c
$TIOB s y s t e mr e a d e rr o u t i n e , a n d c h e c k t h e r e t u r n c o d e s . B e c a u s e
STRAN t h e r e t u r n c o d e i s i n t h e s a m eb y t e a s t h e o p e r a t t o nc o o e ,
$ T RL t h e o p e r a t i o nc o c l em u s t b e r e s e tb e f o r e e a c h c a l l . T h e
$TRTB