home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / sysutl / launch13.arc / LAUNCH.DOC next >
Text File  |  1989-03-20  |  18KB  |  595 lines
  1.  
  2.  
  3.  
  4.      LAUNCH User's Guide                                                 3/20/89
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                LAUNCH User's Guide
  20.                                    Version 1.3
  21.                        Copyright (c) 1989 Hamrick Software
  22.                                All Rights Reserved
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.          Please send all suggestions, error reports, and corrections to:
  35.  
  36.                                                        Hamrick Software
  37.                                                        P.O. Box 58635
  38.                                                        Renton, WA 98058
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      Copyright (c) 1989 Hamrick Software                                  Page 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      LAUNCH User's Guide                                                 3/20/89
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                TABLE OF CONTENTS
  77.  
  78.      1.0  Introduction....................................................3
  79.      2.0  Prerequisites...................................................4
  80.      2.1  Hardware Required...............................................4
  81.      2.2  Software Required...............................................4
  82.      2.3  Obtaining a Password to use LAUNCH..............................4
  83.      3.0  Running LAUNCH..................................................5
  84.      4.0  Limitations and Restrictions....................................5
  85.      5.0  Sample LAUNCH Commands..........................................6
  86.      6.0  Error Messages..................................................6
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      Copyright (c) 1989 Hamrick Software                                  Page 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      LAUNCH User's Guide                                                 3/20/89
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                                    TRADEMARKS
  143.  
  144.      X*CHANGE,  X*PRESS, and  X*PRESS Executive  are trademarks  of X*PRESS
  145.      Information Services, Ltd.
  146.  
  147.      Microsoft   and   MS-DOS  are   registered  trademarks   of  Microsoft
  148.      Corporation
  149.  
  150.      IBM  and PC-DOS  are registered  trademarks of  International Business
  151.      Machines Corporation
  152.  
  153.      Turbo  Pascal and Turbo Assembler are registered trademarks of Borland
  154.      International, Inc.
  155.  
  156.  
  157.  
  158.  
  159.                                 ACKNOWLEDGEMENTS
  160.  
  161.      LAUNCH was written using Turbo Pascal and Turbo Assembler.
  162.  
  163.      The User's Guide was created using Microsoft Works.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      Copyright (c) 1989 Hamrick Software                                  Page 3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      LAUNCH User's Guide                                                 3/20/89
  203.  
  204.  
  205.      1.0  Introduction
  206.  
  207.           LAUNCH  is a program that lets you run another program using
  208.      a portion of your computer's available memory, and interrupt this
  209.      program at any time to run DOS in the remaining memory.
  210.  
  211.           There are two applications for LAUNCH.  The main application
  212.      is  to allow you to run  certain programs in the background, such
  213.      as  X*CHANGE, while  you run  DOS in  the foreground.   The other
  214.      application  is to  let you start  certain long-running programs,
  215.      and interrupt them periodically to perform other tasks.
  216.  
  217.           The only programs that will continue to run when interrupted
  218.      are  programs that are  "interrupt driven".   An interrupt driven
  219.      program  either processes characters from a serial communications
  220.      port  or  does some  processing every  time the  computer's clock
  221.      ticks.   Two programs which are  interrupt driven, and which will
  222.      continue processing after being interrupted, are the X*CHANGE and
  223.      X*PRESS  Executive  programs from  X*PRESS  Information Services,
  224.      Ltd.   Any program that is interrupted will be continued from the
  225.      point it was interrupted, without any adverse effects.
  226.  
  227.      This  User's Guide contains  some examples of  actual output from
  228.      the  LAUNCH program.   These  examples of  actual output  will be
  229.      highlighted  by a row of dots before  and after the example.  For
  230.      example, the help screen for the LAUNCH program is:
  231.  
  232.      ..........................................................................
  233.  
  234.      LAUNCH Version 1.3  Copyright (c) 1989 Hamrick Software
  235.       
  236.      LAUNCH lets you run any program in a way that lets you temporarily
  237.      interrupt the program to perform DOS commands.  To interrupt LAUNCH,
  238.      press the Alt key and right-hand Shift key.  To run LAUNCH, type:
  239.       
  240.      LAUNCH memory program parameters
  241.       
  242.      where "memory" is the number of K-Bytes of memory to use to run the
  243.      program, "program" is the filename of the program you want to run, and
  244.      "parameters" are the parameters you would normally type after the
  245.      program name.  For example:
  246.       
  247.      LAUNCH 256 XCHANGE     will start XCHANGE in 256K of memory
  248.       
  249.      The first time you run LAUNCH, you will be asked to enter the password
  250.      you were sent by Hamrick Software.  To help you determine whether
  251.      LAUNCH is useful to you, LAUNCH will run without a password for up to
  252.      15 minutes.
  253.       
  254.      A LAUNCH password can be purchased for $49.95 from   Hamrick Software
  255.                                                           P.O. Box 58635
  256.                                                           Renton, WA 98058
  257.      ..........................................................................
  258.  
  259.  
  260.  
  261.  
  262.      Copyright (c) 1989 Hamrick Software                                  Page 4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      LAUNCH User's Guide                                                 3/20/89
  269.  
  270.  
  271.      2.0  Prerequisites
  272.  
  273.           The  following  three  sections  describe  the  hardware and
  274.      software  required to run the LAUNCH program, and describe how to
  275.      purchase a copy of LAUNCH.
  276.  
  277.      2.1  Hardware Required
  278.  
  279.           In  order to use LAUNCH, you  will need an IBM PC compatible
  280.      personal  computer with a minimum of 384K of memory.  LAUNCH will
  281.      run  at any hardware clock speed,  including 4.77 MHz, and can be
  282.      loaded  from either a  floppy disk or  a hard disk.   In order to
  283.      interrupt a program started by LAUNCH, the display must be in one
  284.      of the three possible 80 column alphanumeric display modes: BW80,
  285.      CO80, or MONO (mode 2, 3, or 7, respectively).
  286.  
  287.      2.2  Software Required
  288.  
  289.           In  order to run LAUNCH,  you will need a  copy of MS-DOS or
  290.      PC-DOS,  version  2.0 or  higher.   You  also need  the following
  291.      LAUNCH program file:
  292.  
  293.      LAUNCH.EXE     -    Main LAUNCH program
  294.  
  295.           The LAUNCH User's Guide, and the examples contained within
  296.      it are contained in the following file:
  297.  
  298.      LAUNCH.DOC     -    LAUNCH User's Guide
  299.  
  300.      2.3  Obtaining a Password to use LAUNCH
  301.  
  302.           LAUNCH  is a computer program  which is a commercial product
  303.      of  Hamrick Software.   In order to  run LAUNCH for  more than 15
  304.      minutes  at a time, you need to purchase a password.  To purchase
  305.      a LAUNCH password, please send $49.95 to:
  306.  
  307.                          Hamrick Software
  308.                          P.O. Box 58635
  309.                          Renton, WA  98058
  310.  
  311.           You will receive your LAUNCH password within approximately 2
  312.      weeks.   The LAUNCH  software is not copy  protected, and you may
  313.      make  as many  backup copies  as you wish.   The  license you are
  314.      granted allows running LAUNCH on one computer at a time.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.      Copyright (c) 1989 Hamrick Software                                  Page 5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      LAUNCH User's Guide                                                 3/20/89
  335.  
  336.  
  337.      3.0  Running LAUNCH
  338.  
  339.           To run LAUNCH, type the following command at a DOS prompt:
  340.  
  341.      LAUNCH memory program parameters
  342.  
  343.      where  "memory" is the number of K-Bytes  of memory to use to run
  344.      the  program, "program" is  the file name of  the program to run,
  345.      and "parameters" are the parameters you would normally type after
  346.      the program name.  For instance, if you would normally type
  347.  
  348.      make -Iinclude -DTURBO=c:\tp5\project
  349.  
  350.      to  build a program, and  if you wanted this  build process to be
  351.      interruptible, you could type
  352.  
  353.      launch 350 make -Iinclude -DTURBO=c:\tp5\project
  354.  
  355.           The  first time you  run LAUNCH, you will  be asked to enter
  356.      the  password  for LAUNCH.    You will  only  need to  enter this
  357.      password  again if you  run LAUNCH on  another computer, disk, or
  358.      directory.    If the  password is  incorrect,  you may  still use
  359.      LAUNCH for up to 15 minutes.  If LAUNCH is still running after 15
  360.      minutes,  the  computer  will be  rebooted,  just as  if  you had
  361.      pressed Control-Alt-Delete.
  362.  
  363.           While  you are running a program  started by LAUNCH, you can
  364.      cause  it to  be interrupted by  pressing the  Alt and right-hand
  365.      shift keys simultaneously.  The current screen will be saved, and
  366.      a  new screen will be displayed with the standard DOS prompt.  At
  367.      this  point you  may enter DOS  commands and  run other programs.
  368.      When you want to return to the program you interrupted, type EXIT
  369.      at a DOS prompt.
  370.  
  371.      4.0  Limitations and Restrictions
  372.  
  373.           The  LAUNCH program will only  interrupt the running program
  374.      when you press Alt-RightShift and when the running program is not
  375.      in the middle of a DOS operation.  Some DOS operations may take a
  376.      long  time, so there  may be a  delay of up  to 30 seconds before
  377.      LAUNCH recognizes that you have pressed Alt-RightShift.  You must
  378.      keep  both the  Alt key and  right hand  Shift key simultaneously
  379.      depressed until the program is interrupted.
  380.  
  381.           Some  programs use an un-interruptible DOS operation to read
  382.      from  the  keyboard.   These programs  will not  be interruptible
  383.      while they are waiting for you to type on the keyboard.  However,
  384.      most   commercial  programs  do   not  use  un-interruptible  DOS
  385.      operations to read from the keyboard.
  386.  
  387.           If  you start a program which uses either a 40 column alpha-
  388.      numeric  display or  a graphics  display, pressing Alt-RightShift
  389.      will  do nothing.   The  program can  only be  interrupted if the
  390.      display is an 80 column alpha-numeric display.
  391.  
  392.  
  393.  
  394.      Copyright (c) 1989 Hamrick Software                                  Page 6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      LAUNCH User's Guide                                                 3/20/89
  401.  
  402.  
  403.      5.0  Sample LAUNCH Commands
  404.  
  405.      A>LAUNCH 256 XCHANGE          This   command  loads   the  LAUNCH
  406.                                    program  from floppy  disk drive A.
  407.                                    LAUNCH    tries   to   run   either
  408.                                    XCHANGE.EXE  or XCHANGE.COM in 256K
  409.                                    of  memory.  The  current drive and
  410.                                    directory  is  searched  first, and
  411.                                    then  all directories  specified by
  412.                                    the PATH command are searched.
  413.  
  414.      A>LAUNCH 384 C:\XCHANGE       This   command  loads   the  LAUNCH
  415.                                    program  from floppy  disk drive A.
  416.                                    LAUNCH    tries   to   run   either
  417.                                    C:\XCHANGE.EXE or C:\XCHANGE.COM in
  418.                                    384K of memory.
  419.  
  420.      C>LAUNCH 256 COMMAND /C DIR   This   command  loads   the  LAUNCH
  421.                                    program from the hard disk.  LAUNCH
  422.                                    tries   to  run   the  DOS  command
  423.                                    processor  in 256K of  memory.  The
  424.                                    DOS  command processor will execute
  425.                                    the  DIR command.  The execution of
  426.                                    the  DIR command can be interrupted
  427.                                    by pressing Alt-RightShift.
  428.  
  429.      6.0  Error Messages
  430.  
  431.           This  section  contains a  list of  all error  messages that
  432.      might  be produced by the LAUNCH program, the cause of each error
  433.      message, and what you can do to correct each error.
  434.  
  435.      ..........................................................................
  436.  
  437.      Program too big to fit in memory
  438.      ..........................................................................
  439.  
  440.           MS-DOS  or PC-DOS will display this message if your computer
  441.      doesn't  have enough free  memory to run  the LAUNCH program. You
  442.      will  need  approximately 128,000  bytes  of free  memory  to run
  443.      LAUNCH.   You may be able to  obtain more free memory by removing
  444.      some  memory resident programs or  by reducing or eliminating the
  445.      amount  of  memory  dedicated  to  a  RAM  disk.    You  can  get
  446.      information  about how much free memory you have by using the MS-
  447.      DOS or PC-DOS utility program CHKDSK.  Please refer to the MS-DOS
  448.      or  PC-DOS documentation  for details  on how  to run  the CHKDSK
  449.      program.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.      Copyright (c) 1989 Hamrick Software                                  Page 7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      LAUNCH User's Guide                                                 3/20/89
  467.  
  468.  
  469.      ..........................................................................
  470.  
  471.      Sorry, nnn is not a valid number.
  472.      ..........................................................................
  473.  
  474.           You  will get  this error  message if  you enter  an invalid
  475.      number.  Check that the number is valid, that it does not contain
  476.      a comma, and that it is greater than 0 and less than 640.
  477.  
  478.      ..........................................................................
  479.  
  480.      Sorry, nnn must be greater than zero.
  481.      ..........................................................................
  482.  
  483.           You  will get  this error  message if  you enter  a negative
  484.      number  or zero.  You should  only enter numbers that are greater
  485.      than zero.
  486.  
  487.      ..........................................................................
  488.  
  489.      Sorry, not enough memory available.
  490.      ..........................................................................
  491.  
  492.           You  will get this error message  if you enter a memory size
  493.      that  is too big.    Try using  a smaller number,  or try to free
  494.      existing  memory.  You may be able  to obtain more free memory by
  495.      removing   some  memory  resident  programs  or  by  reducing  or
  496.      eliminating  the amount of  memory dedicated to a  RAM disk.  You
  497.      can  get information about how much free memory you have by using
  498.      the MS-DOS or PC-DOS utility program CHKDSK.  Please refer to the
  499.      MS-DOS  or PC-DOS  documentation for  details on  how to  run the
  500.      CHKDSK program.
  501.  
  502.      ..........................................................................
  503.  
  504.      Sorry, can't find xxxxxx
  505.      ..........................................................................
  506.  
  507.           You will get this error message if the file name you entered
  508.      can't  be located.  You will  also get this message if LAUNCH.EXE
  509.      is  not in  the current  directory or  in one  of the directories
  510.      specified  by the DOS  PATH command.  Make  sure that the program
  511.      file is either located in the current directory or in a directory
  512.      that  has been referred  to with the  DOS PATH command.   You can
  513.      either  change your current directory,  include the explicit path
  514.      in  the file name, or add the path to the file using the DOS PATH
  515.      command.  See your DOS manual for more details.
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.      Copyright (c) 1989 Hamrick Software                                  Page 8
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      LAUNCH User's Guide                                                 3/20/89
  533.  
  534.  
  535.      ..........................................................................
  536.  
  537.      Sorry, nnnK is not enough memory to run xxxxxx
  538.      ..........................................................................
  539.  
  540.           You  will get this error message if the amount of memory you
  541.      have  specified is too  small.  Try the  LAUNCH command with more
  542.      memory specified.
  543.  
  544.      ..........................................................................
  545.  
  546.      Sorry, that password is not valid.  LAUNCH will continue
  547.      to run for another 15 minutes so you can evaluate it.
  548.      ..........................................................................
  549.  
  550.           You  will get  this error  message if  you enter  an invalid
  551.      password,  or no password  at all.  Try  the LAUNCH command again
  552.      with  the  correct password  if you  need to  run longer  than 15
  553.      minutes.  You should only need to enter the password once.
  554.  
  555.      ..........................................................................
  556.  
  557.      DOS Error nn - Please write Hamrick Software how to reproduce this error.
  558.      ..........................................................................
  559.  
  560.           You  should never  receive this error  message.   If you do,
  561.      please  send  a  description of  how  to reproduce  the  error to
  562.      Hamrick  Software.  You  should also try  rebooting your computer
  563.      and seeing if you can still reproduce the problem.
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.      Copyright (c) 1989 Hamrick Software                                  Page 9
  593.  
  594.  
  595.