














 ----------------------------------------------------------------------------------
 |                                                                                | 
 |                                                                                |
 |                                  E  N  T  R  Y                                 |
 |                                                                                |
 |                                                                                |
 |              DESCRIPTION ==> __A_FULL_SCREEN_DATA_ENTRY_SYSTEM___              |
 |                              ____________________________________              |
 |                              _ALLOWS_USERS_TO_ENTER_DATA_ONTO_A__              |
 |                              _____SCREEN_OF_THEIR_OWN_DESIGN_____              |
 |                                                                                |
 |                                                                                |
 |              FEATURES =====> INPUTS,_________    SEARCHES,_______              |
 |                              CHANGES,________    ERROR_CHECKING,_              |
 |                              DELETIONS,______    AND_PRINTING_OF_              |
 |                              BROWSING,_______    SCREENS.________              |
 |                                                                                |
 |                                                                                |
 |              FOR USE ON ===> VT100_FAMILY_TERMINALS                            |
 |                                                                                |
 |                                                                                |
 |              AUTHOR =======> R._DAVID_BARSKY_______                            |
 |                                                                                |
 |                                                                                |
 | LOC:    1 INP:    0 CHA:    0 DEL:    0                                        |
 ----------------------------------------------------------------------------------


CONTENTS *********************************************************************










              TOPICS               PAGE


INTRODUCTION .....................  1

DISTRIBUTION KIT .................  2

UNDERSCORE OPTIONS ...............  2

MODES ............................  3

KEYPAD MODES - APPLICATION .......  4

KEYPAD MODES - NUMERIC ...........  5

ENTERING COMMANDS ................  5

INPUTTING RECORDS ................  5

COMMANDS .........................  6 - 7

THE SCREEN .......................  8

CREATING A SCREEN ................  9

ERROR CHECKING ...................  10 - 14

FILES ............................  15

STARTING AND FINISHING ENTRY .....  16

IOENTRY FILE CONVERSION PROGRAM ..  17


INTRODUCTION ********************************************************* Page 1




ENTRY is a Full Screen Data Entry System which allows the user to enter data 
onto a screen of his/her own design.  Data records can be inputted, changed,
deleted (and undeleted), browsed through, searched for, and printed.
ENTRY is modeled after KED/EDT with similar keypad functions and HELP screen. 
The numeric keypad can be used in both Application AND Numeric keypad modes
ENTRY is written to be run on a VT100 family terminal running under RSX-11M.

This is a preliminary version of ENTRY.  It has been written in both 
FORTRAN-77 (V4.0-2) and MACRO-11 and tested under RSX-11M (V3.2).  It should
run under later versions and may run under VMS.  ENTRY does not require
any FPU instructions.  Unsolicited AST support is required.  Subsequent
releases of ENTRY will contain numerous performance and operational 
improvements/additions.





DISTRIBUTION KIT ***************************************************** Page 2




This Distribution includes:

         README.1ST
         ENTRY.TXT             Description of program operation and use
         ENTRY.HLP             Help file used by program (Put into LB:[1,2])
         ENTRY.CMD             Compile/assemble/taskbuild command file
         SAMPLE.SCR            Sample Screen file
         *.FTN,*.MAC           ENTRY sources
         *.CMN,*.DAT           F77 Includes to *.FTN
         *.OBJ                 F77 (V4) and MAC object modules
         ENTRY.TSK             Non-FPU, non-overlaid, non-FCSRES Task Image.
         IOENTRY.FTN,OBJ,TSK   UNformatted <---> Formatted file conversion
                               program.


To Generate ENTRY:   @ENTRY    Answer question accordingly.


R. DAVID BARSKY
U. C. L. A. 
SCHOOL OF PUBLIC HEALTH 
CENTER FOR THE HEALTH SCIENCES, ROOM 71-245
LOS ANGELES, CALIFORNIA  90024
TEL (213) 825-9284






UNDERSCORE DISPLAY OPTIONS **************************************************


Two underscore display options are available for the screen display at 
compile/taskbuild time:

(1) The underscores can appear EXACTLY as they appear in the screen file:
         __________________________________________________

(2) The underscores can appear as a SOLID LINE produced by setting the VT100
    'UNDERSCORE ON' screen attribute.  List this file on a VT100 family
    terminal to see the following line with this attribute:
         [4m                                                  [0m


MODES **************************************************************** Page 3




ENTRY operates in 3 modes.  To enter any of the modes you type the name of
the mode in response to the 'ENTER MODE:' prompt when you first start ENTRY.
Here is a list of the three modes and when they are to be used:

(1) ENTER:  This mode is good for inputting new records.  Only records 
            that are inputted during a current ENTRY session are access-
            ible.  Upon exit the new records are appended to the end of
            the OUTPUT file.

(2) MODIFY: This mode is good for changing, deleting, and viewing existing
            records in addition to inputting new records.  ENTRY initially
            copies the existing records from the OUTPUT file into the
            SCRATCH file and upon exit copies the SCRATCH file over the
            records of the OUTPUT file.  These transfers of records can be
            time consuming.  Therefore, MODIFY mode should only be used if
            you will be working with existing records.

(3) CHECK:  This mode is used to alter the error checking parameters of the
            attribute file.  See the section on error checking.




KEYPAD MODES - APPLICATION ******************************************* Page 4




The numeric keypad on the right side of the VT100 keyboard can operate in 2
keypad modes, APPlication and NUMeric.

APPlication keypad mode uses the numeric keypad keys as function keys.
This is the default keypad mode.  (Function keys automatically issue
complete commands - thereby saving the user the drudgery of typing in
each command whenever he/she wants to do something.)

This is a diagram of the Keypad functions in APPlication mode:

            -----------------------------------------------
            |           |           | FINDNEXT |  DELETE  | 
            |   GOLD    |    HELP   |          |          | 
            |        PF1|        PF2|  FIND PF3| UNDELETE | 
            -----------------------------------------------   
            |  MOVE 10  |   MOVE 1  |  CHANGE  |  RESHOW  | 
            |           |           |          |  SCREEN  | 
            |  COMMAND 7|          8|         9|         -| 
            ----------------------------------------------- 
            |   ADVANCE |   BACKUP  |  CLEAR   |  SWITCH  | 
            |           |           |  SCREEN  |  SCREENS |
            |   BOTTOM 4|    TOP   5|         6|         ,|
            -----------------------------------------------
            |   NEXT    |   LAST    |  PRINT   |          | 
            |   FIELD   |   FIELD   |  SCREEN  |          | 
            |          1|          2|         3|  INPUT - |
            -----------------------------------|  DO NOT  |
            |      FIRST FIELD      |   TOP    |  CLEAR   |
            |      OF NEXT LINE     |  FIELD   |          |
            |                      0|         .|     ENTER|
            -----------------------------------------------


Other keys available (in both keypad modes) are:
 
ARROW KEYS: Moves the cursor anywhere on the screen (except row 24)

TAB KEY:    Moves the cursor to the next field (Same as the '1' key on
            the numeric keypad in APPlication keypad mode.)

BACKSPACE:  Moves the cursor backwards one space within an data entry field.
            It will not work in any protected areas.

DELETE:     Deletes the previous character in a data entry field.

CNTRL/C:    Stops a FIND/FIND NEXT operation in progress.  (See commands.)

RETURN:     Inputs a new record and clears the screen.



KEYPAD MODES - NUMERIC *********************************************** Page 5




NUMeric keypad mode uses the numeric keypad keys as they are marked.
When this mode is used the commands must be typed in rather than being
sent from the numeric keypad as in APPlication keypad mode.  The 
keypad in numeric mode can be used for high-volume NUMERIC data entry.
While in numeric mode the only function keys that operate are the four
function keys (PF1 - PF4) above the numeric keypad.  Here is a list of
their functions in NUMeric keypad mode:

PF1:  Command input
PF2:  Switch screens 
PF3:  Enter data, don't clear screen 
PF4:  Clear screen
  
Note that the four function keys (PF1 - PF4) are different in NUMeric keypad 
mode than in APPlication keypad mode.






ENTERING COMMANDS ************************************************************

Many commands can be entered.  To enter commands type:

   In APplications mode:  Gold-7 (PF1-'7')
   IN NUmeric      mode:  Gold   (PF1)

Then enter the command and terminate with the 'RETURN' key (Not the ENTER key)






INPUTTING RECORDS ************************************************************

There are 2 ways to enter records -
 
(1) Enter, clear screen:    In APplication keypad mode use the RETURN key.
                            In NUmeric keypad mode use the RETURN and
                            ENTER keys.  The location counter at the bottom
                            of the screen will be updated to point after the
                            last record entered.  This is where the next 
                            record entered will be placed.

(2) Enter,                  In APplication keypad mode use the ENTER key.
    do not clear screen:    In NUmeric keypad mode use PF3.  The location
                            counter at the bottom of the screen will be
                            updated to point at the last record entered.





COMMANDS ************************************************************* Page 6




This is an alphabetized list of the commands followed by their function key
in APPlications keypad mode.  All commands must be typed at the BEGINNING of 
the command entry field and be the same case.  Only the first 2 letters of
each command is required.


ADvance  Sets the direction for Move 1, Move 10, and searches to be in the
'4'      forward direction.

APp:     Puts the numeric keypad into application keypad mode for using
         keypad functions keys.

BAckup   Sets the direction for Move 1, Move 10, and searches to be in the
'5'      backwards direction.

BOttom   Displays the last record in the file. (Updates the location counter.)
Gold-'4'
 
CHange   After typing changes onto a displayed record this key will enter the
'9'      change.  (Updates the change counter.)  

CLear    Clears the screen of data displayed in the unprotected fields.
'6'

DElete   Deletes the record displayed.  (Updates the delete counter.)
'PF4'    (The REshow key/command will re-display the record before it was
         deleted.  It is STILL deleted though.)

EXit:    ENTER  mode:
           (1) Existing file: Records are appended to the end of the OUTPUT
                              file.
           (2) New file:      Records are written to the OUTPUT file for the
                              first time.
         MODIFY mode:         Records are written over the existing OUTPUT
                              file.
         CHECK  mode:         Saves all checks.
                              
FInd     Clears the screen and waits for you to type in search characters.
Gold-    The search characters MUST be in the EXACT position as they are in
'PF3'    the file.  The first 24 characters are used for the search.  They
         do not have to be contiguous.  After typing the search characters,
         either the ADVANCE (forward search) or BACKUP (backwards search)
         key/command must be hit/entered to initiate the search.  This is
         identical to the search method used in KED/EDT.
 
FNext    Find Next.  Repeats a FInd in the direction of the last ADVANCE/
'PF3'    BACKUP entered.

HElp     Displays the help listing.  There are two screens to HELP.  Typing
'PF2'    'C' while in HELP will display the alternate screen.  Typing any
         other character will redisplay the screen before HElp was typed.

NUm:     Puts the keypad into numeric keypad mode for typing in numeric data.


COMMANDS CONTINUED *************************************************** Page 7



 
PRint    Puts the screen displayed into a file named 'SY:alphanum.PRT' to be 
'3'      printed upon termination of ENTRY.  The file may or may not be 
         deleted upon exit/quit depending upon system options.
 
QUit:    Stops the program and does not save anything in ENTER or MODIFY
         modes.  In CHECK mode all checks are saved.

REshow   Re-displays the record prior to any alterations.
'-'

TOp      Displays the first record in the file. (Updates the location
'5'      counter.)

UNdelete Undeletes the record at a deleted location.  (Updates the delete
Gold-    counter.)
'PF4'

1        Move over 1 record.  Displays the next or previous record in the
'8'      file. (Depending on the current direction - ADvance or BAckup.)
         (Updates the location counter.)

10       Moves over 10 records.  (Depending on the current direction -
'7'      ADvance or BAckup.)  (Updates the location counter.)


THE SCREEN *********************************************************** Page 8




This is what a typical ENTRY screen looks like:


----------------------------------------------------------------------------------
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|         NAME ===============> ______________________________                   |
|                                                                                |
|         TITLE ==============> ______________________________                   |
|                                                                                |
|         COMPANY ============> ______________________________                   |
|                                                                                |
|         ADDRESS ============> ______________________________                   |
|                                                                                |
|         CITY, STATE, ZIP ===> ______________________________  __  _____        |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
| LOC:   27 INP:    5 CHA:    3 DEL:    1                                        |
----------------------------------------------------------------------------------

At the bottom of the screen display are four counters:

(1)  LOC:  This is the current location in the file.
(2)  INP:  This show how many records have been inputted.
(3)  CHA:  This show how many records have been changed.
(4)  DEL:  This show how many records have been deleted.


CREATING A SCREEN **************************************************** Page 9




Creating a screen to be used by ENTRY is very simple.  Using an editor
(KED/EDT) you type in the screen exactly as you want it to look.  The
screen will be displayed in 80 column mode by ENTRY.  Just follow these
rules when creating a screen:

(1)  Data entry fields are created by typing in underbars.  The underbar is
     considered a 'reserved character'.  Data fields are unprotected and 
     non-highlighted.  All other portions of the screen are protected and
     text is highlighted.
(2)  The maximum number of underbars allowed (data entry characters) is 510.
(3)  The maximum number of rows per screen is 23.  (Rows    1-23)
(4)  The maximum number of columns per row is 80.  (Columns 1-80)
(5)  Leave a blank in column 1.
(6)  A blank must be the last character of each line, otherwise the screen
     may not appear correct when in ENTRY.  If a line is to be totally blank 
     there must be at least 2 blanks in that line.
(7)  A maximum of 2 screens is allowed. If there are 2 screens, type an
     uppercase 'S' in column 1 AFTER the last row of the the FIRST screen.
(8)  The screen file's name MUST be on the user's default disk (SY:), in the
     user's UIC, and the second qualifier MUST be 'SCR'.  If it isn't, the 
     file name will not be recognized.


This is a listing of a SCREEN file for 2 screens:  Note the uppercase 'S' in 
column 1 to signal the beginning of the second screen.
 
 
 PAGE 1 
 
         NAME ===============> ______________________________ 
 
         TITLE ==============> ______________________________ 
 
         COMPANY ============> ______________________________ 
 
         ADDRESS ============> ______________________________ 
 
         CITY, STATE, ZIP ===> __________________________  __  _____ 
 
S
 
 
 PAGE 2 
 
         PERSONAL INFORMATION: _____________________________________ 
                               _____________________________________ 
                               _____________________________________ 
                               _____________________________________ 
 
 
         TELEPHONE NUMBERS:    H: (___) ___-____   W: (___) ___-____ 




ERROR CHECKING ******************************************************* Page 10




ENTRY can do the following 5 error checks on each field whenever you attempt 
to enter a new record or change an existing record:  (1) numeric only,
(2) required, (3) filled, and numeric (4) minimums and (5) maximums.
  
A file 'alphanum.ATR' saves all error checking attributes.  If this file 
does not exist you will get the message:  

                        ...ent  --  error 29
                        fcs: -26, 0 1 alphanum.ATR

This means that there is no attribute file which contains the error checks.
After this message appears, the file is created.  The file initially 
contains 5 empty records.  As long as the records in this file are empty 
no error checking will be done.
  
If you want error checking then the attribute file must be changed while in
'CHECK' mode:  To enter this mode do the following:

In response to the 'ENTER MODE:' prompt, type 'CHECK' instead of MODIFY 
or ENTER.  The first of the 5 empty records will appear on the screen. 
To change these records do the following and then hit the 'change' key
(keypad '9').  (You will not be allowed to use the RETURN and ENTER keys
because you are not allowed to add any more records to the 5 existing
records of the attribute file, therefore, only the change key will work on
these records.)

How to set up the checks:

Record #1: NUMERIC checks:  Flag numeric only fields (0-9 or blanks allowed)
by typing an uppercase 'N' in the 1st column of each numeric only field.
For example - dates, zip codes, and social-security numbers would be coded
numeric only.

Record #2: REQUIRE checks:  Flag required fields by typing an uppercase 'R'
in the 1st column of each required field.  For example - a person's name in
an address file would be a required field.

Record #3: FILL    checks:  Flag fields that must be completely filled by
typing an uppercase 'F' in the 1st column of each filled field.  If the
field is partially filled it will be flagged in error.  Totally empty fields
will be ignored.  For example - zip codes (5 columns) and social security
numbers (9 columns) would be coded only if totally filled.

Record #4: MINIMUM numeric value checks:  Type minimum numeric values onto
fields which have been flagged as numeric in record #1 above.  The minimum
must be between -32767 and +32767. 

Record #5: MAXIMUM numeric value checks:  Type maximum numeric values onto
fields which have been flagged as numeric in record #1 above.  The maximum
must be between -32767 and +32767. 

Notes: (1) The minimum and maximum can have the same value with one 
           exception - they cannot both be zero.
       (2) A maximum of 200 data entry fields can be checked.


ERROR CHECKING CONTINUED ********************************************* Page 11




A listing of the five records of the attribute file follow on the next few
pages:

Record #1 specifies that 4 fields are to be numeric only: the (1) zip code
and the telephone number (2) area code, (3) prefix, and (4) suffix.

Record #2 specifies that 4 fields are to be required: the (1) name, 
(2) address, (3) city, and (4) state.

Record #3 specifies that 5 fields are to be filled: the (1) state,
(2) zip code and the telephone number (3) area code, (4) prefix, and
(5) suffix.

Record #4 specifies 3 minimum numeric values for: the telephone number
(1) area code (001), (2) prefix (001), and (3) suffix (0001).  Notice that
these fields were specified as numeric in record #1.

Record #5 specifies 3 maximum numeric values for: the telephone number
(1) area code (999), (2) prefix (999), and (3) suffix (9999).  Notice that
these fields were specified as numeric in record #1.


In summary:

NAME         Required.
ADDRESS      Required.
CITY         Required.
STATE        Required and filled.
ZIP          Numeric  and filled.
TELEPHONE 
  AREA CODE  Numeric, filled, minimum of '1', maximum of '999'.
  PREFIX     Numeric, filled, minimum of '1', maximum of '999'.
  SUFFIX     Numeric, filled, minimum of '1', maximum of '9999'.


ERROR CHECKING CONTINUED ********************************************* Page 12




 Record #1 (ATTRIBUTE FILE - NUMERIC FIELDS)
 ----------------------------------------------------------------------------------
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                          A D D R E S S    F I L E                              |
 |                                                                                |
 |                                                                                |
 |         NAME ===============> ______________________________                   |
 |                                                                                |
 |         ADDRESS ============> ______________________________                   |
 |                                                                                |
 |         CITY, STATE, ZIP ===> ______________________________  __  N____        |
 |                                                                                |
 |         TELEPHONE NUMBER ===> (N__) N__-N___                                   |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 | LOC:    1 INP:    0 CHA:    0 DEL:    0                                        |
-----------------------------------------------------------------------------------




 Record #2 (ATTRIBUTE FILE - REQUIRED FIELDS)
 ----------------------------------------------------------------------------------
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                          A D D R E S S    F I L E                              |
 |                                                                                |
 |                                                                                |
 |         NAME ===============> R_____________________________                   |
 |                                                                                |
 |         ADDRESS ============> R_____________________________                   |
 |                                                                                |
 |         CITY, STATE, ZIP ===> R_____________________________  R_  _____        |
 |                                                                                |
 |         TELEPHONE NUMBER ===> (___) ___-____                                   |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 | LOC:    2 INP:    0 CHA:    0 DEL:    0                                        |
 ----------------------------------------------------------------------------------


ERROR CHECKING CONTINUED ********************************************* Page 13




 Record #3 (ATTRIBUTE FILE - FILLED FIELDS)
 ----------------------------------------------------------------------------------
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                          A D D R E S S    F I L E                              |
 |                                                                                |
 |                                                                                |
 |         NAME ===============> ______________________________                   |
 |                                                                                |
 |         ADDRESS ============> ______________________________                   |
 |                                                                                |
 |         CITY, STATE, ZIP ===> ______________________________  F_  F____        |
 |                                                                                |
 |         TELEPHONE NUMBER ===> (F__) F__-F___                                   |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 | LOC:    3 INP:    0 CHA:    0 DEL:    0                                        |
 ----------------------------------------------------------------------------------




 Record #4 (ATTRIBUTE FILE - NUMERIC MINIMUMS)
 ----------------------------------------------------------------------------------
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                          A D D R E S S    F I L E                              |
 |                                                                                |
 |                                                                                |
 |         NAME ===============> ______________________________                   |
 |                                                                                |
 |         ADDRESS ============> ______________________________                   |
 |                                                                                |
 |         CITY, STATE, ZIP ===> ______________________________  __  _____        |
 |                                                                                |
 |         TELEPHONE NUMBER ===> (001) 001-0001                                   |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 | LOC:    4 INP:    0 CHA:    0 DEL:    0                                        |
 ----------------------------------------------------------------------------------


ERROR CHECKING CONTINUED ********************************************* Page 14




 Record #5 (ATTRIBUTE FILE - NUMERIC MAXIMUMS)
 ----------------------------------------------------------------------------------
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                          A D D R E S S    F I L E                              |
 |                                                                                |
 |                                                                                |
 |         NAME ===============> ______________________________                   |
 |                                                                                |
 |         ADDRESS ============> ______________________________                   |
 |                                                                                |
 |         CITY, STATE, ZIP ===> ______________________________  __  _____        |
 |                                                                                |
 |         TELEPHONE NUMBER ===> (999) 999-9999                                   |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 |                                                                                |
 | LOC:    5 INP:    0 CHA:    0 DEL:    0                                        |
 ----------------------------------------------------------------------------------



FILES **************************************************************** Page 15




ENTRY uses several files.  A description of each file follows:


OUTPUT FILE:  (SY:alphanum.OUT - Created by ENTRY) 

This file contains all data records when you exit ENTRY.  All characters
typed onto the unprotected areas of the screen display are concatenated
into a continuous stream in each record of this file.  The file is 
UNformatted.  The records are accessible from user written programs and
RSORT.  They can also be accessed indirectly by KED/EDT.  To do this the 
records should first be rewritten into a formatted file for the editor 
to use.  After editing this formatted file the records should be rewritten 
into an UNformatted file for ENTRY to use.  The task 'IOENTRY' is provided
to accomplish this.  (See the section on IOENTRY.)


SCREEN FILE:  (SY:alphanum.SCR - Created by the user)

This file contains the screen layout.  ENTRY reads this file to obtain the
screen display.  The user creates it with an editor.


ATTRIBUTE FILE:  (SY:alphanum.ATR - Created by ENTRY)

This file contains the 5 error checking parameters: (1) numeric, 
(2) required, (3) filled, (4) numeric minimums, and (5) numeric maximums.
It is initially created by ENTRY without any error checking parameters.
The user adds the error checks while using ENTRY in CHECK mode.


SCRATCH FILE:   (SY:FOR001.DAT - Created by ENTRY)

This file contains all data records accessible during an ENTRY session.
The user works with this file, never with the original OUTPUT FILE.  In
ENTER mode all new records are entered into this file.  Upon exit the
records are appended to the end of the OUTPUT FILE and this scratch file is
deleted.  In MODIFY mode the existing records in the OUTPUT FILE are first
copied into this SCRATCH FILE and are accessible during the ENTRY session.  
Upon exit the records are written over the original output file and this
scratch file is deleted.


PRINT FILE:     (SY:alphanum.PRT - Created by ENTRY)

This file contains a picture of each screen viewed when a print command
is issued.  Messages on the right side of the 24th row are not printed.
This file is immediately spooled upon exiting ENTRY.  The user must delete
it if the operating system does not delete it after spooling.


STARTING AND FINISHING ENTRY ***************************************** Page 16




To begin using ENTRY you must first create a data entry screen with the
editor, otherwise ENTRY will not know where to find a screen.  Create the
screen in the SCREEN FILE.

To start an ENTRY session type 'ENTRY'.  This command activates the ENTRY
system.  (This assumes that ENTRY has been installed as '...ENT'.)

When you start ENTRY there will be 2 prompts:

(1) 'ENTER FILE NAME:'  Respond by typing only the first qualifier of the
                        SCREEN file name.  For example, if the SCREEN file
                        name is 'SAMPLE.SCR' type in 'SAMPLE'.
(2) 'ENTER MODE:'       Respond by typing either 'ENTER' or 'MODIFY' or 
                        'CHECK'.  If using ENTRY for the first time on a 
                        file, the mode cannot be MODIFY because the OUTPUT
                        file does not exist at this time.

While using ENTRY type in all data onto the data entry fields.  If you move
the cursor away from these fields (using the cursor movement keys) and try
to type in a protected field the bell will ring.  The bell will also ring
if you try to backspace or delete prior to the beginning of a field.  If the
computer is running slowly the bell might ring simply because the computer
cannot keep up with you.  If this happens, slow down.  When you have typed
in a complete record, enter it with an input command.  If you want to
change a record, locate it by moving from record to record with the 'Move 1',
'Move 10', or with the Find command.  See the section on commands to try out
the other capabilities of ENTRY.  Any inputs or changes will be checked for 
errors according to the setup of the attribute file.

Leave ENTRY with either the 'QUIT' or the 'EXIT' command.  These two
commands do not have any function key assigned to them, therefore, they
must be typed in by using the COMMAND function (Gold-'7' in APplication
keypad mode, Gold in NUmeric mode.)



IOENTRY FILE CONVERSION PROGRAM ************************************** Page 17




IOENTRY is a program which will convert the UNformatted OUTPUT file to a
Formatted file.  This is necessary if you want to use KED/EDT on the file.
IOENTRY will reconvert this Formatted KED/EDT file back to UNformatted, thus 
enabling ENTRY to access the file correctly.  A new version of the OUTPUT 
file is created in the process.

The Formatted file will have a blank in column 1.  This is the FORTRAN 
carriage control.  Leave it there.  Remember, if the Formatted file is 
to be reconverted to UNformatted the length of each record must not change.

To run IOENTRY type 'IOENTRY'.  (This assumes that IOENTRY has been
installed as '...IOE'.)

When you start IOENTRY there will be 2 prompts:

(1) 'ENTER FILE NAME:'  Respond by typing only the first qualifier of the
                        SCREEN file name.  For example, if the SCREEN file
                        name is 'SAMPLE.SCR' type in 'SAMPLE'.  There MUST
                        be a SCREEN file for IOENTRY to use.

(2) 'INPUT FILE =>    Unformatted (ENTRY)   file  [U]     Respond by typing
                   or Formatted   (KED/EDT) file? [F]:'   'U' if the file
                                                          is the UNformatted
                                                          ENTRY OUTPUT file
                                                          or 'F' if it is 
                                                          the Formatted file.

The flashing message 'WORKING' will signal that the records are being
converted.




To compile and taskbuild IOENTRY:

F77 IOENTRY=IOENTRY/NOF77/NOTR

TKB
TKB>IOENTRY/FP=IOENTRY,SCRINI,UVT100,...
/
MAXBUF=512
//



