 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
                            XTree Tools for Networks
                                NetWare Edition
                                  Version 1.5
                                README.1ST File
 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

 What's new in XTools 1.5?

 Speed key maneuvering.  Each selection list is completely speed key enabled.  

 25th line prompting.  The data displayed on the 25th line has been improved
 to provide more complete information about available commands.  

 Improved and user configurable text editor.  Zedit is included as the
 default text editor.  The administrator may configure another editor to be
 used with the Define Editor selection which is available on the main XTools
 menu and on Configuration Manager, Workstation Monitor and WatchLAN Menus as
 well.  A user's guide is contained in file ZEDIT.TXT which is installed on
 the XTools directory.  

 All server selection lists are sorted and speed key enabled. 

 Memory requirements reduced significantly. 

 - XTree NLM 

    The NLM has been updated to support NetWare 3.11 and 3.12.  However,
    NetWare 3.10 is no longer supported.  

 - Configuration Monitor

    Zedit modifies file server autoexec.ncf, system login script and user
    login script. 

    Improved selection mechanism to modify Group and User directory and file
    trustee assignments.  

 - Server Monitor

    SET Parameters displays additional parameters available with NetWare
    3.12.  

    System Modules displays module version number and generation date where
    available.  

 - Workstation Monitor

    Zedit modifies User autoexec.bat and config.sys files.

    Workstations list sorted by either login name (default) or connection
    number order.  The sort order is changed by pressing F7.  

    Workstation information polled by user request by pressing ENTER.  This
    eliminates the stickiness and delays previously encountered while
    traversing the workstation list.  

    Visual indicators identify 'this' workstation ('*') and workstations that
    encountered polling problems ('?').  The indicator is displayed in the
    character position just before the workstation name.  

 - Remote Control of Windows Workstations.

    Previous versions of XTools provided character based remote control with
    XTServ loaded at the workstations.  Now, Ocean Isle's ReachOut package
    has been incorporated into Workstation Monitor to provide remote control
    of Windows workstations.  Additionally, ReachOut provides for more
    accurate DOS character base and DOS graphics support.  

    ***********************************************************************
    NOTE: The key sequence to release control of remote workstation and
          return to the controlling workstation was SHIFT-ESC.  

          THIS HAS BEEN CHANGED WITH XTOOLS 1.5.

          To release control and return to the XTools workstation,
          simultaneously press LEFT-SHIFT, RIGHT-SHIFT. 
    ***********************************************************************

    The administrator decides what level of support is required and the
    amount of memory to be used at each workstation.  ReachOut requires that
    XTServ 3.0 be loaded at the workstation.  

    Memory requirements are as follows:

        XTServ                  8k
        ReachOut IPX Drivers    8k
        ReachOut DOS           16k 
        ReachOut DOS Graphics   7k

    To enable Windows remote control the administrator need only load the
    ReachOut IPX Drivers component on top of XTServ.  Add Windows remote
    control for only 8k!  The DOS remote control component is available if
    mouse support and better keyboard handling is desired.  The DOS support
    can be loaded as well as the Windows drivers, or loaded on it's own if
    just improved DOS character support is desired.  The DOS Graphics support
    requires the ReachOut DOS component to be loaded along with XTServ.  

    The Define Remote Options is provided to enable int 10 tweaking to
    control Super VGA video boards.  

 - Installing and running ReachOut.

    The ReachOut software is on XTools Disk #2.  Load the software from this
    diskette by running the install program located on the diskette #2.  The
    install program will prompt for complete or custom install.  The Complete
    Install is the easiest choice. 

    After the software is installed on your hard disk perform the following
    steps.

    - Make a copy of your SYSTEM.INI file.
    - Run INSRO.BAT, located in your ReachOut files directory.  This batch
      file will modify the SYSTEM.INI linking in the necessary ReachOut
      windows drivers.  If at a later time you wish to remove the drivers run
      REMRO.BAT. 
    - If XTServ is not loaded, do so now.  The ReachOut software needs to
      communicate with XTServ and will not load if XTServ is not present.  
    - Run GHN.BAT.  This will load the necessary ReachOut support for
      communicating over IPX and additional DOS drivers support.  Following
      is a typical GHN.BAT. 

        set rchpath=C:\REACHOUT
        C:\REACHOUT\rchipx              ; ReachOut IPX driver
        C:\REACHOUT\rchdos              ; ReachOut DOS Character driver
        C:\REACHOUT\dosgraph            ; ReachOut DOS Graphics driver

      If Windows remote control only is desired, you may edit the GHN.BAT,
      delete the last two lines to remove DOS and DOS Graphics support.

    - From your XTools command workstation run Workstation Monitor, select
      the Windows workstation that you've prepared by installing ReachOut,
      and running INSRO.BAT and GHN.BAT.  Select the Remote Control option. 
      You are now controlling a remote Windows workstation!! 

    - To release control and return to the XTools workstation, simultaneously
      press LEFT-SHIFT, RIGHT-SHIFT.

 - Backup&Restore

    An additional option has been added to inhibit the overwriting of XTree
    Bindery Objects when restoring bindery files.  This has been added to
    prevent overwriting an existing XTree Bindery license object with one
    that is included in the configuration backup from another server.  Most
    common usage is when an administrator is using Backup&Restore on a daily
    basis to mirror configuration data from a main server A to a backup
    server B.  This option prevents the license information on B from being
    overwritten with A causing a license violation condition.  

 - WatchLAN

    Define Options section improvements.

    Site name and site number fields have been added to general options. 
    This provides for improved identification of a problem server in the
    alerting actions.  

    The modem string separator ('*') is configurable to support additional
    modems.  

    Two new tests have been added which scan values in log/data files.  When
    WatchLAN starts 'watching' the current status of the file to be tested
    for is saved.  At each 'watch' interval the file status is checked.  If
    the file has been modified, the new data in the file is scanned and
    checked for the test conditions.  

        Severity = in System Error Log.  This tests for a specific severity
        condition in the system error log.  An action event may be triggered
        when the condition is met.  

        Search Text File.  This a more generic version of the above test. 
        This will scan any server file looking for a specific text string
        within that file.  An action event may be triggered when the text is
        found in new data added to the file.  This is an ideal method for
        scanning log files created by server applications, such as backup,
        and providing alerting actions triggered by key status words which
        are stored in the log file.  Text such as, Error, FAILED, CANCELED,
        Violation, Intruder and others.  

    A new action has been added - Execute Console Command.  This allows a
    WatchLAN action to execute a console command in response to a test event.
    An example might be testing for the value of maximum packet receive
    buffers.  Should that value reach the current setting an action can issue
    the SET Parameters command to increase this setting.  

    An Action Count field has been added to the action information.  The
    default value of this field is 0 which means the action will occur each
    time the test condition triggers an action event.  If the count field is
    not equal to zero, the action will occur 'x-count' times and then not
    alert again.  This is ideal for setting 'page me 3 times and then don't
    page me again'.  

    WatchLAN swaps itself out of memory when executing the Execute Program
    and Execute Batch File actions providing maximum available memory for
    those actions.  

    Extensive description information include with cc:Mail and MHS alerting
    text.   Following is a sample cc:Mail report triggered by Connections In
    Use exceeding the test value of 5.  

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

        [165] From: watchlan 12/10/93 12:37PM (734 bytes: 17 ln)
        To: Supervisor
        Subject: (XTREE) Connections In Use @ 18
        --------------------- Message Contents ---------------------
        Site    : 001
        Date    : 12/16/93
        Time    : 12:37:54 pm
        Server  : XTREE
        Test    : Connections In Use > 5
        Result  : 18

         Definition:
          The number of workstations which have the network shell loaded
          and an attachment to the file server.  A connection does not
          necessarily have to have a logged in user in order to be counted.
        
         Importance:
          Network connections are not terminated by LOGOUT nor are they
          immediately cleared when a workstation is turned off.  Therefore,
          the number of Connections In Use may not be proportionate to the
          number of active users on the system.

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

    Extended cc:Mail Import capabilities.  When defining the cc:Mail action
    the administrator can provide a filename that contains additional cc:Mail
    import directives, such as copy recipient, blind-copy, message priority,
    attachments and others. Full description of the message file format is
    provided in the cc:Mail Import/Export User's Manual.  

 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
 
 General Issues
 ==============
 1.  XTree Tools for Networks have not been certified under NetWare SFT III or
     NetWare 4.0 in this release.
 
 2.  All of the modules, except for Configuration Manager, require Supervisor
     Equivalence to execute.
 
 
 
 Installation
 ============
 1.  To install XTree Tools for Networks you must be logged in as user 
     "SUPERVISOR" or have supervisor equivalence.  Begin by inserting 
     diskette #1 in drive A:.  If your drive is named something other than A, 
     substitute that letter for A.  From the command line type:

        A: <Enter>
        INSTALL <Enter>
     
     The installation program will allow you to do the following operations:
               
     Enable License 
     
       XTree Tools is licensed by server.  This option allows you to enable 
       the license on one server.
       
       When the Enable option is selected, a list of your network's known 
       NetWare file servers will appear on screen.  Locate the server you 
       wish to license enable from the list and press ENTER.
       
       Enter the serial number that was included in your package.
       
       Assuming you typed the number correctly, you will be asked to confirm 
       your selection. Type Y to enable or N to return to the main menu.  
     
     Install Tools  
     
       This option allows you to install the Tools modules onto a 
       workstation.  You are allowed to install the modules on more than one 
       workstation that is connected to a properly licensed server.
       
       Select this option and type in the path where you would like to store 
       the XTree Tools for Networks program files.
     
     Disable License
     
       If you wish to move the XTree Tools license from one server to 
       another, you must first choose the Disable License option from the 
       main install menu.  A list of your network's known NetWare file 
       servers will appear on screen.  Locate the server you wish to license 
       disable from the list and press ENTER.
       
       You will then be asked to confirm your selection.  Type Y to disable 
       or  N to return to the main menu.  You will now see the disable 
       success screen that verifies the action has been completed.
     

2.  The installation program will not copy the XTREE.NLM file to the
    SYS:SYSTEM directory, this must be done using a DOS copy command.

    NOTE: The XTree NLM must be loaded at the system console before many of
          the NetWare 3.1x functions can be supported.


3.  Reachout, the Windows remote control package, is fully contained on
    diskette 2 and installed separately from the XTools software.  XTServ is
    contained on diskette 2 but is not copied to the hard disk by the
    Reachout Install program.  You must manually copy this across and include
    it in the autoexec.bat file or user login script.  Reachout will not run
    at the workstation if XTServ has not be previously loaded. 



XTools Main Menu
================
1.  Incompatibilities exist between the XTree Tools for Networks modules and
    workstations running with Clarkson BYU packet drivers.

2.  The XTree Tools for Networks main menu will write a temporary file to the
    current directory when it executes the individual modules.  If this file
    is deleted, an error message will be displayed when returning to the
    menu.

3.  All of the modules in XTree Tools for Networks can be executed as
    standalone applications.  Please refer to the documentation for some
    additional notes.



Workstation Monitor
===================
1.  The manual refers to 'Loading XTSERV' at the end of this section.
    This section is not found in the manual.  However, it is included
    here and in the On-line Help.

    Loading XTSERV

      To have the ability to view a workstation's AUTOEXEC.BAT, CONFIG.SYS,
      System Overview, and System Memory Map, each workstation must be
      running the XTree Server Program.  This is an approximately 6K
      terminate-and-stay-resident program.  This can be loaded through the
      AUTOEXEC.BAT file after IPX.COM on the workstation.
 
       The syntax for loading the program is:
 
         XTSERV [options] [servername]
 
       The options are:
 
       /Pnnn  : password (1-20) characters
 
       /S     : To display the internal communication statistics.
 
       /U     : To unload TSR from memory.
 
       /?     : To display all of these options.
 
 
 2.  Polling delays may be encountered in the following functions due to
     the need to establish an SPX connection prior to retrieving the
     diagnostic information:
 
        Network Configuration
        Server Connections
        Shell Driver
        IPX Statistics
        SPX Statistics
        Shell Statistics
        Shell Diagnostics
 
     Pressing ESCAPE to cancel the operation may have a delayed reaction
     while the SPX connection is properly terminated.
 
 3.  You may experience some problems when remote controlling a workstation
     that is equipped with a monochrome adapter if the controlling
     workstation is running a VGA color adapter.
 
 
 
 Backup&Restore
 ==============
 1.  The Percent Completed bar does not indicate time reference, rather it
     indicates a percentage of tasks completed.  It is possible that the
     last option, printer configuration files, may take up to 50% of the
     overall backup time even though 90% of the tasks have been completed.
 
 
 
 WatchLAN
 ========
 1.  The cc:Mail option requires that the customer separately purchase the
     cc:Mail Import program.
 
 
 
 POWERsave Server Backup
 =======================
 1.  The POWERsave documentation describes its diskettes requirements
     referring to the POWERsave Install Disk #1, which is actually the
     XTree Tools for Networks Disk # 2.
 
 2.  Refer to PSAVE.DOC for POWERsave Version 1.0 release notes and 
     DRIVES.DOC for a list of supported adapters and tape drives.  
     Both of these files are on XTree Tools for Networks Disk # 2 and 
     are copied to your hard drive when the POWERsave software is 
     installed.

 3.  The POWERsave documentation files are stored on the second POWERsave
     diskette.  Two files are provided, one in Word format and another in
     WordPerfect format.  These files are both contained in file PS_DOC.ZIP. 

 
 
 Credits
 =======
 1.  Portions Copyright South Mountain Software.
     The XTools main menu uses a disk swapping program ('Hold Everything'
     from South Mountain Software) to swap itself out of memory to run each
     of the modules.
 
 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

    XTools 1.5 Filelist and Descriptions 
 
    Filename        Description
    ------------    -------------------------------------------

    README.1ST      This text file

    XTOOLS.EXE      XTool Main Program
    BR.EXE          Backup&Restore
    CFGMGR.EXE      Configuration Manager
    MTR.EXE         Server Monitor
    NETTRACK.EXE    NetTrack
    QSTAT.EXE       QuikStat
    WATCH.EXE       WatchLAN
    WSMTR.EXE       Workstation Monitor

    DEF286.WAF      Default 286 Action File
    DEF386.WAF      Default 386 Action File
    DEF286.WTF      Default 286 Test File
    DEF386.WTF      Default 386 Test File

    CONV_ACT.EXE    Utilities to convert Action and Test Files from 
    CONV_OPT.EXE        XTools 1.0x to XTool 1.5 format
    SERLIST.EXE     Utility to display server list with XTools serial #

    BR.HLP          XTools help files
    CFGMGR.HLP
    MTR.HLP
    QSTAT.HLP
    WATCH.HLP
    WSMTR.HLP
    XTOOLS.HLP

    XTN$WLDF.DAT    Actions Definition Files

    BR.PIF          Files for running XTools in Windows 3.x
    CFGMGR.PIF
    MTR.PIF
    NETTRACK.PIF
    QSTAT.PIF
    WATCH.PIF
    WSMTR.PIF
    XTOOLS.PIF
    XTOOLS.ICO      

    XTREE.NLM       The XTools NLM

                    Files needed for remote control workstation access
    XTSERV.COM      The XTree Server TSR
    RCONTROL.EXE    Remote control management
    RCHIPX.EXE      ReachOut communications interface for Novell IPX
    VIEWNET.EXE     Reachout Viewer
    VWREXEC.EXE     Reachout Viewer Executive
    REACHOUT.PRM    Reachout Parameters 

    Z.EXE           Zedit
    ZX.EXE          Non-Overlayed Zedit
    ZEXEC.HST       DOS shell command input history
    ZFILE.HST       File open input history
    ZMISC.HST       Search and miscellaneous input history
    ZLIST.HST       List of most recently edited files
    ZMAC1.CFG       Primary macro set
    ZMAC2.CFG       Alternate macro set w/pc characters
    ZTABS.INI       Tab settings
    ZEDIT.TXT       Zedit Users Guide

 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

Contacting Technical Support 
============================
Before calling Technical Support, please refer to the section of the manual
that explains the procedure about which you have a question or refer to the
on line help.  

Telephone support is available from 6:00am to 4:00pm on Wednesday, and from
6:00am to 5:00pm Pacific Standard Time all other weekdays. 
 
      Telephone: 503-690-8080.

You may also contact Technical Support in writing:

      The Technical Support fax machine is available to receive 24 hours a
      day.  Send your fax to 503 690-7133.

Or send us a letter, addressed to:

      Central Point Software
      Attention:  Technical Support
      15220 NW Greenbrier Parkway, Suite 150
      Beaverton, OR 97006

24 hour On-line Systems:

CP BBS 2400 bps         503-690-6650
CP BBS up to 14400 bps  503-690-4777
CompuServe              GO CENTRAL
TTY/TDD                 503-690-2695
FaxBack                 800-847-8766

 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
                        End of README.1ST
 *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

