Copyright: Copyright (c)1995 by Softronics, Inc.


Table of Contents

DISCLAIMER

Getting Started - Installing Softerm

Introduction and General Information

Part1:  The Session Manager - Setting up Softerm

Session Manager Introduction

Session Manager Controls

File Menu

Setup Menu

Options Menu

Setup Toolbar

Session Phone Book

Connect Pushbutton

COM Interface

Definition of Session

Start a Session

Softerm Default Sessions

Setup a Session

Change a Session

Add a Session

Admittance Data Dialog

Entering a Phone Number

Definition of Object

Setup Objects

Cautionary Points About Changing and Deleting Objects

Setup Objects Overview

Terminal Emulation Objects

Keyboard Objects

Connection Path Objects

Modem Objects

File Transfer Objects

Script Objects

System Environment Objects

Nationality Objects

Telephone Network Objects

Maintaining Different Session Databases

To Create a New Database (*.MDB)

Creating a Script

Turning off Multimedia Sounds

Part2:  The Session Window - On-line With Softerm

Session Window Overview

Session Window Toolbar

Connecting and Reconnecting

Disconnecting

Sending and Receiving Files

Uploading

Downloading

Starting a Script

Capturing Data

Text and Binary Captures

Screen Snapshot

Recording/Playing Keystrokes

Assigning Functions to the User-Defined Button Bar

Scrollback

Mark/Copy

Fonts

Save Window

Changing Object Settings Within the Session Window

Save Setting Changes/Exit Session Window

Part 3: GLOSSARY


Softerm User's Guide
Disclaimer

Information contained within this reference manual is subject to change without notice and should not be construed as a commitment from Softronics, Inc.

Softronics' Softerm products, Softerm Classic, Softerm Modular, Softerm GroupWare, Softerm Plus, Softerm Plus +, Softerm Genome, Softerm Asynchronous Communications Server, and other Softerm products, including this Softerm product are all licensed products.

IMPORTANT:

BEFORE OPENING OR USING THIS SOFTWARE, READ THE SOFTRONICS' SOFTWARE LICENSE AGREEMENT.  BY BREAKING THE SEAL ON THE LICENSE AGREEMENT ENVELOPE YOU ACKNOWLEDGE THAT YOU READ, UNDERSTAND, AND AGREE WITH EVERY PROVISION IN THE LICENSE AGREEMENT CONTRACT.

This software described in this reference manual is licensed software.  The software may only be used in accordance with the terms of this agreement.  It is against the law to copy or reproduce this software on any medium except as specifically allowed in the license agreement.  No part of this reference manual may be reproduced or transmitted, this includes but is not limited to the following forms and means: electronic, mechanical, photocopying, recording, or otherwise, without prior written consent from Softronics, Inc.  This license may only be modified in a written amendment signed by an authorized employee of Softronics, Inc.

Kermit file transfer protocol is developed by Columbia University and is included in Softerm® at no charge.

Restricted Rights Legend

Use, duplication, or disclosure by the Government is subject to restrictions set forth in paragraph (b)(3)(B) of the Rights in Technical Data and Computer Software clause of DAR 7-104.9(a).  Contractor/Manufacturer is Softronics, Inc., 5085 List Drive, Colorado Springs, Colorado  80919, (719) 593-9540.

Trademarks

CompuServe is a trademark of CompuServe, Inc., and H & R Block Company

DEC and VT are registered trademarks of Digital Equipment Corporation

Hayes and Smartmodem are registered trademarks of Hayes Microcomputer Products, Inc.

MCI Mail is a trademark of MCI Communications Corporation.

Microsoft, MS-DOS are registered trademarks and Windows is the trademark of Microsoft Corporation

OS/2, PS/2, PC, AT, PC XT, Microchannel and IBM are registered trademarks of IBM Corporation

Telenet is the registered trademark of GTE Telenet Communications Corporation

Tymnet is the registered trademark of Tymshare Company

Softerm and Genome are the registered trademarks of Softronics, Inc.

Commercial names of products from other companies, manufacturers or developers that appear in this reference manual are registered or unregistered trademarks of their respective companies, manufacturers or developers, who have not expressed approval nor disapproval of this or any Softronics' products.  The names of other companies, manufacturers or developers are used in this document for illustrative purposes only, and to the owners' benefit, are used without an intent to infringe.

© Copyright Softerm Users Guide 1994 by Softronics, Inc.  All rights reserved.

DocLit No.  9400001015


Getting Started - Installing Softerm

Your Softerm package comes with an Installation Disk and numbered disks.  Your package may also include a TCP/IP kernel diskette.

To install Softerm:

1.	Insert the Installation Diskette in the floppy drive.

2.	Select Run from the Program Manager File menu.  The Run dialog box appears.

3.	If the disk is in drive A, type A:\INSTALL in the Command Line box, then click on OK.  The Softerm Installation dialog box appears.

4.	Follow the instructions appearing on screen until the installation is complete.

During installation, you can choose between installing all (INSTALL ALL) the program or customizing it (CUSTOMIZE) by installing only the modules and features you require. Any or all of the modules or features you choose not to install can be added later by using the Softerm Setup program or performing a Dynamic Install on the fly.

Once the program is loaded into Windows, you can run Softerm by clicking on its icon.


Softerm User's Guide - Introduction
Introduction and General Information

Thank you for choosing Softerm!  You are using a program designed to be easily manageable while providing all the capabilities required in a communications/terminal emulation program.

With a Windows environment and Softerms graphical user interface (GUI), you can set up Objects for a telecommunications Session.  Objects are a collection of settings that you configure and name.  Once named, the Object can be reused in variety of communications Sessions.  Softerm provides a means to make adjustments to Objects within the Softerm Session Manager and on the fly while within a Session Window.

This manual explains the main tasks you can perform in Softerm. The book is divided into two basic sections: The Session Manager  Setting Up Softerm, and The Session Window  On-line with Softerm.  The section entitled The Session Manager  Setting Up Softerm explains how to configure and maintain a database of communications.  The section entitled The Session Window  On-line with Softerm explains how to connect and use Softerm while communicating to a host computer or on-line service.

Before moving on, however, we suggest that you read the following general information and hints to help you avoid unnecessary problems in using Softerm:

•	On-line help is available for every display and field.  It can be accessed by:

1.	Pressing the Help pushbutton,

2.	Selecting a Help pulldown menu,

3.	Pressing the F1 key. The F1 key is particularly useful because it provides context-sensitive help for all fields. First select the field, if the field is the type that lists a function you can click on, highlight the field so that it is surrounded by a broken-line box, then press F1.

•	When you make changes to Objects that could affect working Sessions  such as choosing different Objects, copying Objects, naming Objects, or changing Object settings  give strong consideration to saving your changes with Save As instead of Save.  Save As is a good choice because the changes can then be tested without replacing the working version.  Save As also allows you to create an Object that is unique to your needs while keeping the Object on which it is based.  For more information see, "Setup a Session".

•	Definitions are not necessarily provided in the main body of the manual.  See the glossary in the back for meanings of key functions, options, terms, etc. that are not defined in the manual.

•	Softerm has designated COM2 as the modem-connection default.  If, when you initially use the program you dial a number and get a message that the modem connection cannot be found, try changing the communications (COM) port.

•	You can use the Exit option in the Session Manager window to quit Softerm no matter how many Sessions are active. All active connections will be broken and all resources will be cleared from memory.  If any Session Windows are active and the program detects that changes have been made to any Objects used by the window, you will be able to save the changes before exiting.

•	When setting up a communications Session to a host computer, BBS or information service, you need to know the requirements for terminal type, baud rate, and data bits, stop bits, and parity.

Note: If youre not sure of the baud rate and you are using a modem that supports 9600 Baud or greater, select 57,600 Baud. If youre not sure of your data bits, stop bits, and parity, try 8, 1, and None, or 7, 1, and even.


Session Manager Introduction

The Session Manager is where all configurations for Softerm are made.  It not only maintains your database(s) of Session and Object configurations, it serves as a manager for your communications activities.  When you run Softerm, you are presented with the Session Manager window. The Session Manager window displays a list box labeled, Session Phone Book.  The Session Phone Book contains all of the configured Sessions which you can choose to start (connect).  This section will describe how to Start Session, Add Sessions, Change Sessions and how to use Objects, the building blocks of Sessions.

Note:  Once you have created your Sessions, you have the option of changing your program setup so that Session Manager no longer plays such a visible role.  Sessions can be set to start automatically when Softerm is started, by profiling the Session as Autostart.


Session Manager Controls

File Menu

Setup Menu

Options Menu

Setup Toolbar

Session Phone Book

The Session Phone Book displays the name and comments of each Object contained in the current configuration file. If necessary, use the scroll bars to view all Session names and comments that extend past the edge of the display area.

Connect Pushbutton

By clicking the Connect Pushbutton, Softerm will establish a connection for the Session highlighted in the Session Phone Book.

COM Interface

This displays the type of connection for the Session highlighted in the Session Phone Book, i.e. COM Port, Winsock TCP/IP, etc.  If the connection type requires a phone number, then Softerm displays the phone number.


Session Manager - File Menu

New 	Creates a new database file  (*.MDB).

Open	Opens an existing database file (*.MDB).

Import Objects	Imports Objects from another Softerm database.

Export Objects	Exports Objects from another Softerm database.

Save as	Saves an existing database file under a new name.

Exit	Closes Softerm Session Manager and all active Session Windows.


Session Manager - Setup Menu

Add Session 	Sets up a new Session.

Change Session	Change the highlighted Session.

Delete Session	Removes the highlighted Session from the Session Phone Book.

Terminal Emulation Setup	Configure terminal emulation Object(s).

Keyboard Setup	Configure Keyboard Object(s) and Remap Keyboard.

Connection Path Setup	Configure Connection Path Object(s).

Modem Setup	Configure Modem Object(s).

Telephone Network Setup	Configure Telephone Network Object(s).

File Transfer Setup	Configure File Transfer Protocol Object(s).

Protocol Converter Setup	Configure Protocol Converter Object(s).

Script Setup	Configure Script Object(s).

System Environment Setup	Configure System Environment Object(s).

Nationality Setup	Configure Nationality Object(s).


Session Manager - Options Menu

Minimize on use	Minimizes the Window when a Session is started.

Multimedia	Configures the multimedia capabilities in Softerm.

Save window	Saves the parameters of the Session Manager window.

Dynamic install	Installs modules and features that were omitted during the Softerm installation.


Session Manager - Setup Toolbar

The Softerm Session Manager Setup Toolbar

Following are the names and functions of each of the Setup Toolbar buttons:

  Add Session 	Sets up a new Session.

  Change Session	Change the highlighted Session.

  Delete Session	Removes the highlighted Session from the Session Phone Book.

  Terminal Emulation Setup	Configure terminal emulation Object(s).

  Keyboard Setup	Configure Keyboard Object(s) / Remap Keyboard.

  Connection Path Setup	Configure Connection Path Object(s).

  Modem Setup	Configure Modem Object(s).

  Telephone Network Setup	Configure Telephone Network Object(s).

  File Transfer Setup	Configure File Transfer Protocol Object(s).

  Protocol Converter Setup	Configure Protocol Converter Object(s).

  Script Setup	Configure Script Object(s).

  System Environment Setup	Configure System Environment Object(s).

  Nationality Setup	Configure Nationality Object(s).


Session Manager - Session Phone Book
Session Phone Book

The Session Phone Book displays the name and comments of each Object contained in the current configuration file. If necessary, use the scroll bars to view all Session names and comments that extend past the edge of the display area.


Session Manager - Connect Pushbutton
Connect Pushbutton

By clicking the Connect Pushbutton, Softerm will establish a connection for the Session highlighted in the Session Phone Book.


Session Manager - COM Interface
COM Interface

This displays the type of connection for the Session highlighted in the Session Phone Book, i.e. COM Port, Winsock TCP/IP, etc.  If the connection type requires a phone number, then Softerm displays the phone number.


Definition of Session

Softerm uses the word Session to describe a complete configuration of an end to end communication.  The Session contains all the necessary setup to go on-line to a host system.  Within Softerm, the Session is comprised of a Terminal Emulation Object, a Connection Path Object, a File Transfer Object(s), a System Environment Object, and an Auto-start Script Object.  When your Session is completely setup, all you need to do is select the Session and push the Connect button, and Softerm will connect you.

Once a Session is Added, it will appear in the Session Phone Book.


Starting a Session
Start a Session

To start the Session, simply double click on the Session name inside the Session Phone Book or single click on it and push the Connect pushbutton.


Definition of Session

Softerm uses the word Session to describe a complete configuration of an end to end communication.  The Session contains all the necessary setup to go on-line to a host system.  Within Softerm, the Session is comprised of a Terminal Emulation Object, a Connection Path Object, a File Transfer Object(s), a System Environment Object, and an Auto-start Script Object.  When your Session is completely setup, all you need to do is select the Session and push the Connect button, and Softerm will connect you.

Once a Session is Added, it will appear in the Session Phone Book.


Softerm Default Sessions

Softerm comes with more than 20 default Sessions.  These default Sessions will appear in your Session Phone Book if you chose INSTALL ALL or selected them during the Softerm Installation.  Softronics has setup Sessions to connect to most of the popular on-line services.  Also, default Sessions have been configured to give generic connectivity; meaning, that any Session that contains the word generic in its name will connect to a large percentage of BBS type systems.

The default Session names should give you an idea which might be closest to your needs.  For example, BBS ANSI - 9600 followed by the comment Works with most bulletin board systems tells you the Session is tailored for bulletin boards using a typical ANSI type Terminal Emulation with a baud rate of 9600 bits per second.  Or, CompuServe® 2400 with the comment CompuServe on-line information service indicates that the default is set up to communicate with the CompuServe® network at a 2400 baud rate.

If the names and comments are not informative enough, simply click on the Change pushbutton located on the Setup Toolbar (or highlight Change Session in the Setup pull-down menu).


Setup a Session

Ever play with building blocks when you were a kid?  Your blocks could be stacked just like the pictures on the box, or you could mix and match to create designs all your own.  Thats pretty much what Softerm is like, only Softerm uses Objects as building blocks.  What sets Softerm apart from other communications programs is its capability for reusing Objects.  Think about the building blocks again.  Imagine that you have one tower of blue blocks and you want to build a second tower that is identical except for a red block on the top.  Youd have to round up another set of blue blocks, stack them just right, and finally place the red block.  But imagine if you could clone the first tower.  Then all youd have to do is set the red block on top.  Heres a Softerm communications example of the same idea.  Suppose you want to dial into a new bulletin board.  The connection requirements are the same as the one you regularly call, except that the new BBS requires a different Terminal Emulation Object.  With Softerm, you can use your old Session as a base.  Your only task then is to change the Terminal Emulation Object.  Just like that, you have a complete new Session ready to go.


Change a Session

To change an existing Session, do the following:

1.	In the Session Manager window, highlight a default Session that looks like a possible choice, then click on the Change pushbutton in the Settings Toolbar (or highlight Change Session in the Setup pull-down menu).  A dialog titled Change Session. The dialog contains pull-down menus for the following Session Objects: Terminal Emulation, Connection Path, System Environment, File transfer, and Auto-start Script. These Objects define the Session. Dragging the pull-down menus reveals other Objects that can be selected in each category.

2.	As needed, choose different selections for the pulldown menus.  For example, changing the Terminal Emulation Object from DEC VT100 to IBM ANSI will change the Session from using a DEC Terminal Emulation to an ANSI Terminal Emulation.

3.	Click on OK in the Change Session dialog.  The Admittance Data dialog appears, allowing you to enter a phone number or network address and save the Session setup. (See "Admittance Data Dialog")

4.	Click on Save or Save As.  Remember, if you click on Save, Softerm will overwrite the original Session configuration.  It is always best to use Save As when you are not sure if your new changes will work.

5.	If you chose Save As, you are required to Name the Session. Use the Comments area to write something meaningful about the new Session or the changes you made.  This could be an addition to a default comment or a short title that you will help you remember why you created the Session.

If you cannot find the Session Objects you require, see "Setup Objects".


Add a Session

To create a new Session, do the following

1.	Click on the Add button on the Setup Toolbar (or pull down the Setup menu and select the Add Session option).  This takes you to a dialog titled Add Session - Untitled. The dialog contains drop down list boxes for the following Session Object categories: Terminal Emulation, Connection Path, System Environment, File transfer, and Auto-start Script.  Dragging the pull-down menus reveals other Objects that could be selected in each category.

2.	Select an appropriate Session Object from each drop down list box.  Click on the list box arrow and then, click on the Object you require.

Note:  Softerm always requires you to choose a Connection Path with at least a Terminal Emulation or File Transfer or Script.  All other Object fields are optional.  However, if you  want to go on-line with a host system or information service,  you must choose a Terminal Emulation.

CAUTION: Do not simply accept the default Objects in the Session Object fields as if they will automatically work. Each Object is simply first in the alphabetical listing within its category.  You must select the Object you need from the drop down list.

3.	Click on the Add button. The Admittance Data dialog appears, allowing you to enter the phone number or network address and save the Session setup. (For more information, see "Admittance Data Dialog".)

4.	Unlike Change a Session, the Comments area will be blank when youre adding a Session.  But the possibilities are the same:  You can use the space to name the Session or to note certain configurations you made.

If you cannot find the Session Objects you require, see "Setup Objects".


Admittance Data Dialog

The Admittance Data is the final piece you need to complete your Session setup. When you have saved your work in this dialog, you are ready to make a connection, either with a modem or on a network.

Note: Starting a Session can also bring up the Admittance Data dialog. However, for expedience, many users choose to set up Softerm so the dialog does not appear when they start a Session (See Display this dialog box at connect time discussion below). This section only addresses using Admittance Data in saving Object or Session changes.

The type of Admittance Data dialog you see will depend on the type of Connection Path you chose for the Session.  Softerm analyzes the Connection Path and presents you with Admittance Data specifically for that Connection Path.  For example, if you choose a TCP/IP connection, Softerm asks you for an IP address. If you choose a COM Port with a Modem Object, the dialog will ask for a phone number. (For the procedure on entering a phone number, see Entering a Phone Number.)   The Admittance Data always asks you for the final variable piece that the Connection Path demands to make the end to end connection.

Admittance Data controls (changing these controls requires you to click on Save or Save As to retain them for future Session connections):

•	Bypass the autodial information message.  If this box is checked, Softerm will proceed to the Session Window whether or not a valid connection is established, and it will skip displaying the information message and dial timeout counter while a connection is being attempted.

•	Display this dialog box at connect time.  If this box is checked, the Admittance Data dialog will appear every time a given Session is activated. The reverse is true if the box is unchecked.

•	Redial. Another part of the dialog allows you tell Softerm to automatically redial a number and to stipulate how many times to try redialing. For example, if youre calling a number thats busy a lot (like some bulletin boards), you may want to change the Redial fields default to Continuous.

Whether your connection is modem-type or network, save your entries by selecting Save or Save As in the Admittance Data dialog (Save As is your only option if youre adding a Session). Choosing Save As brings up a dialog prompting you to name and comment the new Session.


Entering a Phone Number

For a Connection Path that includes a modem and requires a phone number, entering the phone number is the last step in adding or changing a Session or using a profiled Session. You enter that phone number in the Admittance Data dialog.

To enter the phone number for a profiled Session:

1.	Highlight the desired Session in the Session Phone Book and click on the Change Session pushbutton in the Settings Toolbar or select Change Session from the Settings pull down menu. The Change Session dialog appears.

2.	Click on OK.  The Admittance Data dialog appears.

3.	Enter the phone number. Hyphens are OK, but do not use parentheses for area codes.

4.	Use Save or Save As to save your entries.


Definition of Object

Softerm uses the word Object to describe a configured segment of the settings related to a Session.  One such segment of a Session is the Terminal Emulation.  Since over 60 Terminal Emulations are available for Softerm, and since each Terminal Emulation can be setup in hundreds of different ways, Softerm allows you to configure your own Terminal Emulation setup and save it as an Object.  By giving you Object functionality, you only need to configure something once, and then, you can reuse the configuration many different times.


Setup Objects

In the section Setup a Session,  we suggested that configuring a Session is similar to building a tower out of blocks (Objects).  In this section, we will talk about how to setup the Objects themselves.

Softerm has ten Objects. These are:

•	Terminal Emulation Object which contains Keyboard Object

•	Connection Path Object which can contain a Modem Object

•	File Transfer Object which can contain a Protocol Converter Object

•	System Environment Object which can contain a Nationality Object

•	Script Object

•	Telephone Network Object

These Objects, as previously discussed, are the building blocks for your communications Session.  You will be able mix and match Objects to create a variety of Sessions.


Cautionary Points - Changing/Deleting Objects
Cautionary Points About Changing and Deleting Objects

Cautionary Point 1 - Changes to an Object affects all Sessions using that Object.  Thus, we recommend that you use Save As to give a new name to any Object or sub-Object whose settings you change.

Cautionary Point 2 - If you delete an Object, the Object is removed from the Softerm database entirely.  Any Sessions setup with that Object will no longer work.  Do not delete an Object unless you are sure that no Sessions use the Object.


Setup Objects Overview

Add.  Using this button in any of the Object setup allows you to create a new Object.  Whether you change a setting or not, you will be prompted to name the Object when you save.

Change.  Using this button in any of the Object setup allows you to change the settings in an existing highlighted Object or to save your changes under a new Object name.  (See Cautionary Point 1)

Delete.  Using this button in any of the Object categories will delete the highlighted Object from the database. (See Cautionary Point 2)

Note: Because Delete acts the same for each Object, it will not be separately addressed below.

Comments:  Although this is an optional field, it can be useful by allowing you to enter up to 64 characters describing an Object.  This description can help you distinguish between two similarly named Objects.  For instance, if you remap the keyboard of the pre-profiled DEC VT-100 emulation so that it works with your companys accounting system, you might save this change as DEC VT-100 remap and write in the Comments field:  For accounting system.


Terminal Emulation Objects

A Terminal Emulation Object provides the interface so the host system believes it is communicating with the correct hardware terminal unit. The emulation interprets host-initiated commands and control sequences and transmits appropriate controls back to the host.

Here is the procedure for working with Terminal Emulation Objects:

1.	Click on the Terminal Emulation pushbutton in the Setup Toolbar or select Setup Terminal Emulation Object from the Setup pulldown menu.  This brings you to the Terminal Emulation Objects dialog, which lists the emulation Objects already setup in your Softerm Database (.MDB).

Note: All settings for Softerms Terminal Emulations are set to the original manufacturers specification.  All parameters and features use the seme terminology as the original terminal manufacturer.

Change Terminal Emulation Object:

Highlight the desired Object.  Pressing the Change button moves you to the Terminal Emulation Settings dialog, which lists the Objects settings and lets you change. Double clicking takes you to a dialog box or boxes unique to the settings requirements

Add Terminal Emulation Object:

Clicking the Add button presents you with a dialog showing a list of Terminal Emulations. Clicking one of these selects the Terminal Emulation you desire and takes you to the Terminal Emulation Settings dialog.  Your options are the same as in Change.

Note: If your Terminal Emulation stops working, add a new Terminal Emulation to reset your defaults.

2.	Make setting changes as needed.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the Terminal Emulation Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.


Keyboard Objects

The Keyboard Object lets you remap your PC keyboard to match a desired terminal or assign record mode macros to automate a Session.   Keyboard Objects are managed from either The Terminal Emulation Settings dialog or by pressing the Keyboard Objects pushbutton on the Settings Toolbar.

The Keyboard Object is linked to a Terminal Emulation Object.  A Keyboard Objects terminal type must match the terminal type of the Terminal Emulation Object to which it is linked.  For example, a VT100 Keyboard remap will not work with a Tandem Terminal Emulation.  If you have painstakingly remapped a keyboard and you cannot find it in your selection list in a Setup Terminal Emulation Object dialog, then the keyboard that you remapped does not match the Terminal Emulation for which you are trying to assign it.

Here is the procedure for working with Keyboard Objects:

1.	To work with Keyboard Objects from the Session Manager Window, Click on the Keyboard pushbutton in the Setup Toolbar or select Setup Keyboard Object from the Setup pulldown menu. This brings you to the Keyboard Objects dialog, which lists the Modem Objects already setup in your Softerm Database (.MDB).  Keyboard Objects can also be accessed from the Setup Terminal Emulation Object dialog.

Note: All settings for Softerms Keyboard Objects map the keyboard as closely as possible to original terminal hardware.

Change Keyboard Object:

Highlight the desired Object.  Pressing the Change button moves you to the Keyboard Objects dialog, which lists the keyboards mapping and lets you change it. Double clicking on Keyboard Remap takes you to a graphical representation of the keyboard and allows you to remap any keystroke of shifted keystroke.

Add Keyboard Object:

Clicking on Add brings up a window that gives you setting options for a new keyboard Object, including its layout, type, and nationality.  When you are finished saving, the new Objects name will appear on the list in the Keyboard Object dialog.

Note: If your Terminal Emulation keyboard stops working, remove the Keyboard Object from the Terminal Emulation Object setup.


Connection Path Objects

The Connection Path Object defines the interface your computer uses to communicate with another terminal or computer  whether in the same building or half a world away.  Interfaces vary depending on the type of connection being made.  Some personal computers use modems or modem-type cables, while others use network interfaces and hardware, such as ethernet.  In some cases, you could have both capabilities.

Note:  Certain network Connection Path Objects listed in Softerm are programmed so that they cannot be setup if the necessary drivers are not installed.  If you try to configure them, you get an error message.  Other network Connection Path Objects with uninstalled drivers can be setup, but you will get an error message when you try to make a connection.

Here is the procedure for working with Connection Path Objects:

1.	Click on the Connection Path pushbutton in the Setup Toolbar or select Setup Connection Path Object from the Setup pulldown menu.  This brings you to the Connection Path Objects dialog, which lists the Connection Path Objects already setup in your Softerm Database (.MDB).

Note: All settings for Softerms Connection Paths are set to the original manufacturers specification.  All parameters and features use the same terminology as the original manufacturer.

Change Connection Path Object:

Highlight the desired Object.  Pressing the Change button moves you to the Connection Path Settings dialog, which lists the Objects settings and lets you change them.  Double clicking takes you to a dialog box or boxes unique to the settings requirements

Note: The parameters for data bits, stop bits, and parity are grouped in the only possible valid combinations. You merely need to select a set.

Add Connection Path Object:

Clicking the Add button presents you with a dialog showing a list of Connection Paths available. Clicking one of these selects the Connection Path you desire and takes you to the Connection Path Settings dialog.  Your options are the same as in Change.

Note: If you are using a modem-type Connection Path, select Standard COM. The other names in the Add window list are network Connection Path Objects.

2.	Make setting changes as needed.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the Connection Path Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.

The Connection Path Settings dialog also allows you to set up the related Modem Object if the Connection Path requires a Modem.


Modem Objects

A Modem Object defines the command set used for a specific modem.

Here is the procedure for working with Modem Objects:

1.	To work with Modem Objects from the Session Manager Window, Click on the Modem Objects pushbutton in the Setup Toolbar or select Setup Modem Object from the Setup pulldown menu. This brings you to the Modem Objects dialog, which lists the Modem Objects already setup in your Softerm Database (.MDB).  Modem Objects can also be accessed from the Setup Connection Path Object dialog.

Note: All settings for Softerms Modem Objects are set to the original manufacturers specifications.

Change Modem Object:

Highlight the desired Object.  Pressing the Change button moves you to the Modem Objects dialog, which lists the settings allowed for the specific modem on which you are working and lets you change those settings.

Add Modem Object:

Clicking on Add brings up a window that gives you setting options for a hardwire, autoanswer, autodial or manual-dial modem Object.  Choose hardwire if you have a modem-type cable but no modem..  When you are finished saving, the new Objects name will appear on the list in the Modem Object dialog.


File Transfer Objects

File Transfer is a procedure that lets you move files back and forth to a host computer system (Uploading and Downloading).  The File Transfer Object uses the most popular and recent file transfer protocols as its basis.  File Transfer Protocols available within Softerm include, CompuServe B+, IND$FILE, Kermit, Kermit Smart Mode (Kermit Server), Honeywell Kermit, Softrans, Xmodem, Xmodem CRC, Xmodem Big Block (1k), Xmodem CRC Big Block (1k), Ymodem, Ymodem g, Ymodem Big Block (1k), Ymodem-G Big Block (1k), Zmodem, and Character File Send/Receive.

Unlike other Objects, while on-line in the Session Window, Softerm will let you select any File Transfer Object when transferring a file.  When you choose which File Transfer Object you want for a Session, you are only picking the File Transfer Object the Session will use as a default.  All File Transfer Objects will be available while on-line.

Both Zmodem and CompuServe B+ have automatic download detect capability.  Meaning, when a host system sends a file, Softerm will automatically go into receive file mode.  Because some Terminal Emulations have a problem with the character sequences transmitted used with automatic detect, there is a setting in the Terminal Emulation Object to toggle automatic detect off and on.

Note:  IND$FILE requires setting up a Protocol Converter Object.

Here is the procedure for working with File Transfer Objects:

1.	Click on the File Transfer pushbutton in the Setup Toolbar or select Setup File Transfer Object from the Setup pulldown menu.  This brings you to the File Transfer Objects dialog, which lists the File Transfer Objects already setup in your Softerm Database (.MDB).

Note: All settings for Softerms File Transfer protocols are set to the most commonly used settings.

Change File Transfer Object:

Highlight the desired Object.  Pressing the Change button moves you to the File Transfer Settings dialog, which lists the Objects settings and lets you change them. Double clicking takes you to a dialog box or boxes unique to the protocols requirements

Add File Transfer Object:

Clicking the Add button presents you with a new window showing a list of file transfer protocols from which to choose.  Clicking one of these takes you to the File Transfer Protocol Settings dialog. Your options are the same as in Change mode.

2.	Make setting changes as needed.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the File Transfer Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.


Script Objects

Before Script Objects can be setup, they have to be written in a text editor program and saved as a text file.  Information on creating a Script file is provided in the section Creating a Script.  Documentation on Script commands can be found in the file SCRIPT.WRI.

Script files are similar to batch and command files in that they automate repetitive tasks in a Session.  A Script File Object can pre-set up to five variables that can be used in the Script file.  A Script File Object can be designated as auto-start and will thus activate automatically when a Session starts.  To make a Script File auto-start select the Script you want to make auto-start in the Session Setup dialog (See "Add a Session" and "Change a Session").

Here is the procedure for working with Script Objects:

1.	Click on the Script pushbutton in the Setup Toolbar or select Setup Script Object from the Setup pulldown menu.  This brings you to the Script Objects dialog, which lists the Script Objects already setup in your Softerm Database (.MDB).  Please note, Softerm does not provide any pre-setup Scripts; so, the first time you view the Script Objects dialog, it will be empty.

Change Script Object:

Highlight the desired Object.  Pressing the Change button moves you to the Script Settings dialog, which lists the Objects settings and lets you change them.

Add Script Object:

Clicking the Add button presents you with a dialog in which you choose the actual file you want to make a Script File Object.

2.	Any changes to the Script have to be performed in a text editor.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the Script Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.


System Environment Objects

Similar to the control panel in Windows, the System Environment Object allows you to customize the way your Session Window is displayed and how it interacts with your printer and disk drives. You can change settings for screen colors and intensity, the default path for file operations, how (or whether) you save your work when you exit the window, and the way you use the mark/copy and scrollback editing tools during a Session. The Sub-Object setting within System Environment is Nationality.

Here is the procedure for working with System Environment Objects:

1.	Click on the System Environment pushbutton in the Setup Toolbar or select Setup System Environment Object from the Setup pulldown menu.  This brings you to the System Environment Objects dialog, which lists the System Environment Objects already setup in your Softerm Database (.MDB).

Change System Environment Object:

Highlight the desired Object.  Pressing the Change button moves you to the System Environment Settings dialog, which lists the Objects settings and lets you change them. Double clicking takes you to a dialog box or boxes unique to the System Environments requirements.

Add System Environment Object:

Clicking the Add button presents you with the System Environment Settings dialog, which lists the Objects settings and lets you change them. Double clicking takes you to a dialog box or boxes unique to the System Environments requirements.

2.	Make setting changes as needed.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the System Environment Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.

The System Environment Settings dialog also contains the related Nationality Object.


Nationality Objects

Softerm is designed to operate correctly between personal computers and host systems which do not use the United States character set.  For instance, when the host system transmits an È, we want Softerm to understand it as a ß.  Frequently, though, the host and the personal computer use different languages.  The Nationality Object provides the character code translation between the host system and the PC.

Here is the procedure for working with Nationality Objects:

1.	To work with Nationality Objects from the Session Manager Window, Click on the Nationality Objects pushbutton in the Setup Toolbar or select Setup Nationality Object from the Setup pulldown menu. This brings you to the Nationality Objects dialog, which lists the Nationality Objects already setup in your Softerm Database (.MDB).  Nationality Objects can also be accessed from the Setup System Environment Object dialog.

Change Nationality Object:

Highlight the desired Object.  Pressing the Change button moves you to the Nationality Objects dialog, which lists the settings for Nationality settings.

Add Nationality Object:

Clicking the Add button presents you with a dialog showing Nationality Object types.  When you are finished saving, the new Objects name will appear on the list in the Nationality Object dialog.

2.	Make setting changes as needed.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the Nationality Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.


Telephone Network Objects

The Telephone Network Object lets you enter a prefix and/or suffix for your phone number.  The Telephone Network Object is useful when you have dial a number, such as 9, for an outside line, or when you use a calling card for long distance call.  These numbers can be setup as an Object so you do not have enter them each time you dial.

Here is the procedure for working with Telephone Network Objects:

1.	Click on the Telephone Network pushbutton in the Setup Toolbar or select Setup Telephone Network Object from the Setup pulldown menu.  This brings you to the Telephone Network Objects dialog, which lists the Telephone Network Objects already setup in your Softerm Database (.MDB).

Change Telephone Network Object:

Highlight the desired Object.  Pressing the Change button moves you to the Telephone Network Settings dialog, which lists the Objects settings and lets you change them. Double clicking takes you to a dialog box for the Telephone Networks suffix or prefix.

Add Telephone Network Object:

Clicking the Add button presents you with the Telephone Network Settings dialog.  Double clicking takes you to a dialog box for the Telephone Networks suffix or prefix.

2.	Make setting changes as needed.

3.	When you are finished, click on Save, or Save As, or select Cancel to exit without taking action.  If you choose Save As, your newly named Object will appear in the Telephone Network Objects dialog list.  The Save and Save As dialog presents you with a required text field for Name and a text field for comments.


Maintaining Different Session Databases

Softerm is designed so that when you start the program the window title bar reads Softerm Session Manager, followed by the filename of the active modular database (*.MDB), which is called SOFTERM.MDB when you first install Softerm. Any changes to the configuration will be changed to the active database file.

If you like, however, you can create and save as many database files as you need, setting Softerm in such a way that your chosen database loads when starting the program.  This can come in handy if you want to sort your Sessions by categories.  For example, you could have a database for local BBSs, another for long-distance BBSs, and a third for work-related activities.


To Create a New Database (*.MDB)

Access the File pulldown menu and select New.  When youve named the new database file, you can optionally tell Softerm to build default Objects.  This will take a few minutes.  After that, you can access the new database by going to File in the pulldown menus and highlighting Open.

If you are concerned about accidentally deleting Objects in the setup windows, you can copy the SOFTERM.MDB database to a backup disk.


Creating a Script

Before you can setup a Script File Object, you need to create a Script file.  You can create a Script in any editor (such as DOS editor) that allow you to save a file as ASCII text.  For easy access to the file from Softerm, we recommend that you save the file into the Softerm directory.  Also bear in mind that when Softerm looks for Script files, the file extension is *.SCR.

Softerm's Script files act much like DOS batch files by automating repetitious operations. The Script language is intended for communications tasks. Because communications operations involve data,  Softerm's Script language includes many file and data manipulation functions.

Softerm Script capabilities include file transfer, disk file manipulation, error processing, operator input, text string manipulation, numeric operations, variable manipulation, conditional processing, and various calculations. Documentation on Script commands can be found in the file SCRIPT.WRI.


Turning off Multimedia Sounds

You dont have to work with Softerm long before you hear a pleasant voice confirming your actions, such as terminal disconnections, file transfers, and so forth.  Sometimes users decide they prefer to work in silence.  Should you want to disconnect the sound, follow these steps:

1.	In the Session Manager window (or the Session Window), highlight Multimedia in the Options pulldown menu.  This brings up a dialog box titled Softerm Multimedia Configuration.  It lists each individual multimedia event in the program.

2.	To shut off the multimedia entirely, click to remove the check mark in the lower left corner after the words, Multimedia Enabled.

3.	Click in the OK box.  This takes you back to the Session Manager window.

4.	Highlight Save Window in the Options menu. The voice is now shut off.

If you decide you want to restore the voice, follow the above steps, except click the check mark back after Sound Enabled.  You can use the Test button in the Multimedia Configuration dialog to preview any multimedia event.  Use on-line help for more information about multimedia.


Session Window Overview

The Session Window (sometimes referred to as the Runtime Window or the Terminal Emulation Window) is used for direct interaction with a remote host computer.  All the commands discussed in this section are activated from the Session Window. You access the Session Window from the Session Manager Window by clicking on the Connect pushbutton or highlighting Start in the Setup pulldown menu.


Session Window Toolbar

Session Window Toolbar

A horizontal row of buttons, called the Toolbar, is at the top of the Session Window.  These buttons provide single-click access to the most commonly used Softerm menu functions.

The Toolbar buttons are (from left to right):

  CONNECT - Dials the phone number or reconnects through your network, depending upon the Connection Path Object used for the Session.

  DISCONNECT - Hangs up the phone or disconnects through your network.

  TX (transmit) and RX (receive)  These are not buttons.  They light automatically when transmitting or receiving data and act like the lights you find on a modem.

  COPY TO CLIPBOARD - Copies marked text to the Windows Clipboard.

  COPY TO HOST - Copies marked text to the host computer system.

  PASTE - Pastes from Windows Clipboard to the host computer system.  Note: This action will only paste text. Graphics and bitmaps are not acceptable paste items.

  SEND FILE - Uploads (sends) file to host using your selected File Transfer Object.

  RECEIVE FILE - Downloads (receives) file from host using your selected File Transfer Object.

  SCREEN SNAPSHOT - Prints whats on the Session Window.

  SCROLLBACK - Brings up a scrollable window displaying your Session.  Scrollback is limited in memory to the buffer limits set in your Terminal Emulation Objects, Buffer Definitions.

  START SCRIPT - Lets you run a predefined Script or Script Object.

  KEYBOARD REMAP - Remap your terminal keyboard and save in your Keyboard Object.  If no Keyboard Object has been setup for your active Session, it performs the View Keyboard function.

  PERFORM KEYBOARD FUNCTION - Lets you implement terminal keyboard functions and playbacks.

  BEGIN KEYBOARD RECORD - Saves terminal keystroke combinations as a macro.

  END KEYBOARD RECORD - The Begin Keyboard Record button changes to this image when you begin recording a macro.  Click this button to end keyboard record mode.

  TERMINAL RESET - Resets terminal to native state and clears screen.

  HELP - Provides on-line help.


Connecting and Reconnecting

Connecting. Highlight Connect in the pulldown menu or click the Connect toolbar button.

Reconnecting. Repeat the Connect function if you are unable to make a connection (or you lose the connection you have). Unless disabled for this Session, the Admittance Data dialog appears.  Press OK if the phone number and other related data is correct. You are returned to the Session Window, and the connection is reestablished.

Auto-dial and Redial. If your Session is set up for auto-dial, activating the connection command will cause Softerm to dial the Session phone number.  If you get a busy signal and you have set your Session for redial in the Admittance Data dialog, Softerm will automatically redial the number.


Disconnecting

Highlight Disconnect in the File pulldown menu, or click the Disconnect toolbar button. This ends the Session and exits you from the program. Unless you have set up your System Environment otherwise, you will be prompted to save any setting changes as you exit.


Sending and Receiving Files

To send (upload) or receive (download) files, you need to have established a connection with a host computer and ready the host system to send or receive the file. The procedures appear below.

Sending Files (Uploading)

Receiving Files (Downloading)


Uploading

Here is the procedure for uploading (sending) a file:

1.	Go to an upload area in the host system.

2.	Highlight Send File in the Files pulldown menu, or click on the Send File toolbar button.  This brings up Softerms Send File dialog, where you are asked to identify the file you want to send.

Note: Its important to verify that the transfer protocol (at the top of the Send File dialog) matches that of the host.  The dialog allows you to change the protocol settings (by clicking on Change), but this usually is not necessary.

Note:  Most protocols give you about 60 seconds to select and send the necessary file. If you exceed that time limit, the host transfer mode will stop, and a "timeout" error message will appear in the Send File Transfer Status dialog.

3.	To send the file, type the file name and click the send button or find the file name in the on screen directory/files list and double-click on it. (See figure 1)

The Send File Transfer Status dialog appears, with a graphic depiction of the transfer and a running clock of the time required for its completion. When the file transfer is complete, you'll be returned to the Session Window.  To verify the transfer, look for it in the host library where the file was sent.

Multiple files. To send a series of files select the desired files within a directory; to send all the files in a directory, use *.*    You need to have a protocol that allows multiple file transfers. The following protocols allow multiple file transfers: Ymodem g,  Zmodem, Kermit, Softrans, FTP.


Downloading

Here is the procedure for downloading (receiving) a file:

1.	Access the download area on the host system.

2.	Select the file and put the host in a file download mode.

Note: If your Terminal Emulation has autodetect enabled, both the Zmodem and CompuServe B+ protocols will automatically detect a download and implement the file transfer.  Your file will be placed in the Default Path directory as specified in your Sessions System Environment Object. The following steps (3-5) will not be necessary.

3.	Highlight Receive File in the Files pulldown menu, or click on the Receive File toolbar button.  This brings up Softerms Receive File dialog, where you are asked to identify the directory to which the file will be downloaded (see figure 2). Its also important to verify that the transfer protocol (at the top of the Receive File dialog) matches that of the host.

4.	Click on the directory.  In Zmodem you don't need to type in the file name, but in other protocols you do.

5.	Click on receive. The Receive File Transfer Status dialog appears, with a graphic depiction of the transfer and a running clock of the time required for its completion. When the file transfer is complete you'll be returned to the Session Window.  To verify the transfer, look for it in the directory where the file was sent.


Starting a Script

Here is the procedure for starting a Script:

Note:  Information about creating a Script is provided in Creating a Script.  The following assumes that at least one Script file has been created or setup as an Object.

1.	Highlight Start Script in the Options pulldown menu, or click on the Start Script button on the Session Toolbar.  This causes the Select Script dialog to appear.

2.	Select a predefined Script Object; this brings up the Script Variables window, giving you the opportunity set variables within your Script.

3.	Press Start Script.


Capturing Data

Capturing data is a way of saving information, to disk or print, that is transmitted from your host.

Text and Binary Captures

Screen Snapshot


Text and Binary Captures

A text capture is limited to ASCII data.  A binary capture gives you everything sent from the host computer, including hidden escape sequences for screen positioning.  Youre not likely to want a binary capture unless you're troubleshooting your Session.

Here is the procedure for capturing data using the Capture Data toolbar button:

1.	Click on the Capture Off button at the bottom of the screen. The Capture Data window will appear.

2.	Choose what kind of capture you want to make.

Capture to Print (binary or text):  Click on this option to send the captured data directly to the printer.  Then press OK to return to the Session Window.

Capture to Disk (binary or text): Click on this option if you want to save the information to a file on your computer.  Clicking Capture to Disk brings up a Data Capture to Disk window, offering two choices:

a)	Letting Softerm automatically create a unique filename for the captured data, meaning that the program names it for you and puts the file in a Softerm directory (the default for which is SOFTEMP.###, where ### is a number from 000 to 999). When you enable this option and click on OK, Softerm tells you the exact filename and returns you to the Session Window.

b)	Assigning the captured data to a file name and directory you decide. After entering this information, press OK to return to the Session Window.

3.	When you are returned to the Session Window, the Capture button will show the capture choice (Disk or LPT).

4.	When you are finished capturing, click on the Capture button again.  This brings up the Close Capture dialog.

5.	Terminate the capture.

Capture to Print (binary or text):  Click on Save or Discard. The button returns to Capture Off mode.  Save causes the printer to begin printing the captured text (assuming your printer is turned on and is setup to be used with Softerm). Discard deletes the capture from memory and cancels the procedure.

Capture to Disk (binary or text): Click on Save or Discard. The button returns to Capture Off mode. Save causes the captured text to be copied to the designated directory/file. Discard deletes the capture from memory and cancels the procedure.

Here is the procedure for a data capture using the Capture Data option in the pulldown menu:

1.	Highlight one of the Data Capture options in the File pulldown menu.  If you choose print (text or binary), you will stay in the Session Window.  If you choose disk (text or binary), you will be taken to the Data Capture to Disk window (see step 2 above).

2.	Interact with the host computer system as you normally would.

3.	When youve got what you need, highlight Close Capture in the File pulldown menu.

4.	Terminate the capture.

Capture to Print (binary or text):  Click on Save or Discard. Save causes the printer to begin printing the captured text (assuming your printer is turned on and is set up to be used with Softerm). Discard deletes the capture from memory and cancels the procedure.

Capture to Disk (binary or text): Click on Save or Discard. Save causes the captured text to be copied to the designated directory/file. Discard deletes the capture from memory and cancels the procedure.


Screen Snapshot

This feature allows you to print whats on the screen, either to disk or the printer. To activate this function, click on the Screen Snapshot toolbar button or use the option in the pulldown menu.

Note:  Your Screen Snapshot will use the Windows Default Printer if you have not setup a printer in your System Environment Object.

Using the Session Toolbar: Depending on your System Environment Object,  clicking on the button sends the snapshot to the printer or to disk. If your path is set for disk, Softerm will tell you the name of the temporary file it created for the Screen Snapshot.

Using the File pulldown menu: Highlight Screen Snapshot in the File pulldown menu and choose between Printer or Disk.

If you choose Printer, the captured screen prints.

If you choose Disk, the Snapshot to Disk dialog appears, offering two choices:

a)	letting Softerm automatically create a unique filename for the snapshot, meaning that the program names it for you and puts the file in a Softerm directory (the default for which is SOFTEMP.###, where ### is a number from 000 to 999). When you enable this option and click on OK, Softerm tells you the exact filename and returns you to the Session Window.

b)	assigning the snapshot to a file name and directory you decide. After entering this information, press OK to return to the Session Window.


Recording/Playing Keystrokes

This feature allows you to enter a group of keystrokes and record them as a macro so that you can play them back whenever you want.  This is a time-saving feature in many connections where you have many iterative keystrokes.

Note: This feature will only record terminal keystrokes, not Softerm menu selections.

Here is the procedure for recording keystroke macros:

1.	Click on the Record Keystrokes toolbar button, or highlight Begin Keyboard Record Mode in the Options pulldown menu.  The Begin Keyboard Record dialog appears.

2.	Choose the playback number you want to record into.

3.	Click on record.  You are returned to the screen.  Note that the toolbar button icon has changed from the record symbol to the stop symbol.

4.	Type what you want to record on the screen.  When youre done, click on the Stop button or highlight End Keyboard Record Mode in the Options pulldown menu.

Here is the procedure for playing back a keystroke macro:

1.	Click on the Perform Keyboard Function toolbar button or highlight Perform Keyboard Function in the Options pulldown menu.  The Perform a Function window will appear.

2.	Click on the Playback number you want. The macro will appear on the screen.

In the Perform a Keyboard Function dialog, you will notice other available playback options, including dead keys (if they are set up) and any profiled keyboard actions, such as cursor movement and carriage return.


Assigning Functions to the User-Defined Button Bar

The user-defined buttons (the row of empty rectangles at the bottom of the Session Window) give you a speedy way to play back keystroke macros or implement menu functions.

Note: Button assignments are Session-specific; they must be saved as setting changes when you exit the Session or they will not be retained.

To define a button:

1.	Click on the button you want to define. The Define Button Function dialog appears. It contains a pulldown list of playback numbers and menu functions.

2.	In the Define Button Function dialog, name the button and highlight a playback number.  You can only use a number that has a macro assigned to it or a menu function from the list.

3.	Click on Define. You will be returned to the Session Window. The button now bears the name you gave it.


Scrollback

Scrollback allows you to view all that has appeared in your Session Window during your connection to the limits of its buffer, which can be set in the Terminal Emulation Settings dialog.

Heres the procedure for using Scrollback:

1.	Click on the Scrollback toolbar button or highlight Scrollback in the File menu.  This causes the Scrollback Window to appear. The window has its own pulldown menus, allowing you to save the data in the buffer to disk, copy to a clipboard, change fonts, and save the window.

2.	Close the Scrollback Window by selecting Close from the system Icon.


Mark/Copy

Mark the text you want to copy by:

1.	Clicking and dragging with a mouse, or

2.	Highlighting Mark in the Edit pulldown menu.

When text has been marked, the copy option is activated.  This gives you the option of sending the marked copy to the host using the Copy to Host option or placing the marked copy in the Windows Clipboard using the Copy to Clipboard option.

Using the toolbar button. Depending on your requirement, click on either the Copy to Host or Copy to Clipboard buttons.

Using the pulldown menu. Highlight Copy in the Edit pulldown menu; this reveals the options of Copy to Host or Copy to Clipboard.

Note: If you use fonts other than Softerm ANSI fonts, your display may not be accurate.


Fonts

Softerm supports all the fonts installed in your Windows system as well as a special font supplied by Softerm.  When you select this feature (highlight Font in the Options pulldown menu), you get to choose between Dynamic and Fixed fonts.

Choosing Dynamic means the Session Window will use the special Softerm font that automatically changes size to fit the entire display in any size window.  A very small window produces a very small font.

Choosing Fixed means the window will use a non-changing font and size.  A dialog will appear, allowing you to enter the font name and size.  Using a Fixed font can cause portions of your Session to be hidden beyond the borders of the window.

To save a font youve selected for a Session, use the Save Window option.


Save Window

Select this option to save any changes you make in the current Session Window. These are as follows:

Multimedia, Font, window position and size, user-defined buttons, and toolbar.

Note:  Save Window does not save Object setting changes. For information on saving changes to Object settings from the Session Window, see Save Setting Changes/Exit Session Window.


Changing Object Settings Within the Session Window

The Session Window allows numerous on-line Object setting changes during a Session. Changes can be temporary or saved to the same or a new Object.

Using toolbar buttons or the Settings pulldown menu, you can access setting screens for Terminal Emulation, Connection Path, Keyboard (this can only be changed if it is no longer the default keyboard), and System Environment Objects.

Note: Changing the COM port while on line will break the connection. Changing baud rates or communications parameters while on line will corrupt data on the screen. Try changing baud rates only if you view corrupt or bad data.


Save Setting Changes/Exit Session Window

If you want to retain on-line setting changes youve made in the Connection Toolbar (the horizontal row of buttons at the bottom of the Session Window), click on the Save button on the right side of that toolbar at any time.

If you want to retain other setting changes you made to Objects while on-line you can do so as you exit the Session Window.

Exit by clicking on the Disconnect button, highlighting Disconnect in the File pulldown menu, or highlighting Exit in the File pulldown menu.  If you have changed any settings, you will see a dialog asking if you want to exit and if you want to save the changes. Clicking on Exit and Save Settings in that dialog brings up a series of dialog boxes the same as you would see if you had changed the setting(s) by starting from the Set Up Objects dialog. Whether you Save, Save as or Cancel, you will be returned to the Session Manager window.


GLOSSARY

Auto-answer  Tells Softerm to automatically answer if your computer is in Host Mode.

Auto-Answer Disable  Command to disable the modem's auto-answer mode.

Auto-Answer Enable  Command to put the modem in auto-answer mode.

Auto-dial  Tells Softerm to automatically dial the Session phone number you enter in the Admittance Data dialog.

Baud Rate Transmission speed used by the communications link between your PC and the host computer.

Call Failure Type and Response Strings  A response string indicating why a connection was not established. Softerm matches the response string to a call failure type which is used in further processing.

Data Bits  The number of binary information data bits (7 or 8) contained in each character.

Dead Keys  Combination of two keystrokes that send and display non-standard characters, such as characters which use diacritical marks. "Dead" keys are so named because no action is taken until a valid follow-on key is pressed, at which time the dead key and the valid key are combined to form a character.

Device Carrier Exchange Timeout  The amount of time Softerm waits for the connection to be completed before reporting an error.

Device Initialization String  The modem command string that sends initial modem setup commands.

Dialing Prefix  Characters to be transmitted to the modem before the telephone number.

Dialing Suffix  The end of the modem dialing command.

Full Duplex  Characters entered at the keyboard are transmitted to the remote system without being displayed or processed locally.

Half Duplex  Characters entered at the keyboard are transmitted to the remote computer and are processed and displayed locally.

Hang-up String Command forcing the modem from data mode to command mode and to cause it to hang up.

Hardware Form Feed Capability  Refers to the printer's ability to advance to the top of the next page when the ASCII Form Feed character (OC hex) is received.

Hardwire  Direct connection using an asynchronous port.

Host Trigger String  If defined, this string always will be sought in incoming data while Terminal Emulation is active. When found, the string will initiate a Script or keyboard macro as defined by the host Parity. A method of error detection that is determined by the host computer.

Line Feed After Carriage Return  Determines the line termination characters required by the printer at the end of each printed line.

Mark for Delete  Select this button to mark the displayed incoming or outgoing character to be removed from Softerm's translate table.

Printer Deactivation String  Codes to the printer when printing terminates to reset it to a particular printing mode.

Printer Initialization String  Codes to the printer to set it to a particular printing mode (such as condensed or bold-face).

Receive Pacing  Defines the type of pacing control Softerm uses when receiving characters from the host computer system.

Remap Incoming Data Translation  Use to remap a single received character to a single character.

Remap Outgoing Data Translation  Use to remap a single transmitted character either to:

         1. A single character, or

         2. A sequence of up to four characters

Stop Bits The number of bits (1 or 2) which should be appended to each character to detect correct character framing.

Transmit Delay  Allows an adjustable delay between transmitted characters.

Transmit Pacing  Controls whether or not Softerm responds to pacing while transmitting data to the host computer.

View / Delete Data Translations  Use to display all incoming and outgoing characters which receive special processing for this profile, and to delete selected combinations.