TELIX CONFIGURATION MENU


TABLE OF TOPICS


Telix has many features which can be customized. These include things like the screen setup, the communications parameters, filenames and paths, and many other items. The default values for these parameters are stored in a file called TELIX.CNF, the configuration file. Telix will automatically read this file upon starting up. The first time you use Telix, this file is created for you with some standard default values. Pressing Alt-O while in terminal mode brings up the Telix Configuration Menu, which allows you to change all these default settings.

		+-| Configure Telix |------------+
		|                                |
		| Change which default settings? |
		|                                |
		|     Screen and color           |
		|     Terminal Options           |
		|     General settings           |
		|     Modem and dialing          |
		|     Filenames and paths        |
		|     ASCII transfers            |
		|     Protocol options           |
		|     Kermit transfers           |
		|     Comm port setup            |
		|     Write changes to disk      |
		|     Exit                       |
		|                                |
		+--------------------------------+

The first seven options are parameter screens, the last two deal with leaving the Configuration Menu.


Screen and Color Settings


This screen allows you to set various video related options. You will be shown a menu listing the various parts of the screen displays (such as menu foreground colors). If you pick one of these items you will be allowed to scroll through the possible colors for it by using the arrow keys. When you have selected the right colors, press Enter. If you want to leave the colors menu without selecting one press Esc.

Another setting on the Screen and Colors menu is the 'Screen write mode'. If you pick this option you will be asked in which way you want Telix to write to the screen. This depends on the video adapter present in your system. The first option is a direct screen write. This is the fastest mode, and should be used if you have a monochrome adapter, an EGA adapter, or another video adapter that never gets snow. The second option is a direct screen write with port checks.

This method is slightly slower. You should use this method if you screen gets snow on it or it flickers while executing the DOS 'dir' command. One card with which you should use this is the color/graphics adapter. Don't use this option if your video card doesn't need it, as it may interfere with communications. The final method is a screen write with BIOS calls. You should use this method with applications like Topview or DoubleDOS. This method is quite slow however. Note that you do not need this mode to run Telix under DESQview, since Telix is DV aware.

Another setting on this menu is 'Default screen size'. This allows you to pick an alternate default screen size of 80x43 or 80x50. Note that these modes require an EGA or VGA card. Note also that many EGA cards can not do 80x50, and some VGA cards can not do 80x43.

When you have finished picking the colors, select the 'Keep changes & exit' option if you want to keep the color changes you have made, or the 'exit' option if you want to discard them.

Table of Topics


Terminal Options


This screen contains settings related to Telix operation while in terminal mode (with some extending to other areas of Telix). To select a setting to change type the letter beside it. Telix will then allow you to change the old setting. Press Esc at this point to exit without changing anything. Options include:

  1. Default Communications Parameters

    These include comm port, bps (baud) rate, data bits, parity, and stop bits. Note that the current settings will not change, only the defaults for the next time you load Telix. Alt-P changes the current settings.

  2. Emulate Before Translation

    Some European systems override characters used by many terminal emulations to signal color changes and other items that don't show up on the screen as characters. Normally a received character is passed through the translation tables before being examined to see if it is such a character. This option allows the emulation to occur first, and then only translates those characters not seen as emulation commands.

  3. Default Terminal Type

    Allowable terminals are "TTY", "ANSI-BBS", "VT102", "VT52", "ANSI", and "AVATAR". Note that the current terminal will not be changed, only the terminal used the next time you run Telix.

  4. Status Line

    Telix allows a status line to be displayed at the top or bottom of the screen. The status line shows some useful information. Valid options are Top, Bottom or None. While in Terminal Mode the status line may also easily be toggled on or off by pressing Alt-8.

  5. Default Local Echo

    This controls whether or not Telix should echo on the screen any characters you type while in Terminal mode. This is usually off for BBS use. Local echo on is often also called Half Duplex, while local echo off is called Full Duplex.

  6. Add Line Feeds

    This controls whether or not Telix should add line feeds to incoming Carriage Returns characters while in terminal mode. If you are connected to a remote system and lines are overwriting each other, this should be on, otherwise it should be off.

  7. Strip High Bit

    Telix can strip the high (most significant) bit from incoming data bytes while in terminal mode. This is sometimes useful because it allows the high/parity bit of incoming text to be ignored.

  8. Received Backspace Destructive

    This setting controls how Telix treats incoming backspace characters. If backspace characters are destructive, Telix backs up over the previous character and erases it, otherwise the existing character is not erased.

  9. Backspace Key Character

    Normally, Telix sends Backspace when the Backspace key is pressed, and DEL when Ctrl-Backspace is pressed. This option allows these settings to be swapped.

  10. XON/XOFF Software Flow Control

    This controls whether or not Telix should use the XON/XOFF software handshaking protocol while in terminal mode and during ASCII file transfers. This should usually be on.

  11. CTS/RTS Hardware Handshaking

    Hardware handshaking is used with high speed modems and null modem cable links to regulate the flow of data. If the modem supports Hardware handshaking this should be on. If a null modem cable is being used and these signals are valid over the cable, this should be on.

  12. DSR/DTR Hardware Handshaking

    Hardware handshaking is used with high speed null modem cable links to regulate the flow of data. If a null modem cable is being used and these signals are valid over the cable, this should be on. Often a null modem cable will allow one type of hardware handshaking to be used, but not the other.

  13. Compuserve Quick B Transfers

    Compuserve Quick B file transfers are initiated by Compuserve, which sends a few special characters (Ctrl-E and Ctrl-P). Telix, upon detecting these characters while in terminal mode, starts the transfer. If another Host is sending these characters and causing problems, this option allows CIS Quick B recognition to be turned off.

  14. Zmodem Auto-Downloads

    Telix, while in Terminal Mode, can detect the packet from another computer sending files using the Zmodem protocol, and automatically begin a Zmodem download on the local end. This option allows this feature to be disabled.

  15. Answerback string Some systems require that the terminal program send an identification string when an ENQ (Ctrl-E) character is received. You may define such an 'answerback' string here. If this string is empty, nothing is sent. As well, note that the answerback string is not sent if Compuserve Quick B transfers are enabled (above), as Ctrl-E is used as part of that protocol.

Table of Topics

General Settings


This screen allows you to change some general default settings, including:

  1. Sound

    If this is off Telix will not make ANY sounds.

  2. Alarm Sound

    If this is off Telix will not make ANY alarm sounds, but will still beep when it receives the bell code from the remote host, unless the sound option is also off.

  3. Keep Aborted Downloads

    If this is on, Telix will keep files which were aborted during a download. Otherwise Telix will delete these files.

  4. Show Free Space for Downloads

    This setting controls whether or not Telix will display the free space on the disk when you start a download. The option to turn it off is provided because the free space display takes a few seconds for large hard disks.

  5. Quick Dial Bar

    When you press Alt-D to access the dialing directory, Telix normally first displays the Quick Dial Bar at the bottom of the screen, which allows you dial entries without having to view the dialing directory. If you would rather go directly to the dialing directory when you press Alt-D, set this option to Off.

  6. Confirm Hang-Up

    Setting this option to on will make Telix ask for confirmation before hanging up, when Alt-H is pressed.

  7. Default Usage Log Setting

    If this option is set to on, Telix will open the default Usage Log (as specified on the Filenames and Paths screen) at program start up. Otherwise the usage log must be manually turned on if needed.

  8. Scroll-Back Buffer Size

    This setting controls the size of the Telix Scroll-Back buffer (in kilobytes). For changes to this setting to take effect you must save the changes to disk and restart Telix.

  9. Capture File Buffer Size

    This is the size of the disk buffer that Telix should use for the Capture file when it is opened. Values from 0 to 4 Kilobytes are allowed. A larger buffer size means the disk is accessed less often.

  10. Date Format

    This is the format that Telix should use when displaying dates. Allowed formats are MMDDYY, DDMMYY, and YYMMDD.

  11. Date Separator Character

    This is the character that Telix will print between parts of the date when displaying a date. The default character is the hyphen (-).

  12. Time Format

    This is the format that Telix should use when displaying times. Allowed formats are 12-hour and 24-hour.

  13. Time Separator Character

    This is the character that Telix will print between parts of the time when displaying a time. The default character is the colon (:).

  14. Enhanced Keyboard Support

    This option allows you to turn off Telix's support for the enhanced (101) keyboard. This should normally be left on, unless there seems to be a keyboard problem.

  15. Shell: 16550 Buffer This option allows you to specify whether the buffer on the 16550a comm chip should be left on or off during a DOS shell. If it is installed in your PC, Telix normally recognizes and enables the buffer on this chip at all times, for greater efficiency, but there are still a few comm application that users might want to run from the shell which can not handle the chip with the buffer turned on.

  16. Shell: Swap to EMS/XMS/Disk

    This option allows you to specify whether Telix will attempt to remove most of itself from memory when executing DOS function calls. The default is off for backwards compatibility, but most users should be able to turn this on without problems.

Table of Topics

Modem and Dialing settings


This screen contains settings that Telix uses to control the modem and its output. The default configuration that Telix comes with is set up for Hayes compatible modems. These modems use the 'AT' command set. By changing these settings Telix can work with almost any modem. The parameters are:

  1. Modem Initialization String

    This string will be sent to the modem when Telix first starts. Different modems might need different strings. The default string is set up for Hayes compatible modems. It is:

                   ATZ^M~~~AT S7=45 S0=0 V1 X4^M
    

    where:

                   AT        is the modem attention code
                   Z         resets the modem to default state
                   ^M        sends the terminating Carriage Return character to
                             the modem.
                   ~~~       pauses to give the modem time
                   AT        is the modem attention code.
                   S7=45     makes the modem wait 45 seconds for a connection.
                   S0=0      turns off auto answer.
                   V1        makes the modem respond with words.
                   X4        makes the modem give extended result codes.
                   ^M        sends the terminating Carriage Return character to
                             the modem.
    
    

  2. Dialing Prefix 1

    A Dialing prefix is what Telix sends to the modem when dialing, before the number, for example, 'ATDT' for Hayes compatible modems. There are three dialing prefixes allowed, and in the dialing directory you may chose which one to use for each entry. One use for this is if your modem support MNP, to define two prefixes which turn MNP support on and off, thus avoiding the delay when you call a system that doesn't support MNP.

  3. Dialing prefix 2

  4. Dialing prefix 3

  5. Dialing Postfix

    The string Telix should send after the number when dialing. On Hayes compatible modems this is just a Carriage Return character, '^M'.

  6. Connect String

    The string which the modem sends upon establishing a connection. e.g., 'CONNECT'

  7. No connect strings

    Up to four strings which the modem sends when it has failed to make a connection while dialing, for example 'NO CARRIER', 'BUSY', etc.

  8. Hang-up string

    This is the string Telix should send to the modem to make it hang up. The default string works for Hayes compatible modems and is:

                   ~~~+++~~~ATH0^M
    

    where

                   ~~~       pauses Telix for 1 1/2 secs.
                   +++       escapes the modem into command mode.
                   ~~~       pauses Telix for 1 1/2 secs.
                   AT        is the modem attention code.
                   H0        tells the modem to hang up.
                   ^M        sends the terminating Carriage Return character to
                             the modem.
    

    Before sending this string to the modem Telix always tries to hang-up the modem by a faster way that works with MOST modems. This is done by dropping (turning off) a special signal called the DTR (Data Terminal Ready) line on the RS-232 port. If dropping the DTR makes the modem hang-up then the hang-up string is not sent to the modem.

  9. Auto Answer String

    This is the string that Telix should send to the modem upon entering Host Mode. This string should allow the modem to automatically pick up the phone when it rings, and initialize it in any other ways that might be necessary.

  10. Dial Cancel String

    The string Telix should send to the modem to cancel the current dialing attempt. On most modems all that is necessary is a Carriage Return character, "^M".

  11. Dial Time

    The amount of time Telix should wait for a connection while dialing. This should usually be set to be greater than the amount of time the modem waits for the connection.

  12. Redial Pause

    The number of seconds Telix should wait between attempts while redialing.

  13. Auto Baud Detect

    If this option is on and Telix dials a number, it will check the modem connect message for a baud rate indication. If the baud is different than was specified for the entry being dialed, Telix switches to the new baud rate. This option only works with Hayes compatible modems. This option must not be enabled when you have told the modem to maintain a constant or locked baud rate between the computer and the modem, as is often done with high-speed, error correcting modems, or modems supporting MNP (e.g. USR HST, Hayes V-Series, etc.).

Table of Topics

Filenames and Path Settings


This screen allows you to change several filename and pathname defaults, including:
  1. Download Directory

    The disk directory in which Telix should save files which are downloaded (received). The user can override this by giving a full pathname when prompted.

  2. Upload Directory

    The disk directory where Telix should look for files to be uploaded. The user can override this by giving a full filename when prompted.

  3. Script Directory

    The directory in which Telix should look for script files when trying to execute them. The user can override this by using a full pathname in front of the filename when specifying it.

  4. Default Capture File

    The default name Telix should use when opening the capture file. The user can override this.

  5. Default Usage Log

    The default name Telix should use when opening the Usage Log. The user can override this.

  6. Directory Program

    The name of the disk directory program the Telix should run when you select the 'Files directory' command. If you do not specify a program here Telix will use an internal routine that also displays the amount of time it will take to transfer each file in the directory. An example of a program you could specify here is 'dir/p', which would use the DOS dir command with pauses at each page full, to display the directory.

  7. Screen Image File

    The file that Telix should save screen images (generated with the Alt-I command) to. the default name is TELIX.MSG.

  8. Editor Pathname

    The name of your editor, including the extension of the name (EXE, COM, or .BAT for batch files), for example, C:\EDITOR.COM. The indicated file must either be in the current directory, in a directory included in the DOS Path, or the name must include the full path. You need to set this parameter only if you want to run your editor using the Alt-A, Run Editor command.

Table of Topics

ASCII Transfers


This screen allows you to customize Telix ASCII file transfers to your needs, so that Telix may work with almost any system. Available settings are:
  1. Strip High Bit

    If this parameter is on, the high (most significant) bit of each character sent for uploads, or received for downloads, is stripped. This can be used to ignore parity. On the other hand, the upper 128 characters in the IBM extended ASCII character set are then converted to the lower value.

  2. Remote Abort Character

    This is the character which when received during an ASCII upload or download, is taken to mean that the remote end wants to abort the transfer. One possible value might be 24 (Ctrl-X).

  3. Local Echo

    If this is on, Telix will echo characters locally while uploading. This should normally be off.

  4. Expand Blank Lines

    If this is on, when Telix is sending a file and it encounters a blank line, it will add a space to that line. This is very useful for systems that assume a blank line means "end of file", or for uploading a message on most bulletin boards.

  5. Pace Character

    This is the ASCII value of the character that Telix should wait for before sending each line. If this value is 0, Telix will not wait for any character.

  6. Line Pacing

    This is the amount of time (in 1/10 seconds), that Telix should wait before sending each line. This delay is often not necessary, but for some bbs's for example, it's vital.

  7. Character Pacing

    This is the time delay (in milliseconds) that Telix should wait between each character. As the PC's hardware clock does not have enough resolution, this is a software loop based delay. Therefore, a value of 1 here will delay a 4.77 MHz XT approximately 1 millisecond, and faster PCs for a proportionally smaller time period.

  8. Upload CR Translation

    This is what Telix should do with Carriage Return chars when uploading ASCII files. The three options are to do nothing, to strip them, or to add a Line Feed character afterwards.

  9. Upload LF Translation

    This is what Telix should do with Line Feed characters when uploading ASCII files. The three options are to do nothing, to strip them, or to add a Carriage Return before each.

  10. Download CR Translation

    This is exactly the same as setting E (above), but applies when downloading ASCII files.

  11. Download LF Translation

    This is exactly the same as setting F (above), but applies when downloading ASCII files.

Table of Topics

Protocol options


This screen allows you to configure external protocols, as well as a few other settings.

An external protocol is simply a file transfer protocol that is implemented outside of Telix. You specify the name of the protocol, the key used to select it on the file transfer menu, and define how it is to be called. You may optionally define a string which will trigger an automatic download much like the auto zmodem transfer capability built into Telix. Items 'A' through 'E' are the definitions for the five external protocols allowed. When you select a definition to edit, Telix will ask a series of questions:

Key

The key that should be pressed to select this protocol when the file transfer menu is displayed.

Protocol Name

The name Telix will display on the file transfer menu for this protocol.

Upload Filename

This is the name of the DOS batch file or Telix script file to call when the user selects an upload using this protocol. If this filename begins with an "@" symbol, Telix will create an ASCII text file "FILELIST" containing the list of specified or tagged files, one file per line. Many external protocols can accept such a file as a parameter, and thus limits on the number of files that can be passed on a DOS command line may be circumvented.

Download filename

This is the name of the DOS batch file or Telix script file to call when the user selects a download using this protocol.

BAT or Script

This controls whether the above two filenames are DOS batch files or Telix script files.

DL Name

This option controls whether or not Telix should ask for the name of the file when performing a download using this protocol. In many protocols, the sender passes the name of the file(s) to the receiver, so Telix shouldn't ask for the download name.

Trigger String

This option is a place to enter a string which when received is indicative of a file being received by the protocol. Telix can thus automatically detect an incoming file and move to download it without need of your intervention. This string must be consistent, unique, and positively identify the occurance of an incoming file. Check your external protocol documentation to determine if the protocol supports a trigger string. This option should be left blank if there is no trigger available for the protocol.

See the Appendix titled External Protocols for information about what information is passed to the batch or script files when an external transfer is selected.

Other settings on this page are:

  1. File Transfer Disk Buffer Size

    This allows you to set the size of the disk buffer used by Telix during file transfers from 1k to 10k (kilobytes) in size. A larger value is more efficient with floppy disk systems, while a smaller value can get around problems with disk controllers or Extended memory use on some hard-disk systems.

  2. Relaxed Xmodem Timing

    This option controls whether or not Telix should use relaxed timing when performing an Xmodem transfer. When calling some services, this option must be turned on because they can not tolerate strict timing.

  3. Filename Guessing

    This option controls Telix's use of filename guessing. When you selected a file transfer to be performed, telix can often guess the name of the file to be transferred, based on your past keystrokes. This option may be turned off here. As well, you may specify that Telix gives only guesses which it is almost certain are filenames, or gives its 'Best try', which may include guesses with extra characters which are not necessarily part of the filename.

  4. Zmodem Receive Crash Recovery

    When an aborted Zmodem transfer must be resumed, this option should be turned on. While this option is on, if a file being downloaded using Zmodem already exists on the disk (and is shorter than the file the sender has), Telix will tell the sender to send only the bytes needed to complete the file. This option should be used with care. The possibility exists that a file with the same name but different contents exists on each system, in which case you do not want only some of the data transferred.

  5. Zmodem Send Crash Recovery

    When this option is on, during a Zmodem upload of files, Telix will try to tell the sender to resume aborted transfers. This option should be used with care, as some systems do not support crash recovery, and will behave unpredictably.

  6. Allow Zmodem 32 bit CRCs

    Real speed freaks may turn off the use of 32 bit CRC error checking (still quite reliable 16 bit CRCs are used instead), to get on the order of a quarter to a half of a percent speed increase in Zmodem transfers.

  7. Zmodem Window Size

    Zmodem normally sends data in streaming mode, never pausing unless the other side requests a re-send due to an error being detected. In some environments, a pause for acknowledgments can be more efficient. The window size (in kilobytes) is the maximum amount of data the protocol should seed before waiting for a reply. A value of 0 indicates streaming mode should be used.

  8. Zmodem File Type

    This option allows you to specify whether the file being transferred with the Zmodem protocol is Binary, ASCII, or Either. Binary means that Telix will make sure no end-of-line conversion is done on files received or sent. ASCII means that on a download, as long as the other side doesn't override this, Telix will assume the file being received is a text file and will make sure the end of each line has a Carriage Return followed by a Line Feed, by adding the CR if the file has only LFs at the end of each line. An ASCII setting when sending will make Telix tell the other system to do end-of-line conversion, although the other system may override this. Finally, a setting of Either (the default), will make Telix assume the file is binary, unless the other system indicates otherwise. DO NOT use a setting of 'ASCII' for file that are not ASCII text files, as binary files will be corrupted by this option.

Table of Topics

Kermit Transfers


This screen allows you to configure Telix's implementation of the Kermit protocol to your needs. The options will not be described here, due to the fact that the Kermit protocol is relatively complicated, and if you must change one of these parameters, you should generally already know what it means.

Table of Topics


Comm Port Setup


This screen allows you to configure/define the communications ports. Telix supports definitions for 8 comm ports. By default, the first four comm ports are defined to the standards for COM1 through COM4. The last four comm ports are by default duplicates of COM1. For each port you may define the base address (in hexadecimal) of that port, as well as the interrupt request number (irq) to use. Unless you are absolutely sure about your information, do not modify these values! Wrong values could cause unexpected and possibly disruptive results.

Table of Topics


Saving Changes and Leaving


Any modified settings can be saved to the configuration file (so that they will be remembered when you next use Telix) by selecting the Write Setup to Disk option. If you want to keep any changes just for the current session, then exit the Configuration Menu using the Exit option.

Table of Topics


[Table of Contents]
Page layout by S. Spyrou, C. Polichroniadis
HTML Programming by C. Polichroniadis