FAQ (Frequently Asked Questions) SlipKnot V. 1.0 through 1.1

This file is designed for solving SlipKnot problems, not for tips on
general usage.  Please skim the file for areas of interest before
wading in.

Updated on Dec. 8,  1995 for Version 1.40
Updated on Oct. 1,  1995 for Version 1.13
Updated on July 27, 1995 for Version 1.12
Updated on June 11, 1995 for Version 1.11
Updated on Apr. 26, 1995 for Version 1.10
Updated on Mar. 26, 1995 for Version 1.08 (beta)
Updated on Mar. 6,  1995 for Version 1.07 (beta)
Updated on Feb. 10, 1995
Updated on Jan. 30, 1995 for Version 1.05 (beta)
Updated on Dec. 15, 1994 for Version 1.0
Created on Dec. 4,  1994 by the MicroMind SlipKnot folks.


=======================  Problems -- Table of Contents.
--  Update news and upgrading instructions
--  Introduction
--  Section 1. What you need before getting SlipKnot
--  Section 2. Problems in getting SlipKnot and running SETUP
--  Section 3. Problems when starting SlipKnot for the first time
--  Section 4. Configuring SlipKnot Terminal and testing the settings
--  Section 5. Problems in "Initializing the Host" or when pressing the
	       World Wide Web button
--  Section 6. Problems in SlipKnot Web
--  Section 7. Current SlipKnot limitations and peculiarities
--  Section 8. Miscellaneous Communications Problems
--  Section 9. Problem with SlipKnot Terminal
--  Appendix 1. Choosing and setting up a UNIX prompt.
--  Appendix 2. "Initializing the Host" manually
--  Appendix 3. If this document does not help solve the problem

======================== Upgrading to Version 1.40 ===============

=== Upgrade Method 1 ===
If your version of SlipKnot is working and you are normally able to retrieve
large documents in SlipKnot Web, then retrieve the SlipKnot What's New Page.
There's a link to it in the SlipKnot Local Home Page which you can use, but
here's the location anyway:
http://www.interport.net/slipknot/whatsnew.html
You will find easy upgrade instructions on the What's New Page.
 
==== Upgrade Method 2 ===
If you are having problems with SlipKnot, then
1. retrieve the following file using anonymous FTP:
   
   site: interport.net   
   directory: /pub/pbrooks/slipknot  
   file: snup140.zip
        or 
   site: ftp.netcom.com
   directory: /pub/pb/pbrooks/slipknot
   file: snup140.zip
   
2. Place the snup140.zip file into your \SLIPKNOT\UPGRADE directory
3. Terminate SlipKnot completely
4. In the Windows SlipKnot group of icons, there is a "NEW" icon, which
   should perform the complete upgrade for you.  If this fails, then
   unzip the snup140.zip file (making sure that there are no CRC errors, and
   if there are errors, then *do not* try to fix them in any way -- try to 
   retrieve the file again).  Place the unzipped contents of the upgrade
   file into your \SLIPKNOT directory, overwriting some older files there.
   Then, using an ASCII editor, edit the \SLIPKNOT\SLIPKNOT.INI file to
   change the version number inside to 1.13

If you are having trouble upgrading using SlipKnot's NEW icon, then:

1. Unzip the SNUP140.ZIP file into a temporary directory.  Make sure that
   there are NO unzipping errors.  If there are, try a different unzipping
   program (we recommend PKUNZIP 2.04c or later), or try retrieving the
   file again in case there were any downloading problems.

2. Copy the resultant unzipped files into your \SLIPKNOT directory.


===================== Introduction

If you are having a problem with SlipKnot recognizing your UNIX prompt, please
see the Appendix on this topic.

Although installation has gone smoothly in most cases, there have, of
course, been some problems.

This file is designed to address the most common problems in installing and
using SlipKnot, and some of its current limitations.  We have tried to make
this document cover as many as possible of the problems that we have heard
of, hence it is long.

We urge you to read this FAQ and check with the Usenet group 
comp.infosystems.www.users before sending us email fo support.

If you know of others interested in SlipKnot, we ask your help in posting 
this document *locally* to help others.  If you are in contact with your
UNIX system administrator, feel free to send this document to that person.

Since SlipKnot tries to run on a large variety of differently configured
PCs connected to a large variety of different UNIX systems, many of the
problems below are rare, but are listed because someone has reported them.

Choose the section below where you are having a problem -- it is not
necessary to read this entire document.

In any case, we know the frustration of software installations, and
apologize in advance if the problem is due to SlipKnot.

NOTE: If you are using a beta version of SlipKnot (prior to Version 1.0),
      then we strongly urge you to upgrade to version 1.40. -- we no longer
      support any beta versions.  Particularly, if you are using Version
      0.53, (a version with many problems), your best bet for solving its
      problems is a complete re-installation.  Retrieve the latest version
      file using anonymous FTP from:

         ftp://oak.oakland.edu/SimTel/win3/internet/slnot140.zip
   
      then remove all files inside your \SLIPKNOT directory and all of its
      subdirectories, before re-installing.
      
NOTE: If you are having trouble, one of the best ways of receiving help is
      to ask other SlipKnot users on your UNIX system (possibly by posting
      a question to a local newsgroup).  Since each UNIX system is slightly
      different from all others, we at MicroMind may not know about such
      problems, and local people might already have solved the problem you
      are experiencing.

======================= Section 1. What you need before getting SlipKnot:

You must have a PC running some flavor of Windows, and a subscription
(account) on a UNIX system.  At this time, you MUST be calling up your
UNIX system using a modem (no direct connections are supported in Version
1.0).

On your PC:

--  A 386, 486, or Pentium PC running Windows 3.1+, or Windows for
    Workgroups, or Windows NT, or Windows 95. OS/2-Win is now supported
    in Version 1.11 or later.

-- SlipKnot WILL NOT currently run on:
   --  Mac running SoftWindows (because, we are told, SoftWindows emulates
       a 286 processor, and SlipKnot requires a 386.  SlipKnot may run on
       the hardware-based 386-enahnced "Houdini" processors, but we have
       not gotten any reports.

-- Windows should be running in 386 Enhanced mode.  If you are not sure
   whether yours is, then launch Windows, and in the Program Manager, press
   the menu item Help and the About Program Manager.  At the bottom of that
   small screen is an indication of the Windows Mode, which should read:
   "Enhanced Mode".  If it does not, you must change the way Windows is
   launched.

On your Host:

-- Your Host MUST be running UNIX (SlipKnot will not work with VAX/VMS)

-- You must have a shell account with your host.  You cannot be trapped
   inside a menu or inside a program.  You must be able to get to a UNIX
   shell prompt from which you can execute any program of your choice.
   NOTE: many "freenets" do not offer shell access to their subscribers,
   choosing instead to provide program access via menus -- SlipKnot will
   not work with such systems.

-- Your Host's UNIX system must have either the lynx or www program
   available. The lynx program MUST be called "lynx".  If your system only
   has a single World Wide Web program called "www", make sure that it is
   not really the lynx program in disguise, by trying to execute the
   following command from your UNIX prompt:

www -version

   If you get a message indicating that you are running some version of
   lynx, then you must create a "pseudo-command" called lynx which will
   execute your www program. The reason is that the official "www" program
   is different from lynx, and SlipKnot will get confused if one
   masquerades as the other.

-- If you are not sure whether your UNIX system has lynx or www available, then
execute:

lynx -version

   or 
   
www

   from your UNIX prompt.  If either works, then choose the appropriate one
   in your SlipKnot Terminal Setup/Host screen.
   
-- If you are going to be using lynx, then make sure that it's version is
   at least 2.2 (and preferably 2-4-2 or 2.4-FM or later).  Versions
   of lynx prior to 2.2 will prevent SlipKnot from retrieving
   pictures.  Versions of lynx prior to 2.3.7 may, under some
   circumstances, cause other unspecified difficulties.

-- If you are using SlipKnot 1.0, then your UNIX system must have a program
   to download files using either the Xmodem or Ymodem protocol.  If you
   are using SlipKnot 1.05 or later, then you may also use either Zmodem or
   Kermit. You will need to know what the correct command is for your UNIX
   system for initiating a download procedure using the protocol of your
   choice, for downloading *binary* files.

1.1  -- The "Exclusive in Foreground" setting:  In Windows 3.1, there is a
	setting in the Windows Control Panel that affects SlipKnot's
	background operations.  Go to the Windows Main group, launch
	Control Panel, go to the "386 Enhanced" settings.  There should be
	a checkbox called "Exclusive in Foreground".  This box should be
	unchecked!  If it is unchecked, then everything is OK.  If it is
	checked, then uncheck it, save the setting by pressing OK,
	terminate Windows, and then come back into Windows and make sure it
	remains unchecked!  We have heard of systems where this is a
	difficult box to uncheck (it seems to want to remain set).  
   
   	If all else fails (the box insists on remaining checked), then you
	will have to force this setting manually by using an ASCII editor
	to edit the SYSTEM.INI file in the \WINDOWS directory.  Exit
	Windows. Edit the \WINDOWS\SYSTEM.INI file.  Therein you will find
	a setting: "WinExclusive=1".  Change this to: "WinExclusive=0".
	Save the file and go into Windows Control Panel to make sure that
	the box is, in fact, unchecked.
   
On your UNIX system:

-- You must have a "shell" account on your UNIX system.  This means that
   when you log in, there is a prompt and you type commands.  Menu-based
   accounts are not supported (where you choose your activities by selecting
   items from lists).  If you have a menu-based system, which allows you
   access to a shell prompt -- then that's all right -- as long as you
   can get to a shell prompt.
   
-- Your UNIX system must have either the program "lynx" (Version 2.2 or
   later) or the program "www" available for your use.  How to test:
   
   -- Try to execute: "lynx" from the shell prompt.  If it works, you
      should see a page of information, and you can exit lynx by pressing
      "q".  To find out the version of lynx, execute:  "lynx -version" from
      the prompt.  If it indicates a version of lynx prior to 2.2, then
      SlipKnot will not be able to retrieve binary files (e.g. pictures),
      and you may want to get your UNIX system to upgrade its version of
      lynx (see next paragraph).
   
      You can find current versions of lynx for a variety of UNIX systems at
      the following site:
   
      ftp2.cc.ukans.edu  in the directory or subdirectories below:
      /pub/WWW/lynx
   
      If you are not quite familiar with your UNIX system, you should
      probably try to get someone else who is to retrieve and install the
      appropriate current version.
   
   -- If lynx is not available, try executing "www".  
   
      If it works, please make sure that this "www" is not just another
      name for "lynx" ("www" is, in fact, a completely different program
      unrelated to "lynx", but on some systems, "www" just executes the
      "lynx" program).  To test whether "www" has been aliased to bring up
      "lynx",  execute: "www -version".  You may get a short explanation
      which indicates that this a version of lynx.  If not, then you are
      probably working with a legitimate copy of "www", and that's fine.
      
      If "www" turns out to be really a version of "lynx", then you must
      try to find out a way to execute this program by typing "lynx"
      instead of "www" (this is called "unaliasing"), and if you do not
      know how to do this, then the best bet is to try asking someone who
      knows.

-- Your UNIX system must be able to send *binary* files to your PC
   (download) using any one of the protocols: Xmodem, Xmodem-CRC, Xmodem-1K
   or Ymodem-Batch, Zmodem or Kermit.  
   
   You should also be able to upload files using these X Y or Zmodem
   or Kermit protocols, but it is not absolutely necessary for
   SlipKnot to be able to do so.
   
   If you do not know whether your UNIX system has this capability, try to 
   ask someone knowledgeable, and in particular, ask what the appropriate
   commands are to launch one of these file transfer programs.  Then install
   these appropriate commands in the Setup/Host screen.
   
   If your UNIX system does not have X or Ymodem file transfer programs,
   there are versions of these programs available on the Internet, but it
   may require a person knowledgeable with your UNIX system to install a
   version.
   
================= Section 2. Problems in getting SlipKnot and running SETUP

2.1 -- Unzipping problems: MOST IMPORTANT:  If, after downloading the
       slnot140.zip file, you have errors in unzipping (say, CRC errors),
       then the file you have may be corrupted. If so, DO NOT proceed to
       either install or try to fix up the file (with programs like zipfix).
       SlipKnot will cause untold errors if its files are corrupted and
       then installed.
       
       -- If you unzipped slnot140.zip on your UNIX system, and then tried
	  to download the resultant files -- don't.  Download slnot140.zip
	  to your PC first and unzip there.  This is because the unzipping
	  programs on UNIX may not unzip the file correctly.
       
       -- If you had unzipping problems on your PC, this may be caused by
	  an incompatibility between your unzip program and slnot140.zip.
	  Try to obtain and use the DOS program PKUNZIP (version 2.04).
	  This program is available on most bulletin boards since the
	  majority of the world's posted PC software is in zipped form
	  using PKZIP as the standard.
       
       -- If you have used PKUNZIP, and there are still errors, then the
	  problem occurred in downloading the file (file is legitimately
	  corrupted).  The problem either occurred in using anonymous FTP
	  to download the file to your UNIX system (if you retrieved the
	  file from the Internet) or in the process of downloading the file
	  to your PC.
	  
	  -- FTP problems: the transfer must be in binary.  Here is a
	     sample session for transferring the file from one of
	     SlipKnot's distribution sites (comments and FTP responses in
	     UPPER CASE, your commands in lower case).
	  
	      ftp
	      open oak.oakland.edu
	      (MESSAGES FROM OAKLAND)
	      LOGIN: anonymous
	      PASSWORD: (enter your email address here)
              cd /SimTel/win3/internet
              binary
              hash
              get slnot140.zip
              (PROGRESS REPORT SHOWING FILE COMING IN)
              quit
              
	  -- Downloading to PC problems:  this process MUST ALSO be in
	     binary mode, not ASCII, and the commands for this process are
	     dependent upon both your PC comm program and the commands to
	     trigger a binary download from your UNIX system.  If you
	     suspect that this may be the source of the problem, try to
	     check with someone else on your UNIX system as to which
	     commands to start for *binary* downloads.
	     
2.2 -- SETUP problems: Once you have successfully unzipped slnot140.zip
       into a temporary directory (say, C:\TEMP), run Windows, and from the
       Program Manager, press File/Run and indicate there the path and name
       of the SETUP.EXE file (e.g. C:\TEMP\SETUP).

       -- Problem: You see "Initializing Setup", and then...nothing
	  happens. The most probable cause of this is a corrupted
	  slnot140.zip file or other problems in unzipping it.  See the
	  prior section (2.1) on these problems.
	  
	  We have heard that there may be an incompatibilty between
	  SlipKnot's SETUP program and a program called VSAFE (or vsave?).
	  When VSAFE is loaded, SETUP may not run successfully.  Once VSAFE
	  is unloaded, then SETUP may run.
  
       -- Problem: You get a message to the effect that DDEML.DLL cannot be
	  copied.  This is usually just a warning message and you can go
	  continue installing.  If instead, SETUP stops at this point,
	  then: exit Windows, find your existent DDEML.DLL file in your
	  \WINDOWS\SYSTEM or \WINDOWS directory, rename the file to some
	  other name (like DDEML.BAK), run Windows again and start the
	  SETUP process again -- SlipKnot should then install its own
	  DDEML.DLL file.
       
       -- Problem: You get a message to the effect that either CMDIALOG.VBX
	  or THREED.VBX is out of date.  Exit Windows, find the offending
	  file (either CMDIALOG.VBX or THREED.VBX) in your \WINDOWS\SYSTEM
	  or \WINDOWS directory, rename the file to some other name (say,
	  CMDIALOG.BAK or THREED.BAK), then run Windows again, and run
	  SETUP again.

================= Section 3. Problems in running SlipKnot for the first time

3.1 -- Problem: a General Protection Fault occurs when you launch SlipKnot.

       -- Did you have any problems/errors in unzipping?  If so, remove all
	  files from your \SLIPKNOT directory and see section 2.1 above.
       
       -- Check your \SLIPKNOT directory to see if you have any files there
	  whose names end in "_" (e.g. PDQCOM21.VB_).  If so, then SETUP
	  did not successfully uncompress these SlipKnot files.  You will
	  have to uncompress them one-by-one (or you can try running SETUP
	  again to do the job).  To uncompress the files, use the DOS
	  program EXPAND.EXE (should already be available on your drive).
	  Here's how to uncompress one of these files:
	  
	  Suppose the file to uncompress is PDQCOM21.VB_.  Look up the suffix 
	  ("VB_") in the list below (you will find: "VBX"), then uncompress
	  this file with the command:
	  
	     EXPAND  PDQCOM21.VB_  PDQCOM21.VBX
	     
	  After successfully expanding the file, delete the original
	  (PDQCOM21.VB_).
	 
	  The following is a list of the compressed suffixes and their
	  matching uncompressed suffixes:
	  
	     Compressed		Uncompressed
	     ----------		------------
	     .BA_		.BAK
	     .BM_		.BMP
	     .DL_		.DLL
	     .EX_		.EXE
	     .GI_		.GIF
	     .HL_		.HLP
	     .HS_		.HST
	     .HT_		.HTM
	     .IC_		.ICO
	     .IN_		.INI
	     .PI_		.PIF
	     .TX_		.TXT
	     .VB_		.VBX
	     .WA_		.WAV
	     
3.2 -- Problem: You get a message to the effect that SlipKnot cannot set
       your Terminal font to any known font.  This is usually caused by a
       bad or corrupted SNTERM.INI file in your \SLIPKNOT directory.  This
       is what that file should look like (if it doesn't, then copy the
       section between the two lines and recreate SNTERM.INI):
       
--------------------- start of SNTERM.INI lines       
[Terminal]
FontName=Courier New
FontSize=9
BackColor=0
ForeColor=15
FontBold=0
Emulation=4

[Communications]
CommPort=2
ModemInit=AT &F E1 V1 L1 S0=0
ModemHangup=,,,+++,,,,,,,ATH^M
Connect=CONNECT
Disconnect=NO CARRIER
IsPulse=0

[Host]
HostName=SAMPLE

[Global]
------------------ end of SNTERM.INI lines

       -- If you still get this Font-related message, then make sure you
	  have the "Courier New" font available.  If not, then change the
	  line "Fontname=Courier New" to some other font that you do have,
	  and change the line "Fontsize=9" to a size available for the font
	  you have chosen.
       
3.3 -- Problem: In version 1.05, if you get a "STACK OVERFLOW" message when
       bringing up the SlipKnot Terminal Setup/Communication screen: see
       section 8.1 below.

========== Section 4. Configuring SlipKnot Terminal and testing the settings

If you have not read SlipKnot Help on Terminal Configuration, then do so
(press on the Help menu item, and go to the topic: Terminal Configuration).
You will find explanations there that solve many problems.

4.1 -- Problem: You are connected to your UNIX system through a serial line
       without a modem.  SlipKnot does not seem to connect.  Reason:
       SlipKnot Version 1.0 does not yet support direct serial connections.
       The next version should.

4.2 -- Problem: SlipKnot does not seem to dial correctly, or does not reach
       the dialing stage.  If you have another communuications program that
       works successfully, then copy the "modem initialization string" from
       that program into the SlipKnot screen: Setup/Communications.

4.3 -- Problem: After SlipKnot dials and connects with the other modem, you
       see garbage on the screen.  Most likely reason: wrong number of data
       bits or wrong parity set in the Setup/Host screen.  If you are on a
       7-bit line connection to your Host, SlipKnot does not yet support
       7-bit connections.  The next version should.

4.4 -- Problem: You are using the script-based login, and when the script
       finishes, SlipKnot waits for a while, and then logs off.  This is
       most likely caused by SlipKnot not recognizing your UNIX prompt. See
       Appendix 1 below for a discussion on setting your UNIX prompt.

4.5 -- Problem: When SlipKnot starts up or when it connects to your UNIX
       system, you get a General Protection Fault involving PDQCOM21.VBX.
       If so, try changing the Terminal Emulation (inside the Setup/Host
       screen) to ANSI if it was VT100.

=============== Section 5. Problems in "Initializing the Host" or when
			   pressing the World Wide Web button

This is where many problems can occur, because it is only at this point
theat SlipKnot is actually trying to do work with your UNIX system.

Most of these problems have to do with setting up the screen: Setup/Host.

There is a quick way of getting the right settings: try to find another
person on your UNIX system who is successfully using SlipKnot, (and doing
so with the same shell [Bourne, C-shell, Korn shell, etc.] that you use).
If you can find such a person, ask for a copy of that person's Host file.
That is a file in the \SLIPKNOT directory with the suffix: .HST that
contains all of the settings for this UNIX host.  These files are in
ASCII-readable format and can be transfered from person to person.  NOTE:
these .HST files DO NOT contain the login ID and password, so they are safe
to copy and distribute.

If you have tried the various suggestions below with no success, it is
possible that the particular technique that SlipKnot uses to
initialize your host is faulty for your UNIX system.  There is a
manual method of initializing your host, detailed in Appendix 2.
Please note that this is a last resort mechanism and we do not
guarantee that it will work successfully (but worth a try).

5.1 -- Problem: an error message occurs: SlipKnot does not recognize your
       UNIX prompt or your UNIX directory is not writable.

       -- This is usually caused by one of the two problems mentioned in
       the error message.  For recognizing the UNIX prompt problem, see
       Appendix 1 below.  For the other problem (writable directory), see 
       5.2 below.
       
5.2 -- Problem: an error message occurs concerning the "noclobber" setting.
       See the discussion in SlipKnot Help (topic: "noclobber").

5.3 -- Problem: SlipKnot tries, unsuccessfully, to initialize your Host, and
       then presents a message that the Host could not be initialized.

       -- This is most likely a problem with file downloading (though it
	  could be caused by the "noclobber" issue -- in which case see
	  section 5.2 above).  If it not a "noclobber" problem, see 5.3.1
	  below.
       
5.3.1  -- Inside Setup/Host, you chose a file transfer protocol (Xmodem-1K
	  or Ymodem-Batch, or...) and also the UNIX command that starts
	  file transfers using that protocol.  It is likely that the
	  command in Setup/Host is not correct for your UNIX system.  
	  
	  For instance:  if you chose Xmodem-1K, then SlipKnot will try to
	  use the UNIX command "sx -k {filename}" to get your UNIX system
	  to send a file using the Xmodem-1K protocol.  Your UNIX system
	  may not have the "sx" program and may be using a different
	  program for Xmodem file transfers instead.
	  
	  If you can find out what the proper command is for this protocol,
	  then install it in the Setup/Host screen (make sure you include the
	  "{filename}" string for where to put the filename when the
	  program actually executes).
	  
	  NOTE: make sure you choose a UNIX command that starts *binary*
	  file transfers.
	  
          NOTE: some modems have the capability to use compression, and if
	  you are having file transfer problems, occasionally this may be
	  the cause.  So, try turning modem compression off.  Modem
	  compression is turned on and off using modem commands in the
	  Modem Init String (this is settable in Setup/Communications).
	  Please check your modem manual for the proper command to turn
	  compression on and off (for instance, on the Supra FAXModem 28.8,
	  the command to turn compression off is %C0)
            
	  -- You can test whether downloading works by trying to download a
	     small file using the menu item: Communcations/Get File from
	     Host. If that fails, then the transfer command is either
	     incorrect, or your UNIX system does not have any program that
	     supports the chosen protocol.
	  
          -- If downloading does not work, try a different protocol (if you
	     used Xmodem-1K, try Ymodem-Batch, or vice versa).
          
5.3.2	  -- If downloading works, but Initializing Host does not, then
	     there may be a fix in a patched version of some of the
	     SlipKnot files.  These files can be obtained from the
	     following source by anonymous FTP:
	     
	     site: interport.net
	     directory: /pub/pbrooks/slipknot
	     file: look for the latest file starting with the letters: "snt".
	     
	     NOTE: the filename of the patch indicates with SlipKnot version
	     it is meant to fix.  For instance, the "snt107c.zip" file is the
	     "C" patch meant for SlipKnot version 1.07. Therefore, you must 
	     already be using version 1.07 to install it.  DO NOT install a 
	     patch file that is meant for a different (particularly a previous)
	     version.  Also: if there are several patch files meant for the
	     same SlipKnot version (e.g. snt107a.zip, snt107b.zip), you
	     only need the one with the highest letter -- it incorporates
	     all previous fixes.
	     
	     Once you have downloaded the patch file, unzip it, and make sure that
	     there are no unzipping errors.  If there ARE unzipping errors, try to
	     unzip the file with another unzip program (we prefer PKUNZIP version
	     2.04 or later).  DO NOT use some sort of a zipfixing program if there
	     are errors, this will only introduce mysterious problems later.
	     
	     You should find a READ.ME file with instructions on
	     installation therein.
	     
	  -- A rare problem occurs on some machines with the two shell
	     scripts that SlipKnot places into your UNIX directory during
	     Initialization. The shell scripts are called: ".slipcommand"
	     and ".slipgeturl". After SlipKnot deposits these shell scripts
	     on your UNIX system, it tries to make these scripts
	     "executable".  Please check to see if, in fact, these scripts
	     exist and that they are executable.  Here's how:  execute the
	     following commands at your UNIX prompt:
	  
	     ls -l .slipcommand
	        and
	     ls -l .slipgeturl
	     
	     In both cases, you should get a line of information indicating
	     that the file in question exists, and at the beginning of each
	     line there should be the string: "-rwx ...".  If the files do
	     not exist, then try Initializing your host again (use the menu
	     item: Setup/Initialize Host). If the "x" in "rwx" does not
	     exist, then execute the following two commands at your UNIX
	     prompt:
	  
	     chmod u+x .slipcommand
	     chmod u+x .slipgeturl

=================  Section 6. Problems in SlipKnot Web

At this point, you have gone through Host initialization successfully, and
using, or about to use SlipKnot Web.


6.1 -- Problem: when running SlipKnot Web for the first time, it
       successfully takes its time in "analyzing your fonts", but then a
       red windows appears, saying "Analyzing" and nothing else happens.
       
       The most probable cause is the "Exclusive in Foreground" Windows
       setting. See Section 1.1.
       
       You should also check, in your Main Windows Group/Control Panel/
       386 Enhanced, that in the Scheduling box: the Windows in Foreground
       setting is approximately 100, and the Windows in Background setting
       is approximately 50.
       
6.2 -- Problem: an error message appears: "Cannot analyze document ()".  At
       this point, SlipKnot is trying to display the document SLIPKNOT.HTM
       which should be located inside your \SLIPKNOT directory.  Please
       check that it is there.  
       
       If it is not, but you do find a file called: SLIPKNOT.HT_ then refer
       to Section 3.1.

       If it is there, then try to remember whether there were any errors
       in unzipping the original slnot140.zip file.  If there were, then
       see Section 2.1.  If there were no unzipping errors, then see
       Section 1.1.

       We have also heard of problems of this type when using 4DOS, an
       alternative to COMMAND.COM.
       
6.3 -- Problem: you can get some small documents from the Internet, but
       larger documents fail to come in.  Downloading always fails at some
       particular number of bytes downloaded (say, 12288).
       
       If this happens for X or Ymodem protocols, and you are using version
       1.0, then upgrade to version 1.1 which now supports Zmodem and
       Kermit. See the section on upgrading above.
       
       If you are using Zmodem (see the Setup/Host screen), and you
       are using as a download command: 
          sz -b {filename}
       then try the following modification of that command: 
          sz -beL 1024 -l 1024 {filename}
       (by the way, the third argument above is dash-EL, not dash-I).
       
6.4 -- Problem: you get a message: "Unable to display this file as a Web
       document".
       
       SlipKnot does not recognize the beginning of the document as a valid
       HTML document.  Technical note: It currently looks for the following
       strings: "<html>", "<head>" and "<title>".  If these are not found,
       then SlipKnot concludes (possibly mistakenly) that this is not a
       valid HTML file, and gives that message.
       
       Version 1.1 is now less strict (rejects fewer documents).  If you
       are using 1.0, it would be wise to upgrade.
       
6.5 -- Problem: SlipKnot Web crashes:  if this happens, you will still be
       able to go back to SlipKnot Terminal by pressing Ctrl-Esc and
       choosing SlipKnot Terminal or SNTERM.  Once back in the Terminal,
       you may find the keyboard locked (try typing a couple of
       characters). If so, use the menu item: Debug/Unfeeeze Keyboard.  At
       this point, you should be able to type, or disconnect, or be able to
       go back to SlipKnot Web (and your previously retrieved documents
       will still be in your History session, re-dislayable by pressing the
       icon with the circular arrow).
       
6.6 -- Problem: SlipKnot Web crashes while trying to display a document and
       messes up the screen.  This can happen when the document has a huge
       number of pictures in it (sometimes a document author will use a
       small picture for each bulletted item over and over again).  In this
       case, exit SlipKnot Web, disconnect, exit SlipKnot, exit Windows.

6.7 -- Problem: SlipKnot Web indicates that "you are not connected to the
       Host" while trying to retrieve a document.  Exit SlipKnot Web back
       to the Terminal, use Debug/Unfreeze keyboard if the keyboard is
       locked.  Try to see if your UNIX system is responding.  If not,
       disconnect and re-connect.
       
       Some UNIX systems will log you off if there is no activity for a
       given period of time.  SlipKnot tries to prevent this if you have
       checked the box in Setup/Host that says: "Tickle host every minute".
       This does not always work.
       
6.8 -- Problem: The document title appears twice.  This is not really a
       problem but rather a design choice on the part of the document
       author.  The author has chosen to use the same words in both the
       document title and its primary header, and SlipKnot displays both.

6.9 -- Problem: you get the message: "Unable to retrieve document".  Often
       this has nothing to do with SlipKnot.  This message may result from
       one of the following possibilities:

	 -- The document address was misspelled (mispelled?), therefore
	    there is no such document.
	 
	 -- The document has been moved, and left no forwarding address.
	 
	 -- The Internet is busy (this happens more and more frequently),
	    and SlipKnot is unable to get through.
	 
	 -- The computer that the document resides on is busy or down.
	 
	 -- The document came through partly, but there was an error in the
	    downloading process.  If so, see Section 5.3.1, particularly
	    concerning *binary* file transfers.
	 
	 To test whether the document is really out there, you can go back
	 to SlipKnot Terminal temporarily, and try to retrieve the document
	 using either lynx or www (whichever you chose in the Setup/Host
	 screen). To do this, you'll need to know the document URL
	 (Universal Resource Locator, or simply: its address).  You can
	 find out the addresses of the most recent documents you tried to
	 retrieve using the Navigate/Retrieve from Internet menu item, and
	 the drop-down list will show you the last 10 addresses.
	 
	 Copy down the address of the problem document (for instance:
	 "http://service/path/filename.html"), go back to
	 SlipKnot Terminal temporarily, and try to retrieve the document
	 using lynx or www in the following way:
	 
	   lynx http://service/path/filename.html
	       or
	   www http:///service/path/filename.html
	   
	 If lynx or www can retrieve it, try it in SlipKnot Web again.  If
	 it fails again, then the problem is somewhere in SlipKnot,
	 otherwise it's an address or Internet problem.

6.10 -- Problem: you get the message: "document too large".  Under some
	circumstances, SlipKnot may not be able to handle a very large
	document or a document with a very large picture.

6.11 -- Problem: SlipKnot Web has lost the list of your personal Folders.
	Upgrade to version 1.1 or later (if you are not already running
	it).  Launch SlipKnot Web, and bring up the Documents/Folders
	dialog box.  There is a button: "Find lost folders".  This will
	recreate access to your folders, although the original names from
	them will be lost.  You can then look into each of the new folders
	(you should see the documents and bookmarks that you've saved
	there), and use the Folders dialog box button "Edit" to rename the
	Folders, one-by-one.

6.12 -- SlipKnot Web problems with the Diamond Stealth 64 card (or possibly
	other Diamond Stealth cards): One of our users reports that there
	is a small icon in Diamond Stealth's "Control Tools", which, when
	visible prevents SlipKnot Web from launching.  His suggestion is to
	make sure that this icon is not visible (and presumably, therefore,
	not active).

 

========== Section 7. Current SlipKnot limitations and peculiarities.

7.1 -- SlipKnot does not do news, or WAIS.

       These are available through SlipKnot Terminal using common UNIX
       commands which are probably already better than SlipKnot would have
       given you.
       
7.3 -- SlipKnot does not do forms.

       Version 1.1 allows forms handling through lynx.
       
7.4 -- SlipKnot Web windows are too small.

       Version 1.13 allows resizable windows.
       
========== Section 8.  Miscellaneous Communications Problems

8.1 -- When bringing up the Setup/Communications screen, the error message:
       "Out of Stack Space" appears. This may be fixed in 1.1.

       This is a mysterious problem occurring on some systems as a result of
       the upgrade to 1.05.  All of the settings that would normally appear
       on this Setup/Communications screen can actually be set with an
       ASCII editor, editing the \SLIPKNOT\SNTERM.INI file.  This screen
       allows changes to the serial line modem control strings, and if
       SlipKnot worked in 1.0, you may not need to make any changes to 
       this screen anyway.  However, here are the lines in then 
       \SLIPKNOT\SNTERM.INI file that this screen controls:
       
       [Communications]
       CommPort=1
       ModemInit=AT &F2 E1 V1 L1 S0=0
       ModemHangup=,,,+++,,,,,,ATH^M
       Connect=CONNECT
       Disconnect=NO CARRIER
       IsPulse=0
       Ismodem=-1
       ModemBusy=BUSY
       ModemReset=ATZ^M

	Most of the lines above are straightforward in meaning, except perhaps
	the IsPulse and IsModem lines.  On these lines, "0" means NO, and "-1"
	means "YES", therefore in the above lines, IsPulse is off (meaning
	that the telephone line is Touch-Tone, not Pulse), and Ismodem is on,
	meaning that there is a modem (rather than a direct serial connection
	without modem).
	

8.2 -- 	SlipKnot can no longer connect to the other modem -- it times out
	too quickly.  This is fixed in 1.1.

        Try: In the Setup/Host screen, turn off the Retry if Busy check
	box, then save the settings, and try to connect.  If it works, then
	you should be able to turn that setting back on.
           
           
8.3 -- When uploading a file using Communications/Send file to Host,
       SlipKnot says that it succeeded but the resultant file on UNIX is
       too small, and just contains a single character: "a".  This is fixed
       in 1.1.

       If you asked SlipKnot to upload a file, (for instance, the
       "REGIST.TXT" file), SlipKnot may create two different files on
       your UNIX system: "regist.txt" and "REGIST.TXT",  where
       "regist.txt" just contains the "a" character, while
       "REGIST.TXT" contains the full information that you wanted to
       send.  NOTE: Unlike DOS, UNIX filenames are case-sensitive, so
       two files with different capitalization in their names can
       coexist inside a single UNIX directory.
       
8.4 -- When uploading a file using Zmodem, the file transfer sometimes fails.

       Not only does uploading fail, but it is possible that the
       Terminal is frozen after a failed upload attempt (you can type,
       but cannot see what yiou are typing, and you may get a
       mysterious "QuickWin Application Error" message).  If this
       happens, you MUST disconnect and exit from SlipKnot, and then
       re-launch SlipKnot so that SlipKnot can recover from this
       error.  Then try to use a different file transfer protocol (see
       next paragraph).
       
       As of Version 1.13, you can now choose a different upload file
       transfer protocol.  Inside the screen: Setup/Host, choose a
       different Send (upload) file transfer.  If you have been using
       Zmodem, then try Xmodem-1K or, better yet, Kermit.  You should,
       however, have some knowledge that your UNIX system supports the
       protocol that you are trying and that the command that SlipKnot
       uses for that protocol is correct.  For instance, SlipKnot's
       default UNIX command for Kermit is "kermit -i -r".  You can
       edit this command, if your UNIX system uses some other command
       to make kermit receive a file.
       
========== Section 9.  Problems with SlipKnot Terminal

9.1 -- You get a GPF (General Protection Fault) naming the PDQCOM2R program.

       This can be caused by a number of things:
       
       1. Your UNIX system sent some invisible screen control codes that
          SlipKnot Terminal was unable to interpret.  
          
          Workaround: change the Terminal emulation in Setup/Host,
	  particularly if you are using VT100 (best bet: change it to
	  ANSI).  After doing so, make sure to tell your UNIX system that
	  you have changed your terminal emulation (say, to ansi).
          
       2. On some video cards, SlipKnot Terminal will only work in 256 color
          mode (not thousands or millions of colors).  This problem might
          occur when you attempt to cut and/or paste in the Terminal window
          or are capturing a URL to retrieve in SlipKnot Web.

          Workaround: as a test, change your video driver to 256 color mode.
          This can usually be accomplished with the Change Settings menu item
          in the Main Windows Group/Windows Setup screen.
          
9.2 -- You see little square boxes on occasion in the Terminal Window.

       This is usually caused by your UNIX system (or the program you are
       running on it) sending NULL-bytes or other non-ASCII characters to
       your terminal.  We've no idea why the UNIX program would want to do
       this, but we will try to fix this visual problem in the future.
       
9.3 -- You have trouble uploading files from your PC to your UNIX system.

       See section 8.4
              
========== Appendix 1. Choosing and setting up a UNIX prompt.

The UNIX prompt that you tell SlipKnot about (in the Setup/Host screen)
will be used by SlipKnot to recognize your UNIX prompt when it appears.
What you tell SlipKnot need not match exactly your actual UNIX prompt, but
it must still be recognizable.

The problem usually occurs on systems using shells that change the prompt
rom line to line.  Say, for instance, that you UNIX prompt is: "peter[1]"
when you just log in, but the number changes ("peter[2]", "peter[3]", ...)
In this case, the solution is simple: tell SlipKnot (in the Setup/Host
screen) that your UNIX prompt is: "peter", and SlipKnot shoud be able to
recognize it.

WARNING: try, if possible, not to tell SlipKnot that your UNIX prompt is
">" or your login id.  This will sometimes confuse SlipKnot.  If your
actual UNIX prompt IS your login id, or the character ">", then you may
have to change your actual UNIX prompt (and tell SlipKnot what the new one
is) before SlipKnot will work.

=========== Appendix 2. "Initializing your Host" manually.

If all else failed in Section 5, then here is a mechanism of
initializing your host manually, divided into 2 parts:

App2.1.0: Getting the shell scripts to your UNIX home directory.

   Check to see whether the two shell scripts that SlipKnot needs (and
   would place into your UNIX directory) are already there.  Execute
   the following command at your UNIX prompt:

   ls -al .slipcommand .slipgeturl
   
   You should see the following two lines, though some details may be
   different.

-rwx------   1 pbrooks  user         227 Aug 13  1994 .slipcommand
-rwx------   1 pbrooks  user         103 May  1 14:22 .slipgeturl

   If you see the UNIX response above, then skip to App2.2.

   App2.1.1: If you see that both files exist, but you do not see the
	     "x" as the fourth character from the left.
	     
	     This means that the two shell scripts are there, but have not
	     been set as "executable".  Here's how to fix that: execute the
	     following command at your UNIX prompt:
	     
	         chmod u+x .slipcommand .slipgeturl
	     
	     Then try the 
	         ls -al .slipcommand .slipgeturl 
	     again and see if the "x" appears as the fourth character.
	     
   App2.1.2: If .slipcommand or .slipgeturl does not exist, then you
	     can retrieve one or both of them using anonymous FTP.
	     Here is where they reside on the Internet:
   
             site: interport.net
             directory: /pub/pbrooks/slipknot
             files: .slipcommand and .slipgeturl
             
             Put the files into your UNIX home directory, and go back to
             step App2.1.1 to make the files executable.

App2.2: Making changes to your .HST file.

   Once you know that the appropriate shell scripts are in your UNIX
   directory, you will have to make a few small changes to your .HST
   file(s) on your PC.  When configuring SlipKnot (in Setup/Host), you
   created the name of a new host, probably a name associated with
   your Internet Service Provider.  For the sake of this example,
   let's call that host: "Fred". You now have a file in your \SLIPKNOT
   directory called FRED.HST.  This is a text file and you will need
   to modify it with a simple text (ASCII) editor. Be careful not to
   use a fancy word-processor, or if you do, make sure that when you
   save the modifications, you save them in "text" or "ASCII" form.
   
   In the first paragraph (called, [Settings]), you will find the lines:
   
     UNIXLSColumn=0
     UNIXLSTotalColumns=0

   If you don't see them, create them as separate lines.  Now look in
   section App2.1.0 above at the output of the ls -al command (starts
   with "-rwx..."), and execute your own ls -al command because it may
   be different!
   
   First, count the columns in each line.  By "column" I mean the
   number of strings separated by spaces.  So, for instance, in the
   example in App2.1.0 above, "Aug" and "13" and "1994" is each a
   column.  In the example above, there are 9 columns in each line
   ("-rwx------", "1", "pbrooks", "user", "103", "May", "1", "14:22",
   and ".slipgeturl").  So change the number as follows:

     UNIXLSTotalColumns=9
   
   Now, count which column (starting at 1) contains the size of the
   file.  In our example above, it is column 5, so:
   
     UNIXLSColumn=5
   
   Also, make the following modification:
   
     HostInit=-1
     
   And finally, find the version of SlipKnot you are using (inside 
   SLIPKNOT.INI) and place it in the following line, for instance:
   
     HostInitVersion=1.13
     
   Now you can save the .HST file.
   
The next time you log onto your UNIX host, and press the World Wide
Web button, SlipKnot should not try to initialize your Host
(hopefully), and you should be able to go to SlipKnot Web.

HOWEVER, what we have done above is fool SlipKnot into thinking that
the Host is already initialized, and maybe that cures the problem.
You are a step closer to success, but may still not be able to
retrieve documents using SlipKnot Web, for whatever reason Host
Initialization failed in the first place.

   
=========== Appendix 3. If this document does not help solve the problem

If you are having file transmission problems or host initialization problems
that are not covered in this document, then you can send us a debugging log
file.  Here are the steps to doing so:

-- See SlipKnot Help topic: "If all else fails" aboout how to create the
   SLIPKNOT.DEB debugging file.

-- Turn on debugging just before the problem occurs, and turn it off just
   afterwards (this can produce a large file -- so only debug the parts
   that are failing).
   
-- If you turned on debugging while logging in, SLIPKNOT.DEB may contain
   your login ID and password.  This is an ASCII file and you should delete
   those pieces of sensitive information before sending.

-- Upload the SLIPKNOT.DEB file to your UNIX system, and embed it in the
   text of the message to us -- DO NOT send it as an attachment because our
   mailer will not understand it.

-- Send the file and your description of the problem.  To speed a response,
   please indicate the fact that you have read this FAQ by typing "**" (two
   asterisks) as the first characters in the subject line of your message.
   
-- Send to: slpstaff@micromind.com

Also, SlipKnot problems, answers and general discussion is held on the
Usenet newsgroup: comp.infosystems.www.users.  SlipKnot's What's New Page
can be retrieved for the latest news on versions and other information (there
is a link to the What's New Page from the SlipKnot Local Home Page).

==============================================

Again, we are sorry that you are having problems, and hope that this guide
helped you through some of them.

-- Brought to you by the overworked (and underpaid) MicroMind folks.

