Connect Help File Version 3.5

<Contents>
[>>]<Menus>
Connect Help Contents
Welcome to the ShivaRemote User's Online Guide. This user's guide
provides instructions on how to use the ShivaRemote software. For
help using ShivaRemote, select any of the topics listed below.

Use the tab key to highlight a topic, then press the Enter key for
help on that topic.  If you have a mouse, double-click the topic.

  [..Help on Menus]<Menus>
  [..Help on This Display]<Display>
  [..Common Dial-In Problems]<Problems>
  [..Additional Procedures]<Procedures>

For further information on using ShivaRemote, see any of the following
documents:

  Shiva Remote User's Quick Reference Card (a printed card included
     with ShivaRemote)
  ShivaRemote User's Online Guide for Windows (a Windows online help file)
  ShivaRemote Software Configuration Notes (CONFIG.TXT in DOS or
     CONFIG.HLP online help file in Windows)
  
<Menus>
[<<]<Contents>
[>>]<Display>
Connect Menus
The Connect menu bar contains four menus:  File, Edit, System, and Help.
Each menu is described below.


File Menu   The File menu lets you save displayed information as a
            connection file and retrieve information from a connection
            file for display.

  New       Clears all connection file information and displays the
            default values for a new connection.

  Open      Allows you to read a connection file that has been saved on
            your disk.  Connect reads the information in the file and
            displays it in the main Connect window.

  Save      Allows you to save the displayed information to disk under
            the name you previously specified.  If you have not yet
            given the connection file a name, you will be asked to
            provide one.

  Save As   Allows you to save the displayed information to disk with
            the name and path you specify.

  Exit      Exits the Connect application and returns to the DOS prompt.
            If you have not saved the displayed information in a
            connection file, you will be asked if you want to do so.


Tools Menu     The Tools menu lets you view statistics and change your
               COM port configuration for all dial-in connections.

   Statistics   Allows you to view the dial-in driver's statistics for
               the serial port and for each protocol supported.

   Port Setup  Allows you to view and change your computer's COM port
               configuration for all dial-in connections. You can specify
               which serial port you are using, which modem you have,
               and so on.


Edit Menu   The Edit menu is not currently supported in ShivaRemote
            Connect for DOS.


Help Menu   The Help menu lets you get general help for the Connect
            program.

   Contents
            Displays the main screen of this online help.

   Help on this Display
            Displays this online help file in a topic that describes
            the current screen of ShivaRemote Connect.

   Common Problems
            Displays this online help file in a topic that describes
            common problems and suggests solutions to them.

   About    Displays the Connect version number, and the version number
            of the dial-in driver that is loaded.



<Display>
[<<]<Menus>
[>>]<Problems>
Connect Display
The main Connect display lets you enter the basic information needed
to dial into a remote network.  Each field is described below.

Description

   The Description field lets you provide a short description of the
   connection file (such as "Main Office").  This field is optional.

Dial-in Name

   Enter your dial-in user ID for the remote access server you will
   be calling. Your Dial-in Name is assigned by the remote system
   administrator.

Password

   If your network administrator has assigned a password to your dial-in
   name, enter it here.  For security reasons, your password is not
   written to disk when you save the connection file.

Phone Number

   Enter the phone number of the remote device you will be calling.  Be
   sure to include any access codes needed to place the call from your
   location, such as a "9" to use an outside line (as in
   "9, 1 800 555 1212".  Do not include any modem dialing commands,
   such as ATDT.


Options Button

   To specify other information for the connection file, select the
   Options button.   The Connection File Options dialog box lets you
   specify options such as the networking protocols you want to use,
   and whether or not to use roaming dial-back.

   Note that some options you selected for this connection file in Connect
   for Windows may not appear in Connect for DOS. You can continue to
   use and save this connection file, but once you save the file under a
   new name (by choosing Save As from the File menu) your settings for
   the additional options will be lost.

Connect Button

   To initiate a dial-in connection, select the Connect button.  The
   Connect program establishes the dial-in connection with the
   information displayed.
   

<Problems>
[<<]<Display>
[>>]<Procedures>
Common Problems
If you are having trouble dialing into a remote network, check the
following list of common problems.


Your computer's modem can't establish a connection with the modem on the
remote access server.

   -- Make sure you have specified the proper COM port and modem you
      are using.  This is done by choosing Port Setup from the Tools menu.

   -- Make sure the phone number you have entered is correct, and that
      it includes any access codes needed to place a call from your
      location (for example, most PBXs require a 9 at the beginning).

   -- Make sure that the remote device is installed and configured
      properly.


ShivaRemote Connect can't communicate with the remote access server
or negotiate LCP.

   -- Make sure the remote access server is installed and configured
      properly.

   -- Make sure that dial-in access is enabled on the remote device.


The remote access server won't accept your dial-in name or password.

   -- Check the phone number to make sure you are calling the correct
      device.

   -- Check with the remote system administrator to make sure you are
      using a valid dial-in name and password combination.




<FileOpen>
Open File Dialog
This dialog box lets you retrieve a connection file from disk.

Enter the desired file name in the "File name:" field, then select
the OK button.  You do not need to specify the connection file
extension; Connect adds this automatically.

You can also use the Files and Directories lists to navigate
through your disk.  Select the file you want to open, then select
the OK button.

If you do not want to open a connection file, select the Cancel button.


<FileSave>
Save As Dialog
This dialog box lets you save a connection file with the specified name
and in the specified directory.

Enter the name of the file to be saved in the "File name:" field,
then select the OK button.  You do not need to specify the connection
file extension; this is added automatically by Connect.

If you want to save the connection file in a different directory, you
can use the Directories list to navigate through your disk.  However,
we recommend that you save all connection files in the default
directory.

If you do not want to save the connection file, select the Cancel button.


<PortSetup>
Port Setup Dialog
The Port Setup dialog box lets you configure the COM ports on your computer
for dial-in. Each field is described below.

Note that some items in the Port Setup dialog box are drop-down lists.
To see the selections in the drop-down list, press the Tab key to highlight
the item, then press the space bar. You can also advance through the
options on the drop down list by pressing the up and down arrow keys on
your keyboard.


Port drop-down list

   Select the serial port to which your modem is connected. This can be
   COM1, COM2, COM3, or COM4.

Modem drop-down list

   Select the type of modem you are using to dial in to the remote network.
   This drop-down list contains the names of many supported modems.  If
   your modem appears in this list, select it.  If it does not, refer to
   the "Modem..." button below.

Speed

   Select the speed at which your computer will communicate with your modem,
   in Bits Per Second (BPS).  When you select a modem from the supported
   list, Connect automatically sets this value to the highest speed that
   the modem supports, usually 38400 BPS or 57600 BPS.

   If ShivaRemote Connect experiences overrun errors while connected
   to the remote network, you should lower this speed.

   You can view error statistics by choosing Statistics from the Tools menu.

Reconnect automatically when connection is lost

   If your dial-in connection is lost, the dial-in driver can try to
   reconnect it.  By default, the driver will ask you if you want to
   be reconnected.

   If you want ShivaRemote to reconnect automatically, select this
   checkbox.  In this case, the driver will not ask first; it will just
   try to reconnect.

   The driver will attempt to reconnect automatically only if the modem
   connection is lost accidentally.  It will not try to reconnect
   automatically if you were disconnected for a reason (such as for
   inactivity, or for exceeding a connection time limit).


OK Button

   When you are done with configuration, select the OK button.  Changes
   will be saved to disk and will be used for all ShivaRemote dial-in
   connections.

Cancel Button         

   To exit the Port Setup dialog without saving the configuration to
   disk, select the Cancel button.

Modem...

   The Modem... button lets you change the settings for the selected
   modem.  These settings include the command used to initialize the
   modem and the type of flow control to be used.

   In most cases, you will not need to change this information.  However,
   if your modem does not appear in the list of supported modems, you may
   need to enter this information.

Advanced...

   The Advanced... button lets you change advanced settings for your
   serial port, such as the I/O address and IRQ number it is using.  In
   addition, you can specify the dialing command to use.

   In most cases, you will not need to change this information.  However,
   if your serial port uses non-standard settings, you need to enter
   the information here.


<EditModem>
[>>]<ModemInit>
Edit Modem Configuration
This dialog box allows you to modify an existing modem configuration or
create a new modem configuration.

Note that some items in the Edit Modem Configuration dialog box are
drop-down lists. To see the selections in the drop-down list, press the
Tab key to highlight the item, then press the space bar. You can also
advance through the options on the drop down list by pressing the up
and down arrow keys on your keyboard.


Modem Name field

   To create a new modem configuration, change the name of the modem in
   the "Modem Name" field.  If you want to modify an existing configuration,
   leave the name of the modem as it is.

Initialize field

   This is the initialization command that Connect sends to your modem
   to prepare it for a dial-in connection attempt.  For more information
   on the initialization command, see the [..Initialization Command]<ModemInit>
   topic.

Answer Init field

   This is the initialization command that Connect sends to your modem to
   prepare it to answer the telephone during a dial-back attempt.  In
   most cases, it is identical to the Initialize command with "S0=1&W"
   added to the end.

Speed drop-down list

   This is the maximum speed at which your computer can communicate with
   the modem in Bits Per Second (BPS).  For most modems, this will be
   either 38400 BPS or 57600 BPS.

   If you just want to change the speed at which your computer communicates
   with the modem, do not change this value; change the value in the
   Port Setup dialog box instead.

Flow Control

   Specifies the type of flow control that should be used between the PC
   and the modem.  This can be either Hardware, Software, or None.
   Hardware flow control is also known as RTS/CTS.  Software flow control
   is also known as XON/XOFF.

   This value only tells the dial-in driver which type of flow control to
   use; it does not tell the modem.  That can only be done using the
   Initialize command above.  It is very important that both the dial-in
   driver and the modem are configured to use the same type of flow control.


Defaults

   The Defaults button is active only if you have previously made changes
   to a modem's configuration.  If you want to revert to the original
   modem definition, select the Defaults button. Note that your
   changes will be lost.

<ModemInit>
Modem Initialization Command
Each time you dial in to a remote network, ShivaRemote Connect sends a
modem initialization command to the modem to prepare it for use.  The
initialization command is responsible for placing the modem in a state
that is appropriate for dialing in.

This section is a discussion of each component of the initialization
command.  Almost all modems support the AT command set developed by
Hayes.  For this example, we'll use the initialization command for the
Intel 14400 EX modem:

   AT&F&C1&D3\J0\N3\Q2\V2%C1"H3S7=60


AT    Start the modem command

      Required at the beginning of every modem command.  The modem
      prepares to accept a command, and determines the port speed
      (DTE speed) being used.

&F    Reset the modem to a known state

      Before the modem can be configured, it must be set to a known
      state.  The &F command restores the Intel modem to its factory
      defaults.

&C1   DCD signal reflects true state of carrier

      By default, most modems keep the DCD (carrier) signal high (or on).
      In effect, this tells the workstation that the modem is always
      connected, even when it is not.  The &C1 command tells the modem to
      keep the DCD signal high only when the modem is actually connected
      to another modem, and low when it is not.  This allows the dial-in
      driver to detect accurately when the dial-in connection is
      available.

&D3   Dropping DTR signal hangs up and resets modem

      Connect can hang up a modem connection quickly by dropping the DTR
      signal, but only if the modem is configured appropriately.  The &D3
      command tells the Intel modem to hang up its connection and reset
      itself to its power-on configuration when Connect drops the DTR
      signal.

\J0   Disable BPS rate adjustment

      Modems that support data compression allow the computer-to-modem
      BPS rate (DTE speed) to be higher than the modem-to-modem BPS rate
      (DCE speed).  For example, the Intel 14400 EX modem supports DCE
      speeds up to 14,400 BPS, and DTE speeds up to 38,400 BPS for
      V.42bis data compression.

      By default, some modems adjust the DTE speed to match the DCE speed
      when a connection is made.  If this happens, the benefits of data
      compression will be lost.  The \J0 command instructs the Intel
      modem to maintain its original DTE speed.

\N3   Enable protocol negotiation

      Modems that support error-correction and data-compression protocols
      must negotiate their use each time a connection is made.  The \N3
      command tells the Intel modem to attempt to negotiate a V.42
      connection; if that fails, it attempts to negotiate an MNP
      connection; and if that fails, it proceeds with a normal
      connection.

\Q2   Select hardware flow control

      Modems that support data compression allow the computer-to-modem
      (DTE) speed to be higher than the modem-to-modem (DCE) speed.  This
      difference in speed requires that flow control be used to manage
      the flow of data.  There are two types of flow control:  hardware
      and software.  The \Q2 command tells the Intel modem to use
      hardware flow control, which is preferred for dial-in.

\V2   Protocol result codes/report DCE speed

      This command tells the modem to indicate which error correction and
      data compression protocols it has negotiated as part of its CONNECT
      message.

      It also tells the modem to return the DCE speed of the connection
      as part of its CONNECT message, so that Connect knows how fast the
      modems are communicating.  It is important that the modem report
      the DCE (modem-to-modem) speed, and not the DTE (workstation-to-
      modem) speed.

%C1   Enable data compression

      The %C1 command tells the Intel modem to negotiate MNP data
      compression.  If the modem is unable to negotiate a V.42
      connection, but is able to negotiate an MNP connection, this
      command instructs it to negotiate data compression.

"H3   Enable V.42bis data compression

      The "H3 command tells the Intel modem to negotiate the V.42bis
      data compression protocol.

S7=60 Set dial timeout to 60 seconds

      When Connect sends a dial command to the modem, the modem will wait
      a certain amount of time for the connection to be made.  If the
      connection has not been made before that amount of time has
      elapsed, the modem will terminate the call and return an error
      message.

      The default value for some modems is too short to allow a V.32 or
      V.32bis connection.  If necessary, this value should be changed to
      at least 60 seconds.  The S7=60 command changes the Intel modem's
      dial timeout to 60 seconds.


<AdvSetup>
Advanced Settings
This dialog box lets you specify the IRQ number and I/O address used
by your COM port.  In addition, you can specify the dialing command to be
used.

Note that some items in the Advanced Settings dialog box are drop-down lists.
To see the selections in the drop-down list, press the Tab key to highlight
the item, then press the down arrow key.

You only have to specify the IRQ and I/O settings if your serial port uses
non-standard values.  Below is a table of serial ports and the standard
values for IRQ and I/O:


   Port     IRQ      I/O
   ===========================
   COM1      4       03F8
   COM2      3       02F8
   COM3      4       03E8
   COM4      3       02E8


IRQ Number field

   If your serial port uses the standard IRQ number, leave this entry at
   Default.  If your port uses a non-standard IRQ number, enter that
   number here.  Valid IRQ numbers are between 2 and 15.

I/O Address field

   If your serial port uses the standard I/O address, leave this entry
   at Default.  If your port uses a non-standard I/O address, enter that
   number here.  For example, if it uses address 3E0 hex, enter "03E0".

Dial String field

   This is the dial string that Connect sends to your modem in order to
   dial the telephone.  In most cases, you should leave this at ATDT,
   the default.  If your telephone connection requires pulse dialing,
   change this to ATDP.

Enable PPP Compression checkbox

   This checkbox indicates whether ShivaRemote and the remote access server
   should compress the information sent over the modem connection. This
   checkbox is selected by default. If the remote access server also has data
   compression enabled, selecting this checkbox can improve the speed
   of your dial-in connection. (If the remote access server does not have
   data compression enabled, this setting is ignored.)

   Note that if you select the Enable PPP Compression checkbox, you must
   load the compression driver (DIALCOMP.EXE) before running CONNECT.EXE to
   establish your dial-in connection. If the compression driver is not
   loaded, you can still connect to the remote access server, but
   ShivaRemote will not compress your data.
                                 
<ModemInit>
[<<]<EditModem>
Modem Initialization Command
The modem initialization command, etc. etc.


<Auth>
Authentication dialog box
The Authentication dialog box is used to enter security information for
the remote device.


User Name

   Enter your dial-in name for the remote device here.

Password

   If your network administrator has assigned a password to your dial-in
   name, enter it here.  The password text will not be displayed;
   asterisks will be displayed instead.

Dial-back Phone #

   If you have requested roaming dial-back in the Connection File Options
   dialog box, the Dial-back Phone # field appears.  Enter your modem's
   telephone number so that the remote device can dial you back.  If you
   enter a blank number, roaming dial-back will not be requested.

   If you have not requested roaming dial-back in the Connection File Options
   dialog box, this field does not appear.

<Options>
Connection File Options
The Connection File Options dialog box lets you specify options for the
displayed connection file.  Below is a description of each field in this
dialog box.

Desired Protocols

  In this section, you specify the network protocols you want to use
  when connected.  You can enable any combination of IPX, IP, and
  NetBEUI/LLC.  However, you will only be able to use a given protocol
  if the remote access server also supports that protocol.

  IP Address

    If you enable the IP protocol, your computer needs an IP address to use
    when dialed in.  Usually, this address is assigned by the remote
    access server, so you should leave the IP Address field blank.

    However, in some cases your remote system administrator may instruct
    you to specify this address.  Enter the desired IP address in the
    standard format (for example, enter "140.248.200.150").  Note that
    the server may assign you a different IP address even if you specify
    one here.

    In either case, once Connect negotiates an IP connection, a message
    appears informing you of the IP address that has been assigned to
    your computer.

Roaming Dial-Back

  With roaming dial-back, you can ask the remote access server to call
  your modem back at a telephone number that you specify.  This lets you
  reverse the charges for the telephone call.  Note that not all servers
  support roaming dial-back.

  To enable roaming dial-back, select the Request Roaming Dial-Back checkbox
  and enter a telephone number in the Dial-back Phone # field.  This is
  the number that the remote server will dial, so it should include any
  access codes needed at the remote site (such as "9" to use an outside
  line).

  You can also request roaming dial-back from the DOS command line (with
  the command "connect @file /r").

Third-Party Security Devices

  If the remote access server you are calling has a security device attached
  to it, select this checkbox.  Third-party security devices are not
  supported by the full-screen Connect; they are only supported from the
  command line (such as "connect @file" from the DOS prompt).

  Once the modems are connected, Connect lets you type characters to
  the security device.  Once you have entered the required security
  information, press the F10 key to continue with the connection.

  Echo Characters Locally

    If the security device you are using already echoes characters that you
    type by default, don't select this checkbox.

    If you don't see any characters on the screen when you type
    to the security device, select this checkbox.  If this box is
    selected, Connect echoes any keystrokes you type to the screen.

<Procedures>
[<<]<Problems>
[>>]<BatchConnecting>
Additional Procedures
This section describes the steps involved in performing several procedures
specific to using ShivaRemote Connect for DOS. For more general procedures,
see the ShivaRemote User's Online Guide for Windows.

Select any of the following topics to see more information:

   [..Using ShivaRemote Connect in Batch Files]<BatchConnecting>
   [..Optimizing Dial-In Performance]<Optimizing>

<BatchConnecting>
[<<]<Procedures>
[>>]<Optimizing>
Using Connect in Batch Files
Once you have created connection files for remote networks, you can automate
the process of dialing in from DOS by creating batch files that load your
networking software, launch the Connect program, and logging in to remote
networking services.

The following table describes the command line options for running the
Connect program from the DOS command line or in a batch file.

     Load Connect program               CONNECT
     List Connect command options       CONNECT /?
     Connect with a connection file     CONNECT @<filename>
     Connect with manual dialing        CONNECT @<filename> /m
     Connect with roaming dial-back     CONNECT @<filename> /r
     Disconnect modem                   CONNECT /d
     View asynchronous statistics       CONNECT /a
     View network error statistics      CONNECT /e
     View IPX networking statistics     CONNECT /ipx
     View IP networking statistics      CONNECT /ip
     View NetBEUI statistics            CONNECT /netbeui

For a sample batch file, see [..Sample Batch File]<SampleBAT> below.

To manually dial the modem to establish a connection, type

     CONNECT @<filename> /m

at the DOS prompt and press Enter. The Connect program will open a simple
terminal display with your selected modem's initialization string already
entered. Press Enter to accept the string, then enter the dialing commands
for your modem (such as "ATDT 9,1-617-555-8312"). When your modem has
connected successfully to the remote access server's modem, press the F10
key to pass control back to ShivaRemote. (Press F9 to cancel.)

<SampleBAT>
Sample Batch File
This section contains a sample batch file that loads Novell workstation
software, dials into a remote access server, and logs on to a NetWare
network file server.

ECHO OFF
C:
REM Loading some of the networking software here...
LSL
DIALODI

REM This line connects to the remote network using the Boston connection
REM file we created with the ShivaRemote Connect program.
CONNECT @BOSTON

REM Load some more of the networking software here...
IPXODI
NETX

REM Load LaunchGuard to prevent remote executables from launching from
REM NetWare servers...
GUARD

REM At this point, we're connected to the network. The next and final line
REM will run the LOGIN program (in our Shiva directory on the local
REM computer) to log on to the Novell server.
LOGIN

<Optimizing>
[<<]<BatchConnecting>
[>>]<LaunchGuard>
Optimizing the Dial-In Connection

Although dialing in to a network is slower than having your computer
connected directly to the network, there are some basic steps you can take
to make sure your dial-in connection is as fast as it can be:

    1) Run all executables from your local hard disk. For example, copy your
       e-mail software to your local computer instead of running it from a
       file server on your network. Using the LaunchGuard utility (GUARD.EXE)
       with NetWare file servers can help prevent launching files from remote
       file servers. The LaunchGuard utility is described below in the
       section [..Using LaunchGuard]<LaunchGuard>.

    2) Use the fastest modem you can get. This means using at least a v.32
       modem. We recommend using a v.32bis or v.34 modem if possible.

    3) Compress files before copying them to or from a hard drive on the
       remote network.
            
<LaunchGuard>
[<<]<Optimizing>
Using LaunchGuard
When you connect to a remote network using ShivaRemote Connect for DOS,
you can use LaunchGuard, a TSR program that helps you avoid loading programs
from remote NetWare file servers.

Note that LaunchGuard works only for the DOS version of ShivaRemote Connect.
If you are using Microsoft Windows, there loading the LaunchGuard utility
will not help with your dial-in performance.

Also note that LaunchGuard works only to prevent launching executables from
Novell NetWare file servers. Other files servers are not affected by using
LaunchGuard.

To use LaunchGuard on your computer:

1. Run GUARD.EXE from the DOS prompt (or from within a batch file)
   before you establish your dial-in connection.

   For a list of command-line switches you can use to modify LaunchGuard's
   behavior, see LaunchGuard Command Line Switches below.

2. Run the DOS CONNECT.EXE program or launch Windows and launch ShivaRemote
   Connect, then establish your remote dial-in connection.

   Once you have run GUARD.EXE, any attempt to run a program on a remote file
   server results in a message appearing warning you that you're launching a
   remote application. The message tells you the name of the program you're
   about to run, its size, your dial-in speed (in bits per second, or bps),
   and an estimate of how long it will take to load the program.

   After displaying this information, the following question appears:

      Do you want to execute this program? Y)es, N)o, D)isable LaunchGuard.

3. Press F1 for help at any time while the LaunchGuard message is displayed.

4. Press the first letter of the desired response.

   Press Y to close the LaunchGuard message and run the program from the
   remote server.

   Press N to close the LaunchGuard message and cancel loading the program
   on the remote server.

   Press D to close the LaunchGuard message and run the program from the
   remote server, disabling LaunchGuard in the process. You can re-enable
   LaunchGuard at any time by typing GUARD /E at any DOS prompt.


 LaunchGuard Command Line Switches

 You can add any of the following command-line switches to modify
 LaunchGuard's behavior:

 /D        Disables LaunchGuard until you use the /E switch.
 /E        Enables LaunchGuard if the /D switch has been used.
 /H or /?  Lists all options available in LaunchGuard
 /M        Lets you specify how long a program should be expected to take
           to load before LaunchGuard will pop up. By default, this is set
           to 0, so that LaunchGuard will pop up for all programs. If you
           want LaunchGuard to pop-up for programs that will take two or
           more minutes to load, enter GUARD /M=2 at the DOS prompt. Valid
           entries are 0 through 9.
 /N        Loads LaunchGuard without the online help. If the online help is
           included, LaunchGuard uses about 3.5 kilobytes of RAM on your
           workstation; if you use this switch, LaunchGuard uses only 2.1
           kilobytes.
 /U        Unloads LaunchGuard from your workstation's memory as long as no
           other TSR has been loaded since you first loaded LaunchGuard. If
           other TSRs have been loaded since you loaded LaunchGuard, you
           must unload them before you can unload LaunchGuard.


<end>


