Tuesday December 4, 2001 dL4Term Terminal Emulator Release 4.4 All Rights Reserved. Copyright (c) 1999 - 2001 by: Dynamic Concepts, Inc. Aliso Viejo, CA 92656 USA Email address: techsupport@dynamic.com Information: www.unibasic.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 Windows operating system type (95, 98, ME, NT, 2000, or XP), and, if at all possible, a reproducible sequence to duplicate the problem. o Please visit our web site at www.unibasic.com for additional dL4Term documentation. What is dL4Term? ================ o dL4Term is a telnet client which is installed on Windows 95/98/ME or Windows NT/2000/XP 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 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/98/ME or Windows NT/2000/XP 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. GUI mnemonic use in general is described in the "dL4 4.3 GUI Training" document. Both documents are available on www.unibasic.com and ftp.dynamic.com. Installation instructions ========================= To install dL4Term for Windows, perform the following steps: 1. Remove any previous dL4Term for Windows release. 2. Run the dL4Term installation program 1B_dl4term_4.4.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 BINARY mode or any other method that will copy the files verbatim without a conversion from DOS to Unix text 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. On Linux systems that use "termcap" for some utilities, the command tic -C dl4term.tic >>/etc/termcap should be used to translate dl4term.tic to termcap format and append it to the termcap database. The file dl4term.cap can also be used with termcap implementations, but it may need modifications to avoid syntax errors. Some terminal dependent applications such as "bash" may require application dependent configuration. The "bash" shell, for example, often requires defining function keys in a ".inputrc" file for any terminal which is not using VT100 function keys. 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. To use dL4Term with dL4 3.x or earlier revisions, copy the file dl4term.dl43 to /usr/lib/dl4/term/dl4term. 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 Samples\ Directory of terminal definition files for host systems All of these files are Unix format text files and may not be displayable under Windows. dl4term.tic TermInfo source file for dL4Term terminal definition dl4term dL4 Terminal Description File (for dl4 4.4 or later) This file is recommended for use on most systems. dl4term.dl43 dL4 Terminal Description File (for dl4 3.x or earlier) To use this file, it should be renamed as "dl4term". dl4term.chwin dL4 Terminal Description File for dl4 4.1 or later using the character window driver instead of the standard GUI window driver. To use this file, it should be renamed as "dl4term". This file might be needed if applications depend on character terminal oriented behavior of the window driver. 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 dl4term.cap Termcap source file for dL4Term terminal definition. This file was prepared for Linux termcap, but may be usable with modification in other termcap implementations. The following files are only available in the dL4Term Plus edition: arialmon.ttf Monospaced Arial font for use with dL4Term arialmb.ttf Monospaced Bold Arial font for use with dL4Term Highlights of This Release ========================== o An optional separate buffer for WCQUERY results to simplify GUI programming in dL4. o dL4Term now allows dL4 for Unix applications to execute commands on the user's PC via the SYSTEM 31 statement. o dL4Term now allows dL4 for Unix applications to open a user selected local printer on a channel. o dL4Term is now available in two versions, dL4Term and dL4Term Plus. The dL4Term Plus version adds a highly readable proprietary font, "Arial Mono for dL4", for use by dL4Term. o New mnemonics 'LPI', 'CPI', and 'FONTCELL' provide more precise control of line height and character width on printers. The new mnemonic 'MARGIN' sets horizontal or vertical margins on printers. o A new GUI input element, 'WCDEFAULTBTN', creates a default button. o A new GUI mnemonic, 'BEGIN', selects the current contents of an edit box for replacement by user input the next time the edit box gains the input focus. New in This Release ================================================================= Dec 4 2001 (Release 4.4) o Support for two new dL4 mnemonics: 'WCBQRYBUF' and 'WCEQRYBUF'. Printing 'WCBQRYBUF' to a window enables special buffering for the data returned by the 'WCQUERY' mnemonic. Normally, sending 'WCQUERY' to a GUI element (such as 'WCSTRING') causes the element to return its current value. For example, sending 'n WCQUERY' where 'n' is the element number of a 'WCSTRING' edit box causes the text in the edit box to be returned as input to the window. This can cause complicate programming because query results are mixed in with event data such as function keys or GUI element status changes. The special buffering enabled by 'WCBQRYBUF' separates the query results from the event data. Event data can be read by normal INPUT statements, but the query buffer can only be read from "record 1" of the window channel. For example, Dim S$[100] Declare Intrinsic Sub DupChannel Call DupChannel(99,-4) Print 'WCBQRYBUF 5 WCQUERY'; Input #99,1;S$ Once a 'WCBQRYBUF' mnemonic is printed, the special buffering mode applies to all windows and persists until a 'WCEQRYBUF' or 'IORS' mnemonic is printed. o Support for a new dL4 mnemonic, 'PGMHELPFN'. The mnemonic sequence PChr$(n,"text");'PGMHELPFN' will program function key 'n' ('Fn') to send the character string "text" as input when pressed. In addition to "text", the function key will send the action string of the currently selected GUI element, if any. This mnemonic is similar to 'PGMFN', but can be used to implement context dependent function keys such as help or search keys. 'RF' or 'XX' mnemonics can be used to reset all function keys to their original values of 'Fn'. o Support for a new dL4 function, MSC(45), to return the GUI element number of the user selected GUI element or a WCQUERYed GUI element. The value returned is not the current element number, but rather the number at the time of the most recent input. For example, assume a user had selected edit box 1, typed 'F6', moved to edit box 5, and then typed 'F6' again. If an INPUT statement read only the first function key value, then MSC(45) would return 1, the selected element at the time the function key was pressed. The value of MSC(45) would not change to 5 until the second function key value was read by an INPUT or READ statement. o A new mnemonic, 'WCRESETFONT', has been defined for dL4 GUI programming. The new mnemonic restores the default font for use by newly created GUI elements. Typically, the mnemonic would be used to clear the font set by a previous 'WCSETFONT' mnemonic. o The Preferences->Printer dialog now allows the user to set an "Options" value. The "binary=true" option can be used with non-device printers to allow unformatted character sequences, such as PCL commands, to be sent directly to a printer (device printers always operate in a binary mode). o dL4Term now allows dL4 for Unix applications to execute commands on the user's PC via the SYSTEM 31 statement. A message box will display each command before it is executed and allow the user to accept or cancel the command. The DWORD registry value HKEY_CURRENT_USER\Software\DynamicConcepts\dL4Term\WinTerm\AllowSYSTEMCmd or HKEY_LOCAL_MACHINE\Software\DynamicConcepts\dL4Term\WinTerm\AllowSYSTEMCmd can be set to one to automatically accept commands without displaying the message box (note: if set to zero, an "AllowSYSTEMCmd" value in HKEY_CURRENT_USER will require the message box no matter how the HKEY_LOCAL_MACHINE value is set). This feature requires dL4 for Unix 4.3.2.6 or later. o dL4Term now allows dL4 for Unix applications to open a user selected local printer on a channel. This feature requires dL4 for Unix 4.3.2.6 or later. o Fix bug: auxiliary printer output was double or triple spaced when dL4Term was used with UniBasic. o Fix bug: dL4Term sometimes "froze" after an ESCAPE or other interrupt key was pressed. May 9 2001 (Maintenance release 4.3.1) o Two new open options have been added to the Windows Page Printer driver. The "LPI=n" option selects a default font size such that "n" lines per inch will be printed. The "CPI=n" option selects a default font size such that "n" characters per inch will be printed. The two options can be used together. The following example shows a printer script that uses 8 lines per inch, 10 characters per inch, with half inch horizontal and vertical margins: rem dl4opts=openas=selected page printer,lpi=8,cpi=10,hmargin=36,vmargin=36 rem rem dL4 selected by dialog printer script o Bug fixed: multiple selection list boxes (such as 'WCLIST') did not work on Windows 95/98/ME systems if two or more items were selected. Mar 15 2001 (Release 4.3) o A new mnemonic, 'WCDEFAULTBTN', has been implemented to create default push buttons. These buttons are identical to those created by the 'WCBUTTON' mnemonic except that the button is marked as the default and will be triggered by the user typing ENTER if the focus is on the button or on another non-pushbutton GUI input element. The arguments to the 'WCDEFAULTBTN' mnemonic are identical to those of the 'WCBUTTON' mnemonic. Note: if the 'nWCFOCUS' mnemonic is used to set focus to a non-default pushbutton, that button becomes the default. o Enhancement: the 'BEGIN' mnemonic can now be sent to GUI edit boxes (such as 'WCSTRING') to place the cursor at the start of the current text and to select the current text for replacement. The user can tab or otherwise move to a different GUI element to leave the value unchanged or type new characters to completely replace the existing value. To send the 'BEGIN' mnemonic to an edit box, the edit box must be the currently selected GUI element (via 'nWCSELECT'). The following example could be used to initialize the contents of a newly created 'WCSTRING' edit box and select the contents for replacement: Print '4WCSELECT';"Initial Data";'BEGIN';'0WCSELECT'; The 'n BEGIN' mnemonic can be used to perform the 'BEGIN' function on GUI element "n" and also set the input focus to that element: Print '4BEGIN'; o New mnemonics 'n,d GRIDENGLISH', 'n,d GRIDMETRIC', and 'n,d GRIDFONT" have been created to provide a higher precision method of setting the coordinate grid. In these new two parameter mnemonics, "n" and "d" are the numerator and denominator of a fraction which is passed to the mnemonic as a parameter. Thus the mnemonic string '1000,72 GRIDENGLISH' is equivalent to 'x GRIDENGLISH' where "x" is equal to 1000/72. Since 'GRIDENGLISH' sets the coordinate grid in 1000ths of an inch, this sets the grid to 1/72 inches (points). These mnemonics are supported by both the window and page printer drivers. o A new mnemonic 'n LPI' has been implemented to set the number of lines per inch when printing to the Page Printer driver. o A new mnemonic 'n CPI' has been implemented to set the number of characters (columns) per inch when printing to the Page Printer driver. A second form, 'n,d CPI' has been implemented to use the fraction "n/d" when setting the number of columns per inch. o A new mnemonic, 'n FONTCELL', has been implemented to set the font height by specifying the line height, rather than the character height. The mnemonic argument is in grid coordinates and is identical to that used by 'n FONTSIZE'. o A new mnemonic, 'MARGIN', has been implemented to set horizontal ('w MARGIN') and vertical ('w,h MARGIN') margins in the Page Printer driver. The arguments to the mnemonic are margins expressed in grid coordinate system units. For example, if the current coordinate grid was tenth inches ('100GRIDENGLISH'), then a half inch left margin could be set by '5MARGIN' or a half inch left margin combined with a one inch top/bottom margin could be set by '5,10MARGIN'. o A new printer mnemonic, 'nLANDSCAPE', has been implemented to select landscape mode if "n" is 1 and portrait mode if "n" is 0. The mnemonic should only be used at the beginning of a page. o The GUI window driver now treats the 'LK' (lock keyboard) and 'UK' (unlock keyboard) mnemonics as no-ops rather than reporting an illegal character error. o Behavior change: if the input focus is on a 'WCBUTTON' button and the tab option is enabled on at least one GUI element in the same window, then typing ENTER will trigger the button. o Enhancement: the drop down section of drop down lists ('WCLISTDROP' and 'WCEDITDROP') can now extend below the bottom of the window on which the list is placed. This makes it possible to place a drop down list near the bottom of a window. If the drop down section extends below the bottom of the screen, the drop down section will be displayed above the normal position. o Enhancement: the 'WCQUERY' mnemonic can now be used with two numeric parameters. The mnemonic 'm,n WCQUERY' (or PChr$(m,n);'WCQUERY') performs a WCQUERY on all GUI elements between m and n inclusive. o ESCAPE, ABORT, and function key ('Fn') characters typed in a GUI input element (such as 'WCSTRING') are now passed to the parent window of the GUI element. This allows applications to use ESCAPE and function keys to trigger special actions in GUI programs. o A new mnemonic, 'n WCWHERE', has been implemented to return as input the action 'n' string value of the GUI element currently selected as the input focus. See 'WCACTION' in the dL4 GUI tutorial for details on action strings. o "Clicking" on a selected item in a list box ('WCLIST') now unselects the item. o The 'WCUNMARK' mnemonic is now supported for single selection list boxes. o The hidden field option, option 16, is now supported in list drop boxes ('WCLISTDROP'). o Behavior change: the MODAL style is no longer ignored in child windows. A MODAL child window will disable all GUI input elements and typing in the parent window. The parent window itself is not otherwise disabled because that would disable the child window. o A new option value, 32, has been implemented for all GUI input elements. The new option causes any loss of input focus to be reported as an input value change (option 2). o Buttons ('WCBUTTON'), check boxes ('WCCHECK'), and radio buttons ('WCRADIO') now support multiline labels. Carriage returns ('CR') can be placed in labels to explicitly split lines. o Behavior change: list boxes ('WCLIST') now occupy the full vertical space assigned to the box. Previously, the height was truncated to eliminate any partially display list items (a list box that was 4.5 items high was displayed as 4 items high). This change makes it possible to align the bottoms of list boxes with varying heights. o Behavior change: the 'BG' and 'EG' mnemonics are now ignored by the Page Printer driver instead of causing an "illegal character" error. o Bug fixed: closing a window and then immediately opening a new window caused some output for that new window to be directed to the main window. o Bug fixed: radio buttons reported a value change only on the first occurrence. o Bug fixed: new independent windows were sized using the coordinate system of the last accessed window instead of the main window. o Bug fixed: 'nWCMARK' did not work after 'CU' was sent to a list box or drop down list box. Also fixed a memory leak when using hidden fields. o Bug fixed: GUI option 4, report changed value, treated any gain of focus in a radio button as a changed value. o Bug fixed: GUI elements and child windows were not positioned correctly when a window was scrolled from the 0,0 position and under some other circumstances. o Bug fixed: If GUI input elements with tab options existed in the parent window, it was not possible to enter input in a child window. o Bug fixed: the 'n WCUNMARK' mnemonic would unselect item "m" in a single selection list box if "m" was currently selected, but item "n" was not. o Bug fixed: tabbing between GUI input elements is now supported in child windows and is no longer restricted to the main and independent windows. o Bug fixed: outputting a bad mnemonic sequence to the Page Printer driver sometimes caused the driver to hang. Aug 1 2000 (Release 4.2) o The terminal definition files in the samples directory are now supplied as Unix text files rather than DOS files. o Scrolling performance of a full window has been improved by 50 to 80 percent on typical systems. o The dL4/UniBasic 'BA', 'EA', 'BO', 'EO', 'AE', and 'AD' mnemonics are now supported to direct output to an "auxiliary printer". When printer output is enabled, output will be sent to the printer selected via the "Printer" sub-menu of the "Preferences" menu. That printer can be configured to be a specific Windows printer, the default Windows printer, a user selected Windows printer, a COMn serial device, or an LPTn printer device. When sending output to a Windows printer, a document will be considered complete and all pages will be printed when auxiliary output is disabled by an 'EA', 'EO', 'AD', or 'XX' mnemonic. A program should not expect to be able to suspend output with 'EA', 'EO', or 'AD' and then later continue output on the same printer page. o The dL4/UniBasic 'WS', 'ES', 'SO', and 'SF' mnemonics are now supported to display a status line the bottom of a window. The 'WS' mnemonic redirects all output to the status line until an 'ES' mnemonic is output. The 'SO' (status line on) and 'SF' (status line off) mnemonics control whether the status line is visible. Note: the mnemonics and status line text must be output to the window that will contain the status line. When using dynamic windows ("WINDOW OPEN"), the "WINDOW OFF" statement or the CALL DUPCHANNEL intrinsic should be used to output status line mnemonics to the main window rather than the current window. o The dL4/UniBasic 'WD' and 'NR' mnemonics have been implemented to change the current font size to either the default font size or 6 tenths of the default font size. Assuming a default window width of 80 characters, the 'NR' mnemonic will set the font and window sizes to provide a width of 132 narrow characters. Both mnemonics clear the window with the equivalent of a 'CS' mnemonic. o A new mnemonic, 'PGMFN' has been defined to control the text sent by the 'Fn' function keys. The mnemonic sequence PChr$(n,"text");'PGMFN' will program function key 'n' ('Fn') to send the character string "text" as input when pressed. The 'RF' or 'XX' mnemonics can be used to reset all function keys to their original values of 'Fn'. This mnemonic will be supported by dL4 4.2. The 'PGMFN' mnemonic has the Unicode value of 0xF1BB. o A new mnemonic, 'INVERT' has been defined to invert colors within a specified region. The mnemonic has the following forms: 'INVERT' - Invert colors from the current position to the end of the current line. 'n INVERT' - Invert colors from the current position for 'n' characters. 'w,h INVERT' - Invert colors from the current position within a rectangle of 'w' characters width and 'h' characters height. 'x1,y1,x2,y2 INVERT' - Invert colors within rectangle defined by the points 'x1,y1' and 'x2,y2' of the current coordinate grid. The 'INVERT' mnemonic has the Unicode value of 0xF1BA. This mnemonic will be supported by dL4 4.2. o In Windows, the user can exit dL4 by selecting the exit button or the "close" action of the system menu. Exiting dL4 in this manner prevents the application from cleaning up any partially written transaction. A new mnemonic, 'ONCLOSE', has been defined to allow application to control such exits. The 'ONCLOSE' mnemonic has the following forms: PChr$(0,"text");'ONCLOSE' - Display "text" within a message box and give the user a choice of exiting dL4 or continuing the application. PChr$(1,"text");'ONCLOSE' - Display "text" within a message box and prevent the user from exiting dL4. PChr$(2,"text");'ONCLOSE' - Prevent the user from exiting dL4 and treat "text" as input for the program. PChr$(0,"");'ONCLOSE' - Disable any previously set ONCLOSE action. Programs using the 'ONCLOSE' mnemonic should output a null action ('PChr$(0,"");'ONCLOSE') or an 'XX' mnemonic before exiting to clear the ONCLOSE action. This mnemonic will be supported by dL4 4.2. The 'ONCLOSE' mnemonic has the Unicode value of 0xF1BC. o The "Initial Values" sub-menu of the "Preferences" menu has been renamed as the "Window" sub-menu. o Behavior change: the 'WCNUMBER' mnemonic now produces an edit box that accepts signed floating point numbers rather than just non-negative integers. The numbers must be in the format <"."> where the sign and decimal point are optional. Entering an illegal character will be rejected. Note: the edit box may return a return a value such as "-", ".", or "-." if the user starts to enter a legal number but never adds the expected digits. o Behavior change: the default keyboard configuration now defines the shifted function keys as F13 through F24. For example, pressing the "F1" key while holding down the shift key will generate an 'F13' character. This change only effects the default configuration and will not add the additional function keys to an existing keyboard configuration (set if the Preferences->Keyboard menu item has been used). o Beta bug fixed: the 'NR' and 'WD' mnemonics did not update the MSC(33) and MSC(40) function values (number of columns). This fix requires use of dL4 4.2 (beta 3 or later). o Beta bug fixed: using 'WD', 'NR', or font mnemonics sometimes caused a resource leak and eventually an error exit from scopew/runw. o Beta bug fixed: outputting illegal characters while the auxiliary printer was enabled sometimes caused legal characters to be lost. o Bug fixed: if protected characters and blinking characters were used together, the blinking area was not always cleared by the 'CS', 'XX', or other "clear" mnemonics. o Bug fixed: a selection in a list box or drop-down list box is reported immediately if the value changed option is used. o Bug fixed: GUI elements such as buttons sometimes needed to be "clicked" several times instead of just once. o Bug fixed: GUI elements such as buttons sometimes returned incorrect values when selected or changed. o Bug fixed: selecting a value from a drop list of a GUI element was not reported when requested by the WCACTION mnemonic. o Bug fixed: using a font size larger than the window caused a memory violation. o Bug fixed: typing a RETURN while a paste area was selected and a input was active caused a memory violation. o Bug fixed: opening a MODAL window in dL4 for Unix caused dL4Term to exit after displaying an "Unexpected error" message box. 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 appropriate 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 cannot be used with Windows 3.1. dL4Term will run under the Window 95, Windows 98, Windows ME, Windows NT, or Windows 2000 operating systems. o The custom font, "Arial Mono for dL4" has been licensed by DCI for delivery with dL4Term Plus. 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 Plus license to ensure users have access to an highly legible font on each properly licensed dL4Term Plus installation. Do not install or use these fonts on any system which does not have a valid dL4Term Plus 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.4 production: ID Platform OS ---------------------------------------------------------------------- 1B Win32 Intel Windows 95/98/ME or Windows NT 4.0/2000/XP