Fri Mar 10 2000 dL4Term Terminal Emulator Release 4.1.2 All Rights Reserved. Copyright (c) 1999 - 2000 by: Dynamic Concepts, Inc. Aliso Viejo, CA 92656 USA Email address: techsupport@dynamic.com Information: www.dynamic.com Downloads: ftp.dynamic.com Pre-installation instructions ============================= o dL4Term does not require an SSN or installation of Passport for Windows. Usage of dL4Term is governed by the software license described in the file license.txt (see "File list" below). o Problem reports should be emailed to techsupport@dynamic.com. All problem reports should contain a description of the problem, the operating system type (Windows 95, Windows 98, or Windows NT), and, if at all possible, a reproducible sequence to duplicate the problem. o Please visit our web site at www.dynamic.com for additional dL4Term documentation. What is dL4Term? ================ o dL4Term is a telnet client which is installed on Windows 95/98/NT systems. Unlike other telnet programs, dL4Term does not emulate a specific character oriented terminal, such as a Wyse60 or VT100. Instead, it offers its own set of character-based and GUI (graphical user interface) features. The feature set that is understood is the set of UniBasic/dL4 mnemonics, including colors, fonts, protection and dL4 version 4 GUI mnemonics. dL4Term operates on the same principle as other emulators, in that it recognizes specific character sequences to invoke its features. It differs in the sense that it cannot be instructed to recognize, and thereby emulate, the hard-coded character sequences of specific terminals. When connected to a Unix host, for example, dL4Term supports shell, vi, IQ, UniBasic and dL4. In essence, dL4Term is a GUI (graphic user interface) oriented terminal model with multiple windows and graphic controls such as buttons and list boxes. It also supports displaying multiple fonts or graphics in any of the windows belonging to the GUI "terminal". Using dL4Term, GUI programs can run under either dL4 for Windows or dL4 for Unix and still produce the same Windows style user interface. These GUI features can also be used without using dL4. All of the GUI functions are controlled by character sequences thus allowing any Unix application to produce and control a Windows-like user interface. For character oriented Unix applications such as "vi", the GUI terminal model includes all necessary character terminal functions such as cursor positioning, line insertion/deletion, and protected characters. dL4Term can be installed and used on any Windows 95, Windows 98, or Windows NT 4.0 system that supports telnet (TCP/IP) connections to a Unix host. A standard telnet connection is used to communicate with host systems. Unix terminal configuration files are supplied and must be installed on each Unix host before using vi (terminfo), dL4 for Unix, UniBasic, or IQ for Unix. For GUI programming in UniBasic and languages other than dL4, the dL4Term user guide describes each of the character sequences used by dL4Term. Installation instructions ========================= To install dL4Term for Windows 95/98/NT, perform the following steps: 1. Remove any previous dL4Term for Windows 95/98/NT release. 2. Run the dL4Term installation program 1B_dl4term_4.1.2.exe (or whatever filename you have copied it to) and follow the displayed instructions. 3. Install terminal definitions for dL4Term on the host Unix system as described in the next section. Before using dL4Term, terminal definitions must be installed on the host Unix system. On each Unix host system, the system administrator should complete the following steps: 1. Copy each of the files from the dL4Term Samples directory to the Unix host system using FTP ASCII mode or any other method that will convert DOS text files to Unix format. 2. As root, compile the file dl4term.tic using the following command: tic dl4term.tic This command will compile and install a terminal definition for use by "vi" and other "curses" based programs that use terminfo ("termcap" is not supported). 3. To use dL4 for Unix with dL4Term, copy the file dl4term to the directory /usr/lib/dl4/term. After copying the file, use the following command to make it readable by all users: chmod 444 /usr/lib/dl4/term/dl4term If the dL4 terminal definition files were installed in a directory other than /usr/lib/dl4/term, simply change the commands to use the actual directory. Note that this terminal definition file can only be used with version 4.1 or later of dL4 for Unix. 4. To use UniBasic with dL4Term, copy the file term.dl4term.iris or term.dl4term.bits to /usr/lib/ub/sys/term.dl4term. If applications use the 'FM' and 'FX' mnemonics to enable and disable protected characters, copy the file term.dl4term.iris. If applications expect the 'BP' mnemonic to both paint and enable protected characters, copy the file term.dl4term.bits. After copying the file, use the following command to make it readable by all users: chmod 444 /usr/lib/ub/sys/term.dl4term If the UniBasic terminal translation files were installed in a directory other than /usr/lib/ub/sys, simply change the commands to use the actual directory. 5. To use IQ for Unix with dL4Term, execute the following command to append the dL4Term definition to iqcap: cat dl4term.iqcap >>/usr/lib/iq4/iqcap If IQ for Unix was installed in a directory other than /usr/lib/iq4, simply change the command above to use the actual directory. 6. On most Unix host systems, the environment variable TERM will be automatically set to the required value of "dl4term" when a dL4Term user logs onto the system. If not, the user ".profile" or other shell initialization file should be modified to set TERM to "dl4term". File list ========= readme.txt This file license.txt Runtime license terms and conditions dl4rt.dll Runtime library dl4stdrv.dll Runtime library dl4sockt.dll Runtime library msvcrt.dll Runtime library dl4term.exe dL4Term executable stubwa10.dll Runtime library arialmon.ttf Monospaced Arial font for use with dL4Term arialmb.ttf Monospaced Bold Arial font for use with dL4Term Samples\ Directory of terminal definition files for host systems dl4term.tic TermInfo source file for dL4Term terminal definition dl4term dL4 Terminal Description File (for dl4 4.1 or later) dl4term.iris UniBasic terminal translation file with IRIS style treatment of protected characters dl4term.bits UniBasic terminal translation file with BITS style treatment of protected characters dl4term.iqcap IQ for Unix IQCAP entry for dL4Term Highlights of This Release ========================== o Full support of dL4 4.1 GUI mnemonics (when used with dL4 4.1 for Unix). o Login scripts can be used to automate connecting to a system and starting an application. A script will present a dialog box if needed for input of a user name and/or password. Login scripts are created by using the Connect -> Scripting dialog. o In the connect dialog, the system name may either be an actual system name or a script name. A system name can include a service name or port number for connection to non-standard telnet ports or non-telnet services. The service name or port number is specified as suffix to the host name separate by a colon ("decker:daytime"). o A custom font, "Arial Mono for dL4", is included to increase legibility. New in This Release ================================================================= Mar 10 2000 (Release 4.1.2) o Maintenance release to fix various problems (see below). o The 'MH' (Move Home) mnemonic is now supported in edit boxes to move the current position to the beginning of the text in the box. o Bug fixed: the input focus was not moved to the current window if binary or activate-on-control-character input mode was used. o Bug fixed: scroll bars weren't enabled or disabled at appropiate times in multiline edit boxes ('WCEDIT' and 'WCTEXT' mnemonics). Dec 2 1999 (Release 4.1.1) o Maintenance release to remove beta period expiration. Nov 17 1999 (Release 4.1) o First production release of dL4Term for Windows. Notes ===== o dL4Term for Windows 95/98/NT cannot be used with Windows 3.1. dL4Term will only run under the Window 95, Windows 98, or Windows NT operating system. o The custom font, "Arial Mono for dL4" has been licensed by DCI for delivery with dL4Term. The font is a standard windows TrueType font and is compatible with other Windows applications, including Telnet, dL4 and IQ for Windows. "Arial Mono for dL4" has been included with the dL4Term license to ensure users have access to an identical font on each properly licensed dL4Term installation. Do not install or use these fonts on any system which does not have a valid dL4Term license. Arial is a trademark of The Monotype Corporation registered in the U. S. Patent and Trademark Office and certain other jurisdictions. o To start a telnet connection select the Connect function of the "Connect" menu to display the "Connect to host" dialog. A system name or script name can be entered in the "host" box or selected from the drop down list. The drop down list contains the most recently accessed system names and all script names. Select the "Connect" button to establish a telnet connection. o In the "Connect to host" dialog, the system name may either be an actual system name or a script name. A system name can include a service name or port number for connection to non-standard telnet ports or non-telnet services. The service name or port number is specified as suffix to the host name separate by a colon ("decker:daytime"). o Shortcut icons can be created to automatically start a telnet session using dL4Term. Simply create a shortcut to dL4Term and then modify the shortcut properties to add a system or script name to the target string. If the target string is quoted, add the system or script name after the closing quotation mark and separated by a space. o The Connect function cannot be used if a connection has already been established. To end the current connection, exit from the host system or use the Disconnect function of the "Connect" menu. o A connection can be terminated by exiting the host session (on a Unix host, type "exit" in the command shell), by using the Disconnect function of the "Connect" menu, or by exiting from dL4Term. Always exit from any host application before ending the connection so that the application can cleanly close any open files. o The Scripting function of the "Connect" menu makes it possible to create and modify login scripts. Login scripts are used to automate telnet sessions. A script can establish a telnet session, log on to the host session, and then start an application. A script consists of one or more actions selected from the Action drop down box. A typical script to log into a Unix system is: Start Wait for Host: ogin: Send User Id to Host Wait for Host: ssword: Send Password to Host Note that the strings "ogin:" and "ssword:" are arguments to the "Wait for Host:" action and must be entered in the Text box. When the script is used, dL4Term will display a dialog box for the user to enter a user id and password. The script will then attempt to log into the system. If attempt fails, the script will timeout in 60 seconds (the "Wait failed if Host sends:" action can be used to detect a failed login without waiting for a timeout). o Scripts can either be shared by all users or belong only to the current user. Set or clear the "Shared Script" check box to control how a script is saved. All scripts are saved in the registry under the key Software\DynamicConcepts\dL4Term\Scripts in either HKEY_LOCAL_MACHINE (shared scripts) or HKEY_CURRENT_USER (personal scripts). Scripts can be copied between systems by exporting and then importing the script registry entry in Regedit. o In the Scripting dialog, the Display check box controls whether host output is displayed while the script is running. The "Exit on Disconnect" check box, if set, causes dL4Term to exit when the telnet session ends. o The "Reset Terminal" function of the "Connect" menu can be used to reset the clear the screen, restore the default font, and delete all GUI objects. This function should only be used after a fatal application error leaves the screen in an unusable state. o Copy and Paste functions are available via a popup menu invoked by pressing the right mouse button. The "Edit" menu is also part of the main window menu bar or part of the System menu ("Alt-Space"). o Font characteristics, window size, and keyboard translation can be modified using the "Preferences" menu. The "Preferences" menu is part of the main window menu bar or part of the System menu ("Alt-Space"). The "Preferences" menu provides access to the "Font", "Initial Values", and "Keyboard" dialogs. Features that are controlled by the "Initial Values" dialog will not change until the next entry into dl4term. Changing the font or font size will immediately effect the current font used to draw new characters, but will not change existing text or the window size. o The number of lines and columns in the main window is controlled by registry settings and defaults to 25 lines of 80 columns. The values cannot be changed for a running instance of dL4Term, but the registry values can be modified by the "Initial Values" dialog for use by the next entry into dL4Term. In that dialog, the canvas values control the actual number of rows and columns while the window values control the number of rows and columns that are displayed. Note that the terminal description files used by terminfo and UniBasic assume a window size of 25 lines and 80 columns. o The default foreground and background colors are controlled by registry settings and default to those of the system color scheme. The default values cannot be changed for a running instance of dL4Term, but the registry values can be modified for future invocations by using the "Initial Values" dialog. o Keyboard translations can be modified using the "Keyboard" dialog of the "Preferences" menu. Changes are applied immediately and are saved in the registry for all future invocations of dL4Term. The "Special Key to Unicode" section is used to examine, add, or modify translations of key combinations to Unicode characters. For example, to define "Shift-F1" to be the character 'F13', enter "F14D", the Unicode character value of 'F13', in the edit box under the heading "Unicode", select the edit box under the heading "Key Combination", press the SHIFT and F1 keys, and then click "Set" and "Ok". Warning: it is possible to intercept normal Windows keys such as Alt-F4 (Close Window/Application) and thus interfere with normal Windows keyboard usage. In the list box, a "Key Combination" value of "VK=xxx" indicates a key combination which isn't supported by the keyboard. Platforms ========= Operating system information for dL4Term 4.1.2 production: ID Platform OS ---------------------------------------------------------------- 1B Win32 Intel Windows 95/98 or Windows NT 4.0