home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / menu / sgamenu.arc / SGAMENU.DOC < prev    next >
Text File  |  1988-05-27  |  21KB  |  490 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                     SGAMENU
  22.  
  23.                         An MS-DOS menu utility program 
  24.  
  25.                                  Version 2.01
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                            Steve Glass & Associates
  52.                                  1206 Century
  53.                                Odessa, TX 79762
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                      Copyright(c) 1988 by Stephen W. Glass
  61.  
  62.  
  63.  
  64.  
  65.          =============================================================
  66.          SGAMENU Users Guide                                    
  67.          =============================================================
  68.  
  69.                               Tables of Contents
  70.  
  71.          General Information......................................1
  72.          Installing SGAMENU.......................................1
  73.          Starting SGAMENU.........................................1
  74.          Menu Utilities...........................................2
  75.             Change the company name...............................2
  76.             Change a menu selection...............................2
  77.             Change a menu command file............................2
  78.             Print SGAMENU documentation...........................3
  79.          System Utilities.........................................3
  80.             Set the date..........................................3
  81.             Set the time..........................................3
  82.             Display configuration.................................3
  83.             Check disk space......................................3
  84.             Edit a text file......................................3
  85.             Format a disk in drive A:.............................4
  86.             Format a disk in drive B:.............................4
  87.          A Note For Users With Local Area Networks................4
  88.          Disclaimer...............................................5
  89.          The USER-SUPPORTED Concept...............................5
  90.          Registration/Order form..................................7
  91.  
  92.  
  93.  
  94.          =============================================================
  95.          SGAMENU Users Guide                                    Page 1
  96.          =============================================================
  97.  
  98.                         ***** General Information *****
  99.  
  100.          SGAMENU  is a general purpose menu program which makes use of 
  101.          the  powerful batch processing capabilities of  MS-DOS.   The 
  102.          general concept is to execute the indicated batch file from a 
  103.          user  friendly environment.  (MS-DOS is a lot of things,  but 
  104.          "user friendly" isn't one of them).
  105.  
  106.          SGAMENU  provides  a  menu screen to select  any  one  of  36 
  107.          different  batch  file ("COMMAND files") for  execution.   It 
  108.          also  provides  a simple text editer to create  and  maintain 
  109.          these command files.
  110.  
  111.          SGAMENU  requires  at  least 128k  of  internal  memory,  DOS 
  112.          Version 2.00 or greater and 1 disk drive to operate.
  113.  
  114.                         ***** Installing SGAMENU *****
  115.  
  116.          To  install SGAMENU,  copy the program file (SGAMENU.EXE)  to 
  117.          the desired disk drive and director.
  118.  
  119.          Two other files (MENU.BAT and SGAMENU.DAT) are required which 
  120.          will be created if not present when SGAMENU is run.  MENU.BAT 
  121.          is  the batch file that SGAMENU uses to control execution  of 
  122.          it's  "command" files and SGAMENU.DAT contains the  text  for 
  123.          the menu selections displayed on the Main Menu.
  124.  
  125.          If  you are setting up SGAMENU for the first time and do  not 
  126.          have a MENU.BAT file,  simply enter SGAMENU and press <ENTER> 
  127.          and <Esc>.  This will create a properly formated MENU.BAT and 
  128.          return you to the DOS level.
  129.  
  130.          To  complete  the installation,  you will need to enter  your 
  131.          "company name" and set up your command files.   Refer to  the 
  132.          topic  "Menu Utilities" in this document for instructions  on 
  133.          setting up command files. 
  134.  
  135.                          ***** Starting SGAMENU *****
  136.  
  137.          To   start SGAMENU,  enter MENU and press  <ENTER>.   SGAMENU 
  138.          uses  a batch file named MENU.BAT to control the execution of 
  139.          it's "command" files and MUST ALWAYS be started with MENU.BAT 
  140.          in  order  to execute correctly.   A sign-on screen  will  be 
  141.          displayed  for a moment and then the main menu  will  appear.  
  142.          The first time the SGAMENU is run each day,  it will pause on 
  143.          the  sign-on  screen and require that you press  another  key 
  144.          before  continuing to the Main Menu.   This extra key  stroke 
  145.          will not be required again for the rest of the day.
  146.  
  147.          To execute a command displayed on the Main Menu, simply press 
  148.          the single highlighted character which appears to the left of 
  149.          the desired operation.  
  150.  
  151.          To  exit SGAMENU and return to the DOS prompt,  simply  press 
  152.          the escape key when the Main Menu is displayed.
  153.  
  154.  
  155.  
  156.          =============================================================
  157.          SGAMENU Users Guide                                    Page 2
  158.          =============================================================
  159.  
  160.                           ***** Menu Utilities *****
  161.  
  162.          The  menu  utilities  are used to  maintain  various  control 
  163.          information  used by SGAMENU in it's operation.   This infor
  164.          mation includes the "company name",  the text for each of the 
  165.          menu selections displayed on the Main Menu,  and the  command 
  166.          files  themselves.   The Menu Utilities also provides a means 
  167.          of printing this documentation.   To display the Menu Utility 
  168.          menu,  press  the  F10  key  while the Main  Menu  or  System 
  169.          Utilities Menu is displayed.
  170.  
  171.          (1) Change the company name.....
  172.  
  173.          To edit the company name which appears at the top of the Main 
  174.          Menu,  press <1> while the Menu Utilities menu is  displayed.  
  175.          You  will be prompted in the lower menu box to enter or  make 
  176.          changes to the company name.   Various line editing functions 
  177.          are supported at this prompt:
  178.  
  179.               Right arrow - move cursor one character to the right
  180.               Left arrow - move cursor one cursor to the left
  181.               Ins - Toggle the character insert mode
  182.               Del - Delete a single character at the cursor position
  183.               Ctrl-ENTER - Delete all characters to the right of the
  184.                            cursor.
  185.               Ctrl-Backspace - Delete all characters to the left of
  186.                                the cursor.
  187.  
  188.          (2) Change a menu selection.....
  189.  
  190.          To  edit the text displayed for one of the menu selections on 
  191.          the  Main  Menu,  press 2 while the Menu  Utilities  menu  is 
  192.          displayed.  The cursor will move to that text on the menu and 
  193.          you will be able to enter or make changes to the text for the 
  194.          indicated menu selection.  Various line editing functions are 
  195.          supported at this prompt:
  196.  
  197.               Right arrow - move cursor one character to the right
  198.               Left arrow - move cursor one cursor to the left
  199.               Ins - Toggle the character insert mode
  200.               Del - Delete a single character at the cursor position
  201.               Ctrl-ENTER - Delete all characters to the right of the
  202.                            cursor.
  203.               Ctrl-Backspace - Delete all characters to the left of
  204.                                the cursor.
  205.  
  206.          (3) Change a menu command file.....
  207.  
  208.          To  edit the commands executed when a menu item is  selected, 
  209.          press  <3> while the Menu Utilities menu is  displayed.   The 
  210.          command  file (DOS batch file) corresponding to the indicated 
  211.          menu selection will be displayed and you will be able to make 
  212.          changes.   Various editing functions are available to use  to 
  213.          edit  the file.   These functions are displayed when you hold 
  214.          down  the  <Alt> key and press <H>.   When you have made  the 
  215.          desired changes, press <Esc> to record the changes and return 
  216.          to the menu.
  217.  
  218.  
  219.  
  220.          =============================================================
  221.          SGAMENU Users Guide                                    Page 3
  222.          =============================================================
  223.  
  224.          (4) Print SGAMENU documentation.....
  225.  
  226.          To print this users guide, press <4> while the Menu Utilities 
  227.          menu is displayed.
  228.  
  229.                          ***** System Utilities *****
  230.  
  231.          The  system  utilities are simple day-to-day functions  which 
  232.          normally require either DOS level commands or other software.  
  233.          Rather  than require the use of batch files or  knowledge  of 
  234.          DOS  commands,  these  functions are provided in a more  user 
  235.          friendly form.   To display the System Utilities menu,  press 
  236.          the  F10  key while the Main Menu or Menu Utilities  Menu  is 
  237.          displayed.
  238.  
  239.          (1) Set the date.....
  240.  
  241.          To  set the computers date which SGAMENU always  displays  in 
  242.          the  upper  left corner of the screen,  press <1>  while  the 
  243.          System Utilities Menu is displayed.   A prompt will appear in 
  244.          the  lower  menu  box which will allow you to  enter  today's 
  245.          date.
  246.  
  247.          (2) Set the time.....
  248.  
  249.          To set the computers time which SGAMENU displays in the upper 
  250.          right  corner  of  the screen,  press <2>  while  the  System 
  251.          Utilities  Menu  is displayed.   A prompt will appear in  the 
  252.          lower  menu  box which will allow you to  enter  the  correct 
  253.          time.
  254.  
  255.          (3) Display configuration.....
  256.  
  257.          This   function   will  display  your   computer's   hardware 
  258.          configuration.  How many times has someone asked you how much 
  259.          memory  that  you  had  installed in your  computer  or  what 
  260.          version of DOS you were running?   To display these pieces of 
  261.          data  and  others about your computer,  press <3>  while  the 
  262.          System Utilities Menu is displayed.
  263.  
  264.          (4) Check available disk space.....
  265.  
  266.          To  find out the capacity of your disk or how much  space  is 
  267.          available on it, press (4) while the System Utilities Menu is 
  268.          displayed.
  269.  
  270.          (5) Edit a text file.....
  271.  
  272.          This  function allows you to edit small ASCII text files such 
  273.          as CONFIG.SYS or DOS batch files.  These files may contain up 
  274.          to 100 lines of 255 characters.
  275.  
  276.          To  edit a text file,  press <5) while the Systems  Utilities 
  277.          Menu is displayed.  You will be prompted to enter the name of 
  278.          the  text file to be edited,  including any path  information 
  279.  
  280.  
  281.  
  282.          =============================================================
  283.          SGAMENU Users Guide                                    Page 4
  284.          =============================================================
  285.          needed  to access that file.   After the file name  has  been 
  286.          entered,  SGAMENU  will  display  it and allow  you  to  make 
  287.          changes.   Various  editing functions are available to use to 
  288.          edit this file.   These functions are displayed when you hold 
  289.          down  the <Alt> key and press <H>.   When you have  made  the 
  290.          desired changes, press <Esc> to record the changes and return 
  291.          to the menu.
  292.  
  293.          (6) Format disk drive A:.....
  294.  
  295.          This  function allows you to format a floppy disk using drive 
  296.          A:  without  running  the risk of formatting the  wrong  disk 
  297.          drive  (like maybe your hard disk).   To format a  floppy  in 
  298.          drive  A:,  press  (6)  while the System  Utilities  Menu  is 
  299.          displayed.
  300.  
  301.          You  will  then  be prompted for whether or not you  want  to 
  302.          include  DOS on the new disk.   If you want to make  the  new 
  303.          disk  a "bootable" disk,  press <S> or press <ENTER> if it is 
  304.          to  be  a "data" disk which will not contain the  DOS  system 
  305.          files.
  306.  
  307.          After you have indicated whether it is a system or data disk, 
  308.          you  will be prompted for whether or not you want to enter  a 
  309.          disk volume label.   This volume label is displayed when  you 
  310.          run  a  directory of the disk and will help you identify  it.  
  311.          If  you  wish to specify a disk volume name,  press  (V)  and 
  312.          enter the desired name.   Press <ENTER> if you do now want to 
  313.          specify a volume name.
  314.  
  315.          After  indicating the volume name,   you will be prompted  to 
  316.          insert  a  new disk in drive A:  and press  ENTER  to  begin.  
  317.          After the disk is formated,  you will be asked if you want to 
  318.          format  another  or not,  if you indicate yes,  you  will  go 
  319.          through the format process again.   If you indicated no,  you 
  320.          will be returned to the System Utilities Menu.
  321.  
  322.          (7) Format disk drive B:.....
  323.  
  324.          This  function  works  in  exactly the  same  manner  as  the 
  325.          previous  one  (Format  disk drive A:) except  that  it  uses 
  326.          floppy drive B to format instead of drive A.
  327.  
  328.          NOTE:  Both  of the format functions utilize the DOS  utility 
  329.          program  FORMAT.COM which must be on the default disk and  in 
  330.          the default directory.
  331.  
  332.               ***** A note for Users of Local Area Networks *****
  333.  
  334.          If you are using SGAMENU on a local area network,  each  user 
  335.          will have to have a seperate SGAMENU system.  This is because 
  336.          SGAMENU uses MENU.BAT to control the use of the command files 
  337.          and  MENU.BAT is constantly being written to by SGAMENU.   If 
  338.          more  than one terminal uses the same MENU.BAT  file,  unpre
  339.          dictable results will occur.
  340.  
  341.  
  342.  
  343.          =============================================================
  344.          SGAMENU Users Guide                                    Page 5
  345.          =============================================================
  346.  
  347.                             ***** Disclaimer *****
  348.  
  349.          In no event will the Author be liable to you for any damages,  
  350.          including any lost profits,  lost savings or other incidental 
  351.          or  consequential  damages arising out of the use of  or  in
  352.          ability  to use these programs,  even if the Author has  been 
  353.          advised of the possibility of such damages,  or for any claim 
  354.          by any other party.
  355.  
  356.                     ***** The User-supported concept *****
  357.  
  358.                             User-Supported Software
  359.            If you are using this program and find it to be of value
  360.                      your contribution ($10 is suggested)
  361.                              will be appreciated.
  362.  
  363.                            Steve Glass & Associates
  364.                                  1206 Century
  365.                                Odessa, TX 79762
  366.  
  367.                 Regardless of whether you make a contribution,
  368.               you are encouraged to copy and share this program.
  369.  
  370.                ---------------------------------------------------
  371.  
  372.          Clubs   and   other  non-profit  organizations  are   granted 
  373.          permission  by  the author to freely copy  this  program  and 
  374.          share it with their members, so long as:
  375.  
  376.             (1) No price is charged for the software or documentation. 
  377.             However,  a distribution cost may be charged for the  cost 
  378.             of the diskette, so long as it is not more than $5 total.
  379.  
  380.             (2)  Club  members  are  informed  of  the  user-supported 
  381.             concept and encouraged to support it with their donations.
  382.  
  383.             (3)  The program or documentation are not modified in  any 
  384.             way and are distributed together.
  385.  
  386.          User-supported  software  is an  experiment  in  distributing 
  387.          computer programs, based on three beliefs:
  388.  
  389.             (1) That the value and utility of software is best assess
  390.             ed by the user on his/her own system. 
  391.  
  392.             (2)  That  the creation of personal computer software  can 
  393.             and should be supported by the computing community.
  394.  
  395.             (3) That copying of programs should be encouraged,  rather 
  396.             than restricted. 
  397.  
  398.          Anyone  may  request a copy of a  user-supported  program  by 
  399.          sending a blank, formatted disk to the author of the program.  
  400.          An  addressed,  postage-paid return mailer must accompany the 
  401.          disk (no exceptions,  please).   A copy of the program,  with 
  402.  
  403.  
  404.  
  405.          =============================================================
  406.          SGAMENU Users Guide                                    Page 6
  407.          =============================================================
  408.  
  409.          documentation on the disk,  will be sent by return mail.  The 
  410.          program will carry a notice suggesting a contribution to  the 
  411.          program's  author.    Making  a  contribution  is  completely 
  412.          voluntary on the part of each user.
  413.  
  414.          Free  distribution of software and voluntary payment for  its 
  415.          use  would  eliminate advertising costs and  copy  protection 
  416.          schemes.   Users  could  obtain quality software  at  reduced 
  417.          cost.   And the best programs would survive,  based purely on 
  418.          their quality and usefulness.
  419.  
  420.          The   entire  computing  community  is  indebted  to   Andrew 
  421.          Fluegelman of the Headlands Press,  Inc. for initial develop
  422.          ment of the "User-supported" concept.
  423.  
  424.          Please join the experiment.
  425.  
  426.          If  you  believe  in  these  ideals,   your  contribution  is 
  427.          solicited to help make them work.
  428.  
  429.  
  430.  
  431.          =============================================================
  432.          SGAMENU Users Guide                                    Page 7
  433.          =============================================================
  434.  
  435.        -----------------------------------------------------------------
  436.                  R E G I S T R A T I O N / O R D E R   F O R M
  437.        -----------------------------------------------------------------
  438.  
  439.        If you have received this program from a User's Group or a friend
  440.        and  would  like  to  be  put  on a mailing list so that you will 
  441.        receive information on upcoming  releases and notification of new
  442.        products, please fill in your name and address below and send
  443.        along with your contribution ($10 suggested) to:
  444.  
  445.                            Steve Glass & Associates
  446.                                  1206 Century
  447.                                Odessa, TX 79762
  448.  
  449.  
  450.        Name ___________________________________________________________
  451.  
  452.        Address ________________________________________________________
  453.  
  454.        ________________________________________________________________
  455.  
  456.        City _________________________ State _________ Zip Code ________
  457.  
  458.        Description of Computer System _________________________________
  459.  
  460.        ________________________________________________________________
  461.  
  462.                                                           ** via-acm **
  463.  
  464.        I  would  also  appreciate  any  input  you  would  care  to give
  465.        concerning the program  and/or  it's documentation.  If you  have
  466.        any ideas or comments that would make it a better  program please
  467.        let me know.  Is the dosumentation  clear  enough?  Are  you ever
  468.        confused as to what to do next at any point in the program?
  469.  
  470.  
  471.        ____________________________________________________________________
  472.  
  473.        ____________________________________________________________________
  474.  
  475.        ____________________________________________________________________
  476.  
  477.        ____________________________________________________________________
  478.  
  479.        ____________________________________________________________________
  480.  
  481.        ____________________________________________________________________
  482.  
  483.        ____________________________________________________________________
  484.  
  485.        ____________________________________________________________________
  486.  
  487.        ____________________________________________________________________
  488.  
  489.  
  490.