System Control Programming MacrosReference Manual

(1)

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 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 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 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 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 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 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 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 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

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 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 a a a a

IBM System./3 Model 15

System Control Programming Macros R e f e r e n c e M a n u a l

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 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 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 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 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 o a a a a a a a a a a a a a a

a a a a a a a a

GC21-7608-2 F i l e N o . 5 3 - 3 6

(2)

P a g e o f G C 2 1 -7 6 0 8 - 2 l s s u e d 2 9 S e p t e m b e r 1 9 7 8 B y T N L : G N 2 1 - 5 6 4 9

Preface

T h i s m a n u a | d e s c r i b e s t h e m a c r c r i n s t r t t c t t c r t t s 1 r t r l v i c 1 t , c i | l i s l . . s a i i i i , i . . i ] i ( ) q l ; i r , | . ; l - 1 i , ' . , ; \ r i | l ! i t h e I B M S y s t e m / 3 M o c l e l 1 5 . T h e p u b l r c , r i i r r r : ; i i r , t c n u e , , j t ; i i r i - ;

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 c A s s e m b l e r

L a n g u a g e o 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 i r] i . i i ) , - - , ) t - o p e n D T F ( D e f i r r e c o n c e p t o f m a c r o i n s t r u c t i o n s a n d s y s l r : i i l r r o g r a r n : ' n i i t t i l n r ; : , i , . 1 i j i l r , t r . i l L j l u r . ; k s f 1 , 1 ,s r r r a r r j o o i r : . 1 a r r r { tl r s k d e v i c e s ,

f o r t h e I B M S v s t e m / 3 N 4 o d e l 1 5 .

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 < l i n t h i : t - . r . r i r i r c a r ; r r i r F { e i a t i : r l l " u i . : i r c a t r t n s o C o d i n g m a c r o i n s t r u c t i o t r s

: . ., i i r ; a . a i , ( i r r i i ; , r r : ; i l i l i , r 1 . , r i r i a r r r , r i l w i l ! { . l i r r r : i t r r c i

r : . t t : ; { ' i 3 S C r - t i ; , ; : .

: , l ) i r . j ! i j t i . i : , r . , 5 , ' 1 j i ' r : . . - r , ir l d l L i . t i :

o D e s c r i p t i o n s o f t l r e v a i t o u s ln a c r o r f t : i r , , 1 c l i ( , r ] : .

t ; i - i : ' t l , , r 5 i 1 ' : ; 1 , ) i t , : s ' t , , 1 { . t : : g . ' , ' , / ; i f : ; i ; e l f : f e l l C e M e f t U a l , a O C L n e c e s s a r y t o c a l l t h e f r r a c i o l l r { ) c r s i / r r r . , } i . - j ; / \ i i l

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 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.

3 / ! )) :,i. , j i-r {l:.r '1 :, i { i:l

T h i r d E d i t i o n (D e c e m b e r 1 9 7 6 )

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 ; ' t ' - ' c ! i r r i L i i i

l \ . i - o ! ! \ i e l i 1 ! : i 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 , j r, 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 . , : , { 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 b y a v e r t i c a l l i n e .

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 f 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 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 : 1 t r t i ' i i \ i ' l l 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 i lr ; , r l i 5 \ r l ] ! e q u i i , : r v e r s i o n s a n d m o d i f i c a t i o n s u n t i l o t h e r w r s e i r ' d r c J t e d r r l r " ! ' ! , ' { r r i r . , r . , : r T e c i , r , r . , , ' n e w s l e t t e r s .

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 j r: r': uirril i iii:

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 i r ' i i ' I B M S y s t e m / 3 B i b l i o g r a p h y , { . - r C 2 O ' B l i S t i - i o r T t , L j r l - i . r : r , i : , i r i i . a i J I . ) : i . r . i r l a n d c u r r e n t .

U s e t h i s p u b l i c a t i o n o n l y i o r t h e l t l i r i ) o s e s s t a l f j ( l i l r t i : 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 { . , - j r j , . . j r !Ui\l: :,!jl)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 r fr r : r { . l i j r , . ! . . r r i i i l l i r i r e p r e s e n t a t t v e O r t O t h e b r a n c h o l f i c e s e r v i n l l 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 : . l i i r t l i : r j r f l , n r j . i j r , r r f i - ) : , , : t , i . R e a d e r ' s C o m m e n t F o r m a t t h e b a c k o f t h i s p u l : l r i : a t t ( l 1 t ! . ) f f l : t i r c i ) i r , i | , , , , r i i t l . ) i , . , , t h i s p u b l i c a t i o n . 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 ; r : i , . i r r l : r f ,i , t l r i l \ i l

C o r p o r a t i o n , P u b l i c a t r o n s , D e p a r t m e n t 2 4 5 , U o c h e s t e r . , \ l i n r r r i ( . , i . r i j 5 : l , J ; ! r : i i , , l : i r , : j v r j r r i 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 , / i n a i i y w a v r t b e t r e v c 5 rr ; : , l 1 i i j i ) . r i i i r . 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 , r . . , i i o ! i r 5 c . c o r i i i T r u , t ! i r : , . , , , ' "

i n f o r m a t i o n y o u s u p p l V .

(3)

C H A P T E R 1 : T N T R O D U C T T O N W r i t i n g M a c r o I n s t r u c t i o n s

S y s t e m C o n f i g u r a t i o n M a c r o I n s t r u c t i o n s P r o v i d e o

C H A P T E R 2 : M A C R O I N S i R U C T I O N S T A T E M E N T S P r o g r a m m i n g Considerations

S y s t e m S e r v i c e s M a c r o s S y s t e m R e a d e r S u p p o r t S y s t e m L o g S u p p o r t G e n e r a l S C P S u p p o r t I n p u t / O u t p u t Support

G e n e r a l l/ O S u p p o r t C a r d D e v i c e S u p p o r l P r i n t e r S u p p o r t D i s k D e v i c e S u p p o r t 3 7 4 1 D e v i c e S u p p o r t T a p e D e v i c e S u p p o r r D e v i c e In d e p e n d e n t g u p p o r r C R T / K e y b o a r d

D i s p l a y S u p p o r t

P r o g r a m F u n c t i o n K e y Support

A macro instruction is a source statement that causes generation of a predetermined set of assembler statements e a c h t i m e th e m a c r o i n s t r u c t i o n i s u s e d . T h e M o d e l 1b Svstem Control Program provides macro instructions which oer- form both system services and input/output device support.

B y u s i n g t h e s e m a c r o i n s t r u c t i o n s , y o u c a n p e r f o r m b o t h system and input/output operations with less coding.

F i g u r e 1 i s a n o v e r v i e w o f t h e o p e r a t i o n o f t h e m a c r o processor. The OCL statements used to call the macro processor are explained in Chapter 3: OCL and Sample Program.

W R IT I N G M A C R O IN S T R U C T I O N S You code macro instructions as follows:

S t a r t i n g C o l u m n 1

N a m e O p e r a t i o n O p e r a n d s C o n t i n u a t i o n S y m b o l

o r b l a n k M a c r o n a m e

N o o p e r a n d s o r o n e o r m o r e s e p a r a t e d b y coTl mas

A n y n o n b l a n k c h a r a c t e r if c o n t i n u a t i o n i s b e i n g u s e d

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 r l a n g u a g e s y m b o l i c n a m e b e g i n n i n g i n c o l u m n 1 . T h e n a m e i s assigned to the first byte of generated code. Since rne name i s o p t i o n a l , it i s s h o w n e n c l o s e d i n b r a c k e t s .

T h e d e s i r e d m n e m o n i c o p e r a t i o n c o d e ( m a c r o in s t r u c t i o n n a m e ) m u s t a p p e a r a s s p e c i f i e d in t h e m a c r o i n s t r u c t i o n d e s c r i p t i o n . T h e o p e r a t i o n c o d e m u s t s t a r t i n c o l u m n g .

O p e r a n d

Chapter 1 : Introduction

O p e r a n d s s p e c i f y th e a v a i l a b l e s e r v i c e s a n d o p t i o n s . T h e operands must start in column 14, and are written as f o l l o w s :

. Each operand consists of a keyword followed bv a dash

a n d a p a r a m e t e r .

o C o m m a s s e p a r a t e t h e o p e r a n d s ; n o b l a n k s s h o u l d b e left between operands.

o Keywords - those shown in capital letters - are coded 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 n d e s c r i p t i o n .

. The parameter part of the operand must immediately f o l l o w t h e d a s h .

Parameters - those shown in lowercase letters - indicate 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 s are not r e q u i r e d . T h e s e o p t i o n a l o p e r a n d s a r e i n d i c a t e d b y e n c l o s i n g t h e o p e r a n d w i t h i n b r a c k e t s IK E y W O R D - parameterl .

An option list for a keyword parameter is specified as f o l l o w s :

K E Y W O R D - A / B / C

T h i s l i s t i n d i c a t e s t h a t t h e k e y w o r d h a s th e o p t i o n s A , B , o r C . T h e s e a 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.

W h e n t h e o p t i o n s Y / N a r e g i v e n in a m a c r o in s t r u c t i o n . Y indicates a yes response, N indicates a no response.

T h e o p e r a n d s m 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 w o r d i s n o t s p e c i f i e d , t h e d e f a u l t v a l u e is u s e d . A default value is selected for optional keywords that are o m i t t e d . T h e d e f a u l t v a l u e is i n d i c a t e d in t h e m a c r o i n s t r u c t i o n d e s c r i p t i o n b 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 , IK E Y - A / B / C ] i n d i c a t e s t h e o p t i o n A i s t h e d e f a u l t v a l u e .

7 2

o

O p t i o n a l D e f a u l t

O p e r a n d V a l u e O p t i o n L i s t K e y w o r d

N A M E - m o d u l e [ , F t N D l a d d ' r e s s j

- ,

L P A C K

I n t r o d u c t i o n

(6)

T h i s i s y o u r p r o g r a m . I t i n c l u d e s m a c r o s t a t e m e n t s .

L o a d t h e m a c r o p r o c e s s o r ( $ M P X D V ) . O C L c a n b e e n t e r e d th r o u g h t h e s y s t e m in p u t d e v i c e o r c a l l e d f r o m t h e p r o c e d u r e l i b r a r y .

Statements placed in y'

$ S O U R C E a r e u s e d a s s o u r c e in p u t t o a n a s s e m b l e r .

F i g u r e 1 . M a c r o P r o c e s s o r O v e r v i e w

----l / x*

- \ _

a \ - : I h i s i n d i c a t e s t h e b e g i r r r r i n g ,

\

o f t h e n e x t j o b .

\

- T h i s i n d i c a t e s t h e e n d o f y o u r j o b .

I B M S y s t e m / 3 M o d e l 1 5 Macro Processor (gMPXDV)

The macro processor reads source 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 m in p u t d e - v i c e o r a s o u r c e li b r a r v .

A l l v a l i d a s s e m b l e r s t a t e m e n t s a n d c o m m e n t s a r e p l a c e d i n $ S O U R C E . M a c r o s t a t e m e n t s a r e l i s t e d in

$ S O U R C E , p r e c e d e d b y a n a s t e r i s k a n d f o l l o w e d b y t h e m a c r o e x p a n s t o n .

M a c r o e x p a n s i o n s t a t e m e n t s a r e 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 ) i n p o s i t i o n 9 6 i n g S O I . J R C E a n d i n d i - c a t e d o n t h e a s s e m b l y l i s t i n g b y a p l u s s i g n ( + ) p r e c e d i n g t h e e x p a n - s i o q s t a t e m e n t .

I n v a l i d s t a t e m e n t s a r e f l a g g e d a n d p l a c e d i n $ S O U R C E .

(7)

N o o p e f a t t ' . i : , r ; . r i t [ ] " l ; ; , u , . ; i l t r : r i i ) r . . r , , i . , 1 ( t r . o 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 . : r i , . , : r u ; , l . , l a : , l i C h a l ' d C l e r a t t d i l i e i a : { u y r , , , . r r , r t , r r i , r t i } ( ; l , l i . ' r . i : . ; r ; i i r . : C O m l l . I a A n , - ; 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 . < 1 l i r l t ' I l l u t ) t : i : r . : 1 , r r , t \ ) r ) i ] l r , ' f } r , i ! , ' . r r : l l l ! l - . i i l ti t l r s i b e g i n i n c o l i l i n n l 4 - 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 . s e e F i g u r e 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 it i . , r , r t! 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 ) ] e l) i i t r l k S [ ; . 1 r L ] a ; ( ) , ir i i ( ; i i i . , :, , - i t i i - i o i 1 . , i , ; r r s r l i l r u f i e t w g g t t o t r t l r a i r c i s { J r i d ' - i l r i lt t t u i i d a . r r r l r r : _ i t t r ; . , i ) r r . F l l q i J r C 3 s i ' r o r r u s e X a m p l € r 1 ) t r i o t i t l t J ! , t : L i t , r : ( J w r I l ] t i r r r i j ; i : ri t s r i l i , . l t i o r l s . O f l t i l e a s s e n t l . ' i e r l a s t i t l g , a ! i c o r i r { i l { i r i l ! o . r ; 1 , , ' g e i l L ' r a t r i ( j c ( , i j C t l t e l i l 5 t i i l r t i i i . ) \ / ti i t j t i r . l i ; f r - , l l r ( j r . i j : r i ) ! t i 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 t : r , r I l i i i r r l ! u l ) e t j i ) t ] - t e i ' i t i J it t C O I U n ) ! r s 4 { J r i t r i i l . J i r / i d i i i t t r r r i i : ; , , r ; t i r i r , ti r , j r i g r ] i.

' , , l

I

1 6 s

l u l

K " 5

"i-lo

t s Y - . t f ] .

r i

i i 1 f _{i i}

r1 I

i 1

_{r l}

F i r , j u r € 2 U .

F i g u ; e , l

l n t r o d u c t i o r r 3

(8)

S Y S T E M C O N F I G U R A T I O N

T h e m i n i m u n t s y s t e m c o n f i g u r a t i o n for using the Model 15 m a c r o s is :

5 4 1 5 P r o c e s s i n g U n i t w i t h a t l e a s t 4 g K b y t e s o f m a i n srorage.

3277 Display Station Model 1 with Feature 4632.

T h i s c o m p r i s e s t h e I B M S y s t e m / 3 M o d e l 1 5 C R T / K e y b o a r d , u s u a l l y re f e r r e d to i n t h i s m a n u a l as the CRT/

K e y b o a r d .

D i s k S t o r a g e D e v i c e . A s y s t e m in p u t d e v i c e . o

l .

o

. 1 4 0 3 P r i n t e r M o d e l 2 , 5 , o r N 1 .

T h e fo l l o w i n g i n p u t a n d o u t p u t d e v i c e s a r e s u p p o r t e d : . 5 4 2 4 Multi-Function C a r d U n i t ( M F C U ) M o d e l A 1 o r

A . 2 , 1 4 4 2 C a r d R e a d p u n c h M o d e l 6 o r M o d e l 7 , o r 2 5 6 0 M u l t i - F u n c t i o n C a r d M a c h i n e ( M F C M ) M o d e l A 1 o r 4 2 .

. 1 4 0 3 P r i n t e r M o d e l 2 , 5 , o r N 1 .

. 3 2 7 7 Display S t a t i o n M o d e l 1 w i t h F e a t u r e N u m b e r 4 6 3 2 ( C R T / K e y b o a r d ) . T h i s d e v i c e c a n b e u s e d b o t h a s th e s y s t e m i n p u t d e v i c e a n d th e s y s t e m l o g d e v i c e . . 3 4 1 0 / 3 4 1 1 M a g n e t i c T a p e S u b s y s t e m M o d e l 1 , 2 , o r 3 . o 2 5 0 1 Card Reader Model A1 or Model A2

3 2 8 4 P r i n t e r

3 7 4 1 D a l a S t a t i o n M o d e l 1 o r Z o r p r o g r a n r m a h l e W o r - k S t a t i o n M o d e l 3 o r 4 .

D i s k S t o r a g e R e q u i r e m e n t s .

' M u t u a l l y e x c l u s i v e

T h e m a c r o p r o c e s s o r o p e r a t e s u n d e r c o i r t r o l o f t h e l B l V l System/3 Model 15 Systeni Control Program.

M A C R O I N S T R U C T I O N S P R O V I D E D

T h e m a c r o i n s t r u c t i o n s p 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 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 th e y p e r f o r m a r e s h o w n i n F i g u r e 4 .

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 e li b r a r y o r r the prograrn pack or the system pack. The progiam pack is the disk pack f rorrr in"rhich the macro processor is loacjed.

T h e s y s t e m p a c k is th c d i s k p a c k f r o r n w h i c h i r i r t i a l p 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 r a n c t l P [ - c o r l e m a y b e o n t h c s a m e p a c k .

Y o u m a y w a n t t o c l e l e t e s o n r e rl r a c r o i n s t r u c i r c r i s l i o n r y o u r l i b r a r y t o r e d u c e tf i t , a m o u i r t o f t l i s k s p a c e re q u i r e r _ l f o r t h e r n a c r o in s t r u c t i o n s . F o r . in s t a r r c e , i f y o u r s y s t e m d o e s n o t i n c l u d e th e 3 4 i i l i 3 4 l 1 M a g r r e t i c 1 - a p e S u b s y s t t r r r r . the tape macro inslruclions vyoult.l be of nr_, use to yor_t.

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 f r i l n i y o u r l i t : r a r i b , , , u s i n g th e l i b r a r y m a i n t e r r a n c i e t i t i l i r y p r o g r a m , $ M A l N l - . a

5704

scl I SC2

Minimum l--rsaT-rse i-,scT,sD

5 4 4 4 D i s k S t o r a s e D r i v e , I x | | f _ -

M o d e r A 2 | I i

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 y . M o d e l A 2

Optional I

5 4 4 4 D i s k S t o r a g e D r i v e , II X M o d e l A 3

5 4 4 5 D i s k S t o r a g e , Ir / o d e l s 1,1 X

Moclel 42

2 , a n d 3 I I I i

3 3 4 0 D i r e c t A c c e s s S t o r a - r ; e i I X i X I X l

(9)

Device Type Supported

S y s t e m R e a c i e r $ R L S T

$ R L S D

$ R E A D

S y s t e m L o g $ L W T O

S L I V I S G

$ L O G

$ L O G D

G e r r e r a l S C P $ R O L L

$ F I N D

$ L O A D S F T C H

$ X C T L

$ T R L

b t r { t t J

$ T R A N

$ S N A P S D A T E S T I O B

$ S i T S T O D

$ R tT

$ E O J

G e n e r a t e r e a d e r p a r a m e t e r l i s t O f f s e t s in r e a d e r p a r a m e t e r l i s t L i n k a g e to s y s t e m re a d e r

G e n e r a t e p a r a m e t e r l i s t f o r W T O o r W T O R

G e n e f a t e p a r a m e t e r l i s t f o r h a l t m e s s a g e o n s y s t e m Io g L i n k a g e to s y s t e m lo g

O f f s e t s in l o g p a r a m e t e r l i s t

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 i n d a d i r e c t o r y e n t r y

L o a d a m o d u l e

L o a d a m o d u l e a n d p a s s c o n t r o l L r : a d a m o d u l e a n d e x c h a n g e c o n t r o l G e n e r a t e a t r a n s l a t e p a r a m e t e r l i s t G e n e r a t e a t r a n s l a t e t a b l e

G e n e r a t e a n i n t e r f a c e t o t h e t r a n s l a t e r o u t i n e S n a p d u m p m a i n s t o r a g e

R e t r i e v e s y s t e m d a t e G e n e r a t e t i m e r I O B S e t i n t e r v a l ti m e r

R e t u r n t i m e o f d a y a n d s y s t e m d a t e

R e t u r n a 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 E n d o f j o b

G e n e r a l l / O $ A L O C

$ O P E N

$CI< L

$ C H K

$ C L O S

$ D T F O

$ C O M N

$ D T F C

$ G E T C

$ P U T C

$ G P C

D e f i n e th e C o n s t r u c t C o n s t r u c t C o n s t r u c t

A l l o c a t e d i s k s p a c e o r d e v i c e P r e p a r e a n l / O d e v i c e G e n e r a t e a c h e c k l i s t

C l r e c k fo 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 P r e p a r e a d e v i c e f o r t e r m i n a t i o n

D T F o f f s e t s fo r a l l d e v i c e s G e n e r a t e e q u a t e s

f i l e f o r a c a r d d e v i c e a c a r d G E T i n t e r f a c e a c a r d P U T i n t e r f a c e

a G E T o r a P U T i n t e r f a c e t o a c a r d f i l e

F i g u r e 4 ( P a r t 1 o f 2 ) . M a c r o I n s t r u c t i o n s

I n t r o d u c t i o n

(10)

-."*"**--T-

Device fype Supported P r i n t r : r

D is l <

D e v i c e I n d e p e n d e n t

( l R T / l ( e v boai d

3 7 4 1

F r g u r e 4 ( P a r t 2 o f ? ) . M a c r o I n s t r u c t t o n s

I nstr riction

N i r i i r e

$ D T F P

$ P U T P

$ D T F t )

$ G E It )

$ P U T I )

$ r ( ] B f )

$ I O E D

$ R D i )

$ W R T D

$ W A I T

$ D T F I

$ G F - f t S P U I I

$ R D T

$ W R f f

$ C I L T

$ w i l

$ D - r F I

$ G E T I

$ P U T I

i t i t r r : 1 i r ' , ,

i ) , : r f i n ' : l ! i ; j { . { ) L ( l o r t 5 i i t r i r t I i , r i, r f e

, , 1 c - ; f r r . r ) t l t o r - i : r r r .

t - l i r l , . t - - [ ; r , r r i i i i

i ) e i ' l r r e . r li g y j r ' 3 1 1 , 1 j , ' 1 ; 1 ) r r . i F l r r t f t l e

( l t ' , r r s t r ; r . t a l ( ' v i r - p i I r r l r . ) p r r : y 1 1 ! o 1 1 1 G F ' i r I r t e t . f a c e I : r r i l , : r ' i ; r : ' t : 1 i i o v i r - p it td a t , e r r i l : , r i 1 !) 1 . . 1 - f i n t e r f a c e

i l , ' l , r ; . : l r r ' , ; , . i r : i j f r ' I

l l i : | ] 1 ; i t t r . ' r I : r , v i r n l t , i r l i . I ; i t t . , , l : l a . r i : : . , c i i j , r , l l f l ! l : ! J l r r , i p r : r - I $ D I t r s

$ G E I S

$ P L r r s

$ P G S S C O E P

$ P F t < Y

$ P I i < l

$ [ ] r r K

$ G E T K

$ P U T K

, r : . l r . r e i j t t o C R T / l { e ' , ' l t o a l I a n I i ) / . I - a r n I L r r i c ' t i o n k e y r e q u e s t

l r i o t s , , r l i l . ' I , r , . , : i , i r r l , , 1 , . , , l

( : i l r l s t r ( , i , r a , J i / l ' l { : t l : l t r r t e r i ' a c p : r r r ; 1 r , , I i 4 | i ' l i t , l r ' " L { ' . ,

I I

I

J

(11)

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 o g e n e r a t e a b l o c k o f 2 . T h e c o d e g e n e r a t e d b y t h e m a c r o s is a s s i g n e d l a b e r s , a s s e m b l e r s t a t e m e n t s t h a t p e r f o r m a c e r t a i n fu n c t i o n . S o m e w h i c h b e g i n w 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 e e a c h ti 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 e th 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 g d i f f e r e n t o p e r a n d s . T h i s a s th e f i r s t c h a r a c t e r o f a l a b e l .

c h a p t e r e x p l a i n s t 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 i n d e t a i l .

S Y S T E M S E R V I C E S M 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 a r e g r o u p e d in t h i s c h a p t e r a c c o r d -

i n g t o t h e f u n c t i o n s th e y p e r f o r m : B y u s i n g s y s t e m s e r v i c e s m 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 u n i c a t e w i t h t h e 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 m . o System services

T h e s e m a c r o i n s t r u c t i o n s c a n d o t h e f o l l o w i n q : . I n p u t / o u t p u t s u p p o r t

o R e a d r e c o r d s fr o m t h e s v s t e m in p u t d e v i c e . I n p u t / o u t p u t s u p p o r t m a c r o i n s t r u c t i o n s a r e f u r t h e r

d i v i d e d a c c o r d i n g t o t h e d e v i c e s u p p o r t e d . o L o g a n d w r i t e e r r o r m e s s a g e s .

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

W h e n y o u u s e th e m a c r o p r o c e s s o r y o u s h o u l d r e m e m b e r t h e f o l l o w i n g r e s t r i c t i o n s :

1 . T h e g e n e r a t e d c 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 s u s e s

o D e t e r m i n e th 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 . . O b t a i n o b j e c t m o d u l e s f r o m d i s k a n d l o a d t h e m i n t o

m a r n s t o r a g e .

o P a s s c o n t r o l t o m o d u l e s in m a i n s t o r a g e . r e g i s t e r 1 ; t h e g e n e r a t e d c o d e f o r o t h e r m a c r o i n s t r u c - a T e r m i n a t e th e c u r r e n t jo b .

t i o n s u s e s r e g i s t e r 2 . Y o u s h o u l d s a v e t h e c o n t e n t s o f

t h e r e g i s t e r u s e d b y t h e g e n e r a t e d c o d e b e f o r e is s u i n g T h e s y s t e m s e r v i c e s m a c r o i n s t r u c t i o n s a r e d i v i d e d in t o 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 , t h e c o n t e n t s a r e t h r e e g r o u p s :

d e s t r o y e d . T h e s e m a c r o i n s t r u c t i o n s u s e r e g i s t e r 1 :

1 . S y s t e m r e a d e r m a c r o i n s t r u c t i o n s , w h i c h p r o v i d e s u p p o r t a n d li n k a g e t o t h e s y s t e m r e a d e r f u n c t i o n .

$ R E A D

$ R L S D

$ R L S T

2 . S y s t e m l o g m a c r o i n s t r u c t i o n s , w h i c h p r o v i d e s u p p o r t a n d li n k a g e t o s y s t e m l o g fu n c t i o n s .

$ L M S G

$ L O G

$ L O G D

$ L W T O

$ P F K Y

$ P F K T

$ R D D

$ T R A N

$ W A I T

$ W R T D

T h e s e m a c r o i n s t r u c t i o n s u s e r e g i s t e r 2 :

$ A L O C $ G E T T $ P U T S

$ C H K $ G P C $ P U T T

$ C L O S $ L O A D $ R D T

$ C T L T $ L O G $ R E A D

$ D A T E $ O P E N $ R IT

$ F I N D $ P G S $ S I T

$ F T C H $ P U T C $ T O D

$ G E T C $ P U T D $ W R T T

$ G E T D $ P U T I $ W T T

$ G E T I $ P U T K $ X C T L

$ G E T K $ P U T P

$ G E T S

M a c r o l n s t r u c t i o n S t a t e m e n t s I

(12)

P a g e o f G C 2 1 - 7 6 0 8 - 2 l s s u e d 2 8 M a r c h 1 9 8 0 B y T N L : G N 2 1 - 5 7 0 0

3 . G e n e r a l S C P m a c r o i n s t r u c t i o n s , w h i c h p r o v i d e l i n k a g e t o s y s t e m f u n c t i o n s .

$ D A T E

$ E O J

$ F I N D

$ F T C H

$ L O A D

$ R O L L ( 5 7 0 4 - S C 1 o n l y )

$ R IT

$ S I T S S N A P

$ T I O B S T R A N

$ T R L

$ T R T B

$ T O D

$ X C T L

System Reader Support

Y o u r e a d a r e c o r d f r o m t h e s y s t e m r e a d e r b y c a l l i n g t h e s y s t e m r e a d e r r o u t i n e t h r o u g h t h e $ R E A D m a c r o i n s t r u c t i o n . T h e s y s t e m r e a d e r m a y b e o n e o f t h e f o l l o w i r r g :

C R T / K e y b o a r d . O n l y 9 6 - b y t e , s i n g l e - b u f f e r e d i n p u t i s a l l o w e d f o r t h i s d e v i c e . D o u b l e b u f fe r i n g is i g n o r e d . 2 5 0 1 C a r d R e a d e r . S i n g l e a n d d o u b l e b u f f e r i n g a r e s u p p o r t e d . O n l y B 0 b y t e s o f t h e g 6 - b y t e b u f f e r a r e u s e d a s in p u t ; th e r e m a i n i n g 1 6 b y t e s a r e c l e a r e d t o b l a n k s .

2 5 6 0 M u l t i - F u n c t i o n C a r d M a c h i n e ( M F C M ) . S i n g l e a n d d o u b l e b u f f e r i n g a r e s u p p o r t e d . O n l y 8 0 b y t e s o f t h e 9 6 - b y t e b u f f e r a r e u s e d a s i n p u t ; t h e r e m a i n i n g 1 6 bytes a r e c l e a r e d t o b l a n k s . S u p p o r t f o r b o t h t h e p r i m a r y ( M F C M ) a n d s e c o n d a r y ( M F C M 2 ) h o p p e r s i s p r o v i d e d . ' 1 4 4 2

C a r d R e a d P u n c h . S i n g l e a n d d o u b l e b u f f e r i n g a r e s u p p o r t e d . O n l y B 0 b y t e s o f t h e 9 6 - b y t e b u f f e r a r e u s e d a s in p u t ; th e r e m a i n i n g 1 6 b y t e s a r e c l e a r e d t o b l a n k s . 5 4 2 4 M u l t i - F u n c t i o n C a r d U n i t ( M F C U ) . B o t h s i n g l e a n d d o u b l e b u f f e r i n g a r e s u p p o r t e d . S u p p o r t f o r b o t h t h e p r i m a r y ( l \ 4 F C U 1 ) a r r d s e c o n d a r y ( M F C U 2 ) h o p p e r s i s p r o v i d e d . A l l 9 6 b y t e s a r e u s e d a s i n p u t .

D i r e c t l y a t t a c h e d 3 7 4 1 D a t a S t a t i o n M o d e l 1 o r 2 o r P r o g r a m m a b l e W o r k S t a t i o n M o d e l 3 o r 4 . S i n g l e a n d d o u b l e b u f f e r i n g a r e s u p p o r t e d . O n l y 9 6 - b y t e r e c o r d s m a y b e r e a d .

T o c a l l th e s y s t e m r 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 : 1 . U s e th e S R L S T m a c r o to c o n s t r u c t a p a r a m e t e r l t s t a s

i l r p u t t o t h e s y s t e m re a d e r ro u t i n e .

2 . U s e th e S R L S D m a c r o in s t r u c t i o n t o e s t a b l i s h e r l u a t e s f o r t h e s y s t e m re a d e r p a r a m e t e r l i s t .

3 . l s s u e t h r . S R E A D m a c r o in s t r u c l r o r r .

T h e $ R E A D m a c r o g e n e r a t e s t h e c o d e to l o a d th e p a r a m e t e r l i s t a d d r e s s i n t o r e g i s t e r 2 , s e t th e o p e r a t i o n c o d e , c a l l th e s y s t e m re a d e r r 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 t h e r e t u r n c o d e i s i n t h e s a m e b y t e a s th e o p e r a t t o n c o o e , t h e o p e r a t i o n c o c l e m u s t b e r e s e t b e f o r e e a c h c a l l . T h e

$ R L S D m a c r o i s p r o v i d e d to g e n e r a t e t h e o f f s e t s in t o t h e p a r a m e t e r l i s t , th e v a l u e s f o r t h e o p e r a t i o n c o d e s , a n d t h e v a l u e s f o r t h e r e t u r n c o d e s .

Generate a System Reader Parameter List ($R LST) T h i s m a c r o i n s t r u c t i o n g e n e r a t e s a r e a d e r p a r a m e t e r l i s t . T h e f o r m a t o f t h e S R L S T m a c r o i n s t r u c t i o n is :

N . r n r " l l S R L S T I B U F l a r l d r e s s , W O R K a d d r e s s l , B U F 2 a d d r e s s l

BUF | -address specif ies the address of tlre leftmost byte of a 9 6 - b y t e b u f f e r t h a t i s a l i g n e d o n a 1 2 8 - b y t e b o u n d a r y . T h i s o p e r a n d is r e q u i r e < . t .

WORK-address specifies the address of the leftmost byte of a 4 7 - b y I e w o r k a r e a ; th i s o p e r a n d is r e q u i r e d .

BUF2-address specifies the address of the leftmost byte of a 9 6 - b y t e b u f f e r t h a t i s a l i g n e d o n a 1 2 8 - b y t e b o u n d a r y . T h i s is t h e s e c o n d b u f f e r i f d o u b l e b u f f e r i n g i s u s e d ; i f t h i s o p e r a n d i s n o t s p e c i f i e d , s i n g l e b u f f e r i n g i s a s s u m e d .

System Reader Parameter List Offsets ($RLSD)

T h i s m a c r o i n s t r u c t i o n g e n e r a t e s a l i s t o f e q u a t e s u s e d to l a b e l th e f i e l d s in t h e s y s t e m r e a d e r p a r a m e t e r l i s t . $ R L S D a l s o g e n e r a t e s t h e o p e r a t i o n c o d e s a n d r e t u r n c o d e s u s e c l b y $ R E A D . T o a v o i d d u p l i c a t e l a b e l s , y o u s h o u l d u s e th i s m a c r o i n s t r u c t i o n o n l y o n c e i n a p r o g r a m .

T h e f o r m a t o f t h e $ R L S D m a c r o i n s t r u c t i o n is : o

(13)

Linkage to System Reader Function ($READ)

This macro instruction generates the linkage to call the system reader function and check for return codes.

The format of the $READ macro instruction is:

I N a m e l | $ R E A D I I L I S T - a d d r e s s ] [ , O P C - c o d e ] [ , E O F - a d d r e s s J [ , E O J - a d d r e s s ] [ , E R R - a d d r e s s l

LlST-address specifies the address of the leftmost byte of the system reader parameter list. lf this operand is not specified, the address of the parameter list is assumed to be in register 2.

OPC-code specifies the operation code for this read request.

T h e a l l o w a b l e c o d e s a n d th e i r m e a n i n g s a r e : Meaning

Set the operation code to read one record from the system reader single buffer.

Set the operation code to read one record from the system reader into buffer 1 and start a read on buffer 2.

Set the operation code to wait on buffer 2.

switch the buffers, and start the other buffer.

Set the operat,-,, -ode to wait on bulfer 2, and switch the buffers; do not start the other buffer.

N Do not set any operation code. lf this value

is specified, it is your responsibility to set the operation code before issuing this macro.

T h e d e f a u l t v a l u e fo r t h i s o p e r a n d is R D .

EOF-address specifies the address in your program that re- ceives control when an end-of-file statement (l* . l&. or /.1 is detected. lf this operand is not supplied. no code is generated to check for the end-of-file condition.

EOJ-address specifies the address of the routine that should get control if an end-of-job or end-of-step statement (/& or /.) was detected on the previous read. lf this operand is not specified. the test for the return code is not generated.

Once a /& statement is read from the system reader, nothing can be read from the system reader until the end of step.

Once a / . statement is read from the system reader, nothing can be read from the system reader until the end of job.

ERR-address supplies the address irr your program where control is passed if the controlled cancel option is taken in response to a permanent l/O error. lf this operand is omit- ted. no code is generated to check for the controlled cancel c o m p l e t i o n c o d e .

Notes:

1 . l f E R R o r E O F a d d r e s s e s a r e n o t s p e c i f i e d , y o u s h o u l d check the return code in your program to determine the outcome of the operation.

2. When double buffering is used, return code should be provided to return to the read macro instruction until end-of-file (EOF) is received. When the program's EOF is dependent upon a user-defined EOF statement, the last request to the read macro should be a wait only call;

this will allow all outstanding read requests to be cleared from the device queues. The last wait request is necessary to prevent overlaying the system input work area before the program reaches end of job.

System Log Support

Specifying a $LOG macro instruction in your program generates a call to system log (system log is a group of system output routines which provide communication with the operator). You may want to use system log to notify the operator of error conditions, error recovery procedures, and the validity of previous operator responses to messages.

lf the operator selects an invalid option in response to a message. the response is not accepted by system log.

Instead, another message is issued to the operator until a correct option is taken.

y'Vofe.' When an immediate cancel (option 3) is selected, control is passed directly to the end-of-job (EOJ) routine by system log.

Two types of printed output are available through system log - logs and messages. Both are printed on the system log device.

o A log is a four- or six-character statement that identifies the type and source of an error.

. A messge is a printed statement which can be used to indicate errors that have occurred or to issue instructions to the operator, such as requesting that a disk file be placed on a certain drive.

Logs and messages can be issued with or without being displayed on the 3277.

Three devices can be used as the system log device: the 1403 printer, the 3284 printer, or the CRT/Keyboard.

You can change devices by entering a LOG statement in your job stream.

Code R D R D F

R D D

R D L

M a c r o I n s t r u c t i o n S t a t e m e n t s I

(14)

To use system log, you must do the following:

1 . B u i l d th e l o g p a r a m e t e r l i s t u s i n g t h e $ L W T O o r

$ L M S G m a c r o .

2 . U s e t h e $ L O G D m a c r o i n s t r u c t i o n t o e s t a b l i s h e q u a t e s for the log parameter list.

3 . l s s u e t h e m a c r o i n s t r u c t i o n :

I N a m e l | $ t - o c | [ r t s t - " o a . e s s ] [ , o p N 0 - a d d r e s s ] [ , O P N 1 - a d d r e s s ] [ , O P N 2 - a d d r e s s ]

4. Process the operator,s reply in your program.

Two types of messages can be displayed on the log: the

system message and the message to the operator.

The $LMSG macro instruction generates a parameter list to

display the standard system message. you can also include from 1 to 107 characters of text with this message. The operator can respond to this message by pressing the pF12 k e y , t a k i n g o n e o f t h e f o u r allowable options, then pressing E N T E R . O p t i o n 0 . 1 , o r 2 is returned to you for checking;

option 3 means end-of-job. lf the operator takes option 3, the system log routine goes directly to the end-of-job.

The $LWTO macro instruction generates a parameter list to

display a message to the operator. This message is from 1 to 107 characters long and is prefixed with six characters w h i c h y o u s p e c i f y u s i n g th e $LWTO macro. you can re_

quest a reply (1 to 72 characters) from the operator, but if no reply is requested. the operator responds to the messaqe b y p r e s s i n g P F 1 2 , t h e n E N T E R .

For either of the message types, the $LOGD macro instruc_

tion is specified to generate offsets into the parameter list a n d t o d e f i n e t h e m e a n i n g o f the fields within the parameter I is t .

Text Length Considerations.. Message text is displayed on the CRT in one, two, or three 36-character lines. depend_

ing on the text length. For example, if the text length is 60 characters, it takes one line of 36 characters and 24 char_

acters from the second line to display the message.

Reply Length Considerations Three, 36-character lines (107 characters plus the CRT control character) are available for

the message and reply. The number of characters allowed

f o r t h e r e p l y d e p e n d s o n t h e n u m b e r o f l i n e s th a t c o n t a i n test characters. Once a test character has been entered on a l i n e , a n y n o n - t e x t p o s i t i o n s o f t h a t l i n e c a n n o t be used f o r a r e p l y . I n s t e a d , t h e r e p l y m u s t b e g i n o n t h e n e x t l i n e . l f t h e t h i r d l i n e c o n t a i n s a t e x t c h a r a c t e r , n o r e p l y c a n b e m a d e . F o r e x a m p l e :

lf the text length is:

more than 1 character b u t l e s s t h a n 3 6 more than 36 characters

but less than 72

more than 72 characters no reply can be made

b u t l e s s t h a n 1 0 8

Generate a Parameter List for WTO or WTOR ($LWTO) T h i s m a c r o i n s t r u c t i o n g e n e r a t e s a s y s t e m lo g p a r a m e t e r l i s t for the write-to-operator or write-to-operator-with-reply f u n c t i o n .

The format of the $LWTO macro instruction is:

l N a m e l | $ L W T O I T L E N - n u m b e r , T A D R - a d d r e s s [ , C O M p - c o d e ] [ , H A L T - c o d e ] [ , S U B H - c o d e ] [ , R E P L Y - Y / N ] [ , R L E N - n u m b e r ] [, R A D R - a d d r e s s ]

TLEN-number specifies the text message length (an un-

s i g n e d , n o n - z e r o , d e c i m a l v a l u e ) . T h i s o p e r a n d is r e q u i r e d a n d c a n b e f r o m 1 t o 1 0 7 c h a r a c t e r s l o n q .

TADR-address specif ies the address of the leftmost bvte of the text message; this operand is required.

COMP-code specifies the first two characters of the halt message. These characters are the component identification.

l f t h i s o p e r a n d is n o t s p e c i f i e d , t h e d e f a u l t v a l u e is t w o b l a n k s .

HALT-code specif ies the second two characters of the halt m e s s a g e - t h e h a l t i d e n t i f i c a t i o n . lf this operand is not s p e c i f i e d , t h e d e f a u l t v a l u e is t w o b l a n k s .

SUBH-code specifies the last two characters of the halt m e s s a g e * t h e s u b h a l t identif ication. lf this operand is not specified, the default value is two blanks.

The reply length can be:

from 1 to 72 characters from 1 to 36 characters

(15)

R E P L Y - Y o r / i / s p e c i f i e s w h e t h e r o r n o t a r e p l y i s r e q u e s t e c j . C O I W P - t : o c l e s p e c i f i e s th e f i r s t t w o ( r l r a r a { ; l . e t s o f l t r e r n e s s i r q { l l f Y ( y e s ) is s p e c i f i e d , s y s t e m l1 - c 1 w a i t s f o r t h e o p e r a t ( ) r t o t h e c o r n p r ; n e n I d r . s c r i D l i i ) r r { C C ) l t r h i 5 o 1 . ' e r ; r n L l t s t t , ' r r e p l y . l f l \ ( n o ) i s s p e t ; i f i e d o t i f t h i s o p e r a n d is L r m i t t e c l , r r o s p e r : i r i 6 1 1 1 , { w r r b l a r r k : ; a r c ir s s u t t t e c i .

r e p l y is a l l o w e d .

R L E N - n u m b e l i s t l r e l e r r g t h o f t h e r e p l y ( a n u n s i g n e d , n o n - z e r o , d e c i r n a l v a l u e , fr o r n 1 I c : 7 2 1 . l f R E P L Y Y i s s p e c i f i e c i , t h i s o p e r a n d is r e g u i r e d .

RADR-address specif ies the aridress of the leftmost byte of t h e r e p l y a r e a . l f R E P I - Y Y i s s p e c i f i e d , t h i s o p e r a n d is r e q u i r e d .

I Gerterate a Paraftteter List for Message on Systern Log ($LMSG )

T h i s m a c r o i n s t r u c t i o n q e n e r a t e s a s y s t e n r l o g p a r a n t e t e r l i s t f o r a l o g a n d / o r m e s s a g e t o t h e o p e r a t o r .

T h e f o r m a t o f t h e $ L M S G m a c r o i n s t r u c t i o n is : l N a m e l I S L M S ( j I I F O n M A T c o d r ' l [ , C O N l P . c o r l e l

[ , 1 ] A t - l - r t r l e l [ , S t J U H - c o d e ] I , S E V c o c l e j [ , D E F ' c o d e ] L , O P N O ' Y / N l l . O P N 1 Y / N l [ , O P N 2 Y / N ] I , O P N 3 - Y / N l [ T t - E N ' n u r n b e r l [ , f A D F ] a d c l r e s s l

FORMAT-code specif ies the type and length of the system l o g p a r a m e t e r l i s t . T h e v a l i d c o d e v a l u e s a n d t h e i r r n e a n i t t g f o l l o w :

Code Length of List Format of List

l ! . 4 L i t o d e s p e c i i i e s t h e s e c o n c i r w o c t t a r a c t c t s o i i . l t c r n e s s a g e - - th e r n e s s a g e i d e n t i f i c a t i o n ([ ' l l " t ) . lf t l r r s , . ) l ) i ' r , ] r ( i i s n o t s p e c i f i e d , t w o b l a n k s a r e a s s u r r t e c i -

S U B I I c o d e s p e c i f i e s th e l a s t tw o c l l a r a c t e r s r r l t t l e n r e s t i t ( l e r h e s r - r t r t t a l t i d e r r t i f i c a t i o n (l l ) . l f F O t l l t l A T i l ' r r f l w a s s p e c i f i e c l a n d t l r i s o p e r a n d is o t r t i t t r : d , i v u o l. ' l a t t k l a t r : a s s u m e d "

S E V - c o d e s p e c i l i e s t h e s e v e r i t y w h i c h c o n d i t i o n s tl t e s e l e c ' t i o n r ' l f th e d e f a u l t ( D E F ) o p t i o n o p e t a n t i T l t i s e t t t r v c o r ' r e s p o n r l s t o t h e s e v e r i t y c o d e e n t r y i n t n e N O F I A L . i s t a l t : m e n t . l f t h e s e v e r i t y c o d e s p e c i f l e d i r t t l r e N O H / \ L - I i ; t a t e m e n t i s l e s s t h a n t h e v a l u e s p e c i f i e d i n t h i s e n t r y , t l l e h a l t w i | | b e i s s r i e d . V a l id e t r t r i e s ( f r o r l t lo w e r s t t o l r i g h e s t ' r ) v r r I I I ii I a r e 1 , 2 , 1 1 , a r r d 8 . l f t l r i s o p e r a n c l i s o r l i t t e d , a s e v e r i t y o f B i s a s s u m e d -

D E F c o d e s p e c i f i e s t l t e c l e f a u l l o p t i o r t t o ' j e l e o t v v l l o l l e ) ( ( ) o r r I i n q I n u n . l t t e n d e d m o d e - V a l i d e r l t r i e s a r e N , [ J , ' l

, 2 , a r r r J 3 ; i t r h i s o p r : r o n r - l r s r r o t s l r e c i f i e d , N ( n o r r c ) is a s s t . t t r e r i .

O P N 0 - y ' / N s p e c i f i e s w h e t h e r o p t i o n 0 i s a l l " r w r : d . lf Y { y e s ) i s e n l e f e d " o p t i o r t 0 i s a l l o w e d ; i f l ' , 1 ( r r o i is t r t r l u t e c l o t i t t h i s o p t l r a r r d i s l r r r i t t e r i , o J r t i o r t 0 i s n o t a l l o w t : r l -

O P N I Y / N s p e c i f i c s w h e i h t : r o p t i o n 1 i s a l l o w e c l . l { Y i . r e n t e r e d , c t 1 - r t i o n 1 i s a l l o w e d ; i f lJ ( n o ) i s i: t r t e t e r l o r i J t l r i ' , o p r : r a n d i s o r n i t t e d o p t i o n I i s n o t a l l o w e d ^

L ) P N 2 - Y / N s i . ' e c i f r e s w f r e t h e r o p t i o n 2 i s a l l o v v r : t l . l { Y ( y e s ) i s e l t T e r e d , o p t i o n 2 i s a l l o w e d ; i f N ( r i o ) is e o i e r t r r l ' r r i f t h i s c p e r a r i d i s c l r n i t t e d , ( ) i ) t i ( l r r 2 i s r t n t ; l l r ' ' w r : r i

O P N 3 Y / N s p e c i f i e s w h e t h e r o p t i o r r 3 t s a l l o w e d . l t Y ( v c s ) i s s p r r c i f i e d , o p t i o n 3 i s a l l c ' w e d ; i i N ( n o ) i s s l > e c i f i e c i ' t r i t t h i s o J r e r a n r l i s o r n i t t e d , o p t i o l - l 3 i s r r o t ; r i l o v ; t " i

l v ( l f r r . l f t i 1 : l i t t t l 3 i s a l l o w e d . c ( ) ! l 1 r ( - ) l v v i l l tt ' r t l t i l i ' l r t l li t ) r l t o y o u l p r o q r a l l r l .

A 7 b y t e s

B 9 bytes

C 1 0 b y t e s

D 1 2 bytes

w h e r e : F a n d D a r e f l a g b y t e s C C i s t h e c o m p o n e n t lD I'lll is the nressage lD

O i s t h e o p t i o n i r r d i c a t o r ( t h i s is d e t e r n r i n e d b y t h e s e t t i n g s o f o p e r a n d s O P N 0 , O P N 1 , O P N 2 , a n d O P N 3 )

l l i s t h e s u b - h a l t l D L i s t h e l e r r g t h o f t h e t e x t A A i s t h e a d d r e s s o f t h e t e x t

l f t h i s o p e r a n d is o r n i t t e d , F O R M A T B i s a s s u n r e d . F D C C H H ( J F D C C I . I H O I I F D C C H I I O I - A A F D C C H H O I I L A A

M a c r o I n s t r u c t i o l l S l a t e r n d l l t s I 1

(16)

T L E N - n u m b e r s p e c i f i e s t h e t e x t l e n g t h . T h i s e n t r y ( L ) , v v h i c h is a d e c i m a l e n t r y f r . c r n 1 to 1O7, is requirecl if

F O R M A T C o r D i s s p e c i f i e d .

TADB-address specif ies the leftmost byte of the rext a d d r e s s . T h i s o p e r a n d ( A A ) i s r e q u i r e d if FORMAT_C or D i s s p e c i f i e d .

Generate the Linkage to the System LoS $LOG)

T h i s m a c r o i n s t r u c t i o n g e n e r a t e s t h e l i n k a g e re q u i r e d to u s e t h e s y s t e m lo g f u r r c t i o n , a n d c h e c k s th e r e s p o n s e r e t u r n e d . T h e $ L O G D m a c r o i n s t r u c t i o n m u s t be usecl w i t h t h i s m a c r o i n s t r u c t i o n , t o e s t a b l i s h o f f s e t s in t h e s y s t e m r o g p a r a m e t e r l i s t .

l f y o u w i l l n e e d to u s e th e d a t a i n r e g i s t e r 2 a t a l a t e r ti m e , y o u s h o u l d s a v e th e c o n t e n t s of that register before issuing t h e $ L O G m a c r o in s l r u c t i o n .

T h e f o r m a t o f t h e $ L O G m a c r o in s t r u c t i o n is:

I N a m e l I g i 6 6 | l t t s t - r d o ' . r s l t . o p N o - a d c i r e s s l [ . O P N 1 ' a d d r e s s l [ , O P N 2 - a d r J r e s s ]

L|ST-address specifies the address of the leftmost bvte of t h e s y s t e m lo g p a r a m e t e r l i s t . l f t h i s o p e r a n d is n o t s p e c l _ f i e d , t h e a d d r e s s o f t h e p a r a m e t e r l i s t i s a s s u m e d t o b e i n r e g i s t e r 2 .

OPNO-address specif ies the address of the r oLrtine that s h o u l d r e c e i v e c o n t r o l i f o p t i o n 0 i s t a k e n . l f t h i s o p e r a n d i s n o t s p e c i f i e d , n o c h e c k is m a d e f o r a r e s p o n s e o f 0 . y o u w o u l d u s e th i s o p e r a n d o n l y i f t h e $LMSG macro was used t o g e n e r a t e t h e p a r a m e t e r i i s t .

OPN 1 -address specifies the address of the routine tnat s h o u l d r e c e i v e c o n t r o l i f o p t i o n I i s t h e f e s p o n s e . l f t h i s o p e r a n d is n o t s p e c i f i e d , n o c h e c k is m a d e f o r a r e s p o n s e o f 1 . Y o u w o u l d u s e th i s o p e r a n d o n l V i f t h e $LMSG macro w a s u s e d to g e n e r a t e t h e p a r a m e t e r l i s t .

OPN2-address specif ies the address of the routine ttrat should r e c e i v e c o n t r o l i f o p t i o n 2 i s t a k e n . l f t h i s o p e r a n d is not s p e c i f i e d , n c l c l r e c k is m a d e f o r a r e s p o n s e o f 2 . y o u w o u l d u s e th i s o p e r a n d o n l y i f t h e $LMSG macro was used to qen_

e r a t e th e p a r a m e t e r l i s t .

Generate Displacements for System LoS 6L()GD)

" l - h i s

m a c r o i n s t r u c t i o r r g e n e r a t e s t h e f i e r l r . l i d i r s i 5 s 1 r 6 1 o f f s e t s f o r t h e s y s t e m lo g p a r a r r e t e r li s t s " T o iivcirl rluplicate labels, y o u s h o u l d u s e Ih i s m a c r o i r t s t r r r c l i o r t r : n l y L , i l o e r i l ; ) i ) l o g r a n t . T h e f o r m a t o f t h e $ L O G m a c r o i n s t r u c l i o n is :

General SCP Support

T h e g e n e r a l S C P m a c r o i n s t r u c t i o n s a l l c w y o u r o l ) r o v r c t e l i n l < a g e t o s y s t e m fu n c t i o n s b y c o n r r n l r n i c a t i r r g w i t h t h e M o d e l 1 5 s y s t e m c o n t r o r p r o g r a m .

Roi lout/Rol I in Lin kage ( $ RO L L)

T h i s m a c r o a p p l i e s to P r o g r a m N u m b e r 5704-SC1 only.

Y o u u s e $ R O L L t o i n t e r r u p t ( r o l l o u t ) the cunent proqranl s o t h a t a n o t h e r p r o g r a m c a n b e e x e c u t e d . Wherr the second p r o g r a i n is f i n i s l r e d , t h e f i r s t p r o g r a m is r e i n s t a t e c J ( r o l l e c . l i n ) a n d c o n t i n u e s e x e c u l n g .

O n c e r o l l o u t i s i n i t i a t e c l , t h e C R - T / K e y b o a r d b e c o r n e s t h e s y s t e m in p u t d e v i c e u n t i l o t h e r w i s e s 1 . , c i : i f i e d b y t h e u s e r o r u n t i l t h e i n t e r r u p t e d p r o g r a m i s r o l l c t l in .

W h e n u s i n g ro l l r : r , r t , y o u s h o u l d f o l l o w t l r e s e D r o c e c i u r e s : N o t e t h e f r : l l o w i n g r e s t r i c t i o n s :

a . l \ p r o g r a r r r u s i n g $ R O L L c a r r e x e c u t e ir r e i t h e r p a r t i t i o n , b u t w i i l a c k r - r o w l e d q ' r t h e r o l l o u t r e q u e s r o n l y w h e n r u n n i n g ir r p a r t i t r o n 1 .

b . A p r o g r a m u s i n q $ R O L L m u s t h e s o c l e f i n e c l t o t h e l i n k a g e e c l i t o r u s i n g t h c A T T R p ; r a m e t e r i n t h e OPTIONS statement (see IBM Systern/3 Ovenay Linkage Editor Reference Manual, GC21 7b61).

c . l f t h e i n t e r r u p t i n g p r o g r a r n a l s o r e c n c l n i z e s r o l l o u t r e q u e s t s , t h e s e re q u e s t s w i l l l t e i q n o r e d .

d . T h e s a m t ' l/ f ) d e v i c e s a r e a v a i l a h l e t c ) th e i n t e r r u p T - I n g p r o g r a m a s w e r e a v a i l a b l e t o t h e i r r i g i r r a l p l o - q r a m w a t h e x c e p t i o n o f tape r-rnits.

e . W h e n e v e r a n i n t e r r u p t i n g p r o g r a r n s h a r e s t h e s a r n e d i s k f i l e s a s a r o l l e d - o u t p r o g r . n l , o n l y r e a d i n g a n d u p d a t i n g a r e a l l o w e d b y t h e t w o p r o q r a r , n s . L o a d i n g a n d a d C i t i o n s a r e n o t a l l o w e c j .

u p d a t i n g a r e a l l o w e d b y t h e t w o p r o g r a m s _ L . o a d - i n q a n d a d d i t i o n s a r e n o t a l l o w e r J .

(17)

2 .

l s s u e t h e $ R O L L m a c r o i n s t r u c t i o n :

T h e c o d i n g g e n e r a t e d b y t h e $ R O L L m a c r o i n s t r u c - t i o n d e t e r m i n e s w h e t h e r r o l l o u t h a s b e e n r e q u e s t e d b y e n t e r i n g th e R O L L O T J T o p e r a t o r c o n t r o l c o m - m a n d . l f r o l l o u t h a s n o t b e e n r e q u e s t e d , t h e c u r r e n t p r o g r a m c o n t i n u e s e x e c u t i n g . l f t h e r e c l u e s t i s p e n d - i n g t h e r o l l o u t r o u t i n e s a r e c a l l e d . R o l l o u t p e r f o r m s t h e f o l l o w i n g s t e p s :

a . P l a c e s t h e c u r r e n t p r o g r a m ( p r o g r a m b e i n g e x e - c u t e d a n d t h e c u r r e n t c o n t e n i s o f t h e s c h e d u l e r w o r k a r e a o n d i s k .

b . A l l o w s a n e w p r o g r a m o r p r o c e d u r e t o b e r u n i n p l a c e o f t h e c u r r e n t P r o g r a m .

c . R e l o a d s th e o r i g i n a l p r o g r a m a n d r e s t o r e s t h e p r e v i o u s c o n t e n t s o f t h e s c h e d u l e r w o r k a r e a a n d p a s s e s c o n t r o l t o t h e p o i n t w h e r e t h e o r i g - i n a l P r o g r a m w a s i n t e r r u P t e d .

T h e f o r m a t o f t h e $ R O L L m a c r o i n s t r u c t i o n is : I N a r r r e l l $ R o L L I I T N D E X l / 2 I

INDEX-1 /2 specif ies which register can be used in the m a c r o i n s t r u c t i o n . l f t h i s o p e r a n d is o m i t t e d , r e g i s t e r 2 i s u s e d .

Find a Directory Entry ($F IND)

A l o a d m o d u l e m u s t b e i n t i r e o b j e c t l i b r a r y . S p e c i f i c in f o r m a t i o r r m u s t b e o b t a i n e d fr o m t h e m o d u l e ' s o b j e c t l i b r a r y d i r e c t o r y e n t r y b e f o r e a l o a d o r f e t c h c a n b e p e r f o r m e d . T h e r e a r e t w o w a y s y o u c a n l o c a t e a l o a d m o d u l e a n d o b - t a i n t h e i n f o r m a t i o n :

. l s s u e a $ F I N D b e f o r e is s u i n g a $ L O A D , F o r m l l . T h e i n f o r m a t i o n o b t a i n e d d u r i n g t h e f i n d i s u s e d d u r i n q t h e l o a d o p e r a t i o l r .

o l s s u e a l c a d w i t h f i n d ( $ L O A D , F o r m l ) . a f e t c h ( $ F T C H ) o r a f e t c h t o a d d r e s s ( $ X C T L ) . T h e s e fu n c - t i o n s p e r f o r m t h e f i n d o p e r a t i o n a s p a r t o f t h e i r n o r m a l f u n c t i o n s .

T h e $ F I N D m a c r o i n s t r u c t i o n s e a r c h e s t h e o b j e c t l i b r a r v d i r e c t o r y f o r t h e r e q u e s t e d m o d u l e n a m e a n d r e t u r n s th e d i r e c t o r y e n t r y i n t h e p a r a m e t e r l i s t .

l f y o u w i l l n e e d to u s e th e d a t a i n r e g i s t e r 2 a t a l a t e r t i m e , y o u s h o u l d s a v e th e c o n t e n t s o f t h a t r e g i s t e r b e f o r e is s u i n g t h e - q F l N D m a c r o i n s t r u c t i u r t .

T h e f o r m a t o f t h e $ F I N D m a c r o i n s t r u c t i o n is :

l N a m e l | $ F r N D I N A M E - m o d u l e [ . F l N D ' a d d r e s s ] t , P A c K - q / S l

NAME-module provides the name of the module to be f o u n d . O n l y n a m e s o f o b j e c t m o d u l e s ( O m o d u l e s ) c a n b e e n t e r e d h e r e .

FIND-address specifies the label that becornes the address o f a 1 2 - b v t e p a r a m e t e r l i s t b u i l t b y t h e g e n e r a t e d c o d e . I n i t i a l l y t h e p a r a m e t e r l i s t c o r r t a i n s i n p u t t o t h e s u p e r v i s o r . A f t e r e x e c u t i o n , it c o n t a i r r s t h e d i r e c t o r y e n t r y o f t h e m o d u l e . T h e f o r m a t a n d c o n t e n t s o f t h e p a r a m e t e r l i s t a f t e r e x e c u t i o n a r e s h o w n i n F i g u r e 5 . l f t h i s o p e r a n d is n o t s p e c i f i e d , a n l a c r o la b e l is g e n e r a t e d .

PACK-P/S specif ies the program disk pack (P) or the system d i s k p a c k ( S ) t o b e s e a r c h e d . lf t h i s o p e r a n d is n o t s p e c i f i e d , P i s a s s u m e d .

Load a Module ($LOAD)

T h i s m a c r o i n s t r u c t i o n lo a d s a m o d u l e i n t o s t o r a g e a t t h e a d d r e s s y o u s p e c i f y . C o n t r o i i s r e t u r n e d a { t e r th e m o d u l e h a s b e e n lo a d e d . Y o u m a y t h e n p a s s c o n t r o l t o t h e m o d u l e a t t h e s p e c i f i e d a d d r e s s . lf y o u w i l l n e e d to u s e th e d a t a i n register 2 at a larer time. you shoulo save the contents of t h a t r e g i s t e r b e f o r e is s u i n g t h e $ L O A D m a c r o i n s t r u c t i o n ' T w o f o r m s o f t h i s m a c r o c a n b e u s e d : lo a d w i t h f i n d a n d l o a d o n l y .

Load with Find (Form l)

T h e l o a d w i t h f i n d m a c r o i n s t r t t c t i o n l o c a t e s t h e m o d u l e a n d l o a d s it i n t o m a i n s t o r a g e .

T h e f o r m a t o f t h i s m a c r o i n s t r u c t i o n is :

t N a m e l | $ L o A D I N A M E - m o d u l e n a m e [ , F l N D - a d d r e s s ] [ , L O A D - ! / a d d r e s s ] [ , U S E - R / I \ R ] [ , P L l S T - a d d r e s s ] t , P A C K f / S l

M a c r o I n s t r u c t i o n S t a t e m e n t s 1 3

System Control Programming MacrosReference Manual

IBM System./3 Model 15

System Control Programming Macros R e f e r e n c e M a n u a l

Preface

Contents

Chapter 1 : Introduction

- ,

----l / x*

- \ _

\

I

1 6 s

"i-lo

i i 1 f i i

r1 I

i 1

l .

Minimum l--rsaT-rse i-,sc*T*,sD

-."*"**--T-

I I

I

J

Chapter 2. Macro lnstruction Statements

2 .

i i 1 f _{i i}

Minimum l--rsaT-rse i-,scT,sD