

              TeleShare  DOS  REMOTE ACCESS       Page 1




     UPDATED: December, 1994

                   _______
              ____|__     |               (R)
           --|       |    |-------------------
             |   ____|__  |  Association of
             |  |       |_|  Shareware
             |__|   o   |    Professionals
           -----|   |   |---------------------
                |___|___|    Member




     TeleShare SETUP the TsSETUP.EXE program


     The TeleShare/SETUP program is called TsSETUP.EXE.  To execute
     the  program  just  change  to  the  sub-directory  where  you
     deposited the TeleShare programs and enter 'TsSETUP'.  You can
     type it in all lower or all uppercase;  it  appears  in  mixed
     case here to emphasize the SETUP portion of the name.

     You  will  see  a  simple menu screen with some catagories, as
     follows:

     General Defaults   Security   Remote   Transfer   Modem Sharing

     The center of the screen displays various settings as you move
     from  catagory  to  catagory  using  the  arrow  keys   and/or
     PGUP/PGDN.   Use  the  sideways  arrow keys or PGUP or PGDN to
     change catagories.  Use the up/down arrow keys  to  move  from
     field to  field  within  each catagory.  Every selection has a
     matching context sensitive help area  at  the  bottom  of  the
     screen.

     Save your  changes  using  the  ESCape  key.  You will need to
     verify saving by pressing 'Y' when asked if you wish to  'SAVE
     TO DISK?'.

     All settings are written to a binary configuration file called
     TSCONFIG.CFG.   This  file  is  used  by  both HOST and REMOTE
     programs.  The TsSETUP program also creates a text file called
     TS.INI with some settings:  the com port, the  baud,  the  ALT
     keys for  local  and remote.  This file is only (re)created if
     changes are made. The current TeleShare software does not  use





              TeleShare  DOS  REMOTE ACCESS       Page 2


     the  TS.INI  file,  but  other  software  that cannot read the
     TSCONFIG.CFG may.  TsSetup also tries to run  the  SUBSTIT.BAT
     when changes  are  made.  The default SUBSTIT.BAT we ship will
     substitute new COM port values in various batch  files  listed
     in SUBSTIT.BAT  using  the SUBST.EXE utility.  The substit.bat
     will also inform you about the baud changes that you may  wish
     to make to other batch files.

     The  TsSETUP  program  is  identical for both HOST and REMOTE.
     Some settings only apply to one or the other but most apply to
     both.

     If the TSCONFIG.CFG file ever becomes corrupted or you  simply
     want   to   reset   to  the  defaults  then  just  delete  the
     TSCONFIG.CFG file and run TsSETUP.EXE.  You will be  asked  if
     you want  to create a new TSCONFIG.CFG file.  Answer 'Y'es and
     a new one will be created with the default settings.

     If you run TsSETUP while either  the  TSH.exe  or  TSR.exe  is
     running  then  you  will  also be asked on exit if you want to
     'Update the TSR running on this PC?'.  This will send some  of
     the  new defaults directly to the program so you don't need to
     load/unload.

     NOTE:   The  only  settings  which  will   not   take   effect
     immediately  if  you  elect  to update the running program are
     those that deal with the COM port ( baud rate, etc ) and those
     that deal with security ( password, etc. ).    These  settings
     cannot be  changed  on  the  fly.   You have to UNLOAD the TSR
     currently running with 'TSH U' or 'TSR U' and then reload with
     'TSHOST' or 'TSREM' batch  files  to  be  sure  all  parameter
     changes are now in effect.

     This  option  was  intended  to  make  it  easy  to turn 'send
     attributes?' ON/OFF  without  unloading  the  TSR.    Critical
     settings can only be updated by re-loading the TSR.

     A  list  of ALL settings in TsSETUP follows along with a brief
     description of each.


     TsSETUP.EXE CATEGORY 1 - GENERAL DEFAULTS

     - Software interrupt(Decimal):

     Enter the DECIMAL value of  the  software  interrupt.    Valid
     entries are  interrupts  60  <thru> 67.  The default should be
     fine on most PC's.  Change it only if you  have  a  good  idea





              TeleShare  DOS  REMOTE ACCESS       Page 3


     what you are doing.

     - Communications port # (1,2):

     Enter the  number  of the COMMUNICATIONS PORT to use.  Enter 1
     for COM1 or 2 for COM2.

     - Baud  rate........(2400-115200):    Enter  the   baud   rate
     (2400-115200).

     - Send video attributes?.....:

     Press <Y>es  to include attributes in update msgs.  Press <N>o
     to exchange only TEXT characters.  TEXT ONLY  provides  faster
     screen updates.  You may enter any realistic baud rate.

     TeleShare will not transmit GRAPHICS screens!

     - Use alternate video buffer?:

     Press  <Y>es  to use a non-standard video buffer address Press
     <N>o to use normal DOS video buffer address(es)

     NOTE:  If active then the HOST will SEND  from  the  specified
     alternate buffer.    Normally  do not try to use this feature,
     unless you develop a need and know what you are doing.

     This could allow the program  to  be  used  as  a  poor  man's
     network with certain task switching programs or DOS kernels if
     you find out where the screens are stored in memory.


     - Address of alternate buffer:

     Enter  the  decimal value of the video buffer segment address.
     This would be something other than B000 or B800 which are  the
     standard  PC  video buffer addresses for Monochrome and colour
     respectively.  Remember to enter the decimal value.


     TsSETUP.EXE CATEGORY 2 - SECURITY OPTIONS

     If you use the security option then set it ON  for  both  HOST
     and REMOTE,  or  you  will  'lock yourself out'.  You won't be
     able to get in if it's set on  one  and  not  the  other  end.
     Also, the  password  is  case  sensitive:  any capital letters
     must be entered the same way every time you use  the  password
     on both the host and the remote.





              TeleShare  DOS  REMOTE ACCESS       Page 4


     Use security?  :

     Press <Y>es to use SECURITY or <N>o for NONE.

     Password:

     Enter the system access password.

     The  password  exchange  takes  place  each time you press the
     remote access hotkey sequence to request a  session  with  the
     HOST.

     This prevents anyone from 'sneaking on' due to LOST CARRIER as
     you can with some other remote access programs.



     TsSETUP.EXE CATEGORY 3 - REMOTE OPTIONS

     - Polling pause :

     Enter  the  number  of  timer ticks to wait before polling the
     HOST program for a session update.  A timer tick is 1/18 of  1
     second, so 18 ticks equals 1 second.  The minimum is 3 ticks.

     The REMOTE program uses a scheme to request video updates from
     the HOST computer being accessed.  The value specified here is
     the  number of timer ticks to wait between attempts to poll or
     ask for an update.

     Never set the polling pause to anything faster  than  about  3
     timer  ticks or the HOST may become so busy sending you screen
     updates that it won't be able to process the last command in a
     timely way.

     This poll pause is  intended  to  allow  slower  systems  some
     breathing room.    A  fast  HOST  PC  can  handle  short pause
     values.  As can PC's using a direct serial connection.

     A value of 9 timer ticks should provide  good  performance  on
     all types of PC's.

     You  may also adjust this value to whatever you need to access
     systems where interrupt activity is higher than normal.


     - Popup key ALT-






              TeleShare  DOS  REMOTE ACCESS       Page 5


     Press the key to  use  with  ALT  to  enter  the  REMOTE  HOST
     session.   Your  choices  are  limited  to the capital letters
     A-Z.  This allows you to customize the hotkey to  you  choice,
     and to avoid hotkey conflicts with other software.


     - Exitkey ALT-

     Press  the  key  to  use  with  ALT to return to the LOCAL DOS
     session.  Your choices are  limited  to  capital  letters  A-Z
     only.  Customize the hotkey to fit what you want and need.


     - Mode indicator:

     The  MODE  indicator is the small highlighted block which will
     appear in the upper right corner of the  monitor  to  indicate
     LOCAL or  REMOTE  mode.    Press  <Y>es  to show it or <N>o to
     exclude it.


     TsSETUP CATEGORY 4 - TRANSFER OPTIONS


     - Transfer display box ROW:

     Enter the ROW (1-9) to use for the  top  left  corner  of  the
     transfer display window.


     - Wait for filename RCVD OK:

     When sending files the filename is sent to the receiver before
     transfer starts.    Enter  the  number  of seconds to wait for
     acknowledgement of the filename.


     - Retry filename on SEND:

     When sending files the filename is sent to the receiver before
     transfer starts.  Enter the number of  times  to  re-send  the
     filename before giving up.


     - Wait for filename on RECV:

     When  receiving files the filename must arrive before transfer
     can begin.  Enter the  number  of  seconds  to  wait  for  the





              TeleShare  DOS  REMOTE ACCESS       Page 6


     filename before giving up.  The minimum is 10 seconds.


     - Wait for SOH between files:

     When  receiving files with the XMODEM protocol we must receive
     the SOH character before a transfer  can  begin.    Enter  the
     number of  seconds to wait before giving up.  The minimum is 1
     second.


     - Fixed loop timeout on XCHNG:

     Transfer routines use fixed counters for timeouts.    Increase
     this value  if  you get transfer errors.  the minimum is 1000,
     and the maximum is 500000.  A 386PC should be at least 20000.


     - Log all sends to XMSEND.LOG:

     Press 'Y' to log all send transactions to a special  LOG  file
     called XMSEND.LOG.


     - Log all RECVS to XMRECV.LOG:

     Press  'Y'  to  log  all RECEIVE transactions to a special LOG
     file called XMRECV.LOG.

     Use the Log file options when you need to  keep  a  record  of
     your activities.    Example  uses  are  support, security, and
     financial monitoring for each session.


     - Default PATH for log files.:

     Enter the default pathname to use for log files.   This  tells
     the  system  where to put the log files, and where you will be
     able to find them later.

     Please read the TELE.TXT file for more information,  including
     contact and support information.


     Support and the ASP


     For technical support, either call (604) 433-5189, or write to





              TeleShare  DOS  REMOTE ACCESS       Page 7


     Suite 606 - 6455 Willingdon Avenue, Burnaby, British Columbia,
     Canada, V5H  4E4.    Both registered and soon to be registered
     users currently get the same  support  without  any  arbitrary
     time limit.   You may also try leaving a Compuserve message at
     75020, 2664.    Your  message  has  better  chance  of   avoid
     Compuserve 'scroll off' if you send it to:

     INTERNET:vic_williams@mindlink.bc.ca


     ASP Introduction:

     Please  also  carefully  read  the  accompanying  SHR_WARE.TXT
     document.

     "This program is produced by a member of  the  Association  of
     Shareware Professionals (ASP). ASP wants to make sure that the
     shareware  principle  works  for  you.  If  you  are unable to
     resolve a shareware-related problem  with  an  ASP  member  by
     contacting  the  member directly, ASP may be able to help. The
     ASP Ombudsman can help you resolve a dispute or  problem  with
     an  ASP  member,  but  does  not provide technical support for
     members' products. Please write to the ASP  Ombudsman  at  545
     Grover  Road,  Muskegon, MI 49442 or send a CompuServe message
     via CompuServe Mail to ASP Ombudsman 70007,3536."


     This document and associated TeleShare documents and  software
     are Copyright (C)1992-4 P. C. Softsmith All Rights Reserved.

     THE  DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED AND
     SOLD WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED,  REGARDING
     ITS  MERCHANTABILITY  OR  FITNESS  FOR ANY PARTICULAR PURPOSE.
     THE INFORMATION IN THIS DOCUMENTATION  IS  SUBJECT  TO  CHANGE
     WITHOUT  NOTICE  AND  DOES  NOT REPRESENT A COMMITTMENT ON THE
     PART OF THE VENDOR.

     OTHER PRODUCT AND BRAND  NAMES  MENTIONED  ARE  TRADEMARKS  OR
     REGISTERED  TRADEMARKS  OF  THEIR RESPECTIVE HOLDERS, or so we
     presume.












