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 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 o a a a a a a a a a a a a a a a a
33:: ::3t
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 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 o a a a a a a a o a a a a a a a a o a a a a a a a a o a a a a a a a a a a a a a a a
o a a a 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 o 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
IBM System./3
RPG ll Telecommunications Programming
Reference Manual
Program Numbers:
5 7 0 1 - R G 1 ( M o d e l 10 Card System)
5702-RG1 (Model 10 Disk System)
5703-RG1 (Model 6) 5704-RG1 (Model 15) 5704-RG2 (Model 15)
5705-RG1 (Model'12)
sc21-7507-5 File No. 53-30
Program Product
a a a a a a a a a a a a a a a c 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 o a a a a a a a o a o a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a 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 o a a a a a
a a a a a a a a a a o a a a a o a a a o a a a a o a a a a a a a a o a a a a a a a a a a a o a a a a a a a a a a a a a a a a .
a a a a a a a a a a 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 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 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 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 o 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 o 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
o a a a a a a a a a a a
o a a a a a a a a a a a a o a a
a a a a a a a a a a a o
o a a a a a a a a a a a
o 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 o 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 o a o 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
Page of SC21-7507-5 lssued 30 June 1978 By TNL: SN21-5624
Sixth Edition {December 1975)
this is a major revision of, and obsoletes, SC2l-75074 and rechnical Newsletters S N 2 1 - 7 7 3 8 , S N 2 l - 7 7 5 9 , and SN2l-5255. Information for the Model l2 Rpc ll compiler has been added. changes are indicated by a vertical line to the left of the change. New or extensively revised illustrations are indicated by a bullet (o) to the left of the ligure title. Appendix I has been added and should be reviewed in its entiretv.
This edition applies to the following IBM system/3 RpG II program products:
Version Modif ication
I 1 5 1 5 6
z +
1 4 0 0 0 0 0
Program Number
5 7 0 1 - R G 1 5 7 0 2 - R G I 5 7 0 3 - R G I 5704-RGl 5704-RG2 s 7 0 5 - R C l
System/3 Model
10 Card 8 and 10 Disk 4 a n d 6 1 5 A , B , C 1 5 D t 2
This revision remains in effect for all subsequent versions and rnodihcations unless specifically altered by a new edition or a technical newsletter. changes are continually made to the specifications herein; before using this publication in connection rvith the operation of IBM systems, consult the latest IBM Systeml3 Bibliography', GC20-8080, for the editions that are applicable and current.
Use this publication only for the purposes stated in the preface.
Publications are not stocked at the address below. Requests for copies of IBM publications and for technical information about the system should be made to your IBM represenrative or to the IBM branch off,rce serving yourlocality.
This publication could contain technical inaccuracies or typographical errors. use the Reader's comment Form at the back of this publication to make comments about this publication. If the form has been removed, address your comments to IBM c o r p o r a t i o n , P u b l i c a t i o n s , D e p a r t m e n t 245, Rochester, Minnesota 55901. crommenrs become the property of IBM.
@opyright lnternational Business Machines corporation 1969, 1970, r9j1, r9jz, l97J.rg75
This refcrence rnanual is intended prirnariiy for the Systenr/3 user who has littlc or no experience with telecommunications prograrrnring.
This n'ranual provides inforrlation a progralnlner necds to write System/3 RPG ll telecommunications programs.
I t c o n t a i n s a :
o D c t i n i t i o n o f b a s i c t e l e c o r n n r u n i c a t i o n s t e r n t s . Statenlent of the telecotnnrunications capabilitie s of
Sy stcnr/3
o De:scription of each of thc RPG Telcconrrnunications Specifications required to write a telecomnrunicaticins prograni for Systern/3
Samplc progranls arr: includcd in this ntanual to illustrate progranrming techniques and possible applications for Systenr/3 RPG II telecomrnunications prograntrning.
System/3 Model 8 'Ihe
Systerr/l} Model 8 is supported by System/3 Model 10 Disk Sysicm control prograrnming and program products.
T h e la c i l i t i e s d e s c r i b e d i n t h i s p u b l i c a t i o n f o r t h e M o d e l t 0 are also applicable to the Model 8, although the Model 8 is n o t r e f ' e r e n c e d . H o w e v e r , t h e I n t e g r a t e d C o m n r u n i c l t i o n s A d a p t e r ( l C A ) is a v a i l a b l e o n l y o n t h e M o d e l 8 . I f y o u h a v e the ICA, it is alwavs designated as BSCA line 2. Tirerefore, y o u r n u s t e n t e r t h e B S C A O C L s t a t e m e n t ( / i B S C A l- l N E - 2 ) at executior.r timc. It should be noted that rrot all devices and leatures which are available on the Model l0 are available on thc Model 8. Therefore, Model 8 users should be tarriliar with the contents of IBM S.ysteml3ll'lodel 8 Intr<tductnn, GC2l -5 I 1 4.
P a g e o f S C 2 1 - 7 5 0 7 - 5 l s s u e d 2 4 S e p t e m b e r 1 9 7 6 B y T N L : S N 2 1 - 5 4 2 8
Preface
I B M S Y S T E M 1 3 5 4 4 8 D I S K S T O R A G E D R I V E
The IBM Systent/3 5448 Disk Storage Drive ol Systenr/3 M o d c l s 8 a n d l 0 u s e s t h e s a m e p r o g r a m p r o d u c t s u p p o r t as the IBM 5445 Disk Storage . Flowevcr, a separatel system control prograln feature is required for the 5448.
I n g e n e r a l , r e f - e r e n c c s t o 5 4 4 5 in t h i s n r a n u a l a l s o a p p l y to 5448. For specific inforrnation about 5448 opt'rating clraracleristics and prograrnrning suppolt., see IRM Systcmf 3 5448 Disk Storage Drivc Progrant Re.larcttL.t' Manual, GC2l -5 I 68.
P a g e o f S C 2 1 - 7 5 O 7 - 5 lssued 24 September 1976 B y T N L : S N 2 1 - 5 4 2 8
Related Publications
The following chart lists the order numbers of the various related publications.
P u b l i c a t i o n M o d e l 6 Model 8
M o d e l 1 0 Card System
M o d e l 1 0
Disk System M o d e l 1 2 M o d e l 1 5
General IrtJ'ormation Binary
Sy ttchronous Co mmu nica t ions G A 2 7 - 3 0 0 4 GA27 -3004 G A 2 7 - 3 0 0 4 GA27 -3004 G A . 2 1 - 3 0 0 4G A 2 7 - 3 0 0 4
Comp onc t t t s R el ere n c e Ma nual G A 3 4 - 0 0 0 r GA2r-9236 GA2r-9236 GA21-9236 GA2l-9236 GA21-9236
Operator's Ouide GCr2l -75 01 GC21-7634 G C 2 1 - 7 5 l 3 GC2 I -75 08 GC21-5144 G C 2 1 - 5 0 7 5
RPG II ReJ'erence Manual s c 2 l - 7 5 I 7 s c 2 1 - 7 5 0 4 s c 2 l - 7 5 0 0 s c 2 1 - 7 s 0 4 s c 2 I - 7 5 0 4 s c 2 1 - 7 5 0 4
'f ele co mntun ica t io tls L og ic
Manual s Y 2 l - 0 5 2 6 sY2 1-0s 26 L Y 2 l - 0 5 2 8 s Y 2 1 - 0 5 2 6 s Y 2 l - 0 s 2 6 s Y 2 l - 0 5 2 6
Systern Ot,tteratiort
ReJerence tVotual GC2l -5 I 26 G C 2 1 - 5 1 2 6 GC2t-5126 G C 2 l - 5 1 2 6 G C 2 l - 5 1 2 6 GC2t-7 616
lv
Contents
LIST OTI ABtsREVIATIONS
I N T R 0 D U C T I O N
B S C I ' , E L E C O M M IJ N IC A I ' I O N S C]ONCEIY|S A N D T E R M I N O L O G Y
T ' e l e c o m m u n i c a t i 0 n s N e t w o r k s N o n s w i t c h e d N e t r v o r k S u i t c h e d N c t w o r k N e I u o r k ( ' r n l t r r l
l \ l r r l t i | u i n t I ' o i n t - T o - P o i n t I ) a t a L i n k ( ' o n t r o l
l ) r t l [ . i n k ( ' o n l r o l ( ' h a r a c t c r s l ) l l r l , i n k N l c s s u g c ( ' o c l c s l ) l r l r L i n k l \ l c s u g e l , r r r n r l s
S l : t n d i l r d I u t n ) r t I F l r . 1 ; 1 1 1 r r t : s P r r t ' n e 1
I r r l r : r m r r d i a l e B l o c k ( ' h c c k i n g M o d e r ( l l ' B ) R P G I I B S C A P R O G R A M M I N C
I I S ( ' A S t a t i o n - f y p e s
R P ( i I I T e l c c o n r r n u n i c a t i o n s S p e c i l i c a t io r i r ( ' o l u n r n s l- 2 ( P a g c ) .
( ' o l u r n n s S - 5 ( l - i n e ) ( ' o l u n r n 6 ( l o r n r T y p c ) ( ' o l u n r n 7 (('ornntcn ts) ( l o l u r n n s 7 - 1 4 ( l i i l e N : r n r e ) . ( ' o l u m n l 5 ( ( ' o n t i g u r r t i o n ) ( ' o l u m n I 6 ( l y p c o l ' S l a t i o n ) ( ' o l u n r n l 7 ( T y p c o l C l o n t r o l ) ( ' o l u n r n I 13 ( T y p c o1'(iode) ( ' o l u n r n I 9 ('I'ransparcncy) ( ' o l u m n 2 O ( S w i t c h o d ) ( ' o l u r n n s 2 l - 3 1 ( l ) i a l N u r n b e r )
( ' o l u r n n 3 2 ( L o c a t i o n o f l d o n t i f i c a l i o n T h i s S l a t i o n ) ( ' o l u m n s 3 3 - 3 9 ( l d e n t i l ' i c a t i o n T h i s S l a t i o n ) C o l u n r n 4 ( ) ( L o c a t i o n o l l d c n t i l ' i c a t i o n - R c n r o t e
S t a t i o n ) .
( n l r r n r n s 4 1 4 7 ( l d e n t i f i c a t i o n R e n l o t c S l a t i o n ) ( ' o l u n r n s 4 8 - 5 I ( R e rn o t c T ' e r n r i u r l )
( ' o l u n r n 5 2 ( 1 1 ' B )
( ' o l u r r r n s -5 - l - - 5 4 ( l ) o r r n a n e n t l , , r r o r In d i c a t o r ) ( - o l u r n n s , 5 5 - 5 7 ( W a i t T i r n e )
( ' o l u r n n s 5 t l - 5 9 ( l l e c o r d A v r i l a b l e I n d i c : r t o r ) ( o l u m n 6 0 ( [ . a s t Ii i l c )
( - o l u n r n s 6 I - 6 2 ( P o l l i n g ( ' h l r a c t c r s ) ( ' o l u n r n s 6 3-64 (Add ressing C h a r a c t e r s ) ( ' o l u n r n s 6 5 - 7 0 ( l { c r n o t c l) c v r c e ) ( ' o l u r n n s 7 l - 7 4 ( l l e s c r v e d ) .
( ' o l u lrr ns 7,5 - t l 0 ( Plrg,rarn lden t i l'icatio n) . I i i l c l ) c s c r i p t i o n S p e c i l ' i c a t i o n l , l n t r i e s l i r r I I S ( ' l r i l c s
( ' o l u r n n s 7 - 1 4 ( l i l e N a r n c ) . C o l L r m n l - 5 ( I r i l e - l - y p c )
. C ' o l u m n |6 ( l r i l e l ) e s i g n a l i o n )
A P P B N D I X I l " ' ) A T A l . l N I \ - ' (ritl R O l - ( ' H A R A C I ' E R S . 4 9 C o l u t n n l7 ( l ' . n d o l [ , i l c t
( l o l u n r n l 9 ( l r i l c li o r n r r l ) C o l u n t n s 2 0 - 2 3 ( l i k r c k [ . r ' n r ' 1 h ] C o l u m n s 2 4 - 2 7 ( l { c s r r r ! { . l r i r i i r ) ( ' o l u m n 3 2 ( A d r l i t i o n l l i \ r c : r ) ( - , r l r r n r n . 4 t 1 4 h ( | ) r \ i ( r ) D e s c r i p t i o n s t i l ' l l S ( ' l r u n r : l i o n r
P r o g f t i l t t r t i l n t ( ' 1 ) r ] s i ( l e r r t i , R e t t ' i l r ( ) r r l 1
l l c c o i v c u i t l t l - r ; u ; r t r r i i t : , i i i ' ( ' n v c r s a l i o n a l l t c p l y ' l ' r ; r n s r n i l
O n l 1 , ' l
r a n s n r i t $ i I l r l { r r : c i r 1 i t ; i . r l ( , r D v c r s a l i o r r u l l { c p l y l r a t r s t t t i l u t r t l l{ c e c i v c l \ l , I , r n v c r s r t i o n r l R e p l y ) A P P F I N I ) l X A . . , \ S C i l A N t ) t . $ t r ) l C ( ' O [ ) U , S
A S ( l l { , r r l t ' r l ' . 8 ( ' l ) l ( ' ( ' o r i e s
A P P I , . N I ) l X C . P O L I - l N ( ; A ) . r i r \ l ) l ) l { l l S S l N ( ; C I I A R A ( l ' l I l R S I r O R S Y S i I ' , t i I
l l t ( ' l ) i ( ' ( , 'd t A S ( ' l l ( ' o r l e
A P P F ] N D I X D . I t P ( ; I I I F ] I i I ] i i . ' { ' I J S S I N G S P E C I F I C I A l ' l 0 N S S ( r l l t h , | , : . i r ,
R . P ( l l l I c l c c o r r r r r r u n i c r l r l r . ' . , r ii icrtions l r i l c l ) c s c r i p t i o n S I c c i l ir . : t i i r , ' r : . i r , ' i l S ( ' A l r i l c s A P P I i N D t X [ . . t J S t N ( i T i l t r ' t r , ] 2 7 7 0
A N D T H I , ] I I ] M 2 7 I J 0 R P ( i l I S p c t i l i r ' ; r t r , ' n r
R P ( l l i i l c l ) c s c r i J r t i r i r r S i i r i . i i , . . i i , ) 1 1 \ l { P t I I i n c ( u u n l ( . ; S t ' . . r i t ' , . : r . R I ) ( i ' f e l c c o n t n r u n i r : ; r t io r ( , ir r : , i I ic a t io n s R P ( ; O u l p u t - l r ( ) r r l r l t S p c { i i l ! i t l jo n s S y \ l ( D l / I ( i l n r i d e r . r t r ' ' r r .
| \ r n l l ) l ( ' s
T r a n s n r i t t i n g l o l l r r I l t l \ { . . i ' , ' t ! l) : r l a (' o r n r l u n i c a t i o n S y s t c r n
R c e e i v i r r r 1 r ' ( ) n i r n l l t l V 2 7 l i 1 i i ' l
c n n i n a l
, t , l , , , , r r , t , i r r i , , n
A P P I t N D I X F . ( ' O l \ , { N l { r N I ( ' A l l | { , l V l ' l ' r l T I l l l O P I I R A T ' l N ( ; S Y r i l t ' . 1 \ t ' I l l I l ' . r . { . } \ , i \ { L i N l( l A ' t l O N S A C C U S S M l i l l t ( l i ) { t { ' A M )
S y s t c r n / 3 t o ' l ( ' A l l
l i i l c I ) c s i ii p i r r ' n S l ) f , i l i e : r I r { ) n \ I r , l r . t r s i l n S P . r i t i t l r r r , r r t r T e l L ( i l l r l l l l i r r i . , r l i , , 1 r . . t 1 r 1 , r , ' . . : . , n \ I r t P r l l 5 p " , t l r { :, r ; ( i r l \
( ' , r l t t r l ; r t i " : i 5 i ' ( ( r l i ( , r I i , , r ' . O u t p u t l o n ! r i r l S I ) c ( i l i c i j t r ! ) l i 3
.l -5 5 5 5 5 6 6 6 6 6 6 6 7 1 IJ li ti 9 9 9
r)
l { )
l 0 t 0 l 0 t 0 t 0 l l l t l l l 2 t 2 t 2 l 2 l 3 t : ] l 3
| , l l . l l l l 3 l 4
1 4 l 4 1 4 t 4 1 4 1 4 t 5 l - s t 6 2 0 2 4 2 1
J I
47 4 7
4lJ
- s I
- ) l
5 2
5 3 5 3 ,5 -5
5 7 5 l 5 7 5rl 5 r.l ,59 5 9 6 0 6 0
o l
6 5 6 6 6 6 6 6 6 7 6 1
6lJ
6 8
Page of SC21 -75C17-5 l s s u e d 2 4 S e p t e m b e r 1 9 7 6 B y T N L : S N 2 1 - 5 4 2 8 T C A M t o S y s t e m , / 3
I i l e D e s c r i p t i o n S i r e c i f i c a t i o n s L x t e n s i o n S p c c i f i c a t io n s
T e l c c o m m u n i c a l i o n s S p e c i f i c a t i o n s I n p u l S p e c i l i c r t i t r n s
C a l c u l a t i o n S p r e c i f i c a t i o n s O u t p u t - l i o r m a l S p c c i f i c a t i o n s . T C A M C o n s i d e r a l i 0 n s
1 0 7 0'70 7 1 1 l 7 2 7 2 7 4
A P P E N D I X G . U S I N C T T I E I B M 374I AND IBM 5230 7 5
R P G l I S p e c i l i c a t i o n s 7 5
R P G l l l r i t e D e s c r i p t i o n S p e c i t i c a t i o n s 7 5 R P G I I T e l e c o r n m u n i c a t i o n s S p e c i t i c a t i o n s i 6 R P G I I O u t p u t l r o r m a t S p e c i f i c a t i o n s . ' 1 6
F l x a m p l e s . i 7
T r a n s r n i t t i n g to t h e I B M 3 7 4 1 . ' 1 7
R e c e i v i n g f r o m a n I B M 3 7 4 1 7 9
R e c e i v i n g a S t a t u s M e s s a g e f r o n r a n I B M 3 7 4 1 D a t a S t a t i o n
R e c e i v i n g l i o m a 3 7 4 1 D a t a S t a t i o n w i t h l l x p a n d e d
C o m m u n i c a t i o n s Ii c a t u r e . 8 6
T r a n s n t i t t i n g to a 3 7 4 1 w i t h L , x p a n d e d
C o m r n u n i c a t i o n s fi c a t u r e 8 8
APPB,NDIX H. USING RPG II IN COMMUNICATION BETWEEN A SYSTEM/3 AND THE IBM 3750 (WORLD TRADE ONLY)
I\oqranrmins Procedure
A P P E N D I X I , S Y S T E M / 3 R P G I I I N T E R F A C E TO BSC LINE PROTOCOL
P o i n t - t o - P o i n t L . e a s e - d L i n e R e c e i v c
T r a n s r n i t
T r a n s m i t M u l l i p l e l r i l c s T r a n s m i t / R e c c i v c R e c e i v e / T r a n s m i t
L e a s e d M u l t i p o i n t , S y s t e r n / 3 T r i b u t a r y Station . Roccive
T r a n s m i t
T r a n s m i t , R e c c i v e R e c e i v e . T r a n s m i t
P o i n t - t o - P o i n t S w i t c h c d L i n e 1 0 S I I Q : S w i t c h e d Line S t a t i o n I d c n t i f i c : a t i o n S e q u c n c c O p t i o n a l
R e c e i v e , S y s t e : r n / 3 A n s r v e r S t a t i o n R e c o i v c , S y s t e m / 3 C a l l i n g S t a t i o n T r a n s m i t , S y s t c m / 3 A n s w e r S t a t i o n T r a n s m i t , S y s t e m / 3 C a l l i n g S t a t i o n
T r a n s m i t / R e c e i v e , S y s t e m / 3 C a l l i n g S t a t i o n . T r a n s m i t / R e c r : i v c , S y s t c m / 3 A n s w e r S t a t i o n R e c c i v e / T r a n s m i t , S y s t e m / 3 A n s w e r S t a t i o n R e c e i v e / T r a n s m i t , S y s t e m / 3 C a l l i n g S t a t i o n . Conversational NIodc
R e c e i v e w i t h C o n v e r s a t i o n a l R e p l y T r a n s m i t w i t h C o n v e r s a t i o n a l R e p l y L i n e C o n d i t i o n S y s t e m / 3 R c s p o n s e s
D a t a M o d e , S y s t e m / 3 T r a n s m i t t i n g D a l : r l\ 1 u d c . S v s r c m / J R e c e i v i n g G L O S S A R Y
I N D E X
8 1
9 l 9 l
9 3 9 3 9 3 94 95 96 97 9 8 9 8 9 9 1 0 0 1 0 1 t02 102 1 0 3 104 1 0 5 1 0 6 r07 1 0 8 1 0 9 l l 0 1 1 0 1 l l 1 1 2 tt2 t t 4 l 1 5 l l 7
V1
ACKO Even positive acknowledge ACKI Odd positive acknowledge
ASCII American national standard code for informa- tion interchange
BCC Block check count BPS Bits per second
BSC Binary synchronous communications
B S C A 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 a d a p t e r BTAM Basic telecommunications access method
(System/370) DA Display adapter
DISC Disconnect
DLE Data link escape character DOS Disk operating system
EBCDIC Extended binary coded decimal interchange code
EHT Error history table
ENQ Enquiry character
E O T E n d o f l r a n s m i s s i o n ERC Error retry count
ETB End of text block character ETX End of text character
ICA International Communication Association ITts Intermediate block check
LCA Local communications adapter NAK Negative acknowledgement character
OS Operating system (System/360 and Systern/370) PEI Permanent error indicator
List of Abbreviations
RVI Reverse interrupt character SDLC Synchronous data link control SOH Start of heading character STX Start of text character
SYN Line synchronization character
T C A M T e l e c o m m u n i c a t i o n s a c c e s s m e t h o d ( S y s t e r n / 3 7 0 ) TTD Temporary text delay character
V T A M V i r t u a l t e l e c o m m u n i c a t i o n s a c c e s s n t e t h o d ( S y s t e m / 3 7 0 )
WACK Wait for acknowledgernent character
vii
IBM System/3 Telecommunications programming provides the user with the capability of sending and receiving binary synchronous data over conlmon carrier facilities. The pro- gramming performs all functions necessary to establish line connections, exchange identification sequences, send and receive data, and execute the correct termination or discon- nect procedures.
Systeml3 RPG II telecommunications support is provided via the RPG II language. Binary synchronous data trans- mission is possible between System/3 and:
. Other System/3s.
o Operating System or Disk Operating System Basic Tele- communications Access Method Binary Synchronous Communications (OS or DOS BTAM BSC).
o System/360 Model 20 Input Output Control System for the Binary Synchronous Communications Adapter.
o Operating System Telecommunications Access Method
(rcAM).
. IBM 3741 Model 2Data Station.
o IBM 5230 Model 2Data Collection Controller.
o IBM 3750 Switching System (World Trade only).
o IBM System/7.
P a g e o f S C 2 1 - 7 5 0 7 - 5 l s s u e d 2 4 S e p t e m b e r 1 9 7 6 B y T N L : S N 2 1 - 5 4 2 8
Introduction
The Systemi 3 Model l0 Disk Systern, I\todel 12, Model 6, M o d e l 8 , a n d M o d e l 1 5 c a n a l s o t r a n s u t i t d a t a to a n d re c e i v e data from the IBM 2770 Dala Commr-rnication System and the IBM 2780 Data Transrnission Terminal (see Appendix h,).
BSCA files are defined by entries on the RPG Irile Descrip- tion Specification and the RPG Telecornnrunicutions Speci- fication.
Note: For use of the sccond BSCA feature .see |he IBM Systeml3 Model 10 Disk System Control Prograntmbtg Ref'erence Manual, GC2l-7512,18M Svsteml 3 Model 12 System Control l'rogramming Relerence Monual, GC2l -5 I 30, or IBIvI Systeml3 Model l5 Sl,sYem Control Programming Rel'erence Manual, GC 2 1 -5077.
A System/3 RPG ll telecommunications program can exist within a dual progranrming system (Dual Programming Fea- ture required). Normal operator attention is required to respond to processing halts.
Note: lf you are atteinpting to commutlicate between two programming levels using the RPG Il tclecommunica- tions features and dual BSCA, it is suggcsted that you do not have overlays in either of the RPG Il prograrns.
For IBM System/3 telecommunications operating procedures, see your system's operator's guide.
l n t r o d u c : 1 i o n I
T h i s s e c t i o n d e s c r i b e s t h e b a s i c c h a r a c t e r i s t i c s a n d o p e r a . t i o n a l c o n c e p t s o f t h e B S C te l e c o n t m u n i c a t i o n s s y s t e l n : w h a t it i s , ir o w it s p a r t s a r e re l a t e d , a n d h o w c o n t r o l i s maintainecl. Comrnonly used terms arc italicized.
D a t a S e t ( M o d e m )
N o n s w i tc h e d , P o i n t - t o - P o i r r t
D a t a S e t ( M o d e m )
B S C T e l e c o m m u n i c a t i o n s C o n c e p t s a n d T e r m i n o l o g y
T E L E C O M M U N I C A T I O N S N E T W O R K S
A t e l e c o m m u n i c a t i o n s s y s t e m m a y u s e a n o n s w i t c h e d n e t - w o r k o r a s w i t c h e d n e t w o r k ( F i g u r e l ) .
S w i t c h e d P o i n t - t o - P o i n t
S y s t e m / 3 7 0 S y s t e m / 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 i 5
D a t a S e t ( M o d e m )
D a t a S e t ( M o d e m )
C o m m o n C a r r ie r E x c h a n g e
System/7 Data Set
( M o d e m )
D a t a S e t ( M o d e m )
D a t a S e t ( M o d e m )
B r.
A
T r i b u t a r y S t a t i o n
B
J
n A N o n s w i t c h e d M u l t i p o i n t
\
\
C o n t r o I S t a t i o n
D a t a S e t ( M o d e m )
D a t a S e t ( M o d e m )
I
;
T r i b u t a r y Stati o n
B
a
A
t , r
[-J
IData Set ( M o d e m )
B
A
T r i b u t a r y S t a t i o n
B
a
A
l i g u r e l. T e l e c o m m u n i c a t i o n s N e l u o r k s ( P a r t I o t 2 )
l l S C T e l e c o m m u n i c a t i o n s C - ' o n c e p t s a n d T e r m i n o l o g y
8 0 0 0 B P S L o c a l I n t e r f a c e
2 4 0 0 B P S L o c a l I n t e r f a c e
' ' l
h e l n t c r r l l c d ( o r r r r n u n i c a t i o n s A ( h p t e r ( I ( A ) n r u s t b e l t d d r c s s c c l a s U S ( ' A l i n c 2 . ' f h c
n r a n u e l I ( ' A s w i t c h c a n h u v e o n l v o n c i n t c r f ' a c c l c l i v c l l l r n y o n c t i n r e .
I S c c I t i g u r o | ( l ' l 1 1 I o t 2 ) l i r r c r r m p l e s o 1 ' l l S ( ' A li n e c o n t i l l u r a t r o n s .
l : i 1 ' u r c L T e l( ' r ' , ' t l l r l t t l r l i L r l i , r n r \ e l u , r r k s { P r r l I , ' l I t
S y s t e m / 3 M o d e l 8
D a t a S e t ( M o d e m )
D a t a S e t ( M o d e m )
Nonswitched Network
A n o n s w r t c h e d n e t w o r k c o n s i s t s o f a n u r n b e r o f p r i v a t e o r l e a s e d c o r n m u n i c a t i o n l t n e s th a t c o n n e c t a c o l l t p u l c r to o n e ()r rrore r(ntote tarminals. Rernote terntinals is a general l e r n l u s e d to r e p r e s e n t i n t e r c o n n e c t e d e q u i p r n e n t a t a r e l n o t e k l c a t i o r r . h a v i n g e i t h e r in p u t o r o u t p u l c a p a b i l i t y . o r b o t h . ( l n t r o n s w i t c h e d n e t w o r k s , th e c o r n p u t e r a n d r e r r o t e t e l n r i n a l s a r e p h y s i c a l l y c o u n e c t e d , t l r a t i s . t h e c i r c u i t s n r a k i n g u p t l ) e c o u t n t u n t c a t i o n l i n e s a r e c o n t i n u o u s l y c s t a b l i s h e d f o r p r e d e t e r n t r n e d t i r r e p e r i o d s , d u r i n g w h i c h d a t a r n a y t r e t r a n s m i t t e d o v e r t h e l i n e s .
T h e l i n e s r h a t c o r n p r i s e a n o n s w i t c h e d n e tw o r k a r e v a r i o u s l y known as privatc, leasetl, or tledic'ated /incs. These lines r n l y b e f u r n i s h e c l b y a c o n t n r o n c a r n e r o n a c o n t r - a c t b a s i s b e t w e e n s p e c i f i e d l o c a t i o n s f o r a c o n t i n u o u s p e r i o d o r f o r r e g u l a r l y r c c u r r i n g p e r i o d s a t s t a t e d h o u r s , ti r r t l t e e x c l u s i v e u s e o f o n e c u s t o l n e r .
l n t h i s p u b l i c a t i o n th e t e r n t n o n s w i t c h e d n e t w o r k r e fe r s to a n c t w o r k i n w h i c h t h e c o n i n t u n t c a t i o n l i l t e s li n k i n g t h e c o n l p u t e r u n d t h e r e n l o l e t e r n t i n a l a r e c o n t i n u o u s l y e s t a b - l i s h e d , t h u s r e c l u i r i n g n o d i a l i n g to e s t a b l i s h t h e c t t n n e c r i o n .
Switched Network
A s w i t c h c d n e t w o r k a l l o w s r l a n y r e n l o t c t c n n i n a l s to c o n ) t l t u n i c a t e w i t l t a c o r n p u t e r w i t h o u t r e q u i r i r - r g d e d i c a t e d c o r n r n u n i c a t i o n l i n e s . T h e c o m p u t e r a n d t h e f e n t o t e te r r n i _ n a l s a r c c o n n e c t e d b y a c c e s s l i n e s to t h e c o r n r n o n c a l r - r c r e x c h a n g e s e r v i n g t h e i r r e s p e c t i v e l o c a t i o n s . A c o n r p l e t c a u d c o n t i n u o u s d a t a p a t h i s e s t a b l i s h e d b e t w e e n th e c o r n - p u t e r a n c l th e r e m o t e te r n t r n a l o n l y t b r t h e p e r i o d o1'tinte i n w h i c h d a t a t r a n s l n i s s i o n t a k e s p l a c e . T l r e c o n n c c t i o n is e s t a b l i s h e c l b y d i a l i n g th e t e l e p h o n c n u r n b e r o f r h e r e m o t e t e r r l r i n a l .
l n s w i t c h c d n e t w o r k s . Ii n e r e f - e r s t o a d i s c r e t e d a t a p a t h b e t w c e n th c t e l e c o n t r l u n i c a t i o n s c o n t r < t l u n i 1 . o r a c l a p t e r , and the cornnton carrier exchange. The servicc providecl by thc cornnlol-l carrier is usually on a tirne-used basis.
l n t h i s p u b l i c a t i o n , th e t e r n l s w i t c h e d n e t w o r k r e f ' e r s t o a n y n e t w o r k i n w l r i c h a d i r e c t p h y s i c a l c o n n e c t i o r r b e t w e e n th e c o r n p u t e r tn d t h e r e l r l o t e te r u i i n a l ln u s t b c e s t a b l i s h e d b y d i a l i n g in o r c l c r fb r d a t l t r a n s u t i s s i o u t o o c c u r .
N E T W O R K C O N T R O L
I n i t i a l c o n t l c t b c t w e e n a c o n l p u t e r a n d a r e n t o t c te r n r i n a l n r a y o c c u r i l t t w o w a y s . d e p e n d e n t o n t h e t y p e o l l i n c c o n n e c t i o n b e t w e e n th e n r . T h e c o n n e c t i o n s p o s s i b l e a L c
m u l t i p o i n t . o n n o n s w i t c h e d li n e s , a n d p o i n t - t o - p o i n t e o r r - l e n t i o n . o n b o t h s w i t c h e d a t r d tr o n s w i t c h e d l i n e s . T h e BSC telecornrnunication systent perntits comn.runicatton u s i n g e i t h e L t y p e o 1 ' c o n n e c t i o n ( F i g u r c I ).
M u l t i p o i n t
I t a r e n r o t e te r r r i n a l is c o n n e c t e d v i a a n r u l t i p o i n t ii n e . c l a t a i s s e n t a n c i re c c i v e d u n d e r t h e c o n t r o l o l ' t h e t ' c n t r a l o r conlrol station. ln order to scncl ttr leceive data. tlre reulote ternrirral, rel'erred ro as't ntultitlroppetl termirrul ot tributur)' s t a t i o n , l. n u s t b e s e l e c t e d b y t h e c o n t r o l s t a t r o n . ' I l l i s
p r . o - gess ol station selection is called Txtlling or atlclrcssittg.
M r r c . S y s t e n l i - l c t l l t o t b c a c o n l n r l s t a t i o n .
P o l l i r t g : P o l l i n g ls a l e c l u e s t t o a t r r b u t a r y s t a l i o l t to r f a n s - r n i t d a t a t o t h e c o n t r o l s t a t t o n . O n c e t h e b r i b u t a r y s r a t i o n h a s a c c e p t e d t h e i n v i t a t i o n . t h r u r . e c o g n i t i o n o f i t s u n i c l u c p o l l i n g c h a r a c t e r s s e n t b y t h e c o n t l o l s t a t i o n . th e r e n t o t e t e r n r i n a l m a y u s e th e l i n e t o s e n d d a t a .
' I h e
t r i b u t a r y s t t t i o n l t o t i l l c s t l r e c o n t r o l s t a t i o n w l r c t r d a t a t r a n s l e r is c o n r p l c t e b y s e n d i n g a u n i q u c Ii t r d - o . f - T r a r t s t t t i s s i t t r r ( E O T ) c h a r a c t e r t o t h e c o n t r o l s l a t i o l t . ( F o r n r o r e il t l i l n r a - ticrrr or-r control clraractels. scc Duta Littk C'otttntl tn tltis s e c t i o n . ) U p o n l e c e i p t o f t h e L , O T s e ( l u e t l c e . t l r e c o n t r . o l s l a t i o n u r a y p o l l o r a d d r e s s a n o t h c r tr i b u t a r y s l l t r t r r r .
Addrcssing: Datl transf-er fronr the cont lol sttliolt to thc t r i b u t a l y s t a t i o n o r r a n t u l l i p o i n t n e l w o l k i s l c c o r r r p l i s l r c t l b y a d d r e s s i n g t l r e s e l e c t c c l t r i b u t a r y s t a t i o n . A d d r e s s i n g i s n r e q u e s t t ( ) a t r i b u t a f y s t t t i o n t o r c c c i v c d a t a .
T h e c o n t r o l s l a t i o l t n o t i l l e s t h c t r i b u t a r y s t a t i o n w h e u d a t a t r a n s f ' e r i s c o n t p l e t e b y t r a n s n r i t t i n g t h c L . O T s e q u e n c c . A f i e r B O T l ' r a s b c c n s e n t . th s c o n t l o l s t a t i o l l p o l l s o r a d d r c s s e s o t h e r t r i b u t a r y s t a t r o r r s c o n n c c l c r - l v i l t l t e r n u l t i - p o i n t n e l w o r k .
O r r l y t h e c o n t r o l s t a t i o n h a s th e f i g l i t t o r c r l u e s l d r t l t r l n s l c r - s o r r a n i u l t i p o i n t n e t w o t ' k .
Point-to-Point - f l t c , ' t l t e r
t y p c r ) l l i r r e e o r r r r e e l i o n i s p o i r r l - t t , - l ) " i l l e u n - t e n t i o n . w i t h t h e c o n t p u t e r a n d t l i e r e n t o t e te n r r i r r a l c o n n e c l e d v i a a n o n s w i t c h e c l o r s w i t c l r e d l i n e .
l l S ( l t l c c o r t n r t t r i c r r l i o n s ( ' ( ) n e c l ) t s l u t r l I r r l r i n o l i r r t
Non-Switched: On a nonswitched line. either the computer By using data link control characters, the computer and or the renrote terminal ntay initiate the transrnission of data. the remote station notify each other of their status, and However" if both stations srmultaneously attempt to transmit the status of data sent or recelved by them. During normal o r r e c e i v e d a t a , t h e li n e is d i s c o n n e c t e d . o p e r a t i o n , t h e d a t a li n k c h a r a c t e r s c a n n o t b e in c l u d e d i n t h e
data belns sent or received.
Switched. On a switched line. one of the statrons is desig-
nated as the calling station. The other stations. or called Data Link Message Codes stations, accept calls from the calling station. The calling
station may perlbrrn the calling sequence by either autocall The BSC adapter is capable of sending or receiving data in (autonratic dialing by the compul-er) c:r manual dial (dilJring one of two codes: EBCDIC ( Extended Binary Coded Deci- performed by the machine operator). The called station rnal lnterchange Code) or ASCII (Arnerican National Stand- accepts calls from the calling station by either autoanswer ard Code for Information Interchange). The code you use (automalic answering by the computer) or manual answer is deterrnined by the type of tsSC adapter installed in your (machine operator makes the data set ready). system.
The calling station must initiate data transntission by sending EBCDIC and ASCII character code charts are provided in t h e p r o p e i c o n t r o l s e q u e n c e t o e n s u r e t h a t a c o n n e c t i o n A p p e n d i x A o f t h i s m a n u a l .
has been rrade with the desired station. Tl're control se- quen0e usuaily involves the exchange ol stati<,tn identiJicatbrt
sequences. When station identification sequences are used, DATA LINK MESSAGE FORMATS data transrnission will not begin until both the called and
the calling station have sent and received the correct lD Standard Format s e q u e n 0 e .
The standard tnessage fbrrnat consists of characters of data When tl.re control sequence has been completed. the calling from the code selected. excluding specially designated data station rnay either send data to tlie called station, or may link control characters.
relinquish the right to send data by sending an End-of-Trans- rnission character. Once the L,OT has been sent. the called
s t a t i o n n l a y in i t i a t e s e n d i n g d a t a to t h e c a l l i n g s t a t i o n . W h e n E B C D I C T r a n s p a r e n c y b o t h s t a t i t - r n s h a v e c o m p l e t e d s e n d i n g d a t a . t h e c a l l i n g s t a t i o n
starts a discclnnect procedure to terntinate the data link. tsSC adapters with tl're BBCDIC transparency feature in- stalled rnay send and receive nlessages containing any or all o f t h e p o s s i b l e 2 5 6 c h a r a c t e r c o m b i n a t i o n s i n t h e E B C D I C D A T A L I N K C O N T R O L c o d e . i n c l u d i n g d a t a li n k c o n t r o l c h a r a c t e r s . T h i s f' e a t u r e
a l l o w s u n i q u e d a t a . s u c h a s p a c k e d d e c i r n a l d a t a . t o b e Data link oontrol procedures are used to ensure the proper sent unallered from one contputer to another.
sending and receiving of data between the computer and the r e m o t e t e r m i n a l . S y s t e m / 3 B S C A s u p p o r t a s s u r n e s t h e
responsibility lbr rnaintaining the proper data link control Intermediate Block Checking Mode (lTB) p r o c e d u r e s .
The intermediate block checking feature allows large The following inlbrrnation is presented to provide thc buff'ers o1'data to be sent and received with parity checking Systern/3 progranrmer with sufficient infbrntation 1o performed on eaclt logical record rather than the total propeLly utilize the BSCA capabilities. bufl'er. The ITB character delintits logical records within
the bufl'er.
Data Link Control Characters
D a t a l i n k c o n r m u n i c a t i o n c o n t r o l b e t w e e n s t a t i o n s , t h a t is . between the conrputer and the remote te rrlinal is urrin- l a i n e d b y ' th c u s e o f D a t a L i n k C o n t r o l C h a r a c t e r s ( A p p e n d i x B ) .
System/-) RPG II Telecommunications programming pro- vides the RPG II user with the capability of transmitring and receiving binary synchronous data via a telecommunr_
cations network. BSCA support is achieved through the use of an RPG Telecommunications Specifications Sheet and the addition of BSCA as a valid device entry on the RPG File Description Specificarion. No other RpG speci- fication sheets are aff-ected by BSC.
B S C A S T A T I O N T Y P E S
RPG II permits System/3 to lunction as any of the following station t1,pes:
1 . R e c e i v e o n l y ( r e c e i v e i n p u t d a t a fr o m a r e m o t e t e r m i n a l ) .
l. Receive with transmittal of conversational reply (receive input data from a remote tennlnal and.
when required, transrnit data as an acknowledgement).
R P G ll BSCA Programming
3. Transmit only (transntit data to a remote terminal).
1. Transmit with reception of conversational reply
(trallsmit data to a rernote terminal and, when required, receive data as an acknowledgernent).
5. Transmit and rece:ive no conversational reply. Three r l o d e s o f o p e r a t i o n a r e p o s s i b l e :
a. Transmit a file, then receive another file.
b. Receive a file, then transmit another fire .
c. Transmit records of a file interspersed with receir.
ing records of another file. (This function is avaii- able only when System/3 transmits data to OS or DOS. System/3 rnust transmit first.)
A d e s c r i p t i o n o f t h e s e f u n c t i o n s , i n c l u d i n g c o m p l e l e R p G l l programs, are provided following the description of the specification sheets.
Note: Each telecomnrunications program implies a counter- p a r t a t t h e o t h e r e n d o f ' t h e li n e . The two programs r n u s t b e c o m p a t i b l e . F o r e x a r n p l e , a p r o g r a m w h i c h tr a n s n t i t s A S C I I d a t a re q u i r e s a p r o g r a m w h i c h w i l l L e c e i v e A S C I I d a t a .
R P ( ; I l l l s ( ' A P r o g l u n r n r i n r :
R P G I I T E L E C O M M U N I C A T I O N S S P E C I F I C A T I O N S 'flre
RPG'Ielecornrlunications Specifications Sheet (Figure 2) permits the RPG [I programmer to enter the inforntation necessary to estabiish and maintain the BSC cornmunica- tions link. Each BSCA file defined on the RPG File De- scription Specifications Sheet must have a corresponding RPG Telecomrnunications Specifications Shect.
C o l u m n s 1 - 2 ( P a g e ) E'rttry lixplanation 0 l 9 9 P a g e n u m b e r .
Colunrns li -2 in the uppcr riglrt corncr of tlre spccifications s l r e c t a r c u s e d t o i n c l i c a t e t h e p a g e n u m b e r . T h e f e l c - comrnunication Spccifications nrust follow the File Descrip- t i o n a n d rn y F i l e E x t c n s i o n a n d L i n c C o u n t c r S p e c i f i c a t i o n s S h e e t s .
A n y n u m b e r L i n e n u m b e r s .
Columns 3-5 are used to number the lines on the page.
fblurnns 3-4 are preprinted. so in rnost oases line nurnbering is done for you.
C o l u m n 6 ( F o r m T y p e )
lintry Explanation
T Coluutn 6 must contain a T. T identifies this
page as a Telecornmunicatiotts Spccification.
C o l u m n s 3 - 5 ( L i n e )
Ii rt try Explanation
IBM ft;;, 1 , 1 " , :
l ,' , ,,, ,,,, ] " '"'"" 1 I
I ' " " i ; , ' " i ,
R P G T E L E C O M M U N I C A T I O N S S P E C I F I C A T I O N S
1 2 t a 1 6 7 l / 8 1 9 8 { t
P r . " r d i l l l l
L I 1 , " , . , , L l I I L l
T
!
a
a t
J 5
I
J , ;
. l
" l ' ,
" t '
tl
T T T T T T
r
T T T T T
l i
r l t l :' ]
, l
I L
l t l
l l r
f l i i t I
i l l , i i
11ilii
r-l -T
l l r
I
i ,
' i l
l l l l l t l l l l
r l i :
r l i l l i l i
r r r r l
i l | r i l l l
11llii
l i l i i r
r i l l i i
l
l l ,
l. l t i
l ll l ' : l : l l r r i t ; l l r
l l r l
l
t '
I
t l
L L J
' It
l r i
l i
i i
l1
I
I I
rl
l l
1 l
l l
T T T T T
1l .
r l.
li t
i i
l l
I li
t tLili I l
r' l ll .i ' lI i i g u r e 2 . ' f e i e c o m m u n i c a t i o n s S p e c i t i c a t i o n S h e e t
Column 7 (Commentsl
Entry
Explanationr* Comments line.
You often want to write comments that will help you understand or remember what you are doing in a certain section of coding. RPG II allows you to use an entire line for these comments. The comment line is identified by placing an asterisk (*) in column 7. Comment s are not instructions to the RPG II program. They serve only as a means of documenting your program.
C o l u m n s 7 - 1 4 (F i l e N a m e )
Enffy Exphnation
alphameric This entry must be the same as the file name associated with the BSCA device on the File Description Specifications Sheet.
Column 15 (Configuration)
Entry Explanation
P or blank Point-to-point, nonswitched network (pTp).
M Multipoint network, where the control sta- tion selects the tributary station through polling or addressing. System/3 cannot be the control station.
S Switched network.
Column 16 (Type of Station)
Entry
ExplanationThis station will transmit messages from this file (transmit only or transmit with reception of conversational reply). The file must be designated as an output or combined file on the File Description Specifications Sheet and must appear on the Output Format Specifica- tions Sheet.
This station will receive messages into this file (receive only or receive with transmittal of conversational reply). The file must be desig- nated as an input or combined file on the File Description Specifications Sheet and must appear on the Input Specifications Sheet.
Column 17 (Type of Control)
Entry
ExplanationT This is a tributary station on a multipoint network. System/3 cannot be the control station and transmit the polling supervisory sequence.
blank Polling is not used.
Column l7 must contain a T if column I 5 contains an M (multipoint network).
Column 18 (Type of Code)
Page of SC21-7507-5
lssued 30 June 1978 By TNL: SN2'l-5624
Explanation
ASCII (formerly referred to as USASCII) data link control characters will be used. When ASCII is used, each station must provide file translation when it is required.
Explorwtion
This entry is valid only for EBCDIC. The transparency feature must be installed.
The data being transferred may contain data link control characters. EBCDIC data link control characters are listed in Appendix B.
Entry A , U
Entry Y
E or blank EBCDIC data link control characters will be used.
The entry in this column must be the same type that your BSCA and RPG II program supports. ASCII and EBCDIC codes are listed in Appendix A.
Note: lf your BSC program halts because of an invalid ASCII character in your data, check your ASCII translation table.
Column 19 (Transparency)
T
N or blank The transparency feature is not used. Un- packed numeric or alphameric data will be transmitted and received. The data being transferred may not contain data link control characters.
I Note: This entry is independent of the entry in column 20.
R P G l l B S C A P r o g r a m m i n g 9
Pag€ of SC21-7507-5 lssued 30 June 1978 By TNL: SN21-5624
Column 20 (Switchedl Column 32 (Location of ldentification-This Station)
Entry I M
I
E
Explanation
The computer operator using this program makes the connection between stations by dialing the number (manual dial).
Autocall is to be used by this station. The dial number is listed in columns 21-3 l.
Explaration
This is the number to be dialed when column 20 contains an E.
Explanation
Switched network. This station's identification is located at the position referenced by the symbolic name specified in columns 33-39.
Switched network. The entry in columns 33-39 is this station's identification.
Entry S
S Autocall is to be used by this station. The entry in columns 21-3 I is the symbolic location of the dial number.
A Autoanswer is used by this program.
B Manual answer is used by this program.
blank This is not a switched network.
Notes:
l. When calling, you should use E, M, or S. If the program is to be called, you should use A or B. That is, if two RPG II programs are communicating, one program must have an E, M, or S, and the other must have an A or B.
2. This entry is independent of the entry in column 16.
Columns 21-31 (Dial Numberl
blank This is a nonswitched network or a switched network where no ID is desired for this station.
Columns 3&39 (ldentification-This Station)
Entry Explanntion
alphameric When column 32 contains an E, this entry is the actual identification sequence of this station (minimum two characters).
When column 32 contains an S, this entry is the symbolic name of the location of this sta- tion's identification. The symbolic name must not be an array name. If the BSCA file is primary or secondary, this symbolic name must refer to the first element of a table.
(The table may have only one element.) This ensures that the station identification will be in storage before the telecommunications line is opened.
The station identification can be from two to fifteen characters;however, the length of this field or literal must be the same as the length of the field or literal in columns 4l-47 (b|a*s in literals do not count as part of the lensth). A station identification must not contain a control character sequence (see Appendix B). The station identification will be translated if the BSCA files are beins translated.
Entry numeric
alphameric Columns 2l-31 must contain a symbolic name, other than an array name, referencing the location of the dial number when column 20 contains an S. If the BSCA file is an input file other than a demand or conversational receive file, this name must refer to the fint (or only) element of a table. This ensures that the dial number will be in storage before the telecommunications line is opened.
(This restriction does not apply when the function of the program is transmit with conversational reply.)
l - r , j , r ' ' - , 1 .
! . ; 5 i i a j ( - l Jt l ! l i - ' . y . r \ J : S i .
Column 40 (Location of ldentification-Remote Station) Entry Explanation
S Switched network. The remote station's identification is located at the posirion referenced by the syrnbolic nanre specified i n c o l u m n s 4 l - 4 7 .
E Switched network. The entry in cojurnns 4l-41 is the remote station's identification.
blank This is a nonswitched network or a switched network where no ID is desired tbr tlie rernote station.
Columns 41 -47 ( | dentif lcation- Remote Station ) Entry
alphameric
Explanation
When column 40 contains an E., this entry is the actual identification sequence of the remote station (minimurn two characters).
When column 40 contains an S, this entry is the symbolic name of the location of the rernote station's identification. The syrnbolic name must not be an array name. If the BSC file is primary or secondary, this symbolic narne must refer to the first element of a table. (The table may have only one element.) This ensures that the station identification will be in storage before the telecommunications line is opened. The station identification can be from two to fifteen characters, however, the length of this field or literal must be the same as the iength of the field or literal in columns 33-39 (blanks in literals do not count as part of the lengtir). A station identification must not contain a control character sequence (see Appendix B). The station identification will be translated if the BSC fiies are beils tran slated .
i { i " . i l i i \ c
Pase of SC21-7507-5 lssued 30 June 1978 B y T N L : S N 2 1 - 5 6 2 4
This page intentionally left blank
1 0 . 2
Columns 48-51 (Remote Terminal)
Columns 48-5 I are used only if System/3 is to communicate with the IBM 2770 Data Communication System or the IBM 2780 Data Transmission Terminal (see Appendix E).
Otherwise, columns 48-51 are never used with Svstem/3 and must be blank.
C o l u m n 5 2 ( t T B ) Entry Exphnation
I Intermediate block check (ITB) is used.
blank ITB is not used.
Intermediate block checking can be used only if records are blocked.
Columns 53-54 (Permanent Error Indicator)
Entry
Explanation01-99,L1-L9 A permanent error indicator should be used LR,ll1-H9 with every BSC file. If you are using more
than one BSC file, each should have a per- manent error indicator, not necessarily unique.
When a permanent error occurs, the specified error indicator and the identification indica-
P a g e o f S C 2 1 - 7 5 0 7 - 5 l s s u e d 3 0 J u n e 1 9 7 8 B y T N L : S N 2 1 - 5 6 2 4
tor of the record causing the error are both set on. The permanent error indicator should be used to condition appropriate program- ming response (for example, printing a mes- sage or performing a controlled cancel). No further transmission should be attempted while the permanent error indicator is on.
Ifyou are using dual I/O buffers on the Card System and a permanent error occurs when the first record is received, a system halt is issued automatically.
Disk systems only: To retry an operation after a permanent error occurs, turn off the permanent error indicator. The RPG II pro- gram can then access the BSC file that caused the error. If no error occurs, pro- cessing continues; otherwise the permanent error indicator is turned on again.
Keep the following points in mind when you retry an operation:
l. The permanent error indicator is the only indication given to the RPG lI program that an error has occurred.
2. Any data in the BSC buffers at the time of an error is lost.
3. Switched lines are not disabled when an error occurs except for disconnect sequence received or hardware de- tected disconnect.
4. Any data passed to the user while the permanent error indicator is on is invalid. Unless your program recog- nizes all data, an unidentified record halt may occur.
A limit should be imposed by the RPG II program on the nuntber of times an error occurs before stopping the program.
5 .
RPG II BSCA Programming I I
blank No permanent error indicator is specified.
If a permanent error occurs on a card or disk system when no permanent error indicator has been specified, a system halt occurs. The program cannot be restarted.
Note: Avoid using H1-H9 as permanent error indicators if you wish to condition operations on the permanent error indicator being off. Since Hl-H9 are reset at the end of the detail cycle, they may be set offbefore the program cycle in which the error occurred is completed.
Also, when H1-H9 is used as a permanent error indicator, the Hl-H9 display may preempt the system halt display. If the Hl-H9 display appears before the system display, dial the 0 option on a disk system or restart the card svstem to prompt the system halt display.
Columns 55-57 (Wait Time) Entry E.rplanotion
numeric The length of time in seconds, l-999, that BSC will wait with no messages being sent or re- ceived before a permanent error condition occurs.
blank The system convention for timeout, 180 seconds, is used.
A permanent error results whenever the wait time elapses on an idle line. l'herefore, when you determine your wait time, consider time the operator may require to respond to halts and other processing interruptions, and also time the program may require for special operations such as table searches.
computlng square roots, etc.
Nr.tte: The time limit specified applies only to d,elays caused by this System/3 program and does not apply to the rernote device. If the remote device does not commun- icate with this System/3 within a 20-second period, a permanent error condition occurs. In addition, the time limit applies only during the transmission of a file, not between file transmissions. The occurrence of a permanent error indicates the end of processing of a file.
l 2
Columns 58-59 (Record Available Indicator) Entry Explanation
0l-99, A record available indicator should be assigned Ll-L9, to every BSCA input file that is to be reopened.
LR, (lf a file is used again after end-of-file has been Hl-H9 reached, the file is "reopened.") See Figure 9
and Appendix F for examples using a record available indicator. This indicator is set on whenever a reverse interrupt (RVI) is received.
C o l u m n 6 0 ( L a s t F i l e ) Entry Explanatiorr
L This BSC input file is processed only after all other primary and secondary input files have been processed.
blank It isn't necessary that this BSC input file is the last input file processed.
Columns 61-62 (Polling Characters)
Entry
ExplanatbnAlphameric The polling identification of this station is needed if this station is part of a multipoint network and the BSC file is a transmit (out- put) file. Polling characters are listed in Appendix C.
blank This station is not transmittine on a multipoint network.
C o l u m n s 6 3 - 6 4 (A d d r e s s i n g C h a r a c t e r s )
l'. tttrv [.xplattutittrt
A l p l i a r n e r i c T h e a d d r e s s i n g i d c r r t i f i c a t i o n o f t l i i s s l a r i o l r r s r r e e c l e d i 1 ' t l i i s s t a t i u n is p a r t o 1 ' t l u u l t i - p t l i r r t u e r w o r k l n d t h e B S t l f i l c i s r r e u e i v e ( i u p u t ) l l l e . A d c l r e s s i u g c h a r a c t c l s a r c l i s t c d i u A p p c n d i x [' .
b t r n k T h i s s t l t i o n i s r r o t l e c c r v i n r r o u l t r t r u l t i p o i n t n c t w o r l ( .
, ' \ ' r . , r c . ' L . r r t c r p o l l i n g ln d l c l c l l e s s i r r g c h l r - u c t c r s i r r S y s t e n r i . 3 e o c i c : t h e u o r n p i l e L w i l l c u r r v e l t tl l e c l i t f i l c t c r s to t l l e l i ) l - l n l c c l u i i c c l l r y t h e c t r d e s p c c i l i c d in c o l u r u r r 1 8 .
C o l u m n s 6 5 - 7 0 ( R e m o t e D e v i c e )
( ' o l u n r n : ( r 5 - 7 0 l r c . u s c c l o n l v r l S y s t e r r r . i - i i s t o c o r n t n t r r r i c r t e r ' r ' i t l r t h e t l l N , l 1 7 7 0 D r t a ( l o n r n r u n i c l r i o r r S y s r c n t o r t l r c I l l M l 7 E 0 D r t r l ' r a n s n r i s s i o n ' f c r r r r i n r r l ( S c c A p p e n d i x l- ) . O t l l e l w i s , . : c o l u t t t t t s 6 5 - 7 0 l r c r t e v e ; u s c c l w i t l S y s t c r n t - 3 a n d n r u s l l) e b l u l r k .
C o l u m n s 7 1 - 7 4 ( R e s e r v e d )
C o l u r r r r r s 7 l - 1 1 t r e n c v e r u s e d u ' i l i r S y s t c r n i - l a r r d n r u s t b e b L a n k .
C o l u m n s 7 5 - 8 0 ( P r o g r a m ld e n t i f i c a t i o n )
f ' o i u n r n s , 1 5 - 8 0 n t l y c o n t a i n u n y c h a r a c t c l s . ' f l r c s c
c o l u n t r r s n r a v u s c t l r f p r ( ) ! l f a l l r r r a n r e i n t h c c o r r t | o l c l r c l . 0 r L I t e y n r a y c o r r t r - r i r t c l r u f u c t c f s w h i c l i i d c n t i l y u c c l t r i r r p o r t i o n o t ' t l r e p r o g f a n l . T h c c ' n t l y i s i g n o r c d b y t l r e c o n r p i l c r . b u t w i l l a p l ) e r f in t l r e s o u r c e p r o t r a r r r l i s t i n g .
F I L E D E S C R I P T I O N S P E C I F I C A T I O N E N T R I E S F O R B S C F I L E S
T h e e n t r i e s i r r th e c o l u r n n s l i s t e d b e l o w a r e u s e d t o d e f i u e r BSCA llle on the RPG File Description Specifications S h e e t . T h e e n t r i e s i n c o l u n t n s n o t l i s t e d a r e th e s a r n e a s basic RPG.
No other RPG specification sheets are changed by BSC.
However. since a BSC progran.r nrust not be interrupted. a B n r u s t n o t b e e n t e r e d i n c o l u n r n - 1 7 o t ' t h e R P G ll C o n t r o l C a r d S p e c i l i c a t i o n s w h e n th e B S C p r o g r a m i s t o b e r u n o n a c i i s k s y s t e n r .
C o l u m n s 7 - 1 4 ( F i l e N a m e )
This is the rranre of a BSC file. The samc file narne must be u s e d o n t h e R P G T e l e c o r n r n u n i c a t i o n s S p e c i l i c a t i o n s S h e c t . ,'\r,,rc. Look-ahcad f ields nlust not be specified lbr a BSC f i l e .
C o l u m n 1 5 { F i l e T y p e ) L.h try
I
o
C
I')rplotta tion
T h i s i s a n i n p u t ( r e c e i v e ) I - i l c . T h i s i s a n o u t p u t ( t r a n s r n i t ) l i l e .
Courbined tlle. Use C whcn your receive flle ( ] r t r a n s u r i t fi l e u s c s c o n v c r s a t i o n a l r e p l y . U n - l i k e c o n r b i n c d c a r d f i l e s . th e a c k n o w l e d g e m e n t sent ils a convcrsational rcply nray or nlay not b e a d d c d t o t l . r e l a s t le c o r d r e c e i v e d . ( ' i s a n i n v a i i d cn r r r , ii a n I I I N ' I 1 7 7 0 o r I B M 1 7 8 ( ) is b c i n g u s c d .
l { P ( i l l l l S ( ' , \ I ' r o g r r t t t t t t i n g | 3
