home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / kis1193l.zip / KIS.DOC < prev    next >
Text File  |  1993-11-27  |  8KB  |  192 lines
  1. ==================== Keepin' It Simple Documentation ====================
  2.  
  3. DISCLAIMER:
  4.  
  5.         THE AUTHOR DOES NOT GUARANTEE THIS PROGRAM TO BE FREE FROM
  6.     DEFECTS AND MAY NOT BE HELD RESPONSIBLE FOR LOSS CAUSED BY SUCH.
  7.     YOUR USE OF THIS PROGRAM CONSTITUTES YOUR ACCEPTANCE OF THESE TERMS.
  8.  
  9.         THE AUTHOR ONLY GUARANTEES THAT THIS PROGRAM WILL OCCUPY DISK
  10.     SPACE.
  11.  
  12. What is KIS for OS/2?
  13.  
  14.         This file is principally for the needs of SysOps running DOS BBS
  15.     programs under OS/2.  This program, will, on the presence of a
  16.     semaphore file (referred to from now on as a 'flag'), will execute a
  17.     DOS VDM Full Screen window in the background to process any event
  18.     that you might have that can run in the background and freeing up
  19.     your other processes to run.
  20.  
  21.         KIS is a DEMO program.  It will run for 90 days allowing you to
  22.     fully evaluate the program.  It does not write any values to your
  23.     System or User INI files.  It has its own INI file system.
  24.  
  25. LIMITATIONS:
  26.  
  27.         At present, this program will only recognize five semaphore
  28.     files per program in the configuration, with a limit of 2 programs,
  29.     10 flags. It also requires the VROBJ.DLL runtime library from Watcom
  30.     which may or may not be included in this file.
  31.  
  32. LICENSE:
  33.  
  34.         You are granted a license to run KIS on your personal computer
  35.     systems for a period of 90 days.  After that period you are required
  36.     to purchase the program.  Government Institutions and Business
  37.     establishments must purchase one copy per system for use after that
  38.     period.
  39.  
  40. ABOUT THE PROGRAM:
  41.  
  42.         KIS was developed using VXREXX for OS/2 by Watcom International.
  43.     It is a PM program with enhanced extensions to the REXX language and
  44.     requires that REXX and the Workplace Shell to be installed on the
  45.     system in order to fully work properly.  It also needs VROBJ.DLL in
  46.     order to run. This file may, or may not have been included in this
  47.     archive.
  48.  
  49. INSTALLATION:
  50.  
  51.         To install KIS, you must first copy all KIS executable files to
  52.     the directory in which your flags will exist.  This is the
  53.     INSTALL.CMD, VROBJ.DLL, KISINTL.EXE, KISCFG.EXE and KISOS2.EXE
  54.     files. (If you already have VROBJ.DLL on your system, be sure to
  55.     use the newer version, and you do not need to include this file
  56.     although you will see a short error message stating 'File Not Found'
  57.     when running the Install.cmd.
  58.  
  59.         Open a OS/2 session, change directory to where KISOS2 resides
  60.     and type INSTALL. Follow the prompts and carefully input the
  61.     information it requires. If you do not wish for the DLL file to be
  62.     copied to your OS2\DLL directory, the simply type KISINST.
  63.  
  64.         Installation will take a moment, as it will create the INI file
  65.     that the program will use while it is running.  Depending on your
  66.     machine, it may take a minute or two.  You will not see any screen
  67.     input during this time.
  68.  
  69.         Once the INI file process in complete, it will enter into the
  70.     configuration program.
  71.  
  72.         When this process is done, the configuration program will exit,
  73.     and then you will need to either Migrate the program, or use the
  74.     templates folder to create a program template.  This will set KIS up
  75.     with its own icon file, and allow you to place it wherever you wish
  76.     on your Desktop.
  77.  
  78. CONFIGURATION:
  79.  
  80.         When the program initializes, it will create a KISOS2.INI file
  81.     that contains no "real" information.  You will need to complete the
  82.     configuration process to complete to customize the program for your
  83.     use.  This program will run at the beginning of the installation,
  84.     and again from the main program menu if you need to change it.
  85.  
  86.         You will need to enter in the full path and name of the
  87.     executable file that you desire for Program 1, Program 2 is
  88.     optional.  This value will then be displayed in the settings box so
  89.     that you may select either program to react to each set of flags.
  90.     (The box currently is a drop down box that will show either program.
  91.     Setting this has no current effect on the program.)
  92.  
  93.         You will also need to adjust the IDLE time to your liking.  This
  94.     is the amount of time before the system polls for the presence of
  95.     the flags in the directory and executes the programs if they exist.
  96.     It defaults to 5 minutes on installation.
  97.  
  98.         You will need to take some time to configure your programs. You
  99.     MUST execute a batch file which will have at least these two lines
  100.     in it where the batch file ends:
  101.  
  102.                 DEL RUN1 (or RUN2 for program 2)
  103.                 EXIT
  104.  
  105.         The file RUN1(or 2) is created in the directory where KIS is
  106.     installed.  This is how KIS knows your program is still running and
  107.     does not launch another window in the time frame that you have set.
  108.     This is to avoid programs crashing into each other.  While KIS is
  109.     designed to "spawn" another window, some programs will not run at
  110.     the same time, even if in separate sessions.
  111.  
  112.         The last closes the window and frees up memory space.  Since
  113.     there is no way for KIS to do this, you must ensure that each batch
  114.     file you use ends with these two lines. Without these lines, KIS
  115.     will continue to spawn new windows until you run out of available
  116.     memory, or swap space.
  117.  
  118. PROGRAM EXECUTION:
  119.  
  120.         To start the program, double click on the KISOS2 Icon, This will
  121.     start the main program.  You may click on start at this point, then
  122.     you can minimize the application so it will not occupy space on your
  123.     screen. (You will need to MIGRATE the program to create a program
  124.     icon for it, or you may drag a program icon from the templates
  125.     folder and do this instead.)
  126.  
  127.         You may also run the configuration program from the main program
  128.     menu. This will allow you to change values.  However you will need
  129.     to stop and restart the program at this time to read in the new
  130.     values.
  131.  
  132. HELP:
  133.  
  134.         Currently there is no help available for the program beyond this
  135.     documentation.
  136.  
  137. FUTURE PLANS:
  138.  
  139.         The next demo release will improve on speed of the program as
  140.     well as make it more configurable.  Also, hooks will be added to
  141.     configure if you want the windows opened to be foreground or
  142.     background as well as if you want to launch a DOS session or a OS/2
  143.     session.
  144.  
  145. UPGRADES:
  146.  
  147.         Registration entitles all upgrades through each version, ie:
  148.     1.x. While there might be a modest upgrade fee to the next version,
  149.     at this time I am not sure that it will evolve to that point.  This
  150.     program was designed and thrown together to suit a specific need.
  151.  
  152. BUGS:
  153.  
  154.         Bugs are a fact of life. If I were perfect, I would do this for
  155.     a living.  Please report all bugs to me so that I can address them
  156.     and fix them.
  157.  
  158. PURCHASE:
  159.  
  160.         Registration is a modest 5 dollars US, and the program will run
  161.     for 90 days with all the features of the commercial version.  This
  162.     will allow someone enough time to evaluate it, decide if it is worth
  163.     the money. International check are accepted, however the
  164.     registration ID will not be sent until the check clears as with any
  165.     other personal check.
  166.  
  167. Send Money Order or Check to:
  168.  
  169.                     Doug Glenn
  170.                     FORUM! Information Systems
  171.                     135 Henderson Rd.
  172.                     Statesville, NC 28677
  173.  
  174.  
  175.         Allow time for checks to clear prior to download your ID file if
  176.     sending a check.  An ID file will be available for download within
  177.     72 hours of its clearance.  (Allow for weekends please!)
  178.  
  179. SUPPORT:
  180.  
  181.         Support is offered through The Programmers FORUM! BBS or through
  182.     the 3rd Party Authors conference in the WILDNET(tm) Network. Limited
  183.     support can be given through the FIDO Wildcat! or OS/2 conference
  184.     due to conference guidelines.
  185.  
  186.  
  187.         Most questions will be answered within a 72 hour period. Please
  188.     allow that much time after posting a question before looking for an
  189.     answer.
  190.  
  191.         Thank you for trying Keepin' It Simple for OS/2
  192.