
                                     HC2ENTRY.TXT
                HEC2 ENTRY, Shareware Version 1.04, November 25, 1987
        
        The purpose  of this program is to allow an input file for HEC-2 to be
        quickly created without constant reference to the manual.  The program
        prompts for  required information, and most optional information, with
        some error-checking  capabilities such  as data  field length and data
        type (alphanumeric,  integer, real  number, etc.).   Also, some cross-
        checking of  HEC-2 variables  vs. prompting  for related data in later
        entries takes  place.   Editing data entered at the prompts is limited
        to the  backspace key;  the cursor  keys and  delete key are disabled.
        The data  must be well organized, as no editing of previous entries is
        allowed, other  than the  current "card",  via  a  "Q"  command.    An
        exception to  that rule is the group of X1 thru GR cards, which allows
        restarting the entire cross section, because the GR routine checks for
        proper left bank and right bank locations as specified on the X1 card,
        and stations  on the  BT cards  versus the  GR cards.  The sequence of
        data entry pretty much follows Table 3 in the HEC-2 manual.
        
        This program  can't really  allow for  all HEC-2 options, as it is run
        with menus  and prompts,  and it  would be  pretty cumbersome  to wade
        through prompts  for data  that is  not required  most  of  the  time.
        However, it can still be used to create most of the input file, and be
        assured that  the fields  are formatted properly.  The current version
        does allow for fields within the J1 and J2 cards which reference other
        cards which  are not  supported, such  as the QT, ET, X5 and CI cards.
        Those cards  will have  to be created with your text editor.  The main
        function of  this version is to allow a simple multiple profile job to
        be run.   Options  will be  added to  future versions in the following
        order:   (1) those  I find a need for while using HEC-2, and (2) those
        that other users agree are desirable.
        
        If printed  output is desired, select the proper choice when prompted.
        Printed output  is formatted  for readability and not so you can check
        field lengths  and locations,  so don't  bother checking formatting on
        the printout.
        
        Following are some notes regarding input and limitations:
        
        1.   Aborting or restarting individual card routines:  A prompt at the
             top of  the screen  will tell you the effect of entering a "q" or
             "Q".   "Abort" means  the  program  will  abort  at  this  point,
             creating the  data file,  such as it is.  "Restart", which prompt
             will appear usually after you have started entering data within a
             particular card  routine, means  that the program will start that
             routine over.   "Back up" will be seen within the BT and GR entry
             routines, and  will allow  you to back up to the previous station
             to correct  an error.   Entering "Q" repeatedly will back you out
             of the routine and the program.
        
        2.   File name:   The file name may consist of alphanumeric characters
             only.   An extension  of ".DTA" is used.  The program will prompt
             before overwriting  a file.   Once you are past this point in the
             program, the file will be created, even if you abort the program,
             so be sure you want to overwrite an existing file before choosing
             yes.
        
        3.   Archival cards (AC):  Not supported at this time.
        
        4.   Comment cards  (C_):   Prompts for  the proper  number of comment
             cards based on user input for NUMCT.





        
        5.   Title cards  (T1-T3):   Prompts for  three title cards, including
             the stream  name as a separate prompt for T3.  Indents all titles
             by 6 spaces, consistent with examples in the manual.  If you want
             a blank title card, press "spacebar", "return".
        
        6.   Job Control cards
        
             a)   J1 card:   Prompts  for J1  card and  all variables.   Fully
                  supports all  HEC-2 options  except for  variable  STRT  for
                  number of rating curve pairs on JR card, which is limited to
                  5 maximum.
        
             b)   J2 card:   Prompts  for J2 card, which is optional for first
                  profile, but  requires J2  card if  more than  1 J1 card has
                  been created  (multiple profiles).   Only prompts for number
                  of profile  or if  last profile  if user does not request J2
                  card.   If user  requests J2  card,  then  prompts  for  all
                  variables with following limitations:
        
                  1)   "-" value for variable FN is not supported.
        
                  2)   Value 15 for variable ITRACE is not supported.
        
             c)   J3 card:   Only  prompts for  this card  after the  first J1
                  card.  Variable IVAR is limited to the codes for pre-defined
                  tables.
        
             d)   J4 card:  Not supported at this time.
        
             e)   J5 card:  The "summary printout only for all cross sections"
                  option is the only supported option if a J5 card is chosen.
        
             f)   J6 card:   Only  variable IHLEQ  (friction  loss  equations)
                  option is  supported.   The disk/tape output transfer is not
                  supported.
        
        7.   Change cards
        
             a)   Only the  NC card is supported at this time.  The NH, NV, QT
                  and ET  cards are  scheduled for partial support in a future
                  upgrade.
        
        8.   Cross section cards
        
             a)   The X1 card is fully supported except for the following:
        
                  1)   Negative SECNO (start new tributary backwater).
                  
                  2)   PXSECR and  PSXECE  factors,  to  change  stations  and
                       elevations.
                  
             b)   The CI  card is not supported, but is scheduled for a future
                  upgrade.
             
             c)   The X2  card is only partially supported in that QNEW, a new
                  river flow, may be added.  Other variables will be supported
                  in a future upgrade.
             
             d)   X3 cards are not supported, but partial support is scheduled
                  for a future upgrade.





             
             e)   The X4 card is not supported.
             
             f)   The X5  card is not supported, but is scheduled for a future
                  upgrade.
             
             g)   BT cards are supported with up to 100 stations.
             
             h)   GR cards are supported with up to 100 data pairs.
             
                                     MAIL SUPPORT
        
        I intend to respond in a timely fashion to all requests, comments, and
        questions from registered users.  I welcome comments from unregistered
        users also, as that is the only way I will know which enhancements the
        users prefer.   Unregistered  users may  or may  not get  a  response,
        however.   If you  are undecided  about registration  because  of  the
        limitations of  this version,  let me know, and if possible I will add
        the enhancements  you want and send you the upgraded shareware version
        for your  review.  I will request a $10 handling charge before sending
        it out,  however.   If any  registered users  uncover a  fatal bug  in
        HC2ENTRY, I  will send  a fixed  version free.   The  latest shareware
        version will always be available for $10.
        
                                 SYSTEM CONFIGURATION
        
        HC2ENTRY will  run on  any MS-DOS compatible machine with 256K RAM and
        DOS 2.11  or later.   It  will create  the data  file on the drive and
        subdirectory the  program is located within.  It will work from a hard
        disk or floppy drive.
        
                                     REGISTRATION
        
        This program  is shareware,  which means  you are  free  to  copy  and
        distribute it  as  described  within  the  beginning  screen  message.
        Sending a  contribution of  $35 to the author constitutes registration
        and will result in the following benefits to the user:
        
        1.   Receipt of  a diskette  with  the  latest  version  of  HC2ENTRY,
             without the shareware entrance screen.
        
        2.   Full support (by mail) of all questions regarding use of HC2ENTRY
             and HEC-2.  I am not and probably will never be a "power user" of
             HEC-2, but  in writing  and testing  this program  I have  become
             familiar with some of HEC-2's idiosyncrasies.
        
        3.   Placement on  a mailing  list for notification of availability of
             future enhanced versions, which will be available for $10.
        
        Please send contributions to: Richard Wadsworth
                                      320 Eureka Canyon Road
                                      Watsonville, CA 95076














         ----------------end-of-author's-documentation---------------

                        Software Library Information:

                   This disk copy provided as a service of

                        The Public (Software) Library

         We are not the authors of this program, nor are we associated
         with the author in any way other than as a distributor of the
         program in accordance with the author's terms of distribution.

         Please direct shareware payments and specific questions about
         this program to the author of the program, whose name appears
         elsewhere in  this documentation. If you have trouble getting
         in touch with the author,  we will do whatever we can to help
         you with your questions. All programs have been tested and do
         run.  To report problems,  please use the form that is in the
         file PROBLEM.DOC on many of our disks or in other written for-
         mat with screen printouts, if possible.  The P(s)L cannot de-
         bug programs over the telephone.

         Disks in the P(s)L are updated monthly, so if you did not get
         this disk  directly from the P(s)L,  you should be aware that
         the files in this set may no  longer be the current versions.

         For a copy of the latest monthly software library newsletter
         and a list of the 1,000+ disks in the library, call or write

                        The Public (Software) Library
                              P.O.Box 35705 - F
                           Houston, TX 77235-5705
                      (713) 721-6104 or (713) 721-5205

