GD CONTROL DATA C O ~ O ~ T I O N
NETWORK PRODUCTS
NETWORK ACCESS METHOD VERSION 1 /COMMUNICATIONS CONTROL PROGRAM VERSION 3 REFERENCE MANUAL
I
CDC@ OPERATING SYSTEM:
NOS 2
R E V I S I O N RECORD
R e v i s i o n D e s c r i p t i o n
A ( 1 2 / 0 1 / 7 6 ) O r i g i n a l R e l e a s e . PSR L e v e l 439.
B (04101177) R e v i s e d t o PSR L e v e l 446 f o r t e c h n i c a l c o r r e c t i o n s . C ( 0 7 / 0 1 / 7 7 ) R e v i s e d t o PSR L e v e l 452 f o r t e c h n i c a l c o r r e c t i o n s .
D (04128178) C o m p l e t e l y r e v i s e d f o r NAM v e r s i o n 1 . 1 r e l e a s e a t PSR l e v e l 472 t o i n c l u d e s u p p o r t Of r e m o t e and f o r e i g n NPUs, a s y n c h r o n o u s a n d HASP T I P S , v i r t u a l t e r m i n a l s , IAF, a n d TVF.
E (08115178) R e v i s e d a t PSR l e v e l 477 f o r t e c h n i c a l c o r r e c t i o n s . F ( 1 2 1 1 8 1 7 8 ) R e v i s e d a t PSR l e v e l 485 f o r t e c h n i c a l c o r r e c t i o n s .
G (01115179) R e v i s e d a t PSR L e v e l 485 f o r a d d i t i o n a l t e c h n i c a l c o r r e c t i o n s .
H (08110179) R e v i s e d t o r e f l e c t r e l e a s e of NAM v e r s i o n 1 . 2 . I n c l u d e d a r e d e s c r i p t i o n s of t h e b i n a r y debug l o g f i l e and p o s t p r o c e s s o r , s p e c i a l e d i t i n g s u p p o r t , and QTRM.
J ( 1 2 / 1 1 / 7 9 ) R e v i s e d t o r e f l e c t a d d i t i o n o f c o n n e c t i o n d u p l e x i n g , u p l i n e b l o c k t r u n c a t i o n , b l o c k h e a d e r b r e a k m a r k e r s , QTRM c o n n e c t i o n s w i t c h i n g , and v a r i o u s t e c h n i c a l c o r r e c t i o n s . K ( 0 4 / 1 8 / 8 0 ) R e v i s e d a t PSR l e v e l 517 t o r e f l e c t t h e a d d i t i o n o f 714 p r i n t e r s u p p o r t , a n d v a r i o u s
t e c h n i c a l c o r r e c t i o n s .
L ( 1 0 / 3 1 / 8 0 ) R e v i s e d a t PSR l e v e l 528 t o r e f l e c t t h e a d d i t i o n of QTRM s u p p o r t of a p p l i c a t i o n - t o -
a p p l i c a t i o n c o n n e c t i o n s , t h e u s e r - i n t e r r u p t c a p a b i l i t y , and v a r i o u s t e c h n i c a l c o r r e c t i o n s . M ( 0 5 1 2 9 1 8 1 ) R e v i s e d f o r NAM V e r s i o n 1 . 3 r e l e a s e a t PSR l e v e l 541 t o i n c l u d e 278013780 t e r m i n a l
s u p p o r t , c h a n g e s t o s u p e r v i s o r y m e s s a g e s , PRU i n t e r f a c e , and v a r i o u s t e c h n i c a l c o r r e c t i o n s .
R e v i s e d a t PSR l e v e l 559 t o r e f l e c t r e l e a s e of NAM V e r s i o n 1 . 4 , whicli s u p p o r t s NOS V e r s i o n 2.0 and i n c l u d e s t h e d i s a b l e f l a g p a r a m e t e r on t h e LST/HDX/R s u p e r v i s o r y m e s s a g e and m i s c e l l a n e o u s t e c h n i c a l c o r r e c t i o n s .
R e v i s e d a t PSR l e v e l 580 t o r e f l e c t r e l e a s e o f NAM V e r s i o n 1.5 and CCP V e r s i o n 3 . 5 , w h i c h r u n o n l y u n d e r t h e NOS V e r s i o n 2 o p e r a t i n g s y s t e m . T h i s m a n u a l , w h i c h was p r e v i o u s l y known a s t h e NAM R e f e r e n c e Manual, i s no l o n g e r a p p l i c a b l e t o p r o d u c r s o p e r a t i n g under- NOS 1. I t h a s b e e n r e o r g a n i z e d t o document i n f o r m a t i o n needed by a g e n e r d l n e t w o r k s u s e r , who must c o n s i d e r NAM a s w e l l a s CCP when w r i t i n g a n e t w o r k a p p l i c a t i o n . T h i s is '3
c o m p l e t e r e p r i n t .
REVISION LETTERS I , 0 , Q, AND X ARE NOT USED
@COPYRIGHT CONTROL DATA CORPORATION 1 9 7 6 , 1 9 7 7 , 1 9 7 8 1979, 1 9 8 0 , 1 9 8 1 , 1 9 8 2 , 1983
A l l R i g h t s R e s e r v e d
P r i n t e d i n t h e U n i t e d S t a t e s of America
A d d r e s s comments c o n c e r n i n g t h i s manua l t o : CONTROL DATA CORPORATION
P u b l i c a t i o n s a n d G r a p h i c s D i v i s i o n 215 MOFFETT PARK DRLVE
SUNNYVALE, CALIFORNlA 94086
o r u s e Comment S h e e t i n t h e back u f t h i s manual
New i n ind
f e a t u r e s , a s w e l l a s changes, d e l e t i o n s , and a d d i t i o n s t o i n f o r m a t i o n i n t h i s manual a r e i n d i c a t e d by b a r s t h e margins o r by a d o t n e a r t h e page number i f t h e e n t i r e page i s a f f e c t e d . A b a r by t h e page number i c a t e s p a g i n a t i o n r a t h e r t h a n c o n t e n t h a s changed.
F r o n t Cover T i t l e Page i i
i i i l i v v v i v i i l v i i i i x t h r u x i i x i i i
1-1 t h r u 1-6 2-1 t h r u 2-35 3-1 t h r u 3-43 4-1 t h r u 4-18 5-1 t h r u 5-19 6-1 t h r u 6-15 7-1 t h r u 7-32 8- 1
A-1 t h r u A-48 B-1 t h r u B-10 C-1 t h r u C-17 D-1
D-2
E-1 t h r u E-30 F-1 t h r u F-16 G- 1
6-2
H-1 t h r u H-12 1-1 t h r u 1-22 Index-1 t h r u Comment S h e e t M a i l e r Back Cover
R e v i s i o n
PREFACE
T h i s m a n u a l , f o r m e r l y known a s t h e Network Access Method r e f e r e n c e m a n u a l , h a s been renamed t h e NAM V e r s i o n 1/CCP V e r s i o n 3 r e f e r e n c e manual. I t s new o r g a n i z a t i o n s u p p l i e s r e f e r e n c e i n f o r m a t i o n t o b o t h
Network Access Method (NAM) and Communications
C o n t r o l Program (CCP) u s e r s , t y p i c a l l y e i t h e r sys- tems programmers o r a n a l y s t s who a r e w r i t i n g a n e t - work a p p l i c a t i o n o r who would l i k e t o l e a r n more a b o u t how t h e v a r i o u s p o r t i o n s o f t h e network f i t t o g e t h e r .
T h i s book d e s c r i b e s how a p p l i c a t i o n s i n t e r f a c e t o t h e computer network and how t h e t e r m i n a l u s e r g a i n s a c c e s s t o t h e s e a p p l i c a t i o n s . P l u s , t h i s book f a - m i l i a r i z e s t h e r e a d e r w i t h t h e Network P r o c e s s i n g Unit (NPU) and t h e Communications C o n t r o l Program (CCP). Knowledge of t h e NPU and CCP, however, i s n o t n e c e s s a r y t o w r i t e a n a p p l i c a t i o n program.
NAM and CCP o p e r a t e under c o n t r o l of t h e NOS 2 o p e r a t i n g s y s t e m f o r t h e CONTROL DATA@ CYBER 170
Computer Systems; CDC@ CYBER 70 Computer System
models 7 1 , 72, 7 3 , and 74; and 6000 Computer Sys- tems.
NAM i s t h e s u b s e t of t h e h o s t computer s o f t w a r e t h a t p r o v i d e s communication between a n a p p l i c a t i o n pro- gram i n t h e h o s t computer and o t h e r a p p l i c a t i o n programs o r d e v i c e s a c c e s s i n g t h e n e t w o r k ' s r e - s o u r c e s .
The Communications C o n t r o l Program i s s o f t w a r e t h a t r e s i d e s i n a 255x S e r i e s Network P r o c e s s i n g U n i t t h a t a l l o w s a d e v i c e t o a c c e s s t h e h o s t computer o v e r communications l i n e s .
WHO SHOULD READ THlS MANUAL
T h i s manual i s d i r e c t e d a t t h e g e n e r a l n e t w o r k s u s e r ( a s y s t e m s programmer o r a n a l y s t ) , who i s f a m i l i a r w i t h subsystem a p p l i c a t i o n s programming, c o m p i l e r and a s s e m b l e r programming c o n v e n t i o n s , t e r m i n a l communication p r o t o c o l s , o t h e r network s o f t w a r e p r o d u c t s , and t h e programming r e q u i r e m e n t s of sup- p o r t e d d e v i c e s .
HOW THlS MANUAL IS ORGANIZED
I n a d d i t i o n t o d e s c r i b i n g NAM, t h i s book now con- t a i n s t h e m a j o r i t y of t h e i n f o r m a t i o n p r e v i o u s l y
found i n t h e CCP r e f e r e n c e manual. I n f o r m a t i o n h a s been c o n s o l i d a t e d i n t o t h i s book t o r e d u c e redundacy and t o p r o v i d e a c e n t r a l l o c a t i o n f o r i n f o r m a t i o n needed by t h e g e n e r a l networks u s e r .
S e c t i o n 1 i n t r o d u c e s t h e NAM and CCP s o f t w a r e . S e c t i o n 2 d e s c r i b e s t h e p r o t o c o l s g o v e r n i n g i n f o r - m a t i o n exchanged f o r communication between NAM and e a c h a p p l i c a t i o n program, and between a p p l i c a t i o n programs and t h e i r c o n n e c t i o n s . S e c t i o n 3 d e s c r i b e s t h e synchronous and a s y n c h r o n o u s s u p e r v i s o r y mes- s a g e s used by a p p l i c a t i o n programs. S e c t i o n 4 d e s c r i b e s t h e l a n g u a g e and i n t e r n a l i n t e r f a c e s r e q u i r e d by a n a p p l i c a t i o n program. S e c t i o n 5 d i s - c u s s e s t h e a p p l i c a t i c ~ n i n t e r f a c e program s t a t e m e n t s used by NAM t o a c c e s s t h e network and t o send and r e c e i v e m e s s a g e s . S e c t i o n 6 d i s c u s s e s t h e s t r u c t u r e and e x e c u t i o n of a n a p p l i c a t i o n program job a s a b a t c h o r system o r i g i n t y p e f i l e . S e c t i o n 7 g i v e s more d e t a i l e d i n f o r m a . t i o n on CCP t h a n was p r e s e n t e d i n t h e f i r s t s e c t i o n of t h e book. S e c t i o n 8 de- s c r i b e s network f a i l u r e and t e c h n i q u e s of r e c o v e r y .
Other p a r t s of t h e Communications C o n t r o l Program r e f e r e n c e manual have b e e n moved t o o t h e r network p r o d u c t and o p e r a t i n g s y s t e m p u b l i c a t i o n s . Use t a b l e 0-1 t o h e l p f i n d t h e l o c a t i o n of t h i s i n f o r - m a t i o n .
RELATED PUBLICATIONS
R e l a t e d m a t e r i a l i s c o n t a i n e d i n t h e p u b l i c a t i o n s l i s t e d below. O t h e r manuals may be n e e d e d , s u c h a s t h e h a r d w a r e , f i r m w a r e , o r e m u l a t o r s o f t w a r e r e f e r - e n c e manual f o r t h e d e v i c e s s e r v i c e d by a g i v e n program. A l s o , communication s t a n d a r d s and d e v i c e o p e r a t i n g l i t e r a t u r e (:an be u s e f u l .
The NOS 2 Manual A b s t r a c t s i s a p o c k e t - s i z e d manual t h a t c o n t a i n s a b r i e f d e s c r i p t i o n of t h e c o n t e n t s and i n t e n d e d a u d i e n c e o f e v e r y manual a v a i l a b l e f o r NOS 2 and i t s p r o d u c t s e t . The a b s t r a c t s manual c a n h e l p a p a r t i c u l a r r e a d e r d e t e r m i n e which manuals a r e of g r e a t e s t i m p o r t a n c e .
Another manual, t h e S o f t w a r e P u b l i c a t i o n s R e l e a s e H i s t o r y , g i v e s t h e t i t l e s and r e v i s i o n l e v e l s of s o f t w a r e manuals a v a i l a b l e f o r t h e Programming System R e p o r t (PSR) l e v e l of NOS 2 i n s t a l l e d a t your s i t e .
TABLE 0-1. NEW LOCATION OF CCP REFERENCE MANUAL INFORMATION
The f o l l o w i n g manuals a r e of p r i m a r y i n t e r e s t : I n f o r m a t i o n
CCP o v e r v i e w , c o n c e p t s , and f u n c t i o n s
NPU initialization,
f a i l u r e , and r e c o v e r y C h a r a c t e r s e t s CCP g l o s s a r y Mnemonics S t a t i s t i c s H a l t Codes D i a g n o s t i c s
Customer E n g i n e e r i n g e r r o r messages Dump i n f o r m a t i o n NPU o p e r a t i n g i n s t r u c t i o n s Memory map
Naming convent i o n s NPU durnplng, l o a d i n g , and initializing d e t a i l s
P u b l i c a t i o n COMPASS V e r s i o n 3 R e f e r e n c e Manual
t ~ v a i l a b l e from S o f t w a r e M a n u f a c t u r i n g D i s t r i b u t i o n (SMD)
,
4201 L e x i n g t o n Ave. N o r t h , Arden H i l l s , Minnesota 55112NOS V e r s i o n 2 NAM/CCP R e f e r e n c e Manual
X X X X
XNetwork P r o d u c t s
Network Access Method V e r s i o n 1 Network D e f i n i t i o n Language R e f e r e n c e Manual
Network P r o d u c t s
Network Access Method V e r s i o n 1 T e r m i n a l I n t e r f a c e Guide Network P r o d u c t s
Remote B a t c h F a c i l i t y V e r s i o n 1 R e f e r e n c e Manual
Communications C o n t r o l Program I n t e r n a l Maintenance s p e c i f l c a t l o n t
- -
X X X
ManualNOS V e r s i o n 2 System Maintenance R e f e r e n c e Manual
X X
NOS V e r s i o n 2 R e f e r e n c e S e t , Volume 1 I n t r o d u c t i o n t o I n t e r a c t i v e Usage
P u b l i c a t i o n Number That C o n t a i n s
Communications C o n t r o l Program V e r s i o n 3 D i a g n o s t i c Handbook
X X X
X
I n f o r m a t i o n
A n a l y s t Handbook
-
X
NOS V e r s i o n 2 R e f e r e n c e S e t , Volume 3 System Commands
NOS V e r s i o n 2 R e f e r e n c e S e t , Volume 4 Program I n t e r f a c e
The f o l l o w i n g manuals a r e of s e c o n d a r y i n t e r e s t :
Pub1 i c a t i o n Number
-
Pub 1 i c a t i o n CCP V e r s i o n 3 D i a g n o s t i c Handbook COBOL V e r s i o n 5 R e f e r e n c e Manual
FORTRAN Extended V e r s i o n 4 R e f e r e n c e Manual
FORTRAN V e r s i o n 5 R e f e r e n c e Manual
Message C o n t r o l System V e r s i o n 1 R e f e r e n c e Manual
Network P r o c e s s o r U n i t Hardware R e f e r e n c e Manual NOS V e r s i o n 2
D i a g n o s t i c Index NOS V e r s i o n 2
I n s t a l l a t i o n Handbook NOS V e r s i o n 2
Manual A b s t r a c t s NOS V e r s i o n 2
O p e r a t o r / A n a l y s t Handbook NOS V e r s i o n 2
System Maintenance R e f e r e n c e Manual S o f t w a r e P u b l i c a t i o n s R e l e a s e H i s t o r y TAF V e r s i o n I
R e f e r e n c e Manual
255x Host Communications P r o c e s s o r / Network P r o c e s s o r Unit R e f e r e n c e Manual CCP V e r s i o n 1.0
255X Network P r o c e s s o r U n i t Hardware R e f e r e n c e Manual
2560 S e r i e s Synchronous Communications L i n e Adapter Hardware Maintenance Manual 2561 S e r i e s Asynchronous Communications Li.ne A d a p t e r Hardware Maintenance Manual 2563 S e r i e s SDLC L i n e Adapter
Hardware Maintenance Manual
CDC manuals c a n be o r d e r e d from C o n t r o l Data C o r l ) o r a t i o n , L i t e r a t u r e and D i s t r i b u t i o n S e r v i c e s , 308 North Dale S t r e e t , S t . P a u l , Minnesota 55103.
T h i s p r o d u c t i s i n t e n d e d f o r u s e o n l y a s d e s c r i b e d i n t h i s document. C o n t r o l Data can- n o t b e r e s p o n s i b l e f o r t h e p r o p e r f u n c t i o n i n g o f u n d e s c r i b e d f e a t u r e s o r p a r a m e t e r s .
NOTAT IONS x i i i
1. NETWORK PRODUCTS: AN OVERVIEW 1-1
Computer Network 1-1
Communications Network 1-2
S o f t w a r e Components o f t h e Network 1-2
Network Host P r o d u c t s 1-2
Network Access Method 1-3
P e r i p h e r a l I n t e r f a c e Program 1-3
Network I n t e r f a c e Program 1-3
A p p l i c a t i o n I n t e r f a c e Program 1-3
Queued T e r m i n a l Record Manager 1-3
Network D e f i n i t i o n Language P r o c e s s o r 1-3
Network S u p e r v i s o r 1-4
Communication S u p e r v i s o r 1-4
Network V a l i d a t i o n F a c i l i t y 1 -4
Network U t i l i t i e s 1-4
Network Dump Analyzer 1-4
Load F i l e G e n e r a t o r 1-4
Debug Log F i l e P r o c e s s o r 1-4
Hardware Performance A n a l y z e r 1-4
NAM A p p l i c a t i o n Programs 1-4
Network P r o c e s s i n g U n i t and Communications
C o n t r o l Program 1-4
Network P r o c e s s i n g U n i t 1-5
Communications C o n t r o l Program 1-5
Base System S o f t w a r e 1-5
S e r v i c e Module 1-6
Host I n t e r f a c e Program 1-6
T e r m i n a l I n t e r f a c e Program 1-6
Link I n t e r f a c e Program 1-6
Block I n t e r f a c e Program 1-6
In-Line and On-Line D i a g n o s t i c s 1-6
Console Debugging Aids 1-6
Performance and S t a t i s t i c s Programs 1-6
CDC CYBER Cross System S o f t w a r e 1-6
2. INFORMATION PROTOCOLS 2-1
Informa t i o n Flow S t r u c t u r e P r o t o c o l s
P h y s i c a l P r o t o c o l s and Network Blocks L o g i c a l P r o t o c o l and P h y s i c a l Blocks
Network Data Blocks T r a n s m i s s i o n B l o c k s
I n t e r a c t i v e Terminal I n p u t Concepts L i n e Mode Operat ion
Block Mode O p e r a t ion P h y s i c a l and L o g i c a l L i n e s End-of-Line I n d i c a t o r s
M u l t i p l e L o g i c a l L i n e s i n One Message End-of-Block I n d i c a t o r s
I n t e r a c t i v e Terminal Output Concepts Batch Data
I n f o r m a t i o n I d e n t i f i c a t i o n P r o t o c o l s A p p l i c a t i o n Program Message Types A p p l i c a t i o n Block Types
Block B u f f e r Areas Block Header Area Block Text Area Connection I d e n t i f i e r s
A p p l i c a t i o n Connection Number A p p l i c a t i o n L i s t Number
Data Message C o n t e n t and Sequence P r o t o c o l s I n t e r a c t i v e V i r t u a l T e r m i n a l Data
L i n e Turnaround Convention I n t e r a c t i v e V i r t u a l T e r m i n a l Exchange
Modes
Normalized Mode O p e r a t i o n
U p l i n e C h a r a c t e r S e t s and E d i t i n g Modes
Downline C h a r a c t e r S e t s Page Width and Page Length Format Ef f e c t r r s
T r a n s p a r e n t Mcde O p e r a t i o n A p p l i c a t i o n Chardc t e r Types C h a r a c t e r Byte C o n t e n t Block Header Contt n t
S u p e r v i s o r y Message C c n t e n t and Sequence P r o t o c o l s
Asynchronous Messdges Synchronous Messages Block Header C o n t e n t
3. SUPERVISORY MESSAGES AND COMMANDS 3- 1
Message P r o t o c o l s 3-1
Message Sequences 3-1
Managing L o g i c a l C o n n e c t i o n s 3-5
Connecting Devices t o A p p l i c a t i o n s 3-5 Connecting A p p l i c a t i o n s t o A p p l i c a t i o n s 3-13
M o n i t o r i n g C o n n e c t i o n s 3-1 6
T e r m i n a t i n g C o n n e c t i o n s 3-1 6
Managing C o n n e c t i o n L i s t s 3-18
C o n t r o l l i n g L i s t P o l l i n g 3-18
C o n t r o l l i n g L i s t Duplexing 3-1 9
C o n t r o l l i n g Data Flow 3-2 1
M o n i t o r i n g Downline Data 3-22
Using U s e r - I n t e r r u p t F e a t u r e 3-26
C o n v e r t i n g Data 3-27
T r u n c a t i n g Data 3-28
Changing T e r m i n a l C h a r a c t e r i s t i c s 3-29 R e q u e s t i n g T e r m i n a l C h a r a c t e r i s t i c s 3-36
Host O p e r a t o r Communication 3-37
Host Shutdown 3-40
E r r o r R e p o r t i n g 3-4 1
4 . APPLICATlON INTERFACE DESCRIPTLONS 4-1
Language I n t e r f a c e s
P a r a m e t e r L i s t and C a l l i n g Sequence Requirements
P r e d e f i n e d Symbolic Names P r e d e f i e d Symbolic V a l u e s COMPASS Assembler Language
A p p l i c a t i o n I n t e r f a c e Program Macro C a l l Formats
F i e l d Access U t i l i t i e s Compiler-Level Languages
A p p l i c a t i o n I n t e r f a c e Program S u b r o u t i n e C a l l Formats F i e l d Access U t i l i t i e s
Queued T e r m i n a l Record Manager U t i l i t i e s
I n t e r n a l I n t e r f a c e s 4-1 5 A p p l i c a t i o n I n t e r f a c e Program and
Network I n t e r f a c e Program Communication 4-15
W o r k l i s t P r o c e s s i n g 4-15
P a r a l l e l Mode O p e r a t i o n 4-16
O t h e r S o f t w a r e Communication 4-17
5. USER PROGRAM CALL STATEMENTS 5-1
Syntax 5-1
Network Access S t a t e m e n t s 5-1
C o n n e c t i n g t o Network (NETON) 5-1
D i s c o n n e c t i n g From Network (NETOFF) 5 -3 Message Block I n p u t / O u t p u t S t a t e m e n t s 5 -4
S p e c i f i c C o n n e c t i o n s 5 -4
I n p u t i n g t o S i n g l e B u f f e r (NETGET) 5-4 I n p u t i n g t o Fragmented B u f f e r
A r r a y (NETGETF) 5-6
O u t p u t i n g From S i n g l e B u f f e r (NETPLIT) 5-8 O u t p u t i n g From Fragmented B u f f e r
A r r a y (NETPUTF) 5-9
C o n n e c t i o n s on L i s t s 5-1 1
I n p u t i n g t o S i n g l e B u f f e r (NETGETL) 5-11 I n p u t i n g t o Fragmented B u f f e r
A r r a y (NETGTFL) 5-13
P r o c e s s i n g C o n t r o l S t a t e m e n t s 5-15
Suspending P r o c e s s i n g (NETWAIT) 5-15
C o n t r o l l i n g P a r a l l e l Mode (NETSETP) 5-17 Checking Completion of W o r k l i s t
P r o c e s s i n g (NETCHEK) 5-19
6. CHARACTERISTICS OF AN APPLICATION PROGRAM 6-1
NOS System C o n t r o l P o i n t A p p l i c a t i o n Job S t r u c t u r e
Commands O v e r l a y s
Access t o A p p l i c a t i o n Programs Types of A p p l i c a t i o n Programs
D i s a b l e d
Unique I d e n t i f i e r P r i v i l e g e d
E x e c u t i o n of A p p l i c a t i o n Programs F a t a l E r r o r s
Debugging Methods
Debug Log F i l e and A s s o c i a t e d U t i l i t i e s
S t a t i s t i c a l F i l e and A s s o c i a t e d U t i l i t i e s
Dependencies Memory R e q u i r e m e n t s
7. THE COMMUNICATIONS CONTROL PROGRAM
AND THE NETWORK PROCESSING UNIT 7 -1
Hardware Environment
2551 S e r i e s Communications CYBER Channel C o u p l e r C a s s e t t e D r i v e NPU Console
M u l t i p l e x Subsystem M u l t i p l e x Subsystem O p e r a t i o n
I n p u t M u l t i p l e x i n g I n p u t D e m u l t i p l e x i n g O u t p u t M u l t i p l e x i n g Output D e m u l t i p l e x i n g Trunk M u l t i p l e x i n g
P r o c e s s o r 7-1 7-1 7-1 7 -2 7-2 7 -3 7 -3 7-3 7 -3 7 -4 7 -4
Network Block H a n d l i n g
S i m p l i f i e d I n p u t P r o c e s s i n g S i m p l i f i e d O u t p u t P r o c e s s i n g Data P r i o r i t i e s
C o n n e c t i o n R e g u l a t i o n
L e v e l s of L o g i c a l Link R e g u l a t i o n T e r m i n a l I n t e r f a c e Programs
ASYNC TIP
P r o t o c o l Assumptions
S u p p o r t e d I n p u t and O u t p u t Mechanisms T e r m i n a l Code S e t s and P a r i t y
I n i t i a l Connect i o n D i s c o n n e c t i o n
Data F o r m a t t i n g i n Normalized Mode Normalized E d i t i n g Modes
I n p u t O p e r a t i o n s Output O p e r a t i o n s Break S i g n i f i c a n c e I n p u t R e g u l a t i o n E r r o r Recovery X.25 TIP W i t h PAD
P r o t o c o l Assumptions
S u p p o r t e d I n p u t and O u t p u t Mechanisms T e r m i n a l Code S e t s and P a r i t y
I n i t i a l C o n n e c t i o n D i s c o n n e c t i o n
Data F o r m a t t i n g i n Normalized Mode Normalized E d i t i n g Modes
Output O p e r a t i o n s Break S i g n i f i c a n c e I n p u t R e g u l a t i o n E r r o r Recovery MODE4 T I P
P r o t o c o l A s s u m p t i o n s
S u p p o r t e d I n p u t and Output Mechanisms T e r m i n a l Code S e t s and P a r i t y
I n i t i a l C o n n e c t i o n D i s c o n n e c t i o n
Data F o r m a t t i n g i n Normalized Mode Normalized E d i t i n g Modes
I n p u t R e g u l a t i o n E r r o r Recovery HASP TIP
P r o t o c o l Assumptions
S u p p o r t e d I n p u t and Output Mechanisms T e r m i n a l Code S e t s and P a r i t y
I n i t i a l C o n n e c t i o n D i s c o n n e c t i o n
Data F o r m a t t i n g i n Normalized Mode Normalized E d i t i n g Modes
I n p u t R e g u l a t i o n O u t p u t R e g u l a t i i o n E r r o r Recovery BSC TIP
P r o t o c o l Assumptions
S u p p o r t e d I n p u t and O u t p u t Mechanisms T e r m i n a l Code S e t s and P a r i t y
I n i t i a l C o n n e c t i o n D i s c o n n e c t i o n
Data F o r m a t t i n g i n Normalized Mode Normalized E d i t i n g Modes
I n p u t R e g u l a t i o n E r r o r Recovery
8. NElWORK FAILURE AND RECOVERY 8-1
A p p l i c a t i o n Programs Host
Network P r o c e s s i n g U n i t
L o g i c a l L i n k Trunk L i n e T e r m i n a l
APPENDIXES
C h a r a c t e r Data I n p u t , O u t p u t , and
C e n t r a l Memory R e p r e s e n t a t i o n A-1
D i a g n o s t i c M e s s a g e s B-1
G l o s s a r y C-1
U s e r Program C a l l S t a t e m e n t Summary D-1
Queued T e r m i n a l Record Manager E-1
T e r m i n a l D e f i n i t i o n Commands F-1 D e l i m i t i n g and T r a n s m i t t i n g T e r m i n a l I n p u t G-1
A c c e s s i n g t h e Network H- 1
Sample FORTRAN Program 1-1
INDEX
FIGURES
Overview of Network P r o d u c t s The I n t e r f a c e s Between t h e Network
P r o d u c t E l e m e n t s
The R e l a t i o n s h i p Between t h e P a r t s of t h e Communications C o n t r o l Program P h y s i c a l and L o g i c a l I n f o r m a t i o n
S t r u c t u r e s
B l o c k Reassembly P o i n t s
A p p l i c a t i o n B l o c k Header C o n t e n t f o r U p l i n e Network D a t a B l o c k s
A p p l i c a t i o n B l o c k H e a d e r C o n t e n t f o r Downline Network D a t a B l o c k s S u p e r v i s o r y Message G e n e r a l C o n t e n t ,
Asynchronous M e s s a g e s and S y n c h r o n o u s M e s s a g e s o f A p p l i c a t i o n C h a r a c t e r
Type 2 2-29
S u p e r v i s o r y Message G e n e r a l C o n t e n t , S y n c h r o n o u s M e s s a g e s o f A p p l i c a t i o n
C h a r a c t e r Type 3 2-31
A p p l i c a t i o n B l o c k Header C o n t e n t f o r
U p l i n e S u p e r v i s o r y M e s s a g e s 2-33 A p p l i c a t i o n B l o c k Header C o n t e n t f o r
Downline S u p e r v i s o r y Messages 2-35 S u p e r v i s o r y Message Mnemonic S t r u c t u r e 3-1 D e v i c e - t o - A p p l i c a t i o n C o n n e c t i o n
Message S e q u e n c e 3 -5
C o n n e c t i o n - R e q u e s t (CON/REQ/R)
S u p e r v i s o r y Message Format 3-6
C o n n e c t i o n - A c c e p t e d (CON/REQ/N)
S u p e r v i s o r y Message Format 3-9
C o n n e c t i o n - R e j e c t e d (CON/REQ/A)
S u p e r v i s o r y Message Format 3-10
I n i t i a l i z e d - C o n n e c t i o n (FC/INIT/R)
S u p e r v i s o r y Message Format 3-1 1
C o n n e c t i o n - I n i t i a l i z e d (FC/INIT/N)
S u p e r v i s o r y Message Format 3-1 1
C o n n e c t i o n - B r o k e n (CON/CB/R)
S u p e r v i s o r y Message Format 3-12
End-Connec t i o n (CON/END/R) S u p e r v i s o r y Message F o r m a t ,
C o n n e c t i o n E s t a b l i s h m e n t S e q u e n c e s 3-12 Connection-Ended (CON/END/N)
S u p e r v i s o r y Message Format 3-13
A p p l i c a t i o n - t o - A p p l i c a t i o n C o n n e c t i o n
Message S e q u e n c e s 3-14
R e q u e s t - A p p l i c a t i o n - C o n n e c t i o n (CON/ACRQ/R) S u p e r v i s o r y Message Format
A p p l i c a t i o n - C o n n e c t i o n - R e j e c t (CON/ACRQ/A) S u p e r v i s o r y Message Format
C o n n e c t i o n M o n i t o r i n g Message S e q u e n c e s I n a c t i v e - C o n n e c t i o n (FC/INACT/R)
S u p e r v i s o r y Message Format
C o n n e c t i o n T e r m i n a t i o n Message S e q u e n c e s C o n n e c t i o n List: P o l l i n g C o n t r o l
Message S e q u e n c e s
C o n n e c t i o n List: D u p l e x i n g Message S e q u e n c e s
T u r n - L i s t - P r o c e s s i n g - O f f (LST/OFF/R) S u p e r v i s o r y Message Format
Turn-List-Procc?ssing-On (LST/ON/R)
S u p e r v i s o r y Message F o r m a t Change-Connect]-on-List (LST/SWH/R)
S u p e r v i s o r y Message Format Turn-On-Half-Duplex-List-Processing
(LST/HDX/R) S u p e r v i s o r y Message Format T u r n - O n - F u l l - D u p l e x - L i s t - P r o c e s s i n g
(LST/FDX/R) S u p e r v i s o r y Message Format B l o c k - D e l i v e r e d (FC/ACK/R) S u p e r v i s o r y
Message Format
B l o c k - N o t - D e l i v e r e d (FC/NAK/R) S u p e r v i s o r y Message Format B r e a k a n d Reset Message S e q u e n c e B r e a k (FC/BRK/E:) S u p e r v i s o r y Message
Format
R e s e t (FC/RST/F.) S u p e r v i s o r y Message Format
A p p l i c a t i o n - I n t e r r u p t (INTR/APP/R) S u p e r v i s o r y Message Format A p p l i c a t i o n - I n t e r r u p t - R e s p o n s e
(INTR/RSP/R) S u p e r v i s o r y Message Fo rma t
T e r m i n a t e - O u t p u t - M a r k e r (TO/MARK/R) S u p e r v i s o r y Message Format U s e r - I n t e r r u p t - R e q u e s t (INTR/USR/R)
S u p e r v i s o r y Message Format U s e r - I n t e r r u p t Message S e q u e n c e Change I n p u t C h a r a c t e r Type Message
S e q u e n c e
C h a n g e - I n p u t - C h a r a c t e r - T y p e (DC/CICT/R) S u p e r v i s o r y Message Format
D a t a T r u n c a t i o n Message S e q u e n c e D a t a T r u n c a t i o n (DC/TRU/R) S u p e r v i s o r y
Message Format
T e r m i n a l C h a r a c t e r i s t i c s R e d e f i n i t i o n Message S e q u e n c e s
T e r m i n a l - C h a r a c t e r i s t i c s - R e d e f i n e d (TCH/TCHAR/R) S u p e r v i s o r y Message Format
D e f i n e - T e r m i n a l - C h a r a c t e r i s t i c s (CTRL/DEF/R) ; S u p e r v i s o r y Message Format
D e f i n e - M u l t i p l e - T e r m i n a l - C h a r a c t e r i s t i c s (CTRL/CHAR/R) S u p e r v i s o r y Message Format
D e f i n e - M u l t i p l e - T e r m i n a l - C h a r a c t e r i s t i c s Abnormal R e s p o n s e ( CTRL/CHAR/A) S u p e r v i s o r y Message Format M u l t i p l e - T e r m i n a l - C h a r a c t e r i s t i c s -
D e f i n e d (CTRL,/CHAR/N) S u p e r v i s o r y Message F o r m a t
Request-Termina.L-Characteristics (CTRL/RTC/R) S u p e r v i s o r y Message Format
R e q u e s t - T e r m i n a l . - C h a r a c t e r i s t i c s Abnormal R e s p o n s e (CTRLIRTCIA) S u p e r v i s o r y Message Format
x i i
Host U p e r a t o r K e q u e s t - t o - A c t i v a t e - Debug-Code (HOP/DB/R) S u p e r v i s o r y
Message Format 3-37
Host O p e r a t o r Request-to-Turn-Off- Debug-Code (HOP/DE/R) S u p e r v i s o r y
Message Format 3-38
H o s t O p e r a t o r Request-to-Dump-Field- L e n g t h (HOP/DU/R) S u p e r v i s o r y
Message Format 3-38
H o s t O p e r a t o r Request-to-Turn-AIP- Tracing-On (HOP/TRACE/R) S u p e r v i s o r y
Message Format 3-38
Host O p e r a t o r Request-to-Turn-AIP- T r a c i n g - O f f (HOP/NOTR/R) S u p e r v i s o r y
Message Format 3-39
Host O p e r a t o r Request-to-Release-Debug- L o g - F i l e (HOP/REL/R) S u p e r v i s o r y
Message Format 3-39
Host O p e r a t o r R e q u e s t - t o - R e s t a r t - S t a t i s t i c s - G a t h e r i n g (HOP/RS/R)
S u p e r v i s o r y Message Format 3-39
H o s t Shutdown Message S e q u e n c e s 3-40 Host-Shutdown (SHUT/INSD/R) S u p e r v i s o r y
Message Format 3-41
L o g i c a l E r r o r Message S e q u e n c e 3-41 L o g i c a l - E r r o r (ERR/LGL/R) S u p e r v i s o r y
Message Format 3-41
NFETCH Macro C a l l Format 4-10
NSTORE Macro C a l l Format 4-1 1
NFETCH I n t e g e r F u n c t i o n FORTRAN
C a l l Format 4-12
NSTORE S u b r o u t i n e FORTRAN C a l l Format 4-13 QTRM I n t e r f a c e L e v e l Analogy 4-14 NETON S t a t e m e n t FORTRAN C a l l Format 5 -2 S u p e r v i s o r y S t a t u s Word Format 5 -3
NETON S t a t e m e n t Example 5-4
NETOFF S t a t e m e n t FORTRAN C a l l Format 5 -4 NETGET S t a t e m e n t FORTRAN C a l l Format 5-5 NETGET S t a t e m e n t FORTRAN 5 Examples 5-6 NETGET S t a t e m e n t FORTRAN E x t e n d e d 4
Examples 5-6
NETGETE S t a t e m e n t FORTRAN C a l l Format 5-7 NETGETE S t a t e m e n t T e x t Area A d d r e s s
A r r a y 5-7
NETGETE S t a t e m e n t FORTRAN 5 E x a m p l e s 5-8 NETGETF S t a t e m e n t FORTRAN E x t e n d e d 4
Examples 5-8
NETPUT S t a t e m e n t FORTRAN C a l l Format 5-8 NETPUT S t a t e m e n t FORTRAN 5 Example 5-9 NETPUT S t a t e m e n t FORTRAN E x t e n d e d 4
Example 5 -9
NETPUTF S t a t e m e n t FORTRAN C a l l Format 5-9 NETPUTF S t a t e m e n t T e x t Area A d d r e s s
A r r a y 5-10
NETPUTF S t a t e m e n t FORTRAN 5 Example 5-1 1 NETPUTF S t a t e m e n t FORTRAN E x t e n d e d 4
Example 5-1 1
NETGETL S t a t e m e n t FORTRAN C a l l Format 5-12 NETGETL S t a t e m e n t FORTRAN 5 Example 5-13 NETGETL S t a t e m e n t FORTRAN E x t e n d e d 4
Example 5-13
Nb'I'GI'k'L S t a t e m e n t YOKTKAN 5 Example NETGTFL S t a t e m e n t FORTRAN E x t e n d e d 4
Example
NETWAIT S t a t e m e n t FORTRAN C a l l Format NETWAIT S t a t e m e n t FORTRAN 5 Examples NETWAIT S t a t e m e n t FORTRAN E x t e n d e d 4
Examples
NETSETP S t a t e m e n t FORTRAN C a l l F o r m a t NETSETP a n d NETCHEK S t a t e m e n t
FORTRAN 5 Examples
NETSETP a n d NETCHEK S t a t e m e n t FORTRAN E x t e n d e d 4 E x a m p l e s
NETCHEK S t a t e m e n t FORTRAN C a l l Format T y p i c a l J o b S t r u c t u r e f o r System I n p u t NETDBG U t i l i t y FORTRAN C a l l S t a t e m e n t
Format
NETREL U t i l i t y FORTRAN C a l l S t a t e m e n t Format
NETSETF U t i l i t y FORTRAN C a l l S t a t e m e n t Format
NETLOG U t i l i t y FORTRAN C a l l S t a t e m e n t Format
NETDMB U t i l i t y FORTRAL C a l l S t a t e m e n t Fo rma t
DLFP C o n t r o l S t a t e m e n t G e n e r a l Format DLFP J o b Command Examples
DLFP D i r e c t i v e Keyword Format DLFP D i r e c t i v e Examples G e n e r a l Format o f DLFP O u t p u t
NETSTC U t i l i t y FORTRAN C a l l S t a t e m e n t Format
NETLGS U t i l i t y FORTRAN C a l l S t a t e m e n t Format
G e n e r a l Format o f One P e r i o d L i s t i n g i n S t a t i s t i c a l F i l e
B a s i c Components o f a CDC Network P r o c e s s i n g U n i t
B a s i c Components o f t h e M u l t i p l e x S u b s y s t e m
S i m p l i f i e d I n p u t P r o c e s s i n g S i m p l i f i e d O u t p u t P r o c e s s i n g
D e f a u l t Message D e l i m i t e r and T r a n s m i s s i o n Keys
Format E f f e c t o r O p e r a t i o n s f o r A s y n c h r o n o u s and X . 2 5 C o n s o l e s Format E f f e c t o r O p e r a t i o n s f o r
S y n c h r o n o u s C o n s o l e s
Embedded Format C o n t r o l O p e r a t i o n s f o r C o n s o l e s
C h a r a c t e r E x c h a n g e s W i t h C o n n e c t i o n s L e g a l S u p e r v i s o r y M e s s a g e s
V a l i d F i e l d Numbers a n d F i e l d V a l u e s R e s e r v e d Symbols
AIP I n t e r n a l P r o c e d u r e s AIP I n t e r n a l T a b l e s and B l o c k s
Throughout t h i s manual, t h e f o l l o w i n g c o n v e n t i o n s a r e used i n t h e p r e s e n t a t i o n of s t a t e m e n t f o r m a t s , o p e r a t o r t y p e - i n s , and d i a g n o s t i c messages:
1
UPPERCASE Uppercase l e t t e r s i n d i c a t eacronyms, words, o r mne-
monics e i t h e r r e q u i r e d by t h e network s o f t w a r e a s i n p u t , o r produced a s o u t - p u t .
I
l o w e r c a s e Lowercase l e t t e r s i d e n t i f y v a r i a b l e s f o r which v a l u e s a r e s u p p l i e d by t h e NAM o r t e r m i n a l u s e r , o r by t h e network s o f t w a r e a s o u t p u t . E l l i p s i s i n d i c a t e s t h a t o m i t t e d e n t i t i e s r e p e a t t h e form and f u n c t i o n of t h e e n t i t y l a s t g i v e n .S q u a r e b r a c k e t s e n c l o s e e n t i t i e s t h a t a r e o p t i o n a l ; i f o m i s s i o n o f any e n t i t y c a u s e s t h e u s e of a d e f a u l t e n t i t y , t h e d e f a u l t i s u n d e r 1 ined.
B r a c e s e n c l o s e e n t i t i e s from which one must b e c h o s e n . i n p u t p a r a m e t e r T h i s term i d e n t i f i e s a n AIP
c a l l s t a t e m e n t p a r a m e t e r f o r which v a l u e s a r e s u p p l i e d t o AIP by t h e programmer.
r e t u r n p a r a m e t e r T h i s term i d e n t i f i e s a n AIP c a l l s t a t e m e n t p a r a m e t e r f o r which v a r i a b l e s a r e s u p p l i e d t o AIP by t h e pro- grammer and i n which v a l u e s a r e p l a c e d by AIP.
The c t symbol r e p r e s e n t s t h e network c o n t r o l c h a r - a c t e r d e f i n e d f o r t h e t e r - m i n a l . T h i s c h a r a c t e r must be t h e f i r s t c h a r a c t e r of t h e command e n t e r e d .
The LF symbol r e p r e s e n t s a o n e - l i n e v e r t i c a l r e p o s i - t i o n i n g o f t h e c u r s o r o r o u t p u t mechanism. LF a l s o d e s i g n a t e s a c h a r a c t e r o r c h a r a c t e r c o d e a s s o c i a t e d w i t h s u c h a l i n e f e e d o p e r a t i o n .
A c i r c l e around a c h a r a c t e r r e p r e s e n t s a c h a r a c t e r key t h a t i s p r e s s e d i n con- j u n c t i o n w i t h a c o n t r o l
key (CTL, CNTRL, CONTRL,
CONTROL, o r e q u i v a l e n t ) .
The boxed CR symbol r e p r e - s e n t s t h e t e r m i n a l key t h a t c a u s e s message t r a n s m i s s i o n ; u s u a l l y , t h i s i s t h e same key t h a t c a u s e s a c a r r i a g e r e t u r n o p e r a t i o n . Trans- m i s s i o n k e y s a r e d e s c r i b e d i n more d e t a i l i n a p p e n d i x
F.
I
U n l e s s o t h e r w i s e s p e c i f i e d , a l l r e f e r e n c e s t o num- b e r s a r e t o d e c i m a l v a l u e s and a l l r e f e r e n c e s t o b y t e s a r e t o 8 - b i t b y t e s and a l l r e f e r e n c e s t o c h a r a c t e r s a r e t o 7 - b i t ASCII-coded c h a r a c t e r s . F i e l d s d e f i n e d a s unused s h o u l d n o t b e assumed t o
I
c o n t a i n z e r o s .
NETWORK PRODUCTS: A N OVERVIEW
This section introduces the Control Data Corporation
CYBER
170
network products, their relationships toCOMPUTER NETWORK
each other, and their significance to the data corn- The computer network includes host computers, munications user. Network products is a group of application programs, terminals, and the host soft- programs and hardware that provides communications ware associated with network communications. Each services to geographically dispersed users. application program gives the terminal user or
application a specific data processing capability.
As shown in figure 1-1, a network consists of a computer network and a communications network.
Users
F i g u r e 1-1. Overview o f Netuork P r o d u c t s
COMMUNICATIONS NETWORK
The communications network includes network proc- essing units (NPUs) and the connecting communication lines and packet switching networks (PSNs) needed to transport blocks of data between host computers and terminals.
The size and complexity of a communications network varies from a simple network with one local (front- end) NPU or a network with one local NPU and one or more remote NPUs to a more complex network with multiple local NPUs and multiple remote NPUs.
Attached to these NPUs are terminal devices, such as entry/display stations.
Because the communications network minimizes termi- nal type dependency and removes many of the terminal switching operations from the host, the host can process data more efficiently.
SOFTWARE COMPONENTS OF THE NETWORK
Figure 1-2 shows the interfaces between the elements of the network. The left part of the figure shows the network host products (NHP), which are the software elements located in the CDC CYBER 170 host
computer. The middle section shows the Communica- tions Control Program (CCP), which is the software element located in the Network Processing Unit. As shown in the right portion of figure 1-2, CCP com- municates directly with the terminals while the Network Access Method (NAM) communicates with applications. Refer to figure
1-2
while reading the remainder of this overview section on network products.NETWORK HOST PRODUCTS
Network host products includes the network access software and the application programs that provide the specific facilities requred by terminal users.
The network access software is collectively called the Network Access Method or NAM. NAM is used in several contexts throughout this manual and in the other network products documentation. NAM can refer to the interface between application programs and the communications network; to the programs that implement that interface, including the Applications Interface Program (AIP)
,
the Network Interface Pro- gram (NIP), and the Peripheral Interface Program (PIP); or to the product NAM, which also includes the, Network Supervisor (NS), the Communications Supervisor (CS), and the Network Validation Facility (NVF)F i g u r e 1-2. The I n t e r f a c e s Between t h e N e t u o r k P r o d u c t Elements
4
N e t u o r k Host P r o d u c t s I Communictions
I
T e r m i n a l sI
C o n t r o l ProgramI I
I I
I I
I
I
b
I n f i g u r e 1-2, NAM r e f e r s t o t h e s e t o f programs t h a t implement t h e i n t e r f a c e between t h e a p p l i c a t i o n programs and communications network.
Network h o s t p r o d u c t s s o f w a r e , shown i n t h e L e f t p a r t of f i g u r e 1-2, i n c l u d e s :
Network Access Method
Network D e f i n i t i o n Language P r o c e s s o r Network S u p e r v i s o r
Communications S u p e r v i s o r Network V a l i d a t i o n F a c i l i t y Network u t i l i t i e s
Network Access Method a p p L i c a t i o n programs
NETWORK ACCESS METHOD
The Network Access Method i s t h e c e n t r a l network h o s t p r o d u c t . NAM i n t e r f a c e s between a p p l i c a t i o n s i n t h e same h o s t o r between a p p l i c a t i o n s and t h e Communications C o n t r o l Program.
NAM s o f t w a r e c o n s i s t s of t h r e e i n t e r f a c e programs t h a t p r o v i d e a common way f o r CDC CYBER 170 a p p l i - c a t i o n s t o a c c e s s t h e communications network. NAM r e s o l v e s r e s o u r c e c o n t e n t i o n among a p p l i c a t i o n programs and b u f f e r s d a t a t o r e g u l a t e d a t a f l o w .
Peripheral lnterface Program
The P e r i p h e r a l I n t e r f a c e Program ( P I P ) i s a p e r i p h - e r a l p r o c e s s o r u n i t program t h a t i n t e r f a c e s t h e c e n t r a l p r o c e s s o r e x e c u t e d r o u t i n e s of NAM t o t h e channel-connected l o c a l NPUs
.
PIP moves b l o c k s of d a t a between t h e c e n t r a l memory b u f f e r s of NAM and t h e NPU and r e a d s and w r i t e s d i s k f i l e s used by b a t c h d e v i c e s . PIP a l s o c a n d e t e c t when a l o c a l NPU n e e d s i n i t i a l i z i n g . I f t h e NPU does n o t have system a u t o s t a r t module h a r d w a r e , PIP r e q u e s t s t h e network s u p e r v i s o r t o l o a d t h e b o o t s t r a p program i n t o t h e NPU.
Network lnterface Program
The Network I n t e r f a c e Program (NIP) e x e c u t e s a s a system c o n t r o l p o i n t . NIP c o o r d i n a t e s t h e u s e of t h e communications network by a l l a p p l i c a t i o n pro- g r a m s , b u f f e r s d a t a between t h e a p p l i c a t i o n pro- grams and t h e network, and manages t h e l o g i c a l c o n n e c t i o n s .
The b u f f e r i n g p r o v i d e d by NIP e l i m i n a t e s t h e need f o r a p p l i c a t i o n programs t o have o u t s t a n d i n g b u f f - e r s . Although an a p p l i c a t i o n program i s e x p e c t i n g i n p u t d a t a , t h e a p p l i c a t i o n program c a n be swapped o u t , which r e d u c e s t h e u s e o f h o s t r e s o u r c e s . Each a p p l i c a t i o n program may have s e v e r a l connec- t i o n s ; e a c h c o n n e c t i o n i s a s s o c i a t e d w i t h a t e r m i n a l d e v i c e o r w i t h a n o t h e r a p p l i c a t i o n program. NIP
t r a n s l a t e s between network a d d r e s s e s and t h e more c o n v e n i e n t l o g i c a l a d d r e s s e s t h a t r e p r e s e n t t h e c o n n e c t i o n t o t h e a p p l i c a t i o n . NIP a l s o e s t a b l i s h e s new c o n n e c t i o n s a s t h e y a r e r e q u e s t e d and t e r m i n a t e s c o n n e c t i o n s t h a t a r e no l o n g e r needed o r t h a t have f a i l e d .
An a p p l i c a t i o n may r e q u e s t NAM t o c o n v e r t t h e d a t a on a l o g i c a l c o n n e c t i o n from t h e network f o r m a t . Such c o n v e r s i o n s d e t e r m i n e t h e f o r m a t and e n c o d i n g o f c h a r a c t e r s s e e n by t h e a p p l i c a t i o n .
Application lnterface Program
The A p p l i c a t i o n I n t e r f a c e Program (AIP) i s a s e t of subprograms t h a t r e s - i d e s i n t h e a p p l i c a t i o n pro- gram's f i e l d l e n g t h and p r o v i d e s a p r o c e d u r a l i n t e r f a c e t o t h e c a p a b l i l i t i e s of NIP and t h e network.
P r o c e d u r a l s t a t e , m e n t s a r e p r o v i d e d s o t h a t t h e a p p l i c a t i o n program c a n c o n n e c t t o and d i s c o n n e c t from t h e network. P r o c e d u r a l s t a t e m e n t s a l s o con- t r o l i n f o r m a t i o n exchange between t h e a p p l i c a t i o n program and NAM b u f f ~ e r s . T h i s i n f o r m a t i o n may be d a t a , o r i t may be s u p e r v i s o r y messages t h a t coor- d i n a t e t h e a p p l i c a t i o n ' s e x e c u t i o n w i t h e v e n t s t h a t have o c c u r r e d i n t h e network. NAM may p a s s a s u p e r v i s o r y message t o inform t h e a p p l i c a t i o n of a new c o n n e c t i o n t h a t i s r e q u e s t i n g s e r v i c e , o r t h a t a f a i l u r e h a s o c c u r r e d . I n t h e same way, t h e appl i c a t i o n program u s e s s u p e r v i s o r y messages t o communicate w i t h NAM and t h e network e l e m e n t s .
Queued Terminal Record Manager
Queued T e r m i n a l Record Manager (QTRM) i s a s e t of p r o c e d u r e s t h a t r e s i d e s i n t h e a p p l i c a t i o n program's f i e l d l e n g t h and p r o v i d e s a h i g h l e v e l p r o c e d u r a l i n t e r f a c e t o t h e network. QTRM i s d i s c u s s e d i n a p p e n d i x E of t h i s book.
NETWORK DEFINITION LANGUAGE PROCESSOR
B e f o r e t h e n e t w o r k s o f t w a r e c a n r o u t e d a t a t h r o u g h t h e network and i n t e ~ r f a c e t o o p e r a t o r s f o r s u p e r - v i s i o n , t h e d e f i n i t i o n of t h e network c o n f i g u a t i o n must f i r s t be communicated t o t h e s o f t w a r e . Ttle Network D e f i n i t i o n Language (NDL) i s used t o d e s c r i b e t h i s c o n f i g u r a t i o n . The Network D e f i n i -
t i o n Language p r o c e s s o r (NDLP), a n o f f - l i n e b a t c h u t i l i t y , t r a n s l a t e s t h i s c o n f i g u r a t i o n and p r e p a r e s a network c o n f i g u r a t i o n f i l e (NCF) and a Local c o n f i g u r a t i o n f i l e (LCF).
The NCF c o n t a i n s network conf i g u r a t i o n i n f o r m a t i o n r e q u i r e d by t h e network.
The LCF c o n t a i n s host: i n f o r m a t i o n r e q u i r e d by t h e Network V a l i d a t i o n F a c i l i t y , s u c h a s a u t o m a t i c log- i n p a r a m e t e r s and a p p l i c a t i o n i n f o r m a t i o n . The LCF a l l o w s t h e n e t w o r k v a l i d a t i o n f a c i l i t y t o v a l i d a t e and c o n n e c t t o a p p l i c a t i o n s .
NDL i s d e s c r i b e d i n t'ne Network D e f i n i t i o n Language r e f e r e n c e manual.
NETWORK SUPERVISOR Hardware Performance Analyzer
The Network S u p e r v i s o r (NS), which e x e c u t e s a s a NAM a p p l i c a t i o n , i n t e r f a c e s between t h e NPUs and CCP program f i l e s i n t h e h o s t . NS r e s p o n d s t o r e q u e s t s t o l o a d NPUs w i t h t h e i r s o f t w a r e and s a v e s NPU dumps on h o s t f i l e s .
COMMUNICATION SUPERVISOR
The Communication S u p e r v i s o r (CS) program e x e c u t e s a s a NAM a p p l i c a t i o n . I t i n t e r f a c e s t o t h e network p r o c e s s i n g u n i t o p e r a t o r (NOP). CS a l l o w s a n e t - work o p e r a t o r a t a t e r m i n a l o r h o s t c o n s o l e t o o b t a i n and change t h e s t a t u s of network e l e m e n t s , t o communicate w i t h u s e r s a t t e r m i n a l s , and t o r u n d i a g n o s t i c s . CS a l s o r e s p o n d s t o r e q u e s t s f o r n e t - work c o n f i g u r a t i o n d a t a from a n NPU.
NETWORK VALIDATION FACILITY
T h i s program, which e x e c u t e s a s a NAM a p p l i c a t i o n , v a l i d a t e s t h e t e r m i n a l u s e r ' s a c c e s s t o t h e h o s t and a n a p p l i c a t i o n program's a c c e s s t o t h e computer network. The Network V a l i d a t i o n F a c i l i t y (NVF) a l s o m a i n t a i n s and r e p o r t s a p p l i c a t i o n s t a t u s t o t h e h o s t o p e r a t o r (HOP). A s f i g u r e 1-2 shows, t h e NOS v a l i d a t i o n f i l e and t h e l o c a l c o n f i g u r a t i o n f i l e (LCF) s u p p l y v a l i d a t i o n i n f o r m a t i o n .
NETWORK UTILITIES
Four u t i l i t y programs e i t h e r a r e i n c l u d e d w i t h o r used by network h o s t p r o d u c t s :
The Network Dump Analyzer (NDA) The Load F i l e G e n e r a t o r (LFG) The Debug Log F i l e P r o c e s s o r (DLFP) The Hardware Performance A n a l y z e r (HPA)
Network Dump Analyzer
T h i s h o s t u t i l i t y p r o d u c e s a f o r m a t t e d p r i n t o u t from NPU dump f i l e s c r e a t e d by t h e Network Super- v i s o r . The s i t e a n a l y s t can u s e t h e s e dumps t o h e l p a n a l y z e CCP s o f t w a r e o r NPU hardware f a i l u r e s . The network dump a n a l y z e r u s e s t h e network dump f i l e (NDF), which i s shown i n f i g u r e 1-2, a s i n p u t .
Load File Generator
T h i s h o s t u t i l i t y r e f o r m a t s CCP program f i l e s produced by t h e CDC CYBER C r o s s System's l i n k and e d i t programs i n t o a s i n g l e random a c c e s s f i l e used by t h e Network S u p e r v i s o r t o l o a d NPUs. T h i s f i l e i s t h e network l o a d f i l e (NLF), which i s one of t h e NPU f i l e s shown i n f i g u r e 1-2.
Debug Log File Processor
T h i s h o s t u t i l i t y p r o c e s s e s t h e debug l o g f i l e g e n e r a t e d by t h e A p p l i c a t i o n I n t e r f a c e Program.
A f o u r t h u t i l i t y program, t h e hardware performance a n a l y z e r (HPA), i s p a r t o f t h e NOS o p e r a t i n g s y s t e m . T h i s CYBER u t i l i t y program p r o d u c e s r e p o r t s from
i n f o r m a t i o n on t h e a c c o u n t and e r r o r l o g d a y f i l e s . d Network p r o d u c t s s o f t w a r e makes s t a t i s t i c a l , e r r o r ,
and a l a r m message e n t r i e s i n t o t h e s e d a y f i l e s .
N A M APPLICATION PROGRAMS
The h o s t computer e x e c u t e s CDC-written o r s i t e - w r i t t e n s e r v i c e programs c a l l e d a p p l i c a t i o n pro- grams t h a t a r e c o n n e c t e d t o t h e network t h r o u g h NAM. An a p p l i c a t i o n program c a n communicate w i t h o t h e r a p p l i c a t i o n programs o r t e r m i n a l s c o n n e c t e d t o t h e network.
The CDC-provided NAM a p p l i c a t i o n programs a r e : I n t e r a c t i v e F a c i l i t y ( I A F ) , which a l l o w s you t o c r e a t e f i l e s and t o c r e a t e o r e x e c u t e programs from a d e v i c e w i t h o u t u s i n g c a r d r e a d e r s o r l i n e p r i n t e r s . IAF i s d e s c r i b e d i n Volumes 1 and 3 o f t h e NOS 2 R e f e r e n c e S e t .
Remote B a t c h F a c i l i t y (RBF), which p e r m i t s you t o e n t e r a job f i l e from a remote c a r d r e a d e r and t o r e c e i v e job o u t p u t a t a remote b a t c h d e v i c e . RBF i s d e s c r i b e d i n t h e Remote Batch F a c i l i t y r e f e r e n c e manual.
T r a n s a c t i o n F a c i l i t y (TAF), which p e r m i t s you t o implement o n - l i n e t r a n s a c t i o n p r o c e s s i n g under NOS by w r i t i n g programs t o u s e t e r m i n a l s . TAF i s d e s c r i b e d i n t h e TAF r e f e r e n c e manual.
T e r m i n a l V e r i f i c a t i o n F a c i l i t y (TVF), which p r o v i d e s t e s t s you c a n u s e t o v e r i f y t h a t a n i n t e r a c t i v e c o n s o l e i s s e n d i n g and r e c e i v i n g d a t a c o r r e c t l y . TVF i s d i s c u s s e d i n t h e Ter- m i n a l I n t e r f a c e Guide.
Message C o n t r o l System (MCS), which a l l o w s you t o queue, r o u t e , and j o u r n a l messages between COBOL programs and t e r m i n a l s . MCS is d e s c r i b e d i n t h e Message C o n t r o l System r e f e r e n c e manual.
NETWORK PROCESSING UNIT
AND COMMUNICATIONS CONTROL PROGRAM
T h i s s u b s e c t i o n d i s c u s s e s t h e f o l l o w i n g network p r o d u c t s , which a r e p a r t o f t h e communications network and a l l o w a t e r m i n a l t o a c c e s s t h e h o s t computer o v e r communication l i n e s :
The 255x S e r i e s Network P r o c e s s i n g U n i t (NPU), which c o n n e c t s a h o s t t o a t e r m i n a l
The Communications C o n t r o l Program (CCP), which i s t h e s o f t w a r e i n t h e NPU
The CDC CYBER C r o s s System, which s u p p o r t s i n s t a l l i n g , m a i n t a i n i n g , and m o d i f y i n g CCP The m i d d l e p o r t i o n of f i g u r e 1-2 shows t h e communi- c a t i o n s network.
NETWORK PROCESSING UNIT
An NPU h a n d l e s f r o n t - e n d o r r e m o t e d a t a communica- t i o n s f o r t h e CDC CYBER 170 h o s t . The Communica- t i o n s C o n t r o l Program r e s i d e s w i t h i n t h e NPU.
To u n d e r s t a n d CCP, you must h a v e a b a s i c u n d e r - s t a n d i n g of t h e h a r d w a r e on w h i c h CCP r u n s . R e f e r t o t h e h a r d w a r e m a n u a l s l i s t e d i n t h e p r e f a c e f o r a d e s c r i p t i o n o f t h e h a r d w a r e components of t h e NPU.
COMMUNICATIONS CONTROL PROGRAM
The Communications C o n t r o l P r o g r a m , which i s t h e s o f t w a r e t h a t e x e c u t e s i n t h e 255x NPUs, c o n s i s t s o f :
Base s y s t e m s o f t w a r e S e r v i c e Module
Host I n t e r f a c e Program T e r m i n a l I n t e r f a c e P r o g r a m s L i n k I n t e r f a c e Program B l o c k I n t e r f a c e Program
I n - l i n e and o n - l i n e d i a g n o s t i c s C o n s o l e d e b u g g i n g a i d s
P e r f o r m a n c e and s t a t i s t i c s p r o g r a m s
F i g u r e 1-3 shows how t h e m a j o r p a r t s o f CCP r e l a t e t o e a c h o t h e r .
Base System Software
The b a s e s y s t e m s o f t w a r e e x e c u t e s p r o g r a m s , a l l o - c a t e s b u f f e r s , h a n d l e s i n t e r r u p t s , and s u p p o r t s t i m i n g a n d d a t a s t r u c t u r e s . It i n c l u d e s :
A s y s t e m m o n i t o r , which c o n t r o l s t h e a 1 Locat i o n of r e s o u r c e s f o r t h e c o m m u n i c a t i o n s p r o c e s s o r Timing s e r v i c e s , which r u n t h o s e p r o g r a m s o r f u n c t i o n s t h a t a r e e x e c u t e d e i t h e r p e r i o d i c a l l y o r f o l l o w i n g a s p e c i f i c t i m e Lapse f o r t h e p r o c e s s o r
A m u l t i p l e x s u b s y s t e m , w h i c h i n t e r f a c e s w i t h t h e m u l t i p l e x h a r d w a r e and p e r f o r m s c h a r a c t e r by c h a r a c t e r p r o c e s s i n g of t a s k s
I n t e r r u p t h a n d l e r , w h i c h c o n t r o l s t h e t r a n s i - Lion o f t h e c o m m u n i c a t i o n s p r o c e s s o r b e t w e e n d i f f r r e a t program i n t e r r u p t l e v e l s
I n i t i a l i z a t i o n , which p r e p a r e s t h e n e t w o r k f o r a n - l i n e o p e r a t i o n
S t r u c t u r e s e r v i c e s , w h i c h b u i l d and m a i n t a i n i n t e r n a l t a h L e s used f o r r o u t i n g d a t a
R u f f e r main1 e n a n c e , w h i c h d y n a m i c a l l y a l l o c a t e s memory i n m u l t i p l e b u f f e r s i z e s f o r e f f i c i e n t memory u s e
s l o r l c l i s t s e r v i c e s , which p r o v i d e l o g i c f o r 255x i n t e r p r o g r a m c o m m u n i c a t i o n t h r o u g h t h e u s e of w o r k l i s t s
S t a n d a r d s u b r o u t i n t ~ s , which p r o v i d e s u p p o r t r o u t i n e s t o h a n d l e a r i t l l m e t i c c o n v e r s i o n , main- t a i n p a g e r e g i s t e r s , and d o m i s c e l l a n e o u s t a s k s
T e r m i n a l s
F i g u r e 1-3. The R e l a t i o n s h i p Between t h e P a r t s o f t h e Communications C o n t r o l Program
Service Module Console Debugging Aids The Service Module (SVM) includes network control
functions and interface programs that provide a common link to other elements of the communications network. These programs:
Process service messages
Control line and terminal configuration
Report and respond to regulation and supervision changes
Host lnterface Program
The Host Interface Program (HIP) provides the soft- ware that links the host and a local NPU over a channel. The HIP drives the CDC CYBER Channel Coupler, transfers data, checks for errors, and monitors for host failure and recovery.
Terminal lnterface Program
The Terminal Interface Program (TIP) is a modular program that provides protocol support and the con- trol needed to interchange data between a terminal and other elements of CCP. CDC provides TIPs for asynchronous, X.25, mode
4,
bisynchronous, and HASP terminals. Non-CDC TIPs may be written to support specific site requirements. Section7
discusses TIP details.Link lnterface Program
The Link Interface Program (LIP) transfers informa- tion over a trunk between NPUs.
Block lnterface Program
The Block Interface Program (BIP) routes blocks of data, processes service messages, and processes the network block protocol.
In-line and On-line Diagnostics
In-line and on-line diagnostics, which are produced For the NPU, enable a NOP to isolate communications line problems. Alarm, CE error, and statistics service messages are the types of in-line diag- nostics. In-line diagnostics are generated auto- matically. On-line diagnostics must be requested from the NOP console.
Debug aids provide test utilities for debugging programs, taking memory snapshots, and dumping the NPU during program development or system failures.
Performance and Statistics Programs
These programs gather statistics on NPU and indi- vidual line performance, and periodically dispatch theses statistics to the Communications Supervisor.
CDC CYBER CROSS SYSTEM SOFTWARE
The CDC CYBER Cross System software allows you to install, modify, and maintain the CCP software. It is composed of these programs:
PASCAL, which is a high level compiler patterned after ALGOL-60. By using PASCAL, you can define tasks in statements that are processed by the compiler to yield a variable number of actual program instructions.
Formatter, which reformats PASCAL output into an object code format compatible with the com- munications processor macro assembler output Macro Assembler, which assembles communications processor macro level source programs and produces relocatable binary output. The source programs are written with symbolic machine, pseudo, and macro instructions.
Micro Assembler, which provides the language needed to write a micro program. This assembler translates symbolic source program instructions into object machine instructions.
Link Editor, which accepts object program modules and generates a memory image, suitable for executing in the 255x NPU.
Autolink Utility, which simpliflcs program assignment and maximizes the m o u n t of space assigned to handling buffers.
Expand Utility, which inclildes several hardware and software variables used to define a CCP load file for a given NPU configuration.
See the preface for manuals that contain more information on the CDC CYBER Cross System.