             SoftSolutions(R) 4.1 for Windows Update

                    ENHANCEMENT DOCUMENTATION
                               for
            SoftSolutions Windows Diagnostics Program

        (C) 1995 Novell, Inc.  All Rights Reserved.  5/95
_________________________________________________________________

This file was created as an ASCII text file.  Any portion of this
file may be reproduced for use by licensed users of SoftSolutions
4.1 for Windows.
_________________________________________________________________

This document provides documentation for the enhancement,
SoftSolutions Windows Diagnostics Program (SSWDIAG), for updating
from SoftSolutions 4.0 to 4.1 for Windows.

SSWDIAG.EXE is a diagnostics program that reports the status of
certain aspects of the Windows environment needed to run
SoftSolutions.  The Diagnostics Program indicates the location of
the \WINDOWS and \WINDOWS\SYSTEM directories, as well as the
location and version of the Windows DLLs (Dynamic Link Libraries)
used by SoftSolutions.  It also indicates if the DLLs are
currently in use by any applications.

RUNNING SSWDIAG.EXE _____________________________________________

  1. Copy "SSWDIAG.EXE" from the diskette to the SoftSolutions
     for Windows programs directory.

  2. Perform one of the following to run the Diagnostics Program:

       a. In Windows, choose File|Run and type "[SoftSolutions
          Programs Directory]:\SSWDIAG," where [SoftSolutions
          Programs Directory] is the full path to the
          SoftSolutions for Windows program files, like
          SOFTSOLW.EXE.

       b. Create a Program Item icon for the diagnostics program
          and double-click on the icon.  (See the Microsoft
          Windows documentation for information on creating a
          Program Item icon.)

             * When creating an icon, the Working Directory
               should be the same one used for SoftSolutions for
               Windows.

  3. The SOFTSOLUTIONS DIAGNOSTICS PROGRAM window is displayed.

SOFTSOLUTIONS DIAGNOSTICS PROGRAM MENU OPTIONS __________________

The menu contains three options:

File           The File option can be used to run the same
               diagnostics as the Diagnostics option, but the
               three types of diagnostics can be run in any
               combination.  The output may be displayed
               on-screen or sent to a disk file.  The Run (F1)
               and Exit options are on this menu.  Run displays
               the SOFTSOLUTIONS DIAGNOSTICS - RUN window.

               The DLLs and Directories check boxes provide
               access to the same report data as the
               Diagnostics|DLLs and Diagnostics|Directories
               options, except both can be run here as one
               report.

               Help on the SOFTSOLUTIONS DIAGNOSTICS - RUN dialog
               box displays context-sensitive help.

Diagnostics    The Diagnostics option displays a menu that can be
               used to report on a specific diagnostic.  The
               output is displayed on-screen.  The Diagnostics
               menu contains the DLLs (F3) and Directories (F4)
               options.

Help           The Help option provides help on the Diagnostics
               Program.  General displays a brief overview and
               About displays the date and version of
               SSWDIAG.EXE.

EXITING the DIAGNOSTICS PROGRAM _________________________________

To return to the main SOFTSOLUTIONS DIAGNOSTICS PROGRAM window
from any other window, choose Close.

To exit The Diagnostics Program, choose File|Exit or press
Alt-F4.

DLLs ____________________________________________________________

The Diagnostics Program can be used to report on the DLLs needed
by SoftSolutions.  Diagnostics|DLLs displays the SOFTSOLUTIONS
DIAGNOSTICS - DLLs window.

   * Errors displays a window containing all of the SSWDIAG.EXE
     error codes and their explanations.

   * Help on the SOFTSOLUTIONS DIAGNOSTICS - DLLs dialog box
     displays context-sensitive help.

Five DLL areas can be selected, one at a time for reporting:

     Integrations
     System
     OLE 2.0
     ODBC
     Other

As an area is selected, the "Dynamic Link Library:" box displays
the DLLs associated with it.  A DLL can be clicked on in that box
and it is loaded with its information displayed in the following
fields:

   * "Location:" shows the full path of a particular DLL (see
     "Directory Search Order" below for more information).

   * "Status:" indicates the result of loading the DLL (see "DLL
     Status" below for details).

   * "Version:" displays the version of the DLL, if available.

   * "File Date:" shows the date of the DLL.

   * "File Size:" displays the DLL's size in bytes.

The following show examples of the DLLs associated with each
area.  This information is displayed in the SOFTSOLUTIONS
DIAGNOSTICS - DLLs window.

   * With the "Integrations" button clicked, the Dynamic Link
     Library box displays the first seven DLLs:

          appexec.dll
          bc40rtl.dll
          bids40.dll
          btrvtrk.dll
          dsa.dll
          formsdll.dll
          misc.dll

   * With the "System" button clicked, the Dynamic Link Library
     box displays the first seven DLLs:

          ddeml.dll
          netapi.dll
          nwcalls.dll
          nwipxspx.dll
          nwnetapi.dll
          shell.dll
          toolhelp.dll

   * With the "OLE 2.0" button clicked, the Dynamic Link Library
     box displays the first seven DLLs:

          bttncur.dll
          compobj.dll
          gizmobar.dll
          ole2.dll
          ole2conv.dll
          ole2disp.dll
          ole2nls.dll

   * With the "ODBC" button clicked, the Dynamic Link Library box
     displays these three DLLs:

          odbc.dll
          ssodbc.dll
          ssodbcsp.dll

   * With the "Other" button clicked, the Dynamic Link Library
     box displays these five DLLs:

          bwcc.dll
          ctl3d.dll
          sstrans.dll
          ssvlist.dll
          sswin.dll

NOTE
     If a DLL cannot be found, a message box is displayed
     indicating which DLL could not be located.  Simply choose
     Close to proceed with the diagnostic.  The SOFTSOLUTIONS
     DIAGNOSTICS - DLLs dialog box is then displayed.

DLL STATUS ______________________________________________________

After a DLL is loaded, the "Status" field indicates the result of
loading it.  The status can be:

Loaded         The DLL is successfully loaded.

OK             Indicates that the DLL was located and is
               currently being used.  The number of applications
               currently using the DLL is represented by the "n"
               in "OK-n" (dash required).  "OK" (without a
               number) simply means the DLL was loaded
               successfully and is not currently being used by
               another application.

Not Found      Indicates that the DLL could not be located.  Some
               applications (e.g., WordPerfect) contain the
               location of the DLL in an .INI file.  To find the
               location of the DLL, simply load the application
               before running SSWDIAG.EXE.

Failed         Indicates that the DLL could not be loaded.  The
               error code is also indicated by the "n" in
               "Failed-n" (dash required).  Following is a list
               of these error codes with a brief explanation:

                0   System out of memory, executable file
                    corrupt, or relocations invalid.
                2   File not found.
                3   Path not found.
                5   Attempt was made to dynamically link to a
                    task, or there was a sharing or
                    network-protection error.
                6   Library required separate data segments for
                    each task.
                8   There was insufficient memory to start the
                    application.
               10   Windows version was incorrect.
               11   Executable file was invalid.  Either it was
                    not a Windows application or there was an
                    error in the .EXE image.
               12   Application was designed for a different
                    operating system.
               13   Application was designed for MS-DOS 4.0.
               14   Type of executable file was unknown.
               15   Attempt was made to load a real-mode
                    application (developed for an earlier version
                    of Windows).
               16   Attempt was made to load a second instance of
                    an executable file containing multiple data
                    segments that were not marked "read-only."
               19   Attempt was made to load a compressed
                    executable file.  The file must be
                    decompressed before it can be loaded.
               20   Dynamic-link Library (DLL) file was invalid. 
                    One of the DLLs required to run this
                    application was corrupt.
               21   Application requires 32-bit extensions.

     NOTE
          Whether SoftSolutions uses a DLL depends on how it is
          set up.

VIEWING DLLs

Use Diagnostics|DLLs (F3) to run this diagnostic and display the
results on-screen.

   * The SOFTSOLUTIONS DIAGNOSTICS - DLLs dialog box is
     displayed.

NOTE
     If a DLL cannot be found, a message box is displayed
     indicating which DLL could not be located.  Simply choose
     Close to proceed with the diagnostic.  The SOFTSOLUTIONS
     DIAGNOSTICS - DLLs dialog box is then displayed.

REPORTING on DLLs

Use File|Run (F1) to run this diagnostic and send the output to a
disk file:

  1. Click the DLLs check box to its ON position.

  2. Click on the FILE radio button so the output will be sent to
     a disk file rather than the screen.

        * The default is to the screen.

  3. Indicate the location and/or filename of the file to which
     the results should be sent.

        * If no directory is specified, the filename given is
          created in the current working directory.

        * If no filename is specified, "SSWDIAG.LOG" is created
          in the current working directory.

  4. Choose OK.

        * The SOFTSOLUTIONS DIAGNOSTICS - DLLs dialog box is
          displayed.

     NOTE
          If a DLL cannot be found, a message box is displayed
          indicating which DLL could not be located.  Simply
          choose Close to proceed with the diagnostic.  The
          SOFTSOLUTIONS DIAGNOSTICS - DLLs dialog box contents
          are then printed to the disk file.

DIRECTORY SEARCHING ORDER _______________________________________

When loading DLLs, Windows searches several directories until the
DLL is found.  Windows searches for DLLs in this order:

  1. Working - The current working directory.

  2. Windows - The \WINDOWS directory.

  3. System - The \WINDOWS\SYSTEM directory.

  4. Task - The directory containing the executable file for the
     current task.

  5. Path - The directories listed in the PATH environment
     variable.

  6. Network - The list of directories mapped on a network.

VIEWING SEARCHING ORDERS

Use Diagnostics|Directories (F4) to display ON-SCREEN the actual
paths searched.

   * The SOFTSOLUTIONS DIAGNOSTICS - DIRECTORIES dialog box is
     displayed.

REPORTING SEARCHING ORDERS

Use File|Run (F1) to send a report of the actual paths searched
to a DISK FILE:

  1. Click the Directories check box to its ON state.

  2. Click on the FILE radio button to send the output to a disk
     file, rather than to the screen.

        * The default is to the screen.

  3. Indicate the location and/or filename of the file to which
     the results should be sent.

        * If no directory is specified, the filename given is
          created in the current working directory.

        * If no filename is specified, "SSWDIAG.LOG" is created
          in the current working directory.

  4. Choose the OK button.

        * The SOFTSOLUTIONS DIAGNOSTICS - DIRECTORIES dialog box
          contents are printed to the disk file.

REPORTING on a COMBINATION of DIAGNOSTICS _______________________

Although the File menu can be used to run the same diagnostics as
can be run using the options in the Diagnostics menu, the File
menu allows the user to run these diagnostics IN COMBINATION and
to display the results on-screen, OR to send the output to a disk
file.  To run a combination of diagnostics, perform the
following:

  1. Choose File|Run (F1).

  2. Click BOTH check boxes (DLLs, Directories) to their ON
     states.

  3. Click on the FILE radio button if the output should be sent
     to a disk file rather than to the screen.

        * The default is to the screen.

  4. If the output is being sent to a disk file, indicate the
     location and/or filename of the file to which the results
     should be sent.

        * If no directory is specified, the filename given is
          created in the current working directory.

        * If no filename is specified, "SSWDIAG.LOG" is created
          in the current working directory.

  5. Choose OK.

        * The chosen diagnostics dialog box is displayed or its
          contents are printed to disk.
