---------------------------------------------------------------------------------- | | | | | 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:   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 //