Bull DPX/20 Open Terminal Management (OTM) TWS2107 Terminal Emulation User’s Guide AIX ORDER REFERENCE 86 A2 33PE 04
Bull DPX/20 Open Terminal Management (OTM) TWS2107 Terminal Emulation User’s Guide AIX Software April 1996 Bull Electronics Angers S.A.
The following copyright notice protects this book under the Copyright laws of the United States and other countries which prohibit such actions as, but not limited to, copying, distributing, modifying, and making derivative works. Copyright Bull S.A. 1992, 1996 Printed in France Suggestions and criticisms concerning the form, content, and presentation of this book are invited. A form is provided at the end of this book for this purpose.
About this Book This guide contains the information for configuring, administering and using TWS2107 Terminal Emulation running under the Open Terminal Manager (OTM) product. This book is for the users of the OTM product running with TWS2107 emulation. The OTM Product The OTM product covers the emulations necessary to connect DPX/20, Unix machines to other Bull machines using the different GCOS operating systems as well as to IBM machines through the Bull/IBM gateway.
Glossary Index Conventions The generic term DPX is used throughout this guide for systems belonging to the DPX/20 family. As OTM is available also on Bull DPX/2 systems, whenever the use of the generic term DPX could be misleading or not precise enough, the complete name is used (DPX/20 or DPX/2). The name Qxxx is used to designate the Bull Questar family of terminals.
Table of Contents Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TWS2107 Introduction Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . General Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Emulation Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi Chapter 3. The Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Register Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Register Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Access To the Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B. Command Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Tables Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TWS2107 Commands for the Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Correspondent Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Use of Keywords . . . . . . . . . . . . . . . . .
viii OTM – TWS2107 Emulation User’s Guide
Chapter 1. Introduction TWS2107 Introduction Summary • General Overview, on page 1-1. • Emulation Functions, on page 1-3. • Additional Functions, on page 1-4. • Connection with Host Systems, on page 1-4. • Characteristics: Installation – Operation, on page 1-5. • Execution Environment, on page 1-5. General Overview TWS2107 is part of the Bull Open Terminal Management (OTM) communications package.
DPS 6000 DPS 7000 DPS 9000 DTF IOF TSS DM6TP TDS DM4TP DNS DATANET ISO/DSA network TWS2107 Emulation OTM Printer DPX Q310 DKU7102 Q303 VT320 UNIX Terminal A UNIX Terminal B Q210 TWS2103 UNIX Terminal C CONNECTION LINKS SUPPORTED BY TWS2107 EMULATION Figure 1.
Emulation Functions Synchronous Emulation TWS2107 emulates the protocol of the DKU7107/7105 synchronous device on DPX terminals: • Q310 in DKU7102 or vt320 mode • Q303 in vt320 mode All the commands (keyboard/host) of the DKU7107/7105 are supported: • Partitions, • Video attributes, • Cursor positioning, • Normal mode/format mode, • Tabulation, editing functions, • Remote printing, etc. The semi-graphic, national, stressed and international character sets are supported.
Additional Functions Dynamic Execution of UNIX Commands It is possible to access the UNIX SHELL to execute a command without losing the context of the session with the host system. Multi–Sessions A multi–windowing technique may be used to hold several sessions simultaneously with different host systems on the same terminal. The terminal user can, with the help of the appropriate commands, restore the context of a previously established connection or request the opening of a new one.
Characteristics: Installation – Operation Operation is facilitated by an integrated menu–driven system ensuring: • Terminal user welcome, • A user help function, • Configuration of the emulated terminal, • Management of a directory of connectable remote applications and parameters identifying the user, • Entry of connection parameters. The connection welcome and help functions can be disabled. The terminal user can then connect to a Bull host by executing a single UNIX command.
1-6 OTM – TWS2107 Emulation User’s Guide
Chapter 2. Using TWS2107 Emulation TWS2107 Emulation Summary This chapter is organized as follows: • Introduction, on page 2-1. • Configuration Of The Emulated Terminal, on page 2-4. • Terminal Configuration and Register Files, on page 2-31. • ’Command Line’ Mode, on page 2-33. Introduction Starting TWS2107 Reminder TWS2107 is a package that runs on a terminal connected to a DPX by emulating a DKU7107/7105 terminal. As soon as you initialize TWS2107, your terminal behaves like a DKU7107/7105.
2. Return to the main menu or start–up screen (the first screen on initiating TWS2107), by pressing the CONTROL key and the V key at the same time. 3. Display a guide by pressing the CONTROL key and the G key at the same time. 4. Quit TWS2107 by pressing the CONTROL key and the U key at the same time.
Commands Introduction Two types of commands should be distinguished on TWS2107: 1. Commands from the emulated terminal, “mapped” on the keyboard of the real terminal, called VIP commands. 2. Commands introduced by TWS2107, which are not the same as those on a real DKU7107/7105 terminal, but which are useful in an emulation application. VIP Commands These are commands available on a real DKU7107/7105.
Configuration of the Emulated Terminal The Terminal in the Configuration File The configuration of the emulated terminal corresponds to the “set-up” of the DKU7107/7105 terminal. The set–up, or the profile, is registered in the configuration file, under a symbolic name which corresponds to your login converted to UPPER CASE letters. The remainder of this section explains how to create a “set–up” (if it does not already exist), to read the file and to modify it.
. Terminal . . . . . . Function Key Group function key F1 function key F2 function key F3 function key F4 function key F5 function key Fn Relational diagram for the definition of an emulated terminal set-up. Access to the “Terminal Configuration” Menu TWS2107 V7xx.
The first ADMINISTRATION menu appears. TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N M E N U _____________________________________________________________ Directory of correspondents : 0 Terminal configurations : 1 Your selection : 1_ _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Select 1 and validate the screen. The following screen is the “Terminal CONFIGURATION” menu. TWS2107 V7xx.
The “Terminal” Menu TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ T e r m i n a l C o n f i g u r a t i o n Examine : 0 Create : 1 Modify : 2 Remove : 3 Your selection : 0_ _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Terminal Inquiry (Example) To inquire on a set–up, accept the default selection by validating the screen.
Enter the name of your LOGIN (UNIX login), converted into UPPER CASE letters, to inquire on your set-up: TWS2107 V7xx.
If your “terminal” has already been created, you will obtain the desired information on the following screen. TWS2107 V7xx.
The following screen is displayed: TWS2107 V7xx.y Copyright BULL 1991 G U I D E _____________________________________________________________ E x a m i n e T e r m i n a l Name : ”Terminal” name in the configuration file Alarm signal : ”bell” on/off Blink/Blank : VV–>Blink Blank available, VX–>Blink available, XX–>Blink Blank not available, XV–>Blank available. Fixed upper case : Keys typed on the keyboard changed to upper case. Filler character : 0–>” ”, 1–>”0”, 2–>”*” (right justified).
XX : Blink command represented by a ” ^ ” and blank by a ” ~ ”. The secret and flashing attributes are disabled. Default value : VV Alarm Signal According to the binary value of the field, the “bell” is enabled or inhibited: 0 : inhibited 1 : enabled Default value :0 Characteristics : This field has no effect for a Q210 terminal Fixed Upper Case 0 : lower case letters are enabled 1 : all the letters typed on the keyboard are converted into upper case letters.
National Characters This field enables access the the national character sets. 0 : International Character Set 1 : National Character Set Default value :0 Function Key Group This field must contain the name of the Function Key Group which defines the programming for all the programmable function keys of the terminal.
Creation of a New “Terminal” (Example) To exit from the “Terminal” menu, select 1 and validate the screen TWS2107 V7xx.
If the terminal does not yet exist, you will have the default values of the fields defining the “set–up” in the following screen: TWS2107 V7xx.
For an explanation on the meaning of these fields, consult the guide screen. TWS2107 V7xx.y Copyright BULL 1991 G U I D E _____________________________________________________________ U p d a t e Terminal name T e r m i n a l : If you give an EXISTING name, it’s a MODIFICATION! If you give a NEW name, it’s a CREATION! Blink/Blank : VV–>Blink Blank available, VX–>Blink available, XX–>Blink Blank not available, XV–>Blank available.
You will obtain the screen: TWS2107 V7xx.
Modification of a ’Terminal’ (Example) Beginning with the “terminal” created in the preceding section, to obtain a “Terminal” where the keyclick and lower case lettering are enabled, proceed as follows: Exit from the “Terminal” menu by selecting 2, TWS2107 V7xx.
In the next screen, position yourself using the cursor movement and tabulation keys. In the “Fixed upper case” field, type 0. TWS2107 V7xx.
TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ T e r m i n a l Terminal name R e m o v a l : LOGIN –ID _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Hit return to validate the screen. TWS2107 V7xx.
TWS2107 V7xx.
The “Function Key Group” Menu From the following “Terminal Configurations” menu screen: TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ T e r m i n a l C o n f i g u r a t i o n s Terminal Function group Function key : 0 : 1 : 2 Your selection : 0 _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Select 1 and validate the screen.
Two screens will then appear. In the first, type the Function Key Group name (G-EX for Group EXample), in the second, shown below, type the Function Key names (TRS1, TRS0 and IOF) opposite the corresponding commands: TWS2107 V7xx.
By typing ctl P, you will return to the preceding screen, the Function Key Group menu: TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ F u n c t i o n Examine Create Modify Remove : : : : Your selection : 0 K e y G r o u p 0 1 2 3 _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Select option 0, Examine, to check that the group has been created.
Function Key Group Name This name determines the “Terminal” <–> “Function Key Group” link. Length 4 characters maximum Type alphanumeric starting by a letter Specific characteristics obligatory If the name of the “Function Key Group” is unknown in the configuration file, default values are attributed to the 11 non specialized Function Keys. However, as soon as it is known, it becomes possible to work with the associated keys (consultation, creation, modification or cancellation).
The “Function Key” Menu From the following “Terminal Configuration” menu screen: TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ T e r m i n a l C o n f i g u r a t i o n s Terminal Function group Function key : 0 : 1 : 2 Your selection : 0 _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Select 2 and validate the screen.
Selection of 1 enables the creation of new Function Key definitions. TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ F u n c t i o n K e y U p d a t e Function key name : TRS1 _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U The first key name will be TRS1 (TRanSmission of 1).
Function Key Name This is a symbolic name providing access to the programming functions for a Function Key on the keyboard: Length 4 characters Type alphanumeric starting by a letter Specific characteristics obligatory Value of FC1 and FC2 The value of FC1 (or FC2) is transmitted to the central system except when it is equal to 7FH.
The function type remains 0, which means “FKC function to be transmitted”. Put value 1 in the Text field: TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ F u n c t i o n K e y U p d a t e Function key name FC1 Hex value FC2 Hex value Function key type Text : : : : : TRS1 7F 7F 0 1 _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Validate the screen.
TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ F u n c t i o n K e y U p d a t e Function key name FC1 Hex value FC2 Hex value Function key type Text : : : : : TRS1 7F 7F 0 0 _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Validate the screen. The name of the third key is IOF: TWS2107 V7xx.
In the following screen, contrary to the two preceding keys, the function type should be set to 2, which means “Display the FKC function starting from the cursor position”. The text will be IOF: TWS2107 V7xx.
Terminal Configuration and Register Files Access to the Terminal Configuration and Register Files Access Control In the Administration menu, TWS2107 provides an assisted updating service for the register and the emulated terminal configuration files. Since this service is accessible to all users, the correctness of data is ensured by separating files into two classes: • Reference files, • Local files. A reference file is accessible for reading by all users. A local file is accessible for a single user.
This file is normally updated automatically by TWS2107 while operating OFF–LINE, in the screens of the ”Correspondent register” menu. It can nevertheless be updated by the system administrator using the text editor.
’Command Line’ Mode TWS2107 can run in ”command line” mode. It can go to this mode by selecting option 2 in the main menu. In this mode, a certain number of commands are available, consisting essentially of the connection command, the command to modify the function codes, and the on–line operation commands, i.e., the sending of a BREAK and disconnection. User Commands All these commands are in the format: $*$ CMD [– k1 ] ....
Disconnection Command: $*$DIS This command does not have an argument or a keyword. It results in the non negotiated termination of the session in progress. This command is programmed, by default, on the function keys: Key on the Q303 and Q310 keyboards: F10 Break Command: $*$BRK This command does not have an argument or a keyword. It results in the transmission of a break to the session and the purge of messages in the process of being received.
2. Previous TWS2107 session Key on the Q310 keyboard: or <–> PF2 or Esc – Key on the Q303 keyboard: or PF2 or Ctl Z – 3.
2-36 OTM – TWS2107 Emulation User’s Guide
Chapter 3. The Register The Register Summary This chapter is organized as follows: • Introduction, on page 3-1. • The Register Menu, on page 3-1. Introduction The register offers an information service and an abbreviated addressing service. The user stores the necessary information in the register in view of a connection to a remote application. This information is represented by an abbreviated name. The user can recall this information each time that he wishes to establish a connection.
TWS2107 V7xx.y Copyright BULL 1991 A D M I N I S T R A T I O N _____________________________________________________________ D i r e c t o r y Correspondent : 0 Abridged user : 1 Your selection : 0_ M e n u _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U The Correspondent and the Abridged User Addressing To establish a connection with a remote application, its address is required.
Alternative Correspondent To support the high availability feature it is necessary to indicate an alternative correspondent (or secondary correspondent), which will be automatically called if the first one is unreachable. To identify the alternative correspondent, the first and the secondary correspondents are logically linked using the postfixed label .HA. For example if the GCOS7 correspondent has been created, its alternative one is GCOS7.HA.
TWS2107 V7xx.y Copyright BULL 1991 _____________________________________________________________ A D M I N I S T R A T I O N C o r r e s p o n d e n t Examine Create Modify Remove : : : : 0 1 2 3 Your selection : 1_ _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Select Create. TWS2107 V7xx.
TWS2107 V7xx.
Site This is the name of the site where the application may be found, or its “TRANSPORT SERVICE ACCESS POINT”. Type : Alphanumeric Length : 4 characters Characteristics : Mandatory Remote Address This parameter specifies the Remote Address depending on the network type selected. There is no default provided. Possible syntaxes are as follows: LAN DSA : Remote Ethernet address.
The Fields of the “Abridged User” To access the Abridged User Screen, follow this sequence of screens starting from the ”ADMINISTRATION, Directory Menu”: TWS2107 V7xx.y Copyright BULL 1991 _____________________________________________________________ A D M I N I S T R A T I O N D i r e c t o r y Correspondent : 0 Abridged user : 1 Your selection : 1_ M e n u _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Select Abridged User.
Select Create: TWS2107 V7xx.y Copyright BULL 1991 _____________________________________________________________ A D M I N I S T R A T I O N U p d a t e A b r i d g e d Abridged User Name U s e r _ : DUPOND _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U Enter the Abridged User Name: TWS2107 V7xx.
Identifier Field This is the “user–id” sent to the remote application during connection: Type : Upper and lower case alphanumeric, and non alphanumeric characters. Length : 12 characters maximum Characteristics : Mandatory in an “Abridged User” menu screen. Project Field This is the name of the “project” submitted by the user to the remote application during the connection: Type : Alphanumeric, and non alphanumeric characters accepted.
• The system header: characters of the header are in hexadecimal representation (4 characters maximum) Example system header = “ABC” (A= 41H B= 42H C= 43H) ?A6414243 Type : Alphanumeric Length : 32 characters maximum Characteristics : Not mandatory. Note: The first time you create a Correspondent and/or an Abridged User, your register file is created under your LOGIN Directory, and to validate your records it is necessary to exit first from TWS2107 then to restart TWS2107.
Chapter 4. Connecting Connecting Summary This chapter is organized as follows: • The Connection, on page 4-1. • Description Of The Terminal Status Line, on page 4-8. • Environment Variables, on page 4-9. The Connection Introduction This is the access path to the main function of TWS2107. There are two connection screens. In the paragraphs which follow, two methods to make screen entries will be presented, depending on what is required from the register service.
The following screen is the first connection screen: TWS2107 V7xx.y Copyright BULL 1991 C O N N E C T _____________________________________________________________ C o n n e c t i o n Correspondent : ____________ Abridged user : ____________ _____________________________________________________________ Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U This screen requests the entry of a “correspondent” and/or an “abridged user” found in the register.
When you validate the screen, the data is extracted from the register and displayed in the following screen: TWS2107 V707.
TWS2107 V707.
Guide–>ctl G Previous–>ctl P Summary–>ctl V Quit–>ctl U These fields have already been presented (See “The Register Menu” ). Some of thier characteristics may vary and these are discussed below. The Correspondent Field This is not an entry field in this screen. In the second connection screen, there are two possibilities: 1. The field is empty: In this case, you did not enter the name of a correspondent in the previous screen. It is recommended to go directly to the next field. 2.
a. The rest of the screen is empty: The user does not exist in the register. The validation of the connection command results in an error. You should: – return to the previous screen to enter another value for the “correspondent” and/or the “user” ; – verify the existence of the user in the register (go to the ADMINISTRATION menu from the MAIN menu). b. The rest of the screen is not empty: The data corresponding to the other fields of the screen has been retrieved from the register.
• Even if the user field is not blank, the values taken into account for the Identifier, Project, Password, Billing and String parameters will be those displayed, independently of the register. • If the remote application does not accept “user” parameters in the connection request, there is no need to make entries in the corresponding fields in the connection screens. However, the presence of values will not result in an error.
Description Of The Terminal Status Line The status line contains the following information: TRANS This indicator is displayed only during transmission. MESS This indicator is displayed (blinking) when a message from the host is waiting. The ESC F command displays this message on the 25th line. Exit from the status line with the ESC S command. CN User is connected CN PRT There is another connection for the printer.
Environment Variables These following variables are generated by the TWS2107 configuration (refer to OTM Administrator’s and User’s Guide). Term and Terminfo: Terminal and Mode Selection TERM must correspond to a name known to TWS2107. Possible values are: Terminal Value Bull QUESTAR 303 vt320 Bull QUESTAR 306 vt320 Bull QUESTAR 310 vt320 The TERMINFO variable contains the directory for the terminal description files.
If the parameters are operative, printing will begin as soon as one of the conditions is fulfilled. Example: BYTES=OFF; PRT_DELAY=3; Language: Language Selection This variable is used to select the language used in TWS2107 screens and messages. Possible values are: ENGLISH (default value) FRANCAIS TRANSESP: Space Transmission The TWS2107 emulator transmits not only the spaces initialized by the central system, but also those typed by the user, in accordance with the normal operation of a DKU7107.
HA_TIMEOUT: High Availability Disable Timeout If the first Correspondent (that has been defined in a High Availability environment together with the alternative correspondent) is unreachable, it will be disabled for the time specified in this variable. During this time any attempt to establish a connection to the first correpondent will be automatically switched to the alternative correspondent. The first and the alternative correspondents are logically linked using the postfixed label .HA.
4-12 OTM – TWS2107 Emulation User’s Guide
Chapter 5. Keyboard Commands Keyboard Commands Summary This chapter is organized as follows: • Introduction, on page 5-1. • DKU7107/7105 Commands, on page 5-1. • TWS2107 Specific Commands, on page 5-15. Introduction As seen above, there are two classes of TWS2107 commands: • Commands supported by a real DKU7107/7105 terminal, emulated by TWS2107, • Commands specific to TWS2107. The objective of this chapter is to detail the major commands belonging to these two classes.
Format mode: If the cursor is in a field, movement to the right is blocked at the end of the field. If the cursor is in a fixed zone (outside of a field), there is no action. Cursor One Step to the Left (Back Space) On all keyboards: Normal mode: Cursor moves to the left. At the start of the line, the cursor goes to the last column of the previous line. The cursor is blocked at the start of a page.
• If the cursor is in a multi–line field, it goes to the first position in the previous line of that particular multi–line zone. If the cursor is in the first line of a multi–line field, it goes to the first position in the first line of the previous zone. Note: The cursor remains blocked in the first field zone of the page. If a compulsory zone is sequentially (top –> bottom, left –> right) between the exit zone and the start zone, the cursor goes to that zone.
Home Normal mode: Positions the cursor in the margin of the first line of the screen. Format mode: Moves the cursor to the first position in the first unprotected field of the screen. Forward Tabulation (Tab) Key on the DKU7107 keyboard: Key on the Q310 keyboards: and Key on the Q303 keyboard: tab Normal mode: Moves the cursor to the next tab stop on the same line. Format mode: Moves the cursor to the first position in the next field on the screen.
Moves the cursor to the first position in the first, unprotected field up the screen. The cursor cannot move past the first field. Setting Tab Stops (Set Tab) Strike this key on the DKU7107/7105: F2 Strike this key on the Q310 keyboard in mode vt320:
Partial Reinitialization Strike one of these keys on the DKU7107 keyboard: Strike one of these keys on the Q310 keyboard in vt320 mode: Esc R Strike one of these keys on the Q303 keyboard: Ctl Z F3 Editing Commands Erasure of the Active Partition Strike this key on the DKU7107 keyboard: Strike this key on the Q310 keyboard in vt320 mode: Erase Strike this key on the Q303 keyboard: Remove Normal mode: Erases the active partition of the sc
Shift Erase Strike one of these keys on the Q303 keyboard: Z Ctl Remove Erases the active partition: the screen (characters and video attributes) + format table (definition of the fixed and variable fields) + tabs. Goes to normal mode. Cursor goes to Home.
Same as for normal mode, except: • Only the field variables are erased, • Erases characters and video attributes in VIP mode only. Erasure in a Line (E.L.) Or In A Zone (E.A.) Strike this key on the DKU7105 keyboard: F3 Strike this key on the Q303 and Q310 keyboards in vt320 mode: Ctl L Normal mode (erasure in a line): Erases (characters and video attributes in VIP mode only): • From the cursor position to the end of the line, • The cursor position remains unchanged.
Format mode: The characters, from the current cursor position to the end of the field zone, are moved one step to the right. A space is put in the cursor position. The last character of the variable zone is lost. The cursor does not move.
The lines from the cursor position to the end of the screen are moved down one line. A line of spaces is inserted at the current cursor position. The last line of the screen is lost. The cursor does not move. Format mode: No effect.
Transmission Commands Strike this key on the DKU7107/7105 keyboard: Case 1: Trans Case 2: Trans Strike one of these keys on the Q303 and Q310 keyboards in vt320 mode: Case 1: Case 2: Ctl T Normal mode: Case 1: Transmission of the screen from the first character entered on the keyboard. Case 2: Transmission of the entire active partition. Format mode: Case 1: Transmission of the variable fields of the screen. Case 2: Same as for normal mode.
When we run this command by introducing a code, the code replaces the value of FC1, and the old value of FC1 replaces the value of FC2. The old value of FC2 is lost. Thus, the last entered will be the first transmitted. These codes are set to 20 Hex (space) if a function code cancellation command has been sent (see § below).
Ctl Z S Normal mode and format mode: When a message is received from the host, signalled by “Message Waiting”, the user can make it visible by pressing the “system line” keys, and the indicator “Message Waiting” will be immediately turned off. The “status line” keys cause the display of the status line, whatever the active partition. General Purpose Function Keys Definition of the function keys emulator associated with a user name (LOGIN).
Function keys programmed on the terminal Q310 in vt320 mode Q303 Esc PF1 PF1 Esc PF2 PF2 Esc PF3 PF3 Esc PF4 PF4 Esc F6 F6 ... ... Esc F20 F20 On all Q303 and Q310 keyboards in vt320 mode, the programmable functions keys, if they exist and not including those managed by the emulation, are the 20 F1 to F20 keys, plus the same keys when used with SHIFT or Esc. The table above provides the list. There is no correspondence between the columns.
TWS2107 Specific Commands These commands are not handled by the intelligence of a DKU7105 or a DKU7107 terminal concentrator, but which are highly useful in a terminal emulation package. Refreshing the Screen On an asynchronous terminal running under UNIX, it is possible for the terminal to receive UNIX messages during emulation. This command is used to re–establish the screen status existing prior to the reception of the messages.
’Help’ It is possible to display, at any time, a summary of the commands commonly used in TWS2107 and specific to the used terminal, by using “HELP”. Strike this key on the Q303 and Q310 keyboards in vt320 mode: PF4 or: Help Disconnection This command abruptly terminates execution of a remote application, and causes disconnection of TWS2107. It is used in situations where the remote application is malfunctioning, i.e. blocked, user unable to gain control, etc.
Return to the Menus After Disconnection Line Mode In the main menu: TWS2107 V7xx.y Copyright BULL 1991 W E L C O M E M E N U _____________________________________________________________ Connect : 0 Administration : 1 Line mode : 2 Your selection : 2 _____________________________________________________________ Guide–>ctl G Quit–>ctl U Selection 2 results in passage to line mode, i.e. to ”command line” mode, where the connection command must be entered in line mode.
The ’New TWS2107 Session’ Command This command is used, under TWS2107, to initiate “another TWS2107”, freezing the current application, but without losing it. Only one TWS2107 session is active at a time. You can initiate as many new TWS2107 sessions as UNIX will permit (one session corresponds to two processes in parallel).
Previous or Next TWS2107 Session When you work in “Multi TWS2107” mode, you can move sequentially from one session to another, forward or backward in the order in which they were created. There is no concept of the “first” or “last” session, as the passing from one session to another is done in a circular manner. When you pass to the previous or next session, you will find it in the state where it was before leaving it. Moving to a session renders that session ACTIVE, all the others are frozen.
Quitting a TWS2107 Session A TWS2107 session is aborted by using the TWS2107 quit command which produces an effect only on the “active” session. When you exit a session, the previous session (in order of creation) automatically becomes the active session. Strike one of these keys on the Q303 and Q310 keyboards in vt320 mode: Ctl U Note: To avoid a brutal abort, it is recommended to exit the session application prior to aborting the session.
Appendix A. Error Messages and Return Codes Error Messages and Return Codes Summary This appendix is organized as follows: • TWS2107 Messages, on page A-1. • Local Dialog Codes, on page A-4. • OTM Internal Error Codes, on page A-4. • OSI Services Error Codes, on page A-4. • DSA Error Codes, on page A-5. TWS2107 Messages Error Messages When The Emulator Is Initialized MESSAGE MEANING Error message file absent The /usr/bin/vip_fic/vip_msg file was not found. Only the message number will be displayed.
Table Of Error Messages By Type Of Command COMMAND Connection MESSAGE DESCRIPTION Correspondent unknown The correspondent indicated in the command does not exist in the register file.
COMMAND Function code modification Transmission request $*$ MESSAGE DESCRIPTION None Connection in progress Transmission refused because the connection is not yet established You are not connected Transmission refused because the terminal is not connected It is not your turn Transmission refused because no right to transmit Command unknown The name of the local dialog command is erroneous You are disconnected The remote application or a problem detected by telecommunications system has caused
Local Dialog Codes These codes are returned by local dialog messages. $$ you are disconnected (error: xxxxxxxx) $$ you are not connected (error: xxxxxxxx) $$ you are not connected (reason: xxxxxxxx) OTM Internal Error Codes These return codes are issued as soon as an OTM internal problem occurs. They are in the form: 990000xx where xx is a 2-character hexadecimal code; Refer decimal code in ”/usr/include/tmpi/utm_error.h” include file.
DSA Error Codes Some Examples: DSA error code Meaning in this situation 00 04 Remote application not available. The application requested is not currently running on the machine (remote site) accessed. Verify the name of the application and the name of the Remote site. 00 18 Permission Denied / Security violation. Either the password given or the username is incorrect. 00 40 Calling site refused / not known.
A-6 OTM – TWS2107 Emulation User’s Guide
Appendix B. Command Tables Command Tables Summary This appendix is organized as follows: • TWS2107 Commands for the Keyboard, on page B-1. • Correspondent Command, on page B-13. • Terminal Configuration File, on page B-16.
Move the cursor to the next tab stop Move the cursor to the previous tab stop Set a tab stop Move the cursor to the next variable field on the screen. Move the cursor to the previous variable field on the screen.
Insert a line on the page Delete a line on the page INEFFECTIVE INEFFECTIVE Define the start of a ”blink on” zone Define the start of a ”blink on” zone Define the start of a ”hidden input” zone Define the start of a ”hidden input” zone Define a zone on the screen for n CH parameters separated by ”;” Define a zone on the screen for n CH parameters separated by ”;” PRINTING COMMANDS OPERATION DKU7107 KEY Normal mode Format mode Copy the active partition
Annul the values of the programmable functions Transmission of the screen starting with the first character entered on the keyboard. Transmission of the entire active partition. Annul the values of the programmable functions Transmission of the variable fields on the screen. Same as normal mode.
Move the cursor to the pre vious tab stop Move the cursor to the previous variable field on the screen Set a tab stop INEFFECTIVE Erase a tab stop INEFFECTIVE Same as HOME Same as HOME EDITING COMMANDS Q303 KEY OPERATION Normal mode Format mode Erase the active partition Erase the variable fields of the active partition Reinitialize the active parti tion Erase the variable fields of the active partition, then go to
Delete a line on the page INEFFECTIVE Define a zone on the screen
OTHER Q303 COMMANDS Q303 OPERATION KEY Normal mode Format mode Modify the FC1 and FC2 function codes Modify the FC1 and FC2 function codes Annul the values of the pro grammable functions Annul the values of the programmable functions to Programmable function keys Programmable function keys Transmission of the screen starting with the first character entered on the keyboard. Transmission of the variable fields on the screen.
PAGE OVERFLOW Erase the screen + quit the message QUIT THE EMULATOR Stop the emulator HELP Summary of the principal TWS2107 commands MULTI TWS2107 SESSIONS or New TWS2107 Session <–> MULTI TWS2107 SESSIONS or Previous TWS2107 Session <+> MULTI TWS2107 SESSIONS or Next TWS2107 Session CURSOR MOVEMENT COMMANDS Q310 KEY OPERATION Normal mode Move the cursor to the right Move the cursor to the right Move the c
Move the cursor to the margin of the first line on the screen (HOME position) Move the cursor to the head of the 1st variable field on the screen (HOME position) Move the cursor to the next and tab stop Move the cursor to the next variable field on the screen Move the cursor to the previous tab stop Move the cursor to the previous variable field on the screen
Insert a character in the line Delete a character in the line Insert a character in the variable field Delete a character in the variable field Insert a line on the page INEFFECTIVE Delete a line on the page INEFFECTIVE Define a zone on the screen
Annul the values of the pro grammable functions Annul the values of the programmable functions Programmable function keys to Programmable function keys Transmission of the screen starting with the first character entered on the keyboard. Transmission of the variable fields on the screen. Transmission of the entire active partition. Same as normal mode.
HELP Summary of the principal TWS2107 commands MULTI TWS2107 SESSIONS or New TWS2107 Session <–> MULTI TWS2107 SESSIONS or Previous TWS2107 Session <+> MULTI TWS2107 SESSIONS or Next TWS2107 Session LIST OF THE CH VIDEO CODES Format or normal mode: Definition of the video display of a zone: (n ch parameters separated by ”;”, terminated by an ”m”) ch = 0 normal 2 dim 4 underline 5 blink 7 inverse video 8 hidden < column separator m VIP end input o
Correspondent Command Each record describes a correspondent and has the following structure CO – address> – – – DMB – SCID – X25 – USR PROJ – BILL STR – CD
O 10 characters enclosed in ” ” 10 characters maximum on IOF 9 characters maximum on TDS TWS2107 permits the entry of all 32 characters All of the parameters passed to IOF or TDS are in a string: IOF the character ’!’ can be followed by 1 to 3 IOF options separated by a space. They can take the values: NS: no start–up NEW: reconnection after a sudden break during the initialization of a new IOF session NM: no delivery of messages stored in the mailbox.
(A = 41 H C = 43 H) B = 42 H – STR ”?A6414243” O 8 characters A name for the description of a set of connection parameters. The parameters defined in this record are modifications, or are made up of the parameters already defined in the CO record. O: Optional M: Mandatory The Use of Keywords Keywords (–DMB –SCID, etc.) are recognized in both upper and lower case.
Terminal Configuration File This file contains the description of a group of operational parameters for the keyboard and screen that is used for configuration with the DKU7107/7105. This file consists of three types of entries: • description of the terminal parameters: DV command, • description of a function key group: FG command, • description of a function key: FK command.
OPTION NAME ARGUMENT – FL MEANING Filler character (fields justified to the right in screen mode). 0 Space character (Default). 1 Character 0 (zero). 2 Character *. – FG Name in 4 characters Function key group to be used (this group must be defined by an FG command). – UP none Upper case only. – MD none Display messages originating from the host in deferred mode (Default is immediate mode). – SD none Terminal in SDP mode (default is VIP mode): display mode of the video attributes.
FK Command This command introduces a user function key. It defines the action taken when this key is chosen by the user. Structure of the command: FK –C1 –C2 –TY –TX PARAMETERS DESCRIPTION Key name Name of the function key in 4 characters (referred to by the FG command). arg1 Value of FC1 (transmitted to the host if the value is 7F hex). Default value is 20 hex. arg2 Value of FC2 (transmitted to the host if the value is 7F hex). Default value is 20 hex.
Appendix C. The Keys Keys Summary This appendix is organized as follows: • DKU7107 Keys, on pageC-1. • Q303 Keys, on page C-4. • Q310 Keys, on page C-10.
Ctrl CR Erase F1 F1 F2 F2 F3 F3 F4 F4 F5 F5 F6 F6 C-2 OTM – TWS2107 Emulation User’s Guide
Home L L Message NL or Shift Space Space SP SP Trans Trans TAB The Keys C-3
Q303 Keys – – + + c c char char down arrow left arrow q q r r C-4 OTM – TWS2107 Emulation User’s Guide
right arrow up arrow A A B B BACKTAB= Ctl Z tab C C Ctl Ctl D D Do Do The Keys C-5
E E Enter or F F F3 F3 F6 F6 F7 F7 F10 F10 F11 F11 Find Find C-6 OTM – TWS2107 Emulation User’s Guide
Help Help Home Home Insert Insert L L Next Screen Next Screen Prev. Screen Prev.
PF4 PF4 R R Remove Remove S S Select Select Space Space SP SP T T TAB tab C-8 OTM – TWS2107 Emulation User’s Guide
U U X X Z Z The Keys C-9
Q310 Keys – – + + c c char char down arrow left arrow q q r r C-10 OTM – TWS2107 Emulation User’s Guide
right arrow up arrow A A B B BACKTAB Find C C Ctl Ctl D D Delete Delete The Keys C-11
Do Do E E Entrée Entrée Erase Erase Esc Esc F F F6 F6 F7 F7 F10 F10 C-12 OTM – TWS2107 Emulation User’s Guide
F11 F11 F12 F12 Help Help Home Home Insert Insert L L Next Screen Next Screen Prev. Screen Prev.
PF2 PF2 PF3 PF3 PF4 PF4 R R S S Select Select Shift Shift Space Space SP SP C-14 OTM – TWS2107 Emulation User’s Guide
T T TAB and U U X X Z Z The Keys C-15
C-16 OTM – TWS2107 Emulation User’s Guide
Glossary Function Key In The Configuration File Abridged User An abridged user identification, stored in the register, is an abbreviated representation of the “user–id”, “project”, “password” and “billing” parameters, and/or others, belonging to a user and used to connect to several applications running on several remote machines. Alternative Correspondent The alternative correspondent must be defined to support the high availability feature.
G-2 OTM – TWS2107 Emulation User’s Guide
Index Symbols $*$, 2-33 $*$BRK, 2-12, 2-34, 5-13 $*$CN, 2-12, 5-13 $*$DIS, 2-12, 2-34, 5-13 $*$FC, 2-34 $HOME/vip_conf File, 2-4 Numbers 25th Line, 4-8, 5-12 A Abridged User, 2-31, 3-3, 3-7, 3-10, 4-2, B-15 Abridged User Name, 3-2 Account, 3-9, 4-6 Addressing Parameters, 2-33 Administration Menu, 3-1 Alarm Signal, 2-8, 2-11, 2-15 Application, 3-5, 4-5 B Billing, 3-9 Blink/Blank, 2-8, 5-10 Break, 5-16 C Carriage Return, 5-3 Character Sets, 1-3 Commands Communications, 2-3 Display, 2-3 Help, 2-3 Configura
Function Key Menu, 2-30 Function Keys, 1-3, 2-12, 2-24, B-16 Menu, 2-4 Name, 2-22, 2-27 Type, 2-27 H HA_TIMEOUT, 4-11 Help, 5-16 Help Commands, 2-35 High Availability, 4-11 Home, 5-3 I Identification Parameters, 3-2 Identifier, 3-9 Immediate Mode, 2-8 Insertion, 5-8 Installation, 1-5 IOF, 2-22, 2-29, 3-2, 3-9, 4-6, B-14 ISO Model, 1-4 ISO/DSA Address, 3-2 ISO/DSA Mode, 3-2 ISO/DSA Network, 1-1, 1-4 P Page Overflow, 5-15 Partitions, 1-3, 5-6 Password, 3-2, 3-9, 4-6 PC Keyboard, 2-22 Q303, 5-1 Q306, 5-1 Pe
Q306, 2-22 Q310, 1-3, 2-22 Real, 2-3 Terminal Configuration Service, 2-1 Terminal Menu, 2-4, 2-7 Terminal Parameters, B-16 Text, 2-27 Timeout, 4-11 TRANSESP, 4-10 Transmission Commands, 5-11 TRANSPAC, 1-4, 3-2 Transport Service Access Point, 3-6 TRS0, 2-22, 2-28 TRS1, 2-22, 2-26, 2-28 TSAP, 3-2 TWS2107 Command Line Mode, 2-33 Commands, 2-3 Configuration of Emulated Terminal, 2-4 Emulation, 1-1 Register Files, 2-31 Session, 5-19 Specific Commands, 5-15 Starting, 2-1 Terminal Configuration File, 2-31 U UNEDI
X-4 OTM–TWS2107 Terminal Emulation User’s Guide
Vos remarques sur ce document / Technical publication remark form Titre / Title : Bull DPX/20 Open Terminal Management (OTM) TWS2107 Terminal Emulation User’s Guide Nº Reférence / Reference Nº : 86 A2 33PE 04 Daté / Dated : April 1996 ERREURS DETECTEES / ERRORS IN PUBLICATION AMELIORATIONS SUGGEREES / SUGGESTIONS FOR IMPROVEMENT TO PUBLICATION Vos remarques et suggestions seront examinées attentivement Si vous désirez une réponse écrite, veuillez indiquer ci-après votre adresse postale complète.
ORDER REFERENCE 86 A2 33PE 04 PLACE BAR CODE IN LOWER LEFT CORNER Bull Electronics Angers S.A.
Utiliser les marques de découpe pour obtenir les étiquettes. Use the cut marks to get the labels.
