===   LIBUSR.TXT   ===

     A documentation of how to use/run the SYSLIB Test Package.

                      Version:        1.0
                      Date Created:   June 30, 1988
                      Created By:     I.B. Sokari
                      Modified By:                

     WHAT IS THE SYSLIB TEST PACKAGE --- LIBTST?
     -------------------------------------------

        The SYSLIB Test Package under the name LIBTST is a collection of
      Fortran programs that test the RT-11 System Library (SYSLIB) 
      subroutines. The primary goal of the test package is to ensure that
      these routines are working as accurately as advertised. 

        The test package can be run under all the three RT-11 monitors ---
      SJ, FB, and XM. Since each monitor has different characteristic(s),
      running the test package means tailoring the package to the requirements
      of each monitor. The IND file "LIBRUN.COM" achieves this and also
      streamlines the procedures used to run the test package. The test 
      package is menu-driven.


    PROCEDURES FOR RUNNING THE SYSLIB TEST PACKAGE.
    -------------------------------------------------

     A: Preparations --- Getting the files needed to run the test Package:
        ------------------------------------------------------------------

        There are two sets of files (plus the IND file LIBRUN.COM) necessary
      to successfully run the test package. The first set comprises all the
      .SAV files and the second set is made up of .TXT files. Both sets of 
      files and LIBRUN.COM reside in the SVV data base directory "VV:[LIBTST]".
         
        Copy the files from the data base to some preferred disk(s) on your
      system. You may keep all the files on the same disk or on separate
      disks. If you choose to keep the files on different disks, you should
      make sure you can identify where they reside since LIBRUN.COM will
      need to know this information in order to successfully make the
      appropriate logical disks assignments.


     B: Running the SYSLIB Test Package:
        --------------------------------

       
        To run the SYSLIB Test Package, execute the file LIBRUN.COM as you
      would any other IND file under any of the monitors --- SJ, FB, or XM.
      If KMON is set to "NOIND", the KMON command:
                    "IND LIBRUN"   is recommended.

        LIBRUN.COM will prompt you for the names of the disks on which
      the .SAV and .TXT files you copied from the data base reside. Supply
      the names of the disks. LIBRUN.COM will make the appropriate logical
      disks assignment and ask you if you would like to continue. You may
      quit at this stage if you made a mistake in supplying the name(s) of
      disk(s) or if you don't want to run the test by typing "N" for "NO".

        If you wish to continue with the test, respond to the query by
      typing "Y" for "YES".  LIBRUN.COM will check the environment under
      which you are running the test, set up the requirements for the
      specific monitor, and run the executable file "LIBTST.SAV".

        This will display the menu of the SYSLIB Test Package. Each menu
      corresponds to a test class. Choose any of the displayed menu items by
      entering the name of the test class you wish to test and pressing the
      RETURN key. The tests will be performed for the test class you have
      chosen. The FIRST FOUR characters of each menu item will also be
      accepted in place of the full name.

          NOTE:
          -----

          (i)    The menu is diplayed THREE times before you can choose 
                 from it This is not an error and will not affect the
                 successful execution of any of the tests. LIBRUN.COM
                 reads the characters "^C RUBOUT" and "^C NULL" and passes
                 them to LIBTST.SAV which interprets them as user responses
                 to the displayed menu . Since these characters are not any
                 of the valid menu items, LIBTST.SAV clears the screen and
                 re-displays the menu. This is why you get the first two
                 displays. 

                 The multiple menu display will stop once a menu item 
                 is chosen and the tests performed.


          (ii)   If you input a non-valid menu item (menu item not displayed)
                 the program will clear the screen and re-display the menu.


          (iii)  Since the package can be run under all three monitors,
                 LIBRUN.COM will inform the user as to which monitor
                 is being used.


        You may exit the test package by typing either "EXIT" or "^C" 
      in response to the query for a test class. 

        HELP is also available in the package. The "HELP" option in 
      the menu will provide you with other information about the 
      test package. 
    
        A summary of the results of the tests performed can be obtained
      by typing "SUMMARY" in response to the query for a test class.

        Finally, you can also perform ALL the tests in ALL the test
      classes by typing "ALL" as the chosen menu item.