====================================
 Silver Xpress Reader Systems Files
====================================

This section will describe the system files and locations (files defined
optional or mandatory) expected by Silver Xpress.  This should assist in
the LAN management or multi-user system setup for the Silver Xpress Reader.
You may use this information to better "separate" the system files between
users.

GLOSSARY:

  PROGRAM PATH     The directory location of the XPREAD.EXE program.

  STARTUP PATH     The current directory location when XPREAD.EXE started.

  XSFP             Optional Xpress System Files Location.

  XOL              Optional Location of XPREAD.OVR overlay file.

  XESP             If the Xpress swap file $SXSWAP.$$$ is written to disk,
                   it will be placed in the current directory.  This swap
                   directory can be defined using the XESP environment
                   string.

  DOS PATH         This is the DOS PATH statement for the user or
                   workstation or multi-tasking session.

  SEARCH PATH      A list of directories where Xpress will look for most
                   files.

FINDING FILES (SEARCH PATH)

  Silver Xpress will use the following FILE SEARCH RULE when it is looking
  for files.  Only the files indicated below in the SYSTEM FILES table use
  this rule.

  FILE SEARCH RULE USED TO DEFINE THE SEARCH PATH

       1) startup directory
       2) optional XSFP location
       3) program path (location where XPREAD.EXE was found)
       4) DOS path

MULTI-USER SETUP:

  Without getting into technical detail, there is 1 ideal way to a create
  multiple user setup.

  No matter what, the basic goal is to help separate files, in particular
  list files, and also share some of the same files.

  Since the FILE SEARCH RULE stipulates that somes files will be searched
  in the startup directory first and others in the program directory, users
  can PUT their customized files in their personal directory.

  1) Create a USER directory for each user such as:

                \XPRESS\HECTOR
                \XPRESS\ANDI

     Then use a batch file:

     SX.BAT

        IF .%1 .. . goto HELP
          C:
          CD \XPRESS\%1
          SET XSFP=C:\XPRESS\%1
          C:\UTILS\XPREAD.EXE
          SET XSFP=
          GOTO EXIT
        :HELP
          ECHO usage: SX [username]
        :END

FILES:

                  ----------------------------------------
                   Location Information
                  ----------------------------------------

  XPREAD.EXE      REQUIRED:

                   The main executable is XPREAD.EXE.  It can be in the
                   current directory or in a directory defined on the PATH.
                   The PROGRAM PATH is where the program is located.

  XPREAD.OVR      REQUIRED:

                   Same location as XPREAD.EXE or defined by XOL
                   environment string.  If XOL is not defined, the
                   XPREAD.OVR is expected in the same directory as
                   XPREAD.EXE.  IF the XPREAD.EXE is renamed, the overlay
                   must be renamed as well.

  $SWSWAP.$$$     REQUIRED BUT HIDDEN FILE:

                   This is the temporary Xpress Swap file.  It is
                   optionally used when Xpress shells to DOS to run 3rd
                   party programs.  If your system has EXPANDED or EXTENDED
                   MEMORY, the $SWSWAP.$$$ file will be placed there.
                   Otherwise it is written to disk. When Xpress returns
                   from the outside program, the swap file is deleted.

                   If the swap file is written to disk, it will be placed
                   in the current directory.  This swap directory can be
                   defined using the XESP environment string.

  XPREAD.CFG      REQUIRED:

                   The Xpress configuration will be located in the SEARCH
                   PATH.  You may use the -C switch to override the
                   configuration file name and location.

  SXMENU.LIB      REQUIRED:

                   The Xpress Menu Library will be located in the PROGRAM
                   PATH.  You may use the -C switch to override the
                   configuration file.

  LIST FILES      OPTIONAL:

                   If a list file is not fully declared, Xpress will follow
                   the FILE SEARCH RULE defined above.

  XPREAD.CLR      OPTIONAL:

                   Expected in the SEARCH PATH

  XPREAD.HLP      REQUIRED (OPTIONAL FOR REGISTERED USERS)

                   Expected in the SEARCH PATH

  ARCHIVER.DEF    OPTIONAL:

                   Expected in the SEARCH PATH

  XPREAD.KEY      REQUIRED (NOT AVAILABLE DURING FIRST TIME USAGE)

                   Expected in the SEARCH PATH

  XPREAD.LOG      OPTIONAL

                   Expected in the PROGRAM PATH.  Can be defined in
                   configuration.

  XPLANG.DEF      REQUIRED

                   Expected in the SEARCH PATH