O n a 3 2 7 0 c o m m u n i c a t i o n l i n e , a d e v i c e d e fi n i t i o n i s d i f f e r e n t f r o m a t e r m i n a l d e fi n i t i o n . A 3 2 7 0 terminal consists of one or more devices; terminal and device are not synonymous.
You must provide one TERMDEV or DEVICE statement f o r e a c h d e v i c e t h a t a c c e s s e s t h e c o m m u n i c a t i o n l i n e t h r o u g h t h e t e r m i n a l y o u a r e d e fi n i n g . I f y o u use a TERMDEV statement, you cannot use a DEVICE statement for the same terminal. Figures 6-14 and 6 - 1 5 p r e s e n t t h e f o r m a t s o f t h e s e s t a t e m e n t s f o r terminals on 3270 protocol lines.
For each terminal you define, you can declare up to 32 DEVICE statements. 3270 terminals can have up to 32 DEVICE statements for CDC-defined console d e v i c e s o r u p t o 7 D E V I C E s t a t e m e n t s f o r
CDC-defined line printer devices.
T h e f o l l o w i n g T E R M I N A L a n d D E V I C E p a r a m e t e r s p r o v i d e d e v i c e d e fi n i t i o n s f o r t h e t e r m i n a l :
ABL DBL LK TA
AUTOCON DBZ PG UBL
Bl DI PL UBZ
B2 DT PRI
CN HD PW
CT HN SDT
For console devices:
device: DEvlCEC,DT=C0N,TA=^rmaddr,ABL=abl,DBZ=dwnLsiz,iJBZ=upbsize,DBL=dwnblim,3 CUBL=upblim,AUT0C0N C=yn13,PRIC=yn23,DIC=yn33,HN=node,HD C=yn43,3
CLK=yn5,B1=b1,B2=b2,CN=cn,CT=ct,PG=pg,PL=pl,PW=pw3.
F o r l i n e p r i n t e r s :
device: DEVICE,DT=LPC,SDT=subdt,TA=trmaddr,DBZ=dwnlsiz,DBL=dwnblim,UBL=upblim,3 CPRIC=yn13,DIC=yn23,PW=pw3.
For site-defined devices:
device: DEVICE,DT=DTl2C,SDT=subdt,TA=trmaddr,ABL=abl,DBZ=dwnlsiz,UBZ-upbsize,3 CDBL=dwnblim,UBL=upblim,AUT0C0N C=yn13,PRIC=yn23,DIC=yn33,3
CHN=node,HDC=yn43,LK=yn5,Bl=b1,B2=b2,CN=cn,CT=ct,PG=pg,PL=pl,PU=pw3.
device The element name of the terminal device being defined. This name can be one through seven characters long; the first character must be a letter, the other characters can be letters or digits. If this statement is used within the set following a GROUP statement, the device name cannot be longer than five characters. This is the name used by the host or NPU operator to monitor and control the device. This name is required; there is no d e f a u l t v a l u e .
All other parameters are described in the text.
<*&«*SgS.
Figure 6-15. DEVICE Statement Format for Communication Lines of TIPTYPE=3270
6-42 60480000 N
T h e D T p a r a m e t e r i s d e s c r i b e d fi r s t b e c a u s e i t a f f e c t s t h e v a l i d i t y, r a n g e s , a n d d e f a u l t s o f t h e o t h e r p a r a m e t e r s . T h e o t h e r p a r a m e t e r s a r e described in alphabetical order.
DT PARAMETER
T h e D T p a r a m e t e r s p e c i fi e s t h e d e v i c e t y p e b e i n g d e fi n e d . Yo u c a n d e c l a r e e i t h e r a C D C - d e fi n e d device type or a site-defined device type.
If you specify a CDC-defined device type, the other d e v i c e d e fi n i t i o n p a r a m e t e r s o n t h e D E V I C E o r TERMDEV statement:
A r e r e q u i r e d b y t h e N D L p r o c e s s o r w h e r e i n d i c a t e d i n t h e t e x t
Have the predefined default shown in the text Have the predefined ranges shown in the text Are checked for uniqueness and compatibility I f y o u s p e c i f y a s i t e - d e fi n e d d e v i c e t y p e , t h e o t h e r d e v i c e d e fi n i t i o n p a r a m e t e r s o n t h e D E V I C E statement:
Are not required by the NDL processor Have no predefined default
Are not checked for uniqueness
A r e n o t c h e c k e d f o r c o m p a t i b i l i t y w i t h o t h e r parameters on the same statement
W h e n y o u s p e c i f y t h e D T p a r a m e t e r, t h e f o l l o w i n g values are valid:
C O N I d e n t i fi e s a C D C - d e fi n e d c o n s o l e d e v i c e . L P I d e n t i fi e s a C D C - d e fi n e d l i n e p r i n t e r
d e v i c e .
D T 1 2 I d e n t i fi e s a s i t e - d e fi n e d d e v i c e w i t h n o p r e d e fi n e d c h a r a c t e r i s t i c s , u s i n g the device type number 12 within NAM.
If you omit the DT parameter, the value of CON is used.
ABL PARAMETER
T h e a p p l i c a t i o n b l o c k l i m i t ( A B L ) p a r a m e t e r specifies the number of downline blocks that can be outstanding (unacknowledged) between an application p r o g r a m a n d t h i s t e r m i n a l . T h e v a l u e y o u c h o o s e s h o u l d k e e p t h e t e r m i n a l b u s y f o r 2 s e c o n d s b y m a i n t a i n i n g t h a t n u m b e r o f o u t s t a n d i n g b l o c k s o f
the size specified by the DBZ parameter.
T h i s p a r a m e t e r i s o p t i o n a l ; i t i s a l l o w e d o n l y f o r console devices or site-defined devices (DT of CON o r D T o f D T 1 2 ) . T h e A B L p a r a m e t e r h a s t h e following range of values:
1 < abl < 7
T h e v a l u e y o u d e c l a r e s h o u l d b e g r e a t e r t h a n o r e q u a l t o t h e d o w n l i n e b l o c k l i m i t ( D B L p a r a m e t e r value) of the terminal. Maximum line usage can be o b t a i n e d b y s e t t i n g b o t h D B Z a n d D B L s o t h a t 1 second of data is queued by CCP.
For console devices (DT of CON), the host queues a b l - d b l b l o c k s ; t h e N P U q u e u e s d b l b l o c k s . A n A B L v a l u e s i g n i fi c a n t l y l a r g e r t h a n t h e D B L v a l u e causes NAM to use more host memory but can reduce t h e n u m b e r o f t i m e s a n a p p l i c a t i o n p r o g r a m i s r o l l e d o u t .
T h e d e f a u l t v a l u e f o r t h i s p a r a m e t e r i s 2 ( D T o f CON only).
AUTOCON PARAMETER
The AUTOCON parameter is a stand-alone keyword that determines whether CCP should automatically connect the console device and any associated batch devices t o t h e s e l e c t e d h o s t n o d e . T h i s p a r a m e t e r i s v a l i d only for console devices.
I f a l l l o g i c a l l i n k s t e r m i n a t i n g i n t h e N P U b e i n g defined are to the same host (all HNAME values are e q u a l ) , a n d t h e N D L p r o c e s s o r p r o v i d e s a d e f a u l t host node, then the NDL processor also sets AUTOCON unless AUT0C0N=N0 is specified.
T h i s p a r a m e t e r a n d i t s v a l u e s a r e o p t i o n a l . Yo u c a n s p e c i f y e i t h e r o f t h e f o l l o w i n g v a l u e s :
NO I n d i c a t e s t h a t C C P d o e s n o t a t t e m p t automatic connection.
Y E S I n d i c a t e s t h a t C C P a t t e m p t s a u t o m a t i c c o n n e c t i o n .
I f y o u o m i t t h e A U T O C O N p a r a m e t e r, t h e d e f a u l t v a l u e o f N O i s u s e d f o r a D T o f C O N . I f y o u s p e c i f y t h i s p a r a m e t e r w i t h o u t a v a l u e , t h e v a l u e of YES is used.
Bl PARAMETER
The Bl parameter specifies the character to be used a s a u s e r b r e a k 1 i n d i c a t o r . W h e n t h e t e r m i n a l user enters this character as the only character on a l i n e , C C P d i s c a r d s t h e b l o c k o f d a t a b e i n g transmitted to the terminal and sends a user break 1 m e s s a g e u p l i n e t o t h e c o n n e c t e d a p p l i c a t i o n program.
T h e e f f e c t t h i s p a r a m e t e r h a s d e p e n d s o n t h e a p p l i c a t i o n p r o g r a m . F o r e x a m p l e , I A F i n t e r p r e t s t h e u s e r b r e a k 1 m e s s a g e a s a j o b s t e p i n t e r r u p t from the terminal user.
T h i s p a r a m e t e r i s o p t i o n a l ; i t i s a l l o w e d o n l y f o r d e v i c e s o f D T = C O N o r D T = D T 1 2 . I f y o u s p e c i f y a value, it must be either the reserved word CCP or a h e x a d e c i m a l v a l u e f o r t h e 7 - b i t A S C I I c o d e t h a t r e p r e s e n t s t h e c h a r a c t e r t o b e u s e d ( t a b l e A - 2 i n a p p e n d i x A l i s t s a l l o f t h e c o d e s i n t h e 7 - b i t ASCII code set).
60480000 N 6-43
You cannot use any of the following values: message upline to the connected application program.
The effect this parameter has depends on the appli
the last message transmitted from the terminal.
T h i s p a r a m e t e r i s o p t i o n a l ; i t i s a l l o w e d o n l y f o r
0f°?\ terminal definition commands to determine or change t h e v a l u e s y o u h a v e e s t a b l i s h e d f o r t h e f o l l o w i n g
The downline block limit (DBL) parameter specifies t h e n u m b e r o f d o w n l i n e b l o c k s t h a t c a n b e o u t standing (unacknowledged) between the host computer and this terminal. The value you choose determines how many blocks of data the NPU queues from the total number of outstanding blocks (ABL parameter value) of the size specified by the DBZ parameter.
DI PARAMETER each downline message. CCP calculates the length of a page from the current values of the page width
6-46 60480000 N
/0^\
and page length (see PW and PL Parameter descrip t i o n s ) . I f t h e p a g e w i d t h i s i n fi n i t e ( P W = 0 ) , a page consists of one line less than the number of l o g i c a l l i n e s s p e c i fi e d a s t h e p a g e l e n g t h . I f t h e page width is finite (PW is nonzero), a page con sists of one line less than the number of physical lines specified by the page length; CCP calculates t h e n u m b e r o f p h y s i c a l l i n e s b y d i v i d i n g e a c h l o g i c a l l i n e i n t o u n i t s l e s s t h a n o r e q u a l t o t h e page width.
I f y o u o m i t t h i s p a r a m e t e r o r s p e c i f y a v a l u e o f CCP, a default value is used (DT of CON only). The d e f a u l t v a l u e i s 2 4 . T h e d e f a u l t v a l u e f o r D T o f
LP is 64.
T h e v a l u e o f t h i s p a r a m e t e r r e v e r t s t o t h e d e f a u l t value when the terminal class is changed from the console or changed by the application program. The terminal user or the application program can change any value that you specify.
T h i s p a r a m e t e r i s o p t i o n a l ; i t i s a l l o w e d o n l y f o r console devices and site-defined devices (DT of CON or DT of DT12). If you specify this parameter, you must use one of the following reserved values:
C C P I n d i c a t e s t h a t C C P u s e s t h e d e f a u l t s e t t i n g a p p r o p r i a t e f o r t h e t e r m i n a l c l a s s ; u s i n g t h i s p a r a m e t e r i s e q u i v alent to omitting the parameter.
N O I n d i c a t e s t h a t p a g e w a i t i n g d o e s n o t o c c u r.
Y E S I n d i c a t e s t h a t p a g e w a i t i n g o c c u r s . When you specify PG=YES, you should also specify a
n o n z e r o v a l u e f o r t h e P L p a r a m e t e r. C C P c a n n o t p e r f o r m p a g e w a i t i n g a t t h e b o u n d a r i e s o f I n fi n i t e l y l o n g p a g e s ( P L = 0 ) .
PRI PARAMETER
T h e P R I p a r a m e t e r i s a s t a n d - a l o n e k e y w o r d t h a t i n d i c a t e s w h e t h e r d a t a t o o r f r o m t h e d e v i c e i s t o h a v e t r a f fi c p r i o r i t y o v e r t h a t t o o r f r o m o t h e r d e v i c e s i n t h e n e t w o r k . D a t a t o o r f r o m a d e v i c e t h a t d o e s n o t h a v e t r a f fi c p r i o r i t y i s s u s p e n d e d t o r e l i e v e n e t w o r k c o n g e s t i o n b e f o r e d a t a t o o r f r o m t e r m i n a l s w i t h t r a f fi c p r i o r i t y i s s u s p e n d e d . I n t e r a c t i v e d e v i c e s s h o u l d u s u a l l y b e g i v e n t r a f fi c p r i o r i t y o v e r b a t c h d e v i c e s .
T h i s p a r a m e t e r i s o p t i o n a l . I f y o u s p e c i f y t h e P R I parameter, you must use one of the following values:
N O I n d i c a t e s t h a t t h e d e v i c e d o e s n o t h a v e d a t a t r a f fi c p r i o r i t y .
Y E S I n d i c a t e s t h a t t h e d e v i c e h a s d a t a t r a f fi c p r i o r i t y .
If you omit the PG parameter or specify a value of CCP, the default value of YES is used.
Th e va lue o f th i s p a ram eter r ev erts to the defaul t value when the terminal class is changed from the console or changed by the application program. The application program or the terminal user can change any value that you specify.
PL PARAMETER
The PL parameter specifies the number of physical l i n e s p e r p a g e o f o u t p u t f o r t h e d e v i c e . I f t h e d e v i c e i s c o n fi g u r e d f o r p a g e w a i t i n g ( P G p a r a m eter) , any message containing more lines of output
t h a n t h e p a g e l e n g t h i s i n t e r r u p t e d b y C C P f o r a page waiting response from the terminal user. The
i n t e r r u p t i o n o c c u r s a f t e r l i n e p i - 1 i s o u t p u t .
I f y o u d e c l a r e t h i s p a r a m e t e r w i t h o u t a v a l u e , t h e v a l u e o f Y E S i s u s e d . I f y o u o m i t t h i s p a r a m e t e r, the default value of NO is used.
PW PARAMETER
The PW parameter defines the number of characters p e r p h y s i c a l l i n e o f i n p u t o r o u t p u t f o r t h i s d e v i c e . T h i s p h y s i c a l l i n e l e n g t h i s a l s o c a l l e d
the page width.
F o r c o n s o l e d e v i c e s , o u t p u t l i n e s l o n g e r t h a n p w characters are not divided but are counted as more t h a n o n e l i n e f o r p a g e w i d t h c a l c u l a t i o n s . I f t h e P W v a l u e f o r t h e d e v i c e i s i n a p p r o p r i a t e , l o s s o f v i s u a l fi d e l i t y c a n o c c u r ; t h e a p p l i c a t i o n p r o g r a m m i g h t d i v i d e t h e d a t a i n t o l i n e s t h a t a r e t o o s h o r t o r t o o l o n g f o r t h e s c r e e n ' s c a p a c i t y, i n s t e a d o f allowing the terminal to wrap lines when needed.
T h i s p a r a m e t e r i s o p t i o n a l ; i t i s a l l o w e d f o r c o n -I s o l e d e v i c e s , r e m o t e b a t c h l i n e p r i n t e r s , a n dsite-defined devices only (DT of CON, DT of LP, or DT of DT12). If you specify the PL parameter, you must use one of the following values:
CCP
I n d i c a t e s t h a t C C P u s e s t h e d e f a u l t v a l u e a p p r o p r i a t e f o r t h e t e r m i n a l c l a s s ; u s i n g t h i s v a l u e i s e q u i v a l e n t t o o m i t t i n g t h e parameter.
8 £ pi £ 255
I n d i c a t e s t h e n u m b e r o f p h y s i c a l l i n e s p e r page.
T h i s p a r a m e t e r i s o p t i o n a l . I f y o u s p e c i f y t h e P W p a r a m e t e r, t h e v a l u e y o u c a n u s e d e p e n d s o n t h e d e v i c e t y p e . T h e f o l l o w i n g v a l u e s a r e a l l o w e d f o r console devices (DT of CON):
CCP
I n d i c a t e s t h a t C C P u s e s t h e d e f a u l t v a l u e a p p r o p r i a t e f o r t h e t e r m i n a l c l a s s ; u s i n g t h i s v a l u e i s e q u i v a l e n t t o o m i t t i n g t h e parameter.
20 £ pw £ 255
I n d i c a t e s t h a t t h e d e v i c e c a n s u p p o r t p h y s i c a l l i n e s n o l o n g e r t h a n t h e i n d i c a t e d decimal value.
60480000 N 6-47
T h e f o l l o w i n g v a l u e s a r e a l l o w e d f o r l i n e p r i n t e r cation program. The application program can change any value you specify for any device; the terminal
/ 0 ^ \
You should choose a value that is larger than the maximum number of logical lines the terminal user c a n e n t e r b e f o r e o u t p u t f r o m t h e a p p l i c a t i o n p r o g r a m i n t h e h o s t m u s t o c c u r. A fi x e d n u m b e r o f input messages might have significance to an appli c a t i o n p r o g r a m . I f s u c h a n a p p l i c a t i o n d o e s n o t perform output until receiving that number of input messages and if you choose a UBL value smaller than this number, the application program becomes dead l o c k e d ( i t w a i t s f o r b l o c k s o f d a t a t h a t C C P i s forced to discard because the block limit has been r e a c h e d f o r u p l i n e q u e u i n g ) . I f t h e d e v i c e m u s t r e c e i v e o u t p u t b e f o r e i t c a n b e g i n a d d i t i o n a l input, the device also becomes deadlocked by this s i t u a t i o n .
This parameter is optional. The UBL parameter has the following range of values:
1 < ubl < 31
I f y o u o m i t t h e U B L p a r a m e t e r, a d e f a u l t v a l u e i s used. The default value is 7.
T h e v a l u e y o u s p e c i f y c a n b e c h a n g e d b y t h e application program for consoles.
UBZ PARAMETER
The upline block size (UBZ) parameter specifies the maximum number of character bytes each upline block c a n c o n t a i n . C C P d i v i d e s e a c h m e s s a g e f r o m t h e t e r m i n a l i n t o b l o c k s o f t h e s i z e y o u c h o o s e . T h e size you choose affects how much memory is needed to store the outstanding (unacknowledged) blocks of data In the NPU and the host.
You should choose a value that allows most of the l o g i c a l l i n e s e n t e r e d b y t h e d e v i c e t o fi t i n t o a single block so that messages need not be divided i n t o m u l t i p l e n e t w o r k b l o c k s . Yo u s h o u l d a l s o choos e a va l u e th a t ca n be effi ci e ntl y mani pul ated by the host application program.
T h i s p a r a m e t e r i s o p t i o n a l ; i t i s a l l o w e d o n l y f o r console devices or site-defined devices (DT of CON or DT of DT12). The UBZ parameter has the follow ing range of values for console devices (DT of CON):
0 < ubz < 2000
The range for site-defined devices (DT of DT12) is:
0 < ubz < 2043
If you specify 0 for a console device, CCP sends an upline block whenever it receives 100 characters.
T h e v a l u e y o u d e c l a r e s h o u l d b e c h o s e n t o g e t h e r with the value used for the UBL parameter. The NDL processor rounds the value you supply to the next m u l t i p l e o f 1 0 0 b y t e s . F o r c o n s o l e d e v i c e s ( D T o f CON), rounding occurs as follows:
Value Supplied 0
1 £ ubz £ 100 101 < ubz < 200
1901 < ubz < 2000
Value Used i n F i l e 0
100 200
2000
The NDL processor issues an informative message if it adjusts the UBZ value that you specify.
I f y o u o m i t t h e U B Z p a r a m e t e r, a d e f a u l t v a l u e i s used. The default is 100 (DT of of CON only). The d e f a u l t o p t i m i z e s u s e o f t h e d e f a u l t v a l u e f o r t h e U B L p a r a m e t e r . T h e d e f a u l t v a l u e I s t h e
recommended value.
For the Message Control System (MCS), the upline I b l o c k s i z e m u s t b e s e t t o 0 . | The application program can change any value you s p e c i f y. T h e t e r m i n a l u s e r c a n c h a n g e t h e v a l u e w i t h i n t h e f o l l o w i n g r a n g e :
0 < ubz < 200