(C) Copyright 1985-1996 Modular Software Corporation. All rights reserved. Version 2.0 for AP - February 14, 1996
Goto: Table of Contents Index Chapter: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
ENTER {DICT} filename {USING scr.name} {attribute list} {option}
The ENTER function is designed to act in a manner very similar to the system LIST function although some of the attribute modifiers are slightly different. An example of the ENTER function would be:
ENTER CUSTOMERS NAME ADDR1 ADDR2 CITY ST ZIP DISPLAY STATUS
This sentence will create a data entry screen which will be used to enter 6 attributes into the CUSTOMERS file and also display the data in the attribute defined as 'STATUS'.
The maximum number of attributes that may be entered with the ENTER function is 22 for a 24 line high screen or window and additional attributes will be ignored. If no attributes are specified, the ENTER function will use the default attributes 1, 2, 3, etc.
The ENTER function does not support data entry with multi-valued fields or other dictionary definitions that have correlatives defined. The ENTER function also assumes that the dictionary conversion operates correctly for both INPUT and OUTPUT conversions. Normally, only data display conversions such as MD2, D2/ and MTS are utilized.
The ENTER function will use the dictionary entry FV-ID to determine the length of the ITEM-ID field. If there is no FV-ID field, a default length of 20 will be provided. The heading field of FV-ID is also used as the label for the ENTER verb function.
If the ENTER function is used with a file for which BTREE indexes have been established, the FV.LOOKUP( ) function is automatically used from within the ENTER function and the key files will be properly maintained.
The ENTER function may also be used in conjunction with pre-defined data entry screens created using the ENTER-SCR painter. In this case, it is possible to utilize limited multi-valued fields and more complicated correlatives and conversions. In order to use this ENTER option, first create a screen using the ENTER-SCR Screen Painter with attribute zero representing the ITEM-ID as a DISPLAY only field. Then paint in any other data elements, arranging them anywhere on the screen. The screen may then be used by the ENTER function by typing:
ENTER file.name USING scr.name
The ENTER-SCR Screen Painter is discussed in detail in the following chapter.
The ENTER function may also be used with the BTREE automatic sequential ITEM-ID assignment function. If the FV-ID dictionary entry contains a valid conversion in attribute 11 which defines auto ID assignment, then the ENTER function will take advantage of this. To use this function, simply leave all fields of the lookup screen blank and the ENTER function will automatically generate an ITEM-ID when the item is filed.
ENTER also has several command-word options which may be specified. These are:
Goto: Table of Contents Index Chapter: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15