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 o a a a a a a
a a a a a a a a
a a a a a a a a
a a o a a a a a
a a a a a a a a
a a a a a a a o a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a o a a o a a a a a a a a a a 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 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 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 o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a
a a a a a a a a a a a a a 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 o a a a a a a a a a a a a a f a a a a a a a a a a a a a a a a a a a a a a a a a a a
a a a a a a a a
a a a a a a a a
a a t a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a 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 o a a a a a a a a a a a a a a
a a a a a a o a a a a a a a a a a a
a a a a a a a a a a a a a o a a a t a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a
a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a ! a a a a a a a a a a a a a a a a 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 a a a a 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 o a a a t 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 r 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 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 o a a a a a o a a o a a a a a a a a a a a a a t a a a a a a a a a a a a a a G 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 a a a a a a a a a a a a a a a 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 a a 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 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 o a a a a a a a o a a a a a a a a a a a a a a a a a
a a a a a a a a a a a a a a a a a a a a a a
a a a a a 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 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 o a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a 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 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
IBM System/3
Multilin elUultipoint Binary Synchronous Reference Manual
Communications
Program lfumbers:
5702-SCl Model 10 5704-SCl Model 15 5704-SC2 Model 15 5705-SC1 Model 12
GC21-7573-4
s3-30
Fifth Edition (December 1976)
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 r e p l a c e s , G C 2 1 - 7 5 7 3 - 3 a n d T e c h n i c a l N e w s l e t t e r s G N 2 1 - 7 7 7 5 , G N 2 1 - 5 2 7 9 , a n d G N 2 1 - 5 3 6 3 . C h a n g e s a r e i n d i c a t e d b y a v e r t i c a l li n e at the left of the clrange. New or extensively revised illustrations are indicated by the s y m b o l o t o t h e l e " t o f t h e c a p t i o n .
T h i s e d i t i o n a p p l i e s to P r o g r a m N u m b e r 5 7 0 2 - S C 1 ( v e r s i o n 1 0 a n d m o d i f i c a t i o n 0 0 ) o f I B M S y s t e m / 3 l / l o d e l 1 0 D i s k S y s t e m , P r o g r a m N u m b e r 5 7 0 4 - S C ' l ( v e r s i o n 0 1 a n d modification O0) c'f IBM System/3 Model 15, Program Number 57O4-SC2 {version 0 1 a n d m o d i f i c a t i o n O 0 ) o f I B M S y s t e m / 3 M o d e l 1 5 , a n d P r o g r a m N u m b e r 5 7 0 5 - S C l ( v e r s i o n O 2 a r r d m o d i f i c a t i o n 0 0 1 o f I B M S y s t e m / 3 M o d e l 1 2 , a n d t o a l l s u b s e - quent versions and modifications until otherwise indicated in new editions or techni' cal newsletters.
Changes to the inf ormation herein are made periodically. Before using this publica- tion to operate an IBM system, refer to the latest IBM System/3 Bibliognphy, GC20-8080, for tl'e editions that are applicable and current.
Requests for copir:s of IBM publications should be made to your IBM representative o r t o t h e I B M b r a r r c h o f f i c e s e r v i n g y o u r locality.
A Readers Comm(lnts form is provided at the back of this publication. lf the form has been removed, cornments may be addressed to tBM Corporation, Publications, Depan- m e n t 2 4 5 , R o c h e s t e r , M i n n e s o t a 5 5 9 0 1 .
This manual provides the programming information required t o u s e t h e M u l t i l i n e / M u l t i p o i n t F e a t u r e ( M L M p ) with System/3 Model 10, Model 12, or Model l5 binary synchro, n o u s c o m m u n i c a t i o n s p r o g r a m s .
On the Model 'l
0 and Model 1 2. M LMp is a feature of the System Control Programming (5702-SCl, Features 6030 a n d 6 0 3 1 ) . O n t h e M o d e l 1 5 , M L M P is included i n t h e b a s e System Control Programming (5704-SC1 or 5704-SC2l.
Hereafter, the terms "MLMP" and ,,System/3,, should be understood as applying to the System/3 Model 10 Disk Sys- t e m , th e M o d e l 1 2 , a n d th e M o d e l 15. unless q u a l i f i e d b y
" M o d e l 10 and Model 1 2 only" or ,,Model 1 5 o n l y . , , This reference manual is intended for applications program- m e r s w h o a r e fa m i l i a r w i t h :
o Basic telecommunications concepts and practices . IBM System/3 Basic Assembler language
o I B M System/3 M o d e l 1 0 D i s k S y s t e m , M o d e l 1 2 , o r M o d e l 1 5
The manual describes MLMP and the functions of MLMp.
the System/3 MLMP macro instructions, and the MLMp diag- nostics and diagnostic aids. The book also lists MLMp sys- tem requirements and considerations. Appendixes contain a list of MLMP considerations unique to certain terminals, ex- amples of coded MLMP macro instructions and a sample pro- gram, data area formats, BSC line control characters and codes, and a macro instruction summary.
As noted in the text, many of the cross references in this manual address index entries.
Preface
SYSTEM/3 MODEL 8
The System/3 Model 8 is supported by Systern/3 Model 10 Disk System control programming and program products.
The facilities described in this publication for the Model 10 are also applicable to the Model 8, although the Model g is not referenced. However. the Integrated Conrmunications A d a p t e r ( l C A ) is only available o n t h e M o d e l g . l f y o u have either the ICA or local display adapter, it is always designated as BSCA line 2. Therefore, you must specify line 2 whenever the ICA or local display adapter is used. or enter the BSCA OCL statement (// BSCA LItVE-2) at execution time. lt should be noted that not all devices a n d fe a t u r e s w h i c h a r e a v a i l a b l e o n t h e M o d e l 1 0 a r e a v a i l - able on the Model 8. Therefore, Model 8 users should be famif iar with the contents of IBM System/3 lvlodet g lntroduction, GC21 -51 14.
Prerequisite Publications
. General lnformation: Binary Synchronous Communica- tions, GA27-3OO4
. IBM System/3 Models 8, 10, 12, and l5 Cc,mponenrc R eference Manual, G 42 1 -9236
Preface i
Related Publications
. IBM System/3 Basic Assenbler Reference Manual s c 2 1 - 7 5 0 9
. IBM System/3 Models 4,6,8, 10, and l2 System Genera- tion Reference Manual, GC21 Sl 26 or tBM System/3 Model l5 System Generation Reference Manual.
G C 2 1 7 6 1 6
. IBM System/3 Model 8 Operator's Guide, GC21-7634, IBM System/3 Model l0 Disk System Operator,s Guide, GC21-7508 or IBM System/3 Modet l5 Operator's Guide. GC21 5075
. IBM System/3 Model lA Disk System Control program- ming Reference Manual, GC21-7512; tBM System/3 Model l5 System Control Programming Reference Manual (5704 SCl l, GC21-5O77 , or tBM System/3 Modet
l5 System Control Programming Concepts and Reference M a n u a l , ( 5 7 0 4 - S C 2 ) , G C 2 1 - 5 1 6 2
IBM System/3 Model l0 Disk System Halt Guide.
GC21-7540 or IBM System/3 Moclet lS System Messages, GC21-5076
IBM System/3 Disk System Control programming Macros Reference Manual, GC2"l-1562 or IBM System/3 Model
15 System Control Programming Macros programming Reference Manual, GC21 7608
l8M SystemR Overlay Linkage Editor Reference Manual, GC21 7561
l8M SystentR Multiple Line Terntinal Adapter RPQ Program Reference and Component Descriptiotl Manual. GC21-7560
IBM SystemR Model l2 Sysrem Control Programming Reference Manual. GC21 -51 30
IBM SystemR Model l2 Operator's Guide, GC21-5144 IBM SystemR Model 12 User"s Guide. GC21-5142 IBM SystemR Models 8, 10, 12, and 15 Components Reference Manual. GA2 1 -9236
o IBM SystemR Model 12 Hatt Guide, GC21-S14b o IBM SystemQ Systerns Summary, GA34 0002
I BM System /7 Binary Synchronous Communications Module (RPG), Programming Guide and Reference Manual. SC34-1 510
I 8M System /7 Teleprocessing Multiplexor "Tf'MM"
Programming Guide and Reference Manual Su,cporting RPO D0801 /. SC34-1506
System Components: IBM 2770 Data Communication System, GA27-3013
l8M 2780 Data Transrnission Terminal: Comtrtonent Descr ip t io n, GA27 -3005
Component Dercription: l8M 2972 Models 8 and | | General Banking Terminal System, GL27-3020 l8M 3270 lnfarmation Display System Compctnent Devription, GA27-2749
l8M 3735 Programmer's Guide, GC30-3001
l8M Systems 3735 Support Program Coding lV,tanual, G C 2 1 . 5 0 9 6
IBM 3600 Finance Communication System Program- mer's Guide and Component Description, GC27-OOO4 o
l '
P a g e o { G C 2 1 - 7 5 7 3 4 l s s u e d 1 1 5 N o v e m b e r 1 9 7 7 B y T N L . : G N 2 1 - 5 5 8 7
Contents
C H A P T E R 5 . R E O T J I R E M E N T S A N D
C O N S I D E R A T I O f . J S 5 7
S y s t e m C o n f r g u r s t i o n 5 1
M o d e l 8 5 1
M o d e l 1 O . 5 7
l \ 4 o d e l 1 2 . 5 8
M o d e l 1 5 . 5 8
S t o r a g e R e q u i r e m e n t s 5 9
P r o g r a m m i n g R e q u i r e m e n t s 5 9 M L M P 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 5 9 C H A P T E R 1 . M U L T I L I N E / M U L T I P O I N T
S Y N C H R O N O U S C O M M U N I C A T I O N S T e l e c o m m u n i c a t i o n s L i n e s S u p p o r t e d F u n c t i o n s
M u l t i p l e L i n e T e r m i n a l A d a p t e r
B I N A R Y
C H A P T E R 2 . S Y S T E M / 3 M A C R O I N S T R U C T I O N S D e s c r i p t i o n
C o n v e n t i o n s
C H A P T E R 3 . M L M P P R O G R A M M T N G P r e p a r i n g f o r D a t a T r a n s f e r
G e n e r a t e C o m m o n E q u a t e s ( $ C O M N ) G e n e r a t e 8 S C D T F D i s p l a c e m e n t s a n d L a b e l s
{ $ D T O B )
D e t i n e t h e F i t e f o r B S C ( $ D T F B ) . A l l o c a t e B S C F r l e s ( $ A L O C ) O p e n 8 S C F i l e s ( $ O P E N )
G € n e r a t e a M o d e l 1 0 a n d M o d e l 1 2 C h e c k l i s t ( $ C K L )
G e n e r a t e a M o d e l ' l
5 C h e c k l i s r 1 $ C K L ) G e n e r a t e a P o l l r n g / A d d r e s s i n g L i s t { $ P O L B ) C h a n g e a P o l i i n g L i s t ( S B C P L )
G e n e r a t e a P a r a m e t e r L i s t f o r C h a n g i n g a P o l l i n g L i s t o r a S w i t c h e d l D L i s t ( $ C H G B )
A l l o c a t e t h e T e r r n i n a l S t a t i s t i c s L o g g i n g A r e a ( $ L O G B i
G e n e r a t e a S w i t c h e d lD L i s r ( $ S W I B ) C h a n g e a S w r t c h e d l D L i s t ( $ B C S W ) 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 ( $ T R L ) G e n e r a t e a T r a n s l a t e T a b l e ( $ T R T B )
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 ( $ T R A N )
G e n e r a t e a n O n l r n e T e s t P a r a m e t e r L i s t ( $ R F T L ) I n r t i a t i n g D a t a T r a n s f e r
M o v e M o d e
l s s u e a G E T R e q u e s t ( $ G E T B ) l s s u e a P U T R e q u e s t ( $ P U T B ) C a n c e l a G E T R e q u e s t ( $ C A N B ) C h e c k fo r l / O C o m p l e t i o n ($ C H K ) T e c h n i q u e s f o r I n i t i a t i n g D a t a T r a n s f e r T e r m i n a t i n g D a t a T r a n s l e r
T e r m i n a t e B S C F i l e s C l r : s e B S C F i l e s ($ C L O S )
C H A P T E R 4 . D I A G N O S T I C S A N D D I A G N O S T I C A I D S
M n o t e s H a l t s
C o m p l e t r o n C o d e s B S C C o u n t e r s I n i t i a l i z i n g M L T E R F I L O n l i n e T e s t
T r a c e
S n a p D u m p M a i n S t o r a g e ( $ S N A P )
I
5 6
7 8 9 I 1 0 1 0 1 0 1 6 1 8 1 7 1 8 1 9 2 0 2 1 2 1 2 2 2 3
2 5 2 7 2 1 28 29 29
J I J V
39 39
4 1
4 l
4 5 4 5 5 0 5 0
5 l
5 4 5 5
6 1
t l l o l b l
1 1 l 6- 1 7 ' 7 7 7 8 7 9 7 9 8 l
I U J
1 0 5 1 0 9 1 0 9 1 1 0 1 1 1 1 1 1 1 1 2 1 1 2 1 1 2 1 1 3 1 1 3 1 1 4 1 1 5
1 1 7 1 1 7 1 1 8 1 1 9 1 1 9 A P P E N D I X A , D E V I C E . D E P E N D E N T
C O N S I D E R A T I O N S
I B M 2 9 7 2 B a n k i n g T e r m i n a l S y s t e m l 8 l \ , 1 3 2 7 0 I n f o r m a t i o n D i s p l a y S y s t e m
P o l l i n g / A d d r e s s i n g a 3 2 7 0
R e a d i n g F r o r n a n d W r i t i n g T o a R e m o t e 3 2 1 O H o w t o R e q i r e s t a n O n l i n e T e s t f r o r n a 3 2 7 0 S t a t u s i S e n s e f v l e s s a g e s
P o l l i n g / A d d r e s s i n g a 3 2 7 0 v i a t h e D i s p l a y A d a p r e r I B M 3 7 3 5 P r o g r a m m a b l e T e r m i n a l
F o r m D e s c r i p t o r C o n v e r t R o u t i n e ( $ $ B S C N ) A d d i t i o n a l 3 7 3 5 C o n s r d e r a t r o n s
A P P E N D I X B . S A M P L E S .
S a m p l e M L M P M a c r o I n s t r u c t i o n s M o d e l 1 0 a n d M o d e l 1 2 S a m p l e P r o g r a m :
C o m m u n i c a t i n g w i t h t h e 3 2 7 0
A P P E N D I X C . D A T A A R E A S , P A R A M E T E R L I S T S . A N D M E S S A G E F O R M A T S .
B S C D T F
M L M P l / O A r e a
T e r m i n a l S t a t i s t i c s L o g g i n g A r e a T r a c e T a b l e
B S C l / O R e g i s l e r s C h e c k l r s t
P o l l r n g / A d d r e s s i n g L r s t S w r t c h e d l D L r s t
P a r a m e t e r L i s t f o r C h a n g i n g a P o l l i n g L i s t o r S w r t c h e d l D L r s t
T r a n s l a t e P a r a m e t e r L r s t O n l r n e T e s l P a r a m e t e r L i s t O n l r n e T e s t R e q u e s t s M L M P M e s s a g e F o r m a t s
A P P E N D I X D . C O N T R O L C H A R A C T E R S A N D C O D E S
E B C D I C A S C I I
H e x a d e c i m a l R e p r e s e n t a t i o n s
T r i b u t a r y S y s t e m / 3 P o l l i n g a n d A d d r e s s i n g C h a r a c t e rs
A P P E N D I X E , M A C R O I N S T R U C T I O N S U M M A R Y 1 2 1 123 I N D E X
C o n t e n t s i i i
Chapter 1. Multiline/Multipoint B inary Synchronous Communications
M u l t i l i n e / M u l t i p o i n t ( M L M P ) i s a b i n a r y s y n c h r o n o u s communications (BSC) feature of System/3. MLMp pro- vides the assembler programmer access to the BSC l/O routines that support the Binary Synchronous Communica- tions Adapter (BSCA) as an l/O device. For a description of the BSCA, see the appropriate components reference manual for your system listed in the Preface.
M L M P e n a b l e s t h e a s s e m b l e r p r o g r a m m e r t o t r a n s m i t a n d r e c e i v e b i n a r y s y n c h r o n o u s d a t a o v e r t w o t e l e c o m m u n i r : a . t i o n s li n e s s i m u l t a n e o u s l y ( e a c h l i n e re q u i r e s a B S C A ) . The two lines can be used in the same program or can be used independently in separate program levels (on Modr:l 10
o r M o d e l 1 2 that has the dual programming f e a r u r e r n - I s t a t t e O l o r i n t h e p r o g r a m p a r t i t i o n s ( o n M o d e l 15). Tl-re
lines can be nonswitched or switched. Figr.rre 1 gives e>cam- p l e s o f t h e li n e c o n f i g u r a t i o n s p o s s i b l e w i t l r M L M P .
N o n s w r t c h e d M u l t i p o i n t
Nonswitched, Point-to-Point
\
\
Switched Point.to-Point
r B M 3 2 7 1 Control U n i t
System/3M o d e l 1 0 , 1 2 , o r 1 5
System/3 Model 6 ( R P G I I O n l y )
Data Set ( M o d e m ) Data Set
( M o d e m )
System/3 M o d e l 1 0 . 1 2 , o r 1 5
B S
c
A
Data Set ( M o d e m ) B S C A
Nonswitched, Poi nt-to-Pr
\
)r nt
L-
\ l
\ l
System/370 Data Set ( M o d e m
Data Set M o d e m l
C o m m o n Carrier
Data Set ( M o d e m )
Data Set
( M o d e m System/370
Data Set ( M o d e m l
B S
c
A
System/3 M o d e l 1 0 , 1 2 , o r 1 5
EI S
c;
Figure I (Part 1 of 21. Examples of MLMp BSC Networks
M u l t i l i n e / M u l t i p o i n t Binary Synchronous Cornmunications 1
System/3 M o d e l 8
8000 BPS Local Interface 2400 BPS Local Interface
' T h e
I n t e g r a t e d C o m m u n i c a r i o n s A d a p t e r ( l C A ) must be addressed a s B S C A l i n e 2 . T h e m a n u a l I C A s w i t c h c a n h a v e o n l y o n e interface active at any o n e t i m e .
2 S e e Figure 1 (Part 1 of 2) for examples of BSCA line configurations.
Figure 1 (Part 2 of 21. Examples of MLMP BSC Networks
The MLMP user specifies the functions of MLMP l/O rou- Figure 2 shows the relation of MLMP to the macro proc- tines by using System/3 assembler macro instructions (see essor, the overlay linkage editor. and user programs.
Chapter 2). The IBM System/3 Macros Feature expands
t h e s e m a c r o i n s t r u c t i o n s i n t o l i n k a g e t o M L M P r o u t i n e s . F i g u r e 3 s h o w s t h e r e l a t i o n s h i p o f a u s e r M L M P p r o g r a m t o M L M P l/ O r o u t i n e s . B S C D T F s , B S C lO l l s a n d b u f f e r s . Linkage to the MLMP routines is assembled as part of the and the BSCA.
user's program. The IBM System/3 Overlay Linkage Editor is then used to incorporate the MLMP routines in the user's object program.
T e r m i n a l s T e r m i n a l s
Figure 2. Generation of a User MLMp Object program
U s e r M L M P Source Program
The
l i n
The l i n k Macro
Processor
Assembler
Overlay L i n k a g e E d i t o r
M L the
U s e r M L Object Program
B S
c
A
Execution B S
c
A
Ihe user assembler program includes macro instructions for MLMP l/O routines.
Macro instructions are expanded into l i n k a g e t o M L M P ro u t i n e s .
The user program. which now includes l i n k a g e t o t h e M L M P r o u t i n e s , i s assembled.
M L M P R o u t i n e s
LMP routines are incorporated into e user's object program.
L M P
M u l t i l i n e / M u l t i p o i n t B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s 3
G L >
L O
o q )
l =
= l
# - - ' . 9 ^
: r t \ i
- =
l c o g
e - t - *
. v
(l)
o - c ^
< ' - L -
z : i . .
J ^ : U
> = d g
o- .E
3
= 3 p A
9 o
- c -
; *
- o
C D o
E X
L O
I L F
3
E o
3F
E
t l
I
i l t lx. 9 0 6 6
: . 3 -- ()
L X
H 5
f
Telecommu nications Lines Sirpported
F o l l o w i n g a r e th e t e r m i n a l s a n d li n e c o n n e c t i o n s s u p p o r t e d b y M L M P . F o r c o n s i d e r a t i o n s u n i q u e t o u s i n g a g i v e n t e r - m i n a l w i t h M L M P , s e e A p p e n d i x A .
N on swi tc h ed Po i n t-to. Po i n t
MLMP supports point-topoint nonswitched connections with central processing units programmed according to the conventions described in General lnformation: Binary Synchronous Communications, GA27-3004. MLMP also supports point-to-point nonswitched connections with the:
o I B M S y s t e m / 7 T e l e p r o c e s s i n g M u l t i p l e x o r ( T P M M ) a s described in IBM System/7 Teleprocessing Multiplexor
"TPMM" Programming Guide and Reference Manual Supporting RPO D0801 /, SC34-1506
o f BM 277A Da1a Communication System as described in System Components: IBM 2770 Data Communication S y s t e m , G 4 2 7 - 3 0 1 3
. IBM 2780 Data Transmission Terminal as described in IBM 2780 Data Transmission Terminal: Component Desc ri p ti on, G427-3005
Multipoint
MLMP supports System/3 as a control station and as a multidropped tbrminal. As a control station, System/3 can exchange binary synchronous data with:
. I B M S y s t e m / 3
. IBM System/7 as described in IBM System/7 Binary Sy nch ro n ou s C om m u n icati on s M odu le P rogramm i ng
Guide and Reference Manual, SC34-1510
r I B M S y s t e m / 7 T e l e p r o c e s s i n g M u l t i p l e x o r ( T P M M ) a s described in l8M System/7 Teleprocesing Multiplexor
"TPMM" Programming Guide and Reference Manual Supporting RPO D0801 /. SC34-1506
o f BM 277O Data Communication System as described in System Componen*: IBM 2770 Data Communication System, GA27-3013
o IBM 2780 Data Transmission Terminal as described in l8M 2780 Data Transmission Terminal: Component Dercription, GA27-3005
ISM 2972/2980 Banking Terminal Systerm (supported in the United States only) as described irt Component Desription: l8M 2972 ModelsS and ll General Bank' ing Terminal Systems, GL27-3020
I B M 3 2 7 0 I n f o r m a t i o n D i s p l a y S y s t e m a s d e s c r i b e d i n IBM 3270 lnformation Display System Clomponent Dercription, GA27-2749
o I B M 3 7 3 5 P r o g r a m m a b l e T e r m i n a l a s d e s c r i b e d i n I B M 3735 Programmer's Guide, GC3G3001
o I B M 3 6 0 0 F i n a n c e C o m m u n i c a t i o n S y s t e m ( M o d e l ' l 5 only) as described in IBM 3600 Finance rCommunica- tion System Programmer's Guide and Co,mponent Des- cription, GC27-0004
When System/3 is a control station. MLMF,
d o e s n o t s u p p o r t i n t e r m i x i n g o f t e r m i n a l s , c n o n e li n e . Note: For information on how to generate IBM 3735 form descriptor programs (FDPs) on System/3, see IBM System/3 Model !0 Disk System 3735 Application Pitckage Coding Manual. GC21-5096. A conversion routine (FDP/Convert) i s p r o v i d e d w i t h M L M P to c o n v e r t F D P s g e n e r a t e d o n O S or DOS to a format suitable for transmission from Model
I 0 or Model 12 ro a 3735. For a description of F DP/Convert, see index entry FDP/Convert.
Switch ed Poin t-to-Poin t
MLMP supports point-to-point switched connections with t h e fo l l o w i n g :
o Central processing units programmed according to the conventions described in General lnforntation: Binary Synchronous Communicationt G427-3004
o I B M S y s t e m / 7 T e l e p r o c e s s i n g M u l t i p l e x o r ( T P M M ) a s described in IBM System/7 Teleprocessi,ng Multiplexor
"TPMM" Programming Guide and Reference Manual Supporting BPO D0801 /, SC34-1506
o IBM 277O Data Communication System as described in System Componen$: IBM 2770 Data C'ommunication
System, GA27-3013
o IBM 2780 Data Transmission Terminal as described in IBM 2780 Data Transmission Terminal: Component Dercription, GA27-3005
M u l t i l i n e / M u l t i p o i n t B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s 5
o IBM 3275 Display Station as described in IBM 3270 I nformation Display System Component Description, GA27.2749
o f BM 3735 Programmable Terminals as describedin tBM 3 73 5 P rogram mer's G u i de. GC30-300.|
o f BM System/7 as described in tBM System/7 Systems Summary, GA34-0002
F o r s w i t c h e d c o n n e c t i o n s , M L M P s u p p o r t s a u t o c a l l ( U n i t e d S t a t e s o n l y ) , m a n u a l c a l l , a u t o a n s w e r , m a n u a l a n s w e r , a n d the exchange of station identification characters.
Note: For information on how to generate IBM 3735 form descriptor programs (FDPs) on System/3, see lgM System/3 Model l0 Disk System 3735 Support program Reference Manual, GC21-5096. A conversion routine (FDp/Convert) is provided with MLMP to convert FDps generated on OS or DOS to a format suitable for transmission from Model 10 to a 3735. For a description of FDP/Convert, see index entry FDP/Convert.
Functions
The following program functions are available to the MLMP user:
Receive only (receive input data from a remote t e r m i n a l ) .
Receive with transmittal of conversational reply (re- ceive input data from a remote terminal and, when required, transmit data as an acknowledgement).
Transmit only (transmit data to a remote terminal).
Transmit with reception of conversational reply (transmit data to a remote terminal and, when re- quired, receive data as an acknowledgement).
Transmit and receive-no conversational reply. Four modes of operation are possible:
Transmit a f ile, then receive another f ile.
Receive a file, then transmit another f ile.
Transmit records of a f ile interspersed with re- ceiving records of another f ile (receive RVI).
Receive records of a f ile interspersed with trans.
mitting records of another file (transmit RVll.
Depending on the terminal used and whether or tlot data is exchanged in conversational mode, records transtnitted and received can be fixed length, variable length, or span- ned (one record can occupy space in two contiguous blocks).
D a t a c a n b e e x c h a n g e d i n E B C D I C ( E x t e n d e d B i r a r y C o d e d D e c i m a l I n t e r c h a n g e C o d e ) o r i n A S C I I ( A m e r i c a n N a t i o n - a l S t a n d a r d C o d e f o r I n f o r m a t i o n I n t e r c h a n g e ) , c l e p e n d i n g on the BSCA used. Data translation is supported by trans-
late tables generated with macro instructions. EllCDlC t r a n s p a r e n c y a n d I T B ( l n t e r m e d i a t e B l o c k C h e c k i n g ) a r e supported by MLMP.
M L M P d o e s n o t t r a n s m i t l e a d i n g g r a p h i c s . M L M p c a n re - ceive leading graphics, but does not pass them to rne user.
D u r i n g p r o g r a m e x e c u t i o n . M L M P a u t o m a t i c a l l y d o e s t h e f o l l o w i n g :
. Blocks and deblocks data as required.
. Moves user data from the user's logical buffer to the telecommunications l/O buffers when sending data (PUT requests).
o Moves user data from the telecommunications l/O buf- fers to the user's logical buffer when receiving data ( G E T re q u e s t s ) .
a Inserts and removes data-link control characters as necessary.
MLMP provides error recovery, error recording arrd. at user's request, online test (OLT). A trace modulrr and a d u m p ro u t i n e a r e a l s o p r o v i d e d w i t h M L M P .
Multiple Line Terminal Adapter
T h e B S C A a n d th e M u l t i p l e L i n e T e r m i n a l A d a p t e r ( M L T A ) can be used concurrently on the disk system. For infor_
mation regarding MLTA, see IBM System/3 Multi,ole Line Terminal Adapter RPO program Reference and Compon- ent Description Manual, GC21 -7560.
t .
2.
3.
4.
5.
d .
b . c , d .
You inform MLMP of the functions your binary synchron.
ous communications program requires by using System/3 macro instructions.
Dercription
A System/3 macro instruction causes a specif ied sequence of assembler source instructions to be generated. The for- mat of a System/3 macro instruction is:
Name Operands
rymbol or blank
u
macronarl€
b no oparands or ona or mor€
op6rands sop8r8t6d by commas
Name
lf you specify a name, it is assigned to the generated se- quence of assembler instructions. The name becomes the symbolic address of the first byte of code generated by the macro instruction and it can be used to reference the code - that is, to modify the code or to branch to the code.
A name:
. Must begin with an alphabetic character in position 1 of the Assembler Coding Form
a Can be from one to six alphameric characters in length o Must contain no special characters or blanks
A/ofe.' System/3 macro instructions generate labels begin- ning with the dollar sign ($). lf you also def ine labels
$ginning with $ when you use System/3 macro instruc- tions, duplicate labels may result.
Operation
The operation entry is the mnemonic operation code of the macro instruction. Each operation entry must begin in position I of the Assembler Coding Form.
Chapter 2. System/3 Macro Instructions
Operands
Operands qualify the operation by specifying functions to be performed and data to be modif ied. Ear:h operand con- sists of a keyword and a parameter joined by a dash. Key- words and parameters are predefined symbols available for use with individual macro instructions. You select key- words and parameters according to the rules that apply to the macro instruction you are writing.
o The first operand must begin in position 14 of the Assembler Coding Form.
Operands must be separated by commas.
Blanks are not permitted between operands coded on the s a m e l i n e .
Blanks are not permitted between keywords and parameters.
Operands cannot be specified beyond position 71.
o Operands can be written in any order.
Continuation Lines
The number of operands involved in some macro instructions may require more than one line of coding. lf continuation is required, column 72 must contain a character and the last operand must be followed by a comma. An operand cannot be divided and continued on the next line. The operands o f t h e c o n t i n u e d f i e l d m u s t b e g i n i n c o l u m n 1 4 . F o r a n example of continuation coding, see Figurer 4.
CommenB
Comments can be placed after the last operand in a line if the comment is separated from the operan,l or comma by a blank. lf a macro instruction has no operands, comments can be placed in the operand field if position 14 is left b l a n k (F i g u r e 4 ) "
1 4 72
System/3 Macro Instructions 7
IBM Sy3tm/3 Beic Assmblor Coding Form
1 9 m 2 1 ) 2 2 3 2 1 X
1 4 r s 1 6 1 7 t a 1 9 n 2 1 2 2 2 3 2 4 E 2 6 2 1 2 A E
Figure 4. Sample of Continued Macro Instructions and Comments
Conventions
Certain symbols are used in this manual to abbreviate the descriptions of macro instructions.
$oP K AIBIC
BRACKETS [ ] indicate an optional entry.
SLASHES / separate entries when a choice exists.
$ a 5 $ 3 ? s $ { 4 1 4 2 a 3 q 4 5 4 4 ? s a g S 5 r s 2 6 3 i l 6 5 6 6 6 7 f f i r r 9 7 0 7 i 7 2
4 r 1 2 L U $ C a r € a g S 5 1 5 2 $ g 5 5 $ 5 7 S 5 9 m 6 1 6 2 6 3 6 4 6 5 6 6 7 6 A 6 e 7 0 7 1 7 2 7 3 7 . 7
UNDERSCORE _indicates the default if a paramerter is not specified.
UPPER CASE LETTERS indicate words or abbrev ations that must be entered as shown.
LOWER CASE LETTERS indicate information you must s u p p l y .
Each MLMP macro instruction is described in detail in Chapter 3. All MLMP macro instructions are sumnrarized in a chart in Appendix E. The chart also gives the approxi- mate length of code generated by each macro instruction.
Every MLMP program you write must accomplish three major functions:
1. Prepare BSC f iles for reception and/or transmission of data.
2. Initiate the transfer of data: receive and/or transmit.
3. Terminate the transfer of data.
Before programming these functions, however, note that one EXTRN must be defined in every MLMP program
($$BSMS). Other required EXTRNs are generated by the MLMP macro instructions when MLMP programs are assembled.
P R E P A R I N G F O R D A T A T R A N S F E R
Preparing for data transfer always includes the following three steps:
l. Generate labels and equates for use by the various macro instructions and generate field displacements and labels for the BSC DTFs. Common labels and equates are generated by the $COMN macro instruction when your MLMP program is
assembled. BSC DTF field displacements and labels are generated by the $DTOB macro instruction when your MLMP program is assembled.
2. Prepare BSC data files. Each BSC file must bet ' a. Defined ($DTFB macro instruction)
b. Allocated ($ALOC macro instruction) c. Opened ($OPEN macro instruction) Create a checklist to check for l/O completion.
Entries in the checklist are created by the $CKL macro instruction.
Ghapter 3. MLMP Programming
lf your station is a control station, you mus;t create a polling/addressing list. Entries in a polling/addressing list are created by the $POLB macro instructiorr. Entries in a polling list can be activated or deactivated by using the
$BCPL macro instruction (stations identified in active entries in a polling list are polled, stations identified in in- active entries are not polled). The $CHGB macro instruc- tion can be used to generate the parameter list required by
$ B C P L .
Control stations must also provide space fori logging termi- nal statistics. The $LOGB macro instruction can be used to allocate space for the Terminal Statistics Logging Area.
lf you are using a switched answer line, you can create a list containing the station identification sequences (station lDs) your station will accept from a remote terminal.
Entries in the switched lD list are created by the $SWIB macro instruction. The $BCSW macro instruction can be used to activate or deactivate entries in the list. (lf an entry is inactive, your station will not accept the station lD given in that entry.) The $CHGB macro instruction can be used to generate the parameter list required by $BCSW.
lf data in your BSC f iles requires translation, either before it is transmitted or after it is received, you rnust provide for data translation by constructing translale tables ($TRTB macro instruction for EBCDIC/ASCll tables) and generating a translate parameter list ($TRL macro instruc- tionl. When you want to trenslate data, generate the inter- face to the IBM-provided translate routine ($TRAN macro instruction ).
3.
MLMP Programming I
Note: lf you are transmitting translated data or receiving data that rnust be translated, be sure you have given the following information in the correct data code (EBCDIC or A S C I I } ;
1. Polling andlor addressing characters if you are a control or tributary station.
2. Station identification sequences if you are on a switched l i n e .
3. Online test parameter lists (generated by the $RFTL macro instruction) and online test messages if you intend to request online tests (see index entry online testl.
Generate Common Equates ($COMN)
The $COMN macro instruction generates labels and equates used by System/3 macro instructions. This macro instruc_
tion must be issued once in every assembler program con_
taining System/3 macro instructions.
$COMN Macro lnstruction Format
S C O M N
Generate BSC DTF Displacements and Labels ($DTOB) BSC DTF f ield displacements and labels must be def ined once in every MLMP program. The $DTOB macro instruc- tion generates f ield displacements and associated labels for BSC DTFs. These displacements and labels, as well as
B S C D T F b y t e a n d b i t d e f i n i t i o n s a n d a d e f i n i t i o n o f M L M p compf etion codes (see index entry completion codel, are i n c l u d e d i n y o u r a s s e m b l y l i s t i n g .
The generated BSC DTF labels are used by the code your MLMP macro instructions generate and you can use the labels to reference fields in the BSC DTFs.
See index entry 8SC DTF tor the labels generated by $DTOB.
$DTOB Macro lnstruction Format
Define the Fite for BSC ($DTFB)
The $DTFB macro instruction generates a BSC DTF. More than one BSC file can be defined for each telecornmunica- tions line. See Appendix C for the format of the BSC DTFs. See also index entry open BSC fites ($O\EN).
$DTFB Macro lnstruction Format
lnamel $DTFB R ECL-decdig,B LKL-decdig,
R CA D-address,FTYP-R CV/TSiM [,8 U FST-address,B U F E N D-actdras]
[,BUFNO-decdig]
t,coDE-E/Al [,LrNE-1/2]
[,UP-binary/Q] [.CH N-namel t,coNV-Y/Nl t,lrB-Y/Nl [,TRANSP_Y/N]
[,R V IADR -address,R V I MS K-hex]
[,DLYCT-decdig]
[,TYPE_EPIMP/CS/AC/MC/AA/MA ]
[,TERMAD-hex] [,AUTORS- y/N]
[, Ll STAD-address,ER R LOG-addresl t,POLRES-Y/N]
[,LlMlT--decdig]
[,D I A L-address,D I A LCT--decd ig]
[,RCVl D-address,R CVCT-deutig/
,swLrsT-Y/Nl
[.SN D I D-address,SN DCT-decdig]
[ . S P A N - Y / N ]
[ , R E C S E P - h e x l [ , E R R C T - d e c d i g ]
n a m e
l f a n a r n e is s p e c i f i e d , i t i s a s s i g n e d t o t h e f i r s t b y t e o f t h e g e n e r a t e d B S C D T F .
R E C L - d e c d i g
S p e c i f i e s , i n d e c i m a l , t h e m a x i m u m r e c o r d l e n g t h f o r t h i s f i l e , e x c l u d i n g l i n e c o n t r o l c h a r a c t e r s . R e c o r d l e n g t h is l i m i t e d b y a v a i l a b l e s t o r a g e a n d t e r m i n a l c h a r a c t e r i s t i c s s u c l r a s t h o s e li s t e d in A p p e n d i x A . S e e in d e x e n t r y $ D T F B considerations.
B L K L - d e c d i g
S p e c i f i e s , i n d e c i m a l , t h e m a x i m u m b l o c k l e n g t h fo r t h i s f i l e , e x c l u d i n g li n e c o n t r o l c h a r a c t e r s . B l o c k l e n g t h m u s t b e e q u a l t o o r g r e a t e r t h a n r e c o r d le n g t h ( R E C L o p e r a n d ) . See index entry $DTFB considerations.
R C A D - a d d r e s s
S p e c i f i e s t h e s y m b o l i c a d d r e s s i d e n t i f y i n g th e f i r s t b y t e o f y o u r l o g i c a l b u f f e r . T h e r e q u i r e d s i z e o f t h e l o g i c a l buf{er d e p e n d s u p o n t h e k i n d o f o p e r a t i o n s r e q u e s t e d f o r t h i s f i l e : o l f t h i s i s a r e c e i v e f i l e a n d O P C - N w i l l b e s p e c i f i e d i n
G E T r e q u e s t s f o r t h i s f i l e , th e l o g i c a l b u f f e r m u s t b e l a r g e e n o u g h to c o n t a i n o n e r e c o r d f o r t h i s f i l e .
. l f t h i s i s a r e c e i v e f i l e a n d O P C - B L K w i l l b e s p e c i f i e d i n G E T r e q u e s t s f o r t h i s f i l e , t h e l o g i c a l b u f f e r m u s t b e l a r g e e n o u g h to c o n t a i n t h e l a r g e s t b l o c k o f d a t a e x - p e c t e d , in c l u d i n g li n e c o n t r o l c h a r a c t e r s .
F o r a d e s c r i p t i o n o f O P C - N a n d O P C - B L K , s e e in d e x entry $GFfB macro instruction.
l f t h i s i s a t r a n s m i t f i l e , t h e l o g i c a l b u f f e r m u s t b e l a r g e e n o u g h to c o n t a i n o n e r e c o r d fo r t h i s f i l e .
R e c o r d s a r e m o v e d f r o m t h e l o g i c a l b u f f e r t o t h e B S C l / O b u f f e r s o n P U T r e q u e s t s ( $ P U T B m a c r o i n s t r u c t i o n ) , a n d m o v e d f r o m t h e B S C l / O b u f f e r s to t h e l o g i c a l b u f f e r o n G E T r e q u e s t s ( $ G E T B m a c r o in s t r u c t i o n ) . S e e index entrv move mode.
F T Y P - R C V / T S M
I n d i c a t e s w h e t h e r t h e f i r s t o p e r a t i o n fo r t n i s f i l e i s r e c e i v e ( R C V ) o r t r a n s m i t (T S M ) . l f y o u d e f in e a r e c e i v e f i l e ( R C V ) , t h e f i r s t l / O r e q u e s t f o r t h e f i l e m u s t b e a G E T r e q u e s t (see index entry $GETB macro instructionl , fi you def ine a t r a n s m i t f i l e ( T S M ) , t h e f i r s t l / O r e q u e s t f o r t h e f i l e m u s t b e a P U T r e q u e s t o r a r e q u e s t f o r a n o n l i n e t e s t ( s e e i n d e x entries $PUTB macro instruction and onli,ne testl .
B U F S T * a d d r e s s
S p e c i f i e s t h e s y m b o l i c a d d r e s s i d e n t i f y i n g th e f i r s t b y t e o f t h e a r e a a v a i l a b l e t o t h i s f i l e f o r l l O b u f f e r s a n d l O B s ( i n p u t / o u t p u t b l o c k s ) .
N o t e : E a c h B S C f i l e r e q u i r e s a u n i q u e l / O a r e a .
B U F E N D - a d d r e s s
S p e c i f i e s th e s y m b o l i c a d d r e s s i d e n t i f y i n g t h e l a s t b y t e o f t h e a r e a a v a i l a b l e t o t h i s f i l e f o r l / O b u f f e r s a n d l O B s . F o r f o r m u l a s n e c e s s a r y t o c a l c u l a t e t h e l e n g t h o f M L M P l / O areas, see index entry MLMP l/O area. See also index e n l r y o n l i n e t e s f i f y o u i n t e n d t o u s e th e , l n l i n e t e s t .
B U F N O - d e c d i g
S p e c i f i e s t h e n u m b e r o f l / O b u f f e r s a n d l ( l B s t o b e c o n - t a i n e d in t h e l / O a r e a f o r t h i s f i l e , a n d s p e c i f i e s t h a t t h e l l O a r e a i s t o b e a l l o c a t e d b y t h i s $ D T F B m a c r o in s t r u c - t i o n . ( S e e in d e x e n t r y M L M P l / O a r e a . l
y ' y ' o f e ; E i t h e r B U F S T a n d B U F E N D o r B | . J F N O s h o u l d b e s p e c i f i e d . O t h e r w i s e , t h e $ D T F B m a c r o in s t r u c t i o n a l l o - c a t e s e n o u g h ll O a r e a t o c o n t a i n o n l y o n e ' I O B a n d b u f f e r .
M L M F ' P r o g r a m m i n g 1 1
P a g e o f G C 2 l - 7 5 7 3 4 l s s u e d 2 5 N o v e m b e r 1 9 7 7 B y T N L : G N 2 1 - 5 5 8 7
C O D E _ E / A
S p e o f i e s w h e t h e r t h e c h a r a c t e r c o d e o f y o u r d a t a is E B C D I C ( E ) o r A S C I I (A ) . T h e c h a r a c t e r c o d e y o u u s e r s d e t e r - n r i n e c j b y t h e t r a n s m i s s i o n c o d e f e a t u r e i n s t a l l e d o n yo,.rr BSCA.
L r N E - t i 2
S p e c i f i e s t l r e B S C A th i s f i l e u s e s ; a d a p t e r 1 o r a d a p t e r 2 . T h e , , ' / 3 5 1 . ; 4 o p e r a t i o n c o n t r o l l a n g u a g e i O C L ) s t a t e m e n t c a n o v e r r i d e t h r s o p e r a n d . F o r O C L i n f o r m a t i o n , s e e t h e a p p r o p r i a t e s y \ t e m c o n t r o l p r . o g y a m m i n g r e f e r e n c e m a n u a l listed in tne Pr ef ace.
U P b i n a r y i C )
S p e c i { i e : t h e c o n d r t i o n a l o p e n r n g o f a D T F . l { t h e b i t s s p e c i f i e d . i n i . r i n a r y , a r e o n i n t h e e x t e r n a l i n d i c a t o r : e t t i n g g i , r e r r b y r h e l a s t S W I T C H O C L s t a t e m e r r t , t h e D T F i s o p e n e d . T h e d e f a u l t 0 s p e c i f i e s t h e u n c o n d i t i o n a l o p e n i i r q o f a D T F . F o r O C L i n f o r m a t i o n , s e e t h e a p p r o p r i a t e s y s t e r ] l c o n t r o l ; : r o g r a m m i n g r e f e r e n c e m a n i r a l li s t e d in Ihe Preface.
Cl-JN r)arne
S r ; e c r f i e s t h e s y r n b o l i c a d c l r e s s o f t h e n e x t D T F i n t h e c h a i n . C h a i n e d D T F s a r e a l l n c a t e d , o p e n e d , o r c t o s e d a t t h e s a r n e t i m e a s t h e f i r s t D T F i n t h e c h a i n . An enct,ot- c h a i n in d i c a t o r , X ' F F F F ' , i s e n t e r e d i r r th e D T F i f n o c h a i n o p e r a n d rs g i v e n .
C O N V - Y / N
S p e c i f i e s w h e t h e r c o n v e r s a t i o n a l r e p i i e s c a n b e s e n t f r o m o r t o t h i s f i l e : Y i f y e s , N i f n o .
f / o t e . ' B l o c k l e n g t h ( B L K L o p e r a n d ) must equal record l e n g t h ( R E C L o p e r a n d ) f o r a c o n v e r s a t i o n a l f i l e
I T B - Y / N
S p e c i f i e s w h e t h e r i n t e r m e c j i a t e b l o c k c h e c k i n g is r e q u e s t e d ; Y i f y e s , N i f n o . I n t e r m e d i a t e b l o c k c h e c k i n g is n o t p e r _ m i t t e d f o r a c o n v e r s a t i o n a l f i l e .
T R A N S P - Y / N
S p e c i f i e s w h e t h e r d a t a f o r t h i s f i l e w i l l b e t r a n s m i t r : e c l i n t r a n s p a r e n t m o d e ; Y i f y e s , N i f n o . T r a n s p a r . e n c y n r a y b e s p e c i f i e d o n l y i f t h e t r a n s p a r e n c y f e a t u r e is i n s t a l l e d o r r t h e B S C A u s e d . l f i r J is s p e c i f i e d a n d t r a n s p a r e n t d a t a r s r e c e i v e d , n o e r r o r o c c u r s d f r d th e $ B C R A N b i t i s s e t r n t n e
$ B D A T T f l e l d o f t h e B S C D T F .
R V I A D R - a d < . i r e s s
S p e c i f i e s th e s y m b o l i c a d c l r e s s o f a c n e - b y - r . c f i e l r l y r ) u p r o - v i d e . T h e f i e l d is u s e t . t v u i t h t l i e n r a s k s p e c i f i e r l i r r t h e
R V I M S K o p e r a r r t i ( f o l l o w i n g p a r a g r a p h ) t o i n c l i c a t e y r h e n a r e v e r s e i n t e r r u l t t r e r l u u s r ( R V l ) i s r e c e i v c r i o r i s t o b e s e n t . S e e in d e x e n t r y r e v e r s e i n t c r r i - r p l f o r c x a r n p l e ; o f u r n q r e v e r s e i n t e r r u p t s . R V I A D R a d d r e s s r e q u i r e : ; t l r e R V I M S K o p e r a n d .
R V I M S K n e x
S p e c i f i e s t w o h e x a d e c i m a l c h a r a c t e r s t o r e p r e s e n t t l t e r e v e r s e i n t e r r u p t ( R V i ) m a s k . T h e b i t s r e i : r e s e r r t e d b y t h e m a s k a r e s e t o i r b y I M L M P in t h e R V I A D R f r e l d ( p r r : c e d i n g p a r a g r a p h ) i f a r e v e r s t - ' i n t e r r u p t r e q u e s t ( R V l l i s r e c e i v e d f r o m a r e m o t e t e r m i n a l . l f a r e v e r s e i n t e r r u p t r e q u e s t ts t o b e s e n t t o a r e m o t e t e r m i n a l , y o u m u s t s e t o r r t h e : rn a s k in the RVIADR f ield. See index entry reverse interrupt f o r e x a m p l e s o f u s i n g r e v e r s e i n t e r r u p t s . R V I M S K - h e x r e q u i r e s t h e R V I A D R o p e r a n d .
D L Y C T - d e c d i g
S p e c i f i e s a d e c i m a l c l e l a y c o u n t . T h e d e l a y c r r u n t i s t h e n u m b e r o f s e c o n d s a f t e r r e c e i v i n g o r t r a n s m i t t i r r g a l t l o c k o f d a t a t h a t M L M P w i l l w a i t f o r y o u t o r e c e i v e o r t r , t n s m i t a n o t h e r b l o c k o f d a t a fo r t h e s a n r e f i l e . M l _ M P w a i t s th e s p e c i f i e d n u m b e r o f s e c o n d s b y u s i n g th e W A C K E t \ O a n r j T T D N A K l i n e c o r r t r o l s e q u e n c e s .
E x c e p t w h e n y o u h a v e r e c e i v e r l o r t r a n s m i t t e d e n d o f f i l e , M L M P a b o r t s tr a n s m i s s i o n a n d p o s t s th e $ B C L S T c o m - p l e t i o n c o d e i f t h e d e l a y c o u r r t i s e x h a u s t e d b e t w e e n tr a n s - missions. (See index entry contpletion code.l
l f y o u d o n o t s p e c i f y a n u m b e r . a 1 8 0 - s e c o n d d e l a y c o u n t i s a s s u m e d . lf y o u d o s p e c i f y a d e l a y c o u n t , c o n s i d e r th e t i m e t h a t m a y b e r e q u i r e d fo r s u c h t h i n g s a s d e v r c e e r r o r s , h a l t s , a n d r e a d y i n g l/ O d e v i c e s .
TYPE_
This operand specifies the type of line connection to be established for this file. You must have the appropriate network attachment feature installed before specifying one of the following line types:
P8
Specifies that this file will use a point-to-point non- switched line. PP is assumed if no line type is specified.
M P
S p e c i f i e s t h a t th i s fi l e w i l l u s e a m u l t i p o i n t l i n e , a n d th i s station is a tributary station. TYPE-MP requires the T E R M A D o p e r a n d .
CS
S p e c i f i e s t h a t t h i s fi l e w i l l u s e a m u l t i p o i n t l i n e , a n d th i s station is the control station. TYPE-CS requires the L I S T A D a n d E R R L O G o p e r a n d s .
AC
Specifies that this file will use a switched line. autocall.
T Y P E - A C r e q u i r e s t h e D I A L a n d D I A L C T o p e r a n d s . M C
Sprecifies that this file will use a switched line, manual c a l l .
AA
Specifies that this file will use a switched line. auto answer.
M A
Specifies that this file will use a switched line, manual answer.
T E R M A D - h e v
Specifies the hexadecimal representation of the two- character polling or addressing sequence used by this file.
l f t h i s is a t r a n s m i t f i l e ( F T Y P - T S M ) , T E R M A D s p e c i f i e s p o l l i n g c h a r a c t e r s ; i f t h i s is a r e c e i v e f i l e ( F T Y P - R C V ) . TERMAD specifies addressing characters.
Each tributary station on a multipoint line must have unique polling and/or addressing characterr;. See index entry tributary System/3 polling and addre,ssing characters f o r t h e p o l l i n g a n d a d d r e s s i n g c h a r a c t e r s a l ' a i l a b l e t o i d e n t i f y System/3 tributary stations. See also index entry pallingi addressing.
T h e T E R M A D o p e r a n d r s u s e d o n l y w h e n - f Y P E - M p i s s o e c i f i e d .
A U T O R S - Y / [ l
S p e c i f i e s w h e t h e r M L M P w i l l a u t o m a t i c a l l l ' s e n d a n e g a t i v e response to polling and addressing sequencoli received after d a t a t r a n s f e r f o r t h i s fi l e i s c o m p l e t e ; Y i f 1 , e s . N i f n o . l f A U T O R S * Y i s s p e c i f i e d , M L M P w i l l c o n t i r r u e t o r e s p o n d n e g a t i v e l y t o p o l l i n g a n d a d d r e s s i n g s e q u e n c e s u n t i l a n o t h e r M L M P l/ O r e q u e s t ( $ G E T B , $ P U T B . o r $ R F T ) is is s u e d f o r t h e li n e , o r u n t i l a r e q u e s t t o c l o s e t h e M L [ 4 P f i l e s ($ C L O S ] is issued. (See index entry macro instructions.l lI
AUTORS-N is specified or if AUTORS is not specified at a l l f o r a t r i b u t a r y s t a t i o n , t h e t r i b u t a r y s t a t i o n w i l l b e o n - l i n e w i t h t h e c o n t r o l s t a t i o n o n l y w h e n a n I M L M p l / O r e - q u e s t ( $ G E T 8 . $ P U T B , o r $ R F T ) h a s b e e n a c c e p t e d . A U T O R S - Y e n a b l e s a t r i b u t a r y s t a t i o n t o r e m a i n o n l i n e w i t h t h e c o n t r o l s t a t i o n a f t e r in i t i a l d a t a t r a n s f e r , e v e n though data transfer is not occurring. When a tributary r e m a i n s o n l i n e u n t i l a l l d a t a tr a n s f e r b e t w e r : n i t a n d th e control station is complete, the control station spends no t i m e w a i t i n g f o r t h e t r i b u t a r y t o r e s p o n d t c , p o l l i n g o r add ress i ng.
A U T O R S is u s e d o n l y w h e n T Y P E - M P is s p e c i f i e d , a n d t h e A U T O R S o p e r a n d m u s t b e s p e c i f i e d t h e s a m e w a v in all $DTFB macro instructions written for the same BSC l i n e .
M L M P P r o g r a m m i n g 13
LISTAD-address
Specifies the symbolic address identifying the first byte of the polling or addressing list used by this f ile. lf this is a transmit file (FWP-TSMl, LISTAD points to an addressing list; if this is a receive file (FTyp-RCV), LISTAD points to a pof ling list. See index entry polling/addressing.
LISTAD is required only when TypE-CS is specified.
E R R L O G - a d d r e s s
Specifies the symbolic address identifying the first byte of an area in main storage to be used for logging transmission statistics by terminal. You must provide one such area for each telecommunications line used ($LOGB macro instruction); and each area must be large enough to con- tain statistics for each unique polling and addressing se- quence used in your program. For the format of this log- ging area and a formula for computing its size. see index entries $LOGB Macro lnstruction and Terminal Statrstics Logging Area.
ERRLOG is required only when TypE-CS is specified.
A/orte.' Only one terminal statistics logging area per line is required in your program. Therefore, all ERRLOG oper- ands specified for DTFs using the same line will be i dentical.
P O L R E S _ Y / X
Specifies whether the control station modules required to poll and address tributaries, log terminal statistics. and close active files are to be resident in main storage; y if yes, N i f n o .
Specifying POLRES-Y for control stations saves it signifi- cant amount of execution time because transient Inodules do not have to be found and loaded from the disk oblect library each time the control station polls or addresses a tributafy, logs terminal statistics, or closes an active file.
POLRES is used only when TYPE-CS is specified. and the POLRES operand must be specified the same way in all
$DTFB macro instructions written for the same BSC line.
L I M I T - d e c d i g
Specif ies the number of times, in decimal, MLMp rrill accept a negative response from each terminal in a wrapped polling or addressing list before posting the $BCNliG com- pletion code (see index entry completion codel. \talid entries are 1-254. lf no number is specified, MLMp passes through a wrapped list until a positive response is received, an error is encountered, or the poll is canceled (seer index
entry $CANB macro instructionl.
LIMIT is used only when TYPE-CS is specified.
ffofe.' Consider defining LIMIT for any addressing list created by a $POLB macro instruction in which LI\ST- WRAP was specified. See index entry fiPOLB mac,ro instruction.
DIAL-address
Specifies the symbolic address identifying the f irst byte of the field containing the decimal number that must be dialed to extablish a switched connection. This operand is used only when TYPE-AC is specified. DIAl-address requires the DIALCT operand (see following paragraph).
DIALCT-decdig
Specifies, in decimal, the length of the number that must be dialed to establish a switched autocall connection. The maximum length permitted is 12. This operand is used only when TYPE-AC is specif ied, and requires the DIAL operand.
RCVID-address
Specifies the symbolic address of the first byte of either the identification sequence required from the remote station or of the switched lD list (see index entry switched lD list for the format of the list). RCVID-address requires either the RCVCT operand or SWLIST - Y. Using RCVID and R C V C T o r R C V I D a n d S W L I S T - Y im p r o v e s d a t a s e c u r i t y on switched lines; these operands are recommended for all switched lines.
RCVCT-decdig
Specifies, in decimal, the length of the identification se- quence required from the remote station. Length can be
1-15. lf 1 is specified, MLMP expects to receive 2 charac- ters - duplicates of the character addressed by the RCVID operand {preceding paragraph}. lf no length is specified, 0 is assumed. RCVCT-decdig requires the RCVID operand.
S W L I S T - Y / N
Specifies whether this switched answer line will use the switched f D list (see index entry switched lD list for the format of the list); y if yes. N if no. SWLIST-y can be specified only when TYPE-AA or TYPE-MA is specified.
S W L I S T - Y r e q u i r e s t h e R C V I D o p e r a n d .
SN DID-address
Specifies the symbolic address of the first byte of the iden- tification sequence required by the remote station. SNDID- address requires the SNDCT operand. Using the SNDID and $NDGT operands improves data security on switched lines; these operands are recommended for all switched l i n e s .
SNDCT*decdig
Specifies, in decimal, the length of the identification sequence required by the remote station. Length can be 1-15. lf
1 is specified, MLMP transmits 2 characters - duplicates of the character addressed by the SNDID operand (preced- ing paragraph). SNDCT-decdig requires the SNDID operand.
SPAN-Y/N
Specifies whether records in this file will span blocks of tex$ Y if yes, N if no. A spanned record must be contained within two contiguous blocks of text.
When spanned records are received or transrnitted, DTF fields $BDWKB and $BDREL are altered. 'l-he
f ields are restored after successful l/O completion. lf an error occurs during transmission of spanned records, you must restore
$BDWKB and $BDREL before requesting arrother operation for the file.
SPAN-Y requires the RECSEP operand if this is a receive file (FTYP-RCV). See index entry $DTFB considerations See afso index entry BSC DTF for the formrat of the BSC D T F .
RECSEP-hex
Specifies the hexadecimal representation of a one-character record separator used to separate variable length records in bf ocks of text. See index entry $DTFB considerations.
ERRCT-decdig
Specif ies the number of times, in decimal, that M LMP re- tries an unsuccessful operation before posting an error con- dition. Valid entries are 1-254. lf no number is specified, an error retry count of 7 is assumed.
fiote; ERRCT specifies an error retry count only for the local MLMP program; ERRCT does not affe'ct the remote terminal. In an error situation occurring between two terminals with different retry counts, the lower retry count determines when the error becomes permanent.
$DTFB Considerations
MLMP supports three kinds of record formats: f ixed length, variable length, and spanned. The kind of format you choose determines the way in which four $DTFB operands must be specified: RECL-decdig, BLKL-decdig, SPAN-Y/N, and RESCEP-hex.
MLMP F'rogramnring 15
