CHANGING DEVICE CHARACTERISTICS

visory messages described in the next subsections.

I n f o r m a t i o n o n t h e u s e o f t h e s e c h a r a c t e r i s t i c s a p p e a r s i n t h e N A M 1 / C C P 3 Te r m i n a l I n t e r f a c e s

reference manual listed in the preface.

T h e p r o c e s s o f c o n fi g u r i n g a t e r m i n a l c o n s i s t s o f d e fi n i n g a n u m b e r o f d e v i c e c h a r a c t e r i s t i c s t h a t t h e n e t w o r k s o f t w a r e s h o u l d u s e i n c o m m u n i c a t i o n w i t h a t e r m i n a l . S o m e d e v i c e c h a r a c t e r i s t i c s c a n b e g i v e n d e f a u l t v a l u e s b y t h e C o m m u n i c a t i o n s Control Program (CCP), while others can be provided by the Network Definition Language (NDL) and the s i t e a d m i n i s t r a t o r.

O n c e a d e v i c e i s c o n fi g u r e d ( o r d e fi n e d ) , s u b s e q u e n t c h a n g e s t o t h e d e v i c e d e fi n i t i o n c a n b e m a d e v i a t e r m i n a l d e fi n i t i o n c o m m a n d s f r o m t h e terminal operator, or via supervisory messages from t h e a p p l i c a t i o n p r o g r a m t o w h i c h t h e d e v i c e i s connected.

This subsection describes the supervisory messages that the application can use to change the settings of device characteristics. The supervisory message u s e d t o fi n d o u t t h e c u r r e n t v a l u e s o f d e v i c e c h a r a c t e r i s t i c s i s d e s c r i b e d i n t h e f o l l o w i n g s u b

s e c t i o n , R e q u e s t i n g D e v i c e C h a r a c t e r i s t i c s . Te r minal definition commands are described in the NAM

1/CCP 3 Terminal Interfaces reference manual listed in the preface.

F i g u r e 3 - 4 5 s h o w s t h e m o s t p r o b a b l e m e s s a g e sequences involved in changing terminal character i s t i c s .

The application program is advised of the terminal d e fi n i t i o n c o m m a n d e n t r y e x p l i c i t l y o n l y w h e n t h e command changes one of three device characteristics:

Te r m i n a l c l a s s ( v a l u e d e s c r i b i n g t h e p h y s i c a l attr i bu tes of a g ro up of s i mi l a r terminals) P a g e w i d t h ( v a l u e d e s c r i b i n g t h e n u m b e r o f characters in each physical line of output) P a g e l e n g t h ( v a l u e d e s c r i b i n g t h e n u m b e r o f physical lines output per page)

T h e u p l 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 - r e d e fi n e d supervisory message is an asynchronous one, with t h e f o r m a t s h o w n i n fi g u r e 3 - 4 6 . T h i s m e s s a g e i s s e n t t o t h e a p p l i c a t i o n b y N A M w h e n e v e r N A M i s n o t i fi e d t h a t o n e o f t h e t h r e e d e v i c e c h a r a c t e r istics has been redefined by a terminal user or by t h e a p p l i c a t i o n p r o g r a m . T h e e f f e c t o f t h e t e r m i n a l d e fi n i t i o n c o m m a n d c a u s i n g t h i s m e s s a g e i s

i m m e d i a t e , a n d n o r e s p o n s e i s r e q u i r e d f r o m t h e application program.

/^P^V.

A p p l i c a t i o n N A M Message

The terminal operator enters the TC, PW, or PL commands to the Terminal Interface Progran.

TCH/TCHAR/R

The next block sent to the device or from the device is affected by any constraints imposed under the new device page width, page Length, or terminal class.

A p p l i c a t i o n N A M T I P M e s s a g e

The application program changes a device characteristic other than page width, page l e n g t h , o r t e r m i n a l c l a s s .

CTRL/DEF/R

The next block sent to the device or sent from the device is affected by any constraints imposed under the new device characteristic.

A p p l i c a t i o n N A M T I P M e s s a g e

The application program changes page width, page length, or terminal class.

▶ C T R L / D E F / R TCH/TCHAR/R

The next block sent to the device or sent from the device is affected by any constraints imposed under the new page width, page length, or terminal class.

Figure 3-45. Terminal Characteristics Redefinition Supervisory Message Sequences (Sheet 1 of 2)

60499500 R 3-45

Application

NAM

_Message

The application sends a define-multiple-terminal-characteristics message to NAM in order to redefine several of the terminal characteristics with a single message. The message

is properly formatted and the new characteristics take effect immediately. NAM replies with a define-terminal-characteristics normal response.

Application

NAM

CTRL/CHAR/R CTRL/CHAR/N

Message

The application sends a define-terminal-characteristics message to NAM, but one of the FN/FV pairs is bad. The changes do not take effect, and a

define-terminal-characteristics abnormal response is sent to the application.

CTRL/CHAR/R CTRL/CHAR/A

Figure 3-45. Terminal Characteristics Redefinition Supervisory Message Sequences (Sheet 2 of 2)

ta

ta tch

tchar

tclass

59 51 49 43 35 23 15

tch

tchar unused

acn

tclass

pw Pi

Symbolic address of the application program's text area receiving this asynchronous super visory message.

Primary function code 64-|0. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol TCH.

Secondary function code 0. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol TCHAR.

Application connection number assigned by the network software to this end of the logical con nection for which the change occurred. This field always contains a value previously used by the application program in an FC/INIT/N message. You can access this field with the reserved symbol CONACN, as described in section 4.

The terminal class currently associated with the real device by the TIP servicing it. The terminal class determines the parameters and ranges valid for redefinition of the device. The device is serviced by the TIP according to the attributes associated with the terminal class (see text). The tclass field can contain the values:

0 Reserved for CDC use.

1 Archetype terminal for the class is a Teletype Corporation Model 30 Series.

2 Archetype terminal for the class is a CDC 713-10, 751-1, 752, 756.

3 Archetype terminal for the class is a CDC 721.

4 Archetype terminal for the class is an IBM 2741.

5 Archetype terminal for the class is a Teletype Corporation Model 40-2.

6 Archetype terminal for the class is a Hazeltine 2000, operating as a teletypewriter.

7 Archetype terminal for the class is a VT100 (ANSI X3.64).

Figure 3-46. Terminal-Characteristics-Redefined (TCH/TCHAR/R) Supervisory Message Format (Sheet 1 of 2)

3-46 60499500 R

Archetype terminal for the

teletypewriter. class

is

a Tektronix 4000 Series, operating as a

9

Archetype terminal for the

workstation. class

is

a HASP (post-print) protocol multileaving

10

Archetype terminal for the class

is

a CDC 200 User Terminal.

11

Archetype terminal for the class

is

a CDC 714-30.

12

Archetype terminal for the class

is

a CDC 711-10.

13

Archetype terminal for the class

is

a CDC 714-10/20.

14

Archetype terminal for the

station. class

is

a HASP (pre-print) protocol multileaving

work-/ ^ ^ \

p i

15 16 17 18 19 t h r u 27 28 t h r u 31

Archetype terminal for the class is a CDC 734.

Archetype terminal for the class is an IBM 2780.

Archetype terminal for the class is an IBM 3780.

Archetype terminal for the class is an IBM 3270.

Reserved for CDC use.

S i t e - d e fi n e d t e r m i n a l c l a s s .

If the terminal class value received has not changed from that previously associated with the device, then the value in either the pw or pi fields (or both) has usually changed. If the terminal class value received has changed from that previously associated with the device, then all attributes associated with the device have been changed to the default attributes for the new terminal class; the values in the pw and pi fields might have changed from those previously associated with the real device. You can access this field with the reserved symbol TCHTCL, as described in section 4.

The most recently declared page width of the console device, specifying the number of characters in a physical line of output. This field can contain the values 0 or 20 £ pw £ 255. You can access this field with the reserved symbol TCHPW, as described in section 4.

The most recently declared page length of the console device, specifying the number of physical lines that constitute a page. This field can contain the values 0 or 8 < pi < 255.

You can access this field with the reserved symbol TCHPL, as described in section 4.

Figure 3-46. Terminal-Characteristics-Redefined (TCH/TCHAR/R) Supervisory Message Format (Sheet 2 of 2)

T h e r e a r e t w o d i f f e r e n t f o r m a t s f o r c h a n g 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 . R e g a r d l e s s o f t h e f o r m a t used, terminal class should only be changed before other changes are made. A change in terminal class resets many other characteristics.

T h e d e fi 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 s u p e r v i s o r y m e s s a g e ( fi g u r e 3 - 4 7 ) s p e c i fi e s t e r m i n a l c h a r a c teristic commands as a string of ASCII characters.

I f t h e r e i s a n e r r o r i n o n e o f t h e c o m m a n d s , t h e TIP stops processing the message, no indication is sent to the application, and any commands prior to t h e e r r o r a r e p r o c e s s e d . T h e r e i s n o r e s p o n s e t o this message.

T h e d e fi 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 8 m e s s a g e is described in figure 3-48. This message specifies a s t r i n g o f p a i r s o f 8 - b i t n u m b e r s s t a r t i n g a f t e r the secondary function code field and extending for a s m a n y 8 - b i t b y t e s a s n e c e s s a r y. T h e a p p l i c a t i o n s t o r e s a n 8 - b i t fi e l d n u m b e r ( F N ) i n t h e fi r s t o f a pair of bytes and a field value (FV) in the second b y t e o f t h e p a i r. E a c h F N r e p r e s e n t s a p a r t i c u l a r d e v i c e c h a r a c t e r i s t i c c o r r e s p o n d i n g t o a t e r m i n a l definition command or command parameter, and the corresponding FV represents the value the applica t i o n p r o g r a m w i s h e s t o a s s i g n t o t h a t c h a r a c t e r i s t i c . T h e a p p l i c a t i o n p r o g r a m n e e d s t o s p e c i f y only the FN/FV pairs for the characteristic it wants

60499500 S 3-47

5 9 5 1 4 9 4 3 3 5 2 7 1 9 1 1 3 0 t a

ta + 7

C t r l def chari char2 char3 char4 char5 char6 act=2

s s

char111 char112 unused

5 9 5 5 4 7 4 3 4 1 3 5 3 1 2 3 1 9 1 1 7 0

t a

ta + 21

c t r l 0 0 def c h a r i char2 char3 act=3

s s

0 chari 09 char110 char111 char112 unused

t a S y m b o l i c a d d r e s s o f t h e a p p l i c a t i o n p r o g r a m ' s t e x t a r e a f r o m w h i c h t h i s s y n c h r o n o u s supervisory message is sent.

c t r l - P r i m a r y f u n c t i o n c o d e C 1 < | 0 . Yo u c a n a c c e s s t h i s fi e l d w i t h t h e r e s e r v e d s y m b o l P F C , a s described in section 4. Its value is defined as the reserved symbol CTRL.

d e f S e c o n d a r y f u n c t i o n c o d e 4 . Yo u c a n a c c e s s t h i s fi e l d w i t h t h e r e s e r v e d s y m b o l S F C , a s described in section 4. Its value is defined as the value of the reserved symbol DEFF.

chari Up to 112 7-bit ASCII characters of one or more commands consisting of the network control character, characteristic mnemonic, and its desired setting. The characteristic and its value are separated by an equals sign. Multiple characteristics can be changed by separating

the commands with the network control character. See the Terminal Interfaces reference manual for the possible commands that can be sent.

/ * ^ | l

Figure 3-47. Define-Terminal-Characteristies (CTRL/DEF/R) Supervisory Message Format

t o c h a n g e . I f o n e o f t h e F N / F V p a i r s c o n t a i n s a n incorrect value, no characteristics are changed and t h e a p p l i c a t i o n p r o g r a m r e c e i v e s t h e a b n o r m a l response message shown in figure 3-49. Figure 3-50 s h o w s t h e n o r m a l r e s p o n s e t o t h e d e fi n e m u l t i p l e -terminal-characteristics supervisory message.

Va l i d c o m b i n a t i o n s o f F N / F V p a i r s a r e d e fi n e d i n table 3-2. Field numbers are listed in hexadecimal,

with octal equivalents in parentheses,

are listed only in hexadecimal. Field values T h e d e fi 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 a n d d e fi 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 s u p e r v i s o r y -m e s

sages sent downline by the application program are removed from the output stream by the TIP and acted o n d i r e c t l y. T h e t e r m i n a l o p e r a t o r i s n o t a d v i s e d

of their occurrence in the output stream.

3-48 60499500 R

/|P?N

t a

ta + 7

t a

ta + 21

ta c t r l char

f v .

59 5 1 4 9 43 35 27 19 11

c t r l char fn-| f V l fn2 fvg fv3 fv4 act=2

f n56 f v 56 unused

5 9 5 5 4 7 4 3 4 1 3 5 3 1

C t r l

2 3 1 9 11 7

char fn-| fV1 fng act=3

*55 fv55 fn56 ^ 5 6 unused

Symbolic address of the application program text area from which this synchronous supervisory message is sent.

Primary function code C1<|0. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol CTRL.

Secondary function code 8. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol CHAR.

The 8-bit field number of the parameter to be changed.

The 8-bit field value for the parameter.

Up to 56 field number and field value pairs can be specified in a single message. Valid field numbers and values are defined in table 3-2.

Figure 3-48. Define-Multiple-Terminal-Characteristics (CTRL/CHAR/R) Supervisory Message Format

60499500 R _3-49

ta c t r l char fn

ta

59 51 49 43 35 27

c t r l char

fn re

unused

5 9 5 5

47

43 41 35

31

2 3 1 9

11

0

c t r l char

fn re

unused

act=3

Symbolic address of the application program text area receiving this synchronous supervisory message.

Primary function code C1-j0. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol CTRL.

Secondary function code 8. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol CHAR.

Field number causing the abnormal response.

Reason code for error. This field can have the values:

0 Reserved for CDC use.

1 Out of range value for command or parameter 2 D u p l i c a t e c h a r a c t e r d e fi n i t i o n

3 Invalid command or parameter value for terminal class to which device belongs 4 I l l e g a l t e r m i n a l c l a s s c h a n g e

5 Illegal command or parameter for terminal class to which device belongs 6 thru Reserved for CDC use

255

Figure 3-49. Define-Multiple-Terminal-Characteristies Abnormal Response (CTRL/CHAR/A) Supervisory Message Format

ta

c t r l

char

ta

59 51 49 43

c t r l char unused

5 9 5 5 4 7 4 3 4 1 3 5 0

0

Ctrl char unused

act=2

act=3

Symbolic address of the application program's text area receiving this synchronous supervisory message.

Primary function code C1<|0. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol CTRL.

Secondary function code 8. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol CHAR.

Figure 3-50. Multiple-Terminal-Characteristics-Defined (CTRL/CHAR/N) Supervisory Message Format

3-50 60499500 R

TABLE 3-2. VALID FIELD NUMBERS AND FIELD VALUES

TABLE 3-2. VALID FIELD NUMBERS AND FIELD VALUES (Contd)

Command (Mnemonic)

F i e l d Number ( O c t a l )

F i e l d Value Range

Field Value Content Meaning

Mode delimiter 3C (74) 1 thru 3, 5 thru 8, 28 thru 31 (9 thru 18)

0 or 1 Timeout (1), no timeout (0)

Mode delimiter 45 (105) 1 thru 8,

28 thru 31 (9 thru 18)

0 thru FF ® Numerical value for character

Mode type 46 (106) 1 thru 8, 10, 13,

15, 28 thru 31

Multiple-message (1) Full duplex (none) 57 (127) 1 thru 3,

5 thru 8, 28 thru 31 (4, 9 thru 18)

0 or 1 Yes (1), no (0)

Terminal transmission block size (none)

28 thru 31 0 thru 7 Number of characters (upper

28 thru 31 0 thru FF Number of characters (lower

b y t e ) U p l i n e b l o c k l i m i t

(none)

18 (30) 1 thru 18,

28 thru 31 0 t h r u I F ® Number of blocks NPU should queue

Notes:

Q ) N o e r r o r o c c u r s if an FN/FV pair is issued for a terminal class shown in parentheses.

( T ) A n y h e x a d e c i m a l value except 00 thru 02, 20, 30 thru 39, 3D, 41 thru 5A, 61 thru 7A, or 7F.

one of the fields for this command is changed, the values of all other fields 1 must also be specified.

REQUESTING DEVICE CHARACTERISTICS

T h e 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 s u p e r v i s o r y m e s s a g e ( fi g u r e 3 - 5 1 ) i s i s s u e d b y a n a p p l i c a t i o n program on console or site-defined device connec t i o n s t o l e a r n t h e c u r r e n t v a l u e o f t h e d e v i c e c h a r a c t e r i s t i c s . T h e a p p l i c a t i o n p r o g r a m s p e c i fi e s a s t r i n g o f p a i r s o f 8 - b i t n u m b e r s s t a r t i n g a f t e r the secondary function code field and extending for as many 8-bit bytes as necessary. The application s t o r e s a fi e l d n u m b e r ( F N ) i n t h e fi r s t h a l f ( 8 b i t s ) o f t h e 8 - b i t p a i r a n d r e s e r v e s t h e s e c o n d h a l f ( 8 b i t s ) f o r a fi e l d v a l u e ( F V ) . E a c h F N r e p r e s e n t s a p a r t i c u l a r c h a r a c t e r i s t i c . T h e n e t w o r k r e t u r n s t h e v a l u e o f t h e c h a r a c t e r i s t i c i n t h e corresponding FV byte. Any value placed in the FV byte by the application Is ignored and overwritten.

The application program needs to specify only the F N s f o r t h e c h a r a c t e r i s t i c s i t i s i n t e r e s t e d i n . I f t h e s t r i n g c o n t a i n s a n i n c o r r e c t F N , n o d e v i c e

c h a r a c t e r i s t i c s a r e r e t u r n e d a n d t h e a p p l i c a t i o n receives the abnormal response message shown in fi g u r e 3 - 5 2 . F o r a l i s t o f l e g a l F N s a n d t h e c o r

responding range of possible FVs, see table 3-2.

T h e r e s p o n s e t o a 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 s u p e r v i s o r y m e s s a g e i s a t e r m i n a l - c h a r a c t e r i s t i c s definition message (figure 3-53). This message can be received only on console or site-defined device c o n n e c t i o n s . T h e N P U g e n e r a t e s a s t r i n g o f p a i r s of 8-bit numbers starting after the secondary func t i o n c o d e fi e l d a n d e x t e n d i n g f o r a s m a n y 8 - b i t b y t e s a s n e c e s s a r y. T h e fi r s t 8 - b i t s o f t h e 1 6 - b i t p a i r i s o n e o f t h e fi e l d n u m b e r s s p e c i fi e d i n t h e 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 s u p e r v i s o r y m e s s a g e . T h e s e c o n d 8 - b i t s o f t h e 1 6 - b i t p a i r i s t h e c u r r e n t v a l u e o f t h e p a r t i c u l a r c h a r a c t e r i s t i c t h e F N r e p r e s e n t s . F o r a l i s t o f v a l i d F N s a n d t h e associated valid range of FVs, see table 3-2.

3-54 60499500 S

ta c t r l r t c frM fv<

ta

Ctrl

rtc fn

59

_{5 1 4 9}

43 35 27 19 11

ta

c t r l

rtc

_fn-j

fVl fn2 fv2

^{• • •}

Symbolic address of the application program's text area from which this synchronous super visory message is sent.

Primary function code C1lo. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol CTRL.

Secondary function code 9. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol RTC.

The hexadecimal field number of the desired parameter. Valid values are defined in table 3-2.

Space for the hexadecimal field value of the desired parameter; can be 0.

Figure 3-51. Request-Terminal-Characteristics (CTRL/RTC/R) Supervisory Message Format

ta

59 51 49 43 35 27

C t r l

rtc fn re

_unused

Symbolic address of the application program's text area receiving this synchronous supervisory message.

Primary function code C116. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol CTRL.

Secondary function code 9. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol RTC.

First field number in the string found to be erroneous by the network software. In case of several bad field numbers, only the first bad one will be diagnosed.

Reason code for error. This field can have the value:

0 Reserved for CDC use thru

6 t h r u 255

Illegal field number value Reserved for CDC use

Figure 3-52. Request-Terminal-Characteristics Abnormal Response (CTRL/RTC/A) Supervisory Message Format

60499500 R 3-55

t a c t r l t e d

f n i f v i

59 51 49 43 35 27 19 1 1 0

c t r l ted fni fVl fng fvg . . .

Symbolic address of the application program's text area receiving this synchronous supervisory message.

Primary function code C1-j0. You can access this field with the reserved symbol PFC, as described in section 4. Its value is defined as the value of the reserved symbol CTRL.

Secondary function code 0A<|o. You can access this field with the reserved symbol SFC, as described in section 4. Its value is defined as the value of the reserved symbol TCD.

The hexadecimal field number of the characteristic parameter. Valid values are defined in table 3-2.

The hexadecimal field value of the characteristic parameter. Valid values are defined in table 3-2.

Figure 3-53. Device-Characteristics-Definition (CTRL/TCD/R) Supervisory Message Format

Im Dokument NETWORK PRODUCTSNETWORK ACCESS METHODVERSION 1HOST APPLICATION PROGRAMMINGREFERENCE MANUAL (Seite 117-128)