LOCALEDITS

Used to stipulate edits to be done within the terminal.

Syntax

LOCALEDITS {edit1,edit2,...editn}

Parameters

edit: Table 4-2 “Local Edit Terminal Menu Selection” lists available local edits along with their meanings. Refer to Table 4-1 “Summary of Processing Statements” for valid local edit combinations. For example, you can specify alphanumeric, required, decimal type, and number of digits to the right of the decimal together. You cannot specify alphanumeric and upshift together.

Discussion

This command allows you to specify local edits that are performed as keys are pressed by the user entering data into the form. At run-time, VPLUS checks the terminal type and, if the terminal supports local edits, loads the specified local edits to the terminal. If the terminal does not support local edits, VPLUS ignores them.

The last three decimal edits in Table 4-2 “Local Edit Terminal Menu Selection” alter the mode of the terminal; therefore, the last field for which a decimal edit is specified that is displayed on the terminal alters the way the terminal processes all fields until the terminal mode is changed by another screen containing a decimal edit. All other local edit specifications affect only the field for which they are specified.

When an invalid key is pressed, the terminal beeps, and an error message issued by the terminal (not by VPLUS) is displayed. Press RETURN to clear, then reenter data into the field.

If you specify local edits with a form family, the local edits associated with the first displayed form in the family are retained as subsequent family members are displayed (in other words, it is not possible to change local edit specifications among family members at run-time).

VPLUS "edit" processing specifications and "terminal" edit processing statements are separate and are not checked for compatibility. There will be no check to see that the designer has specified a terminal local edit (DEC_TYPE_EUR,DEC_TYPE_US) in the configuration phase which is consistent with the language-dependent decimal indicator for the native language specified in the forms file. For more information on Native Language Support, see Section 8.

Table 4-1 Summary of Processing Statements

Local Edit	Description
`ALPHABETIC`	Upper and lowercase alphabetic, space, period, hyphen
`ALPHANUMERIC`	Upper and lowercase alphabetic, digits, space, period, minus sign, plus sign, comma.
`CONSTANT`	No characters may be entered from the keyboard,
`IMP_DEC`	Implied decimal (the number of digits to the right of the decimal is governed by the last `DEC_DIGITS` command in the form).
`IMP_DEC_FILL`	Implied decimal, right justified and zero filled (the number of digits to the right of the decimal is governed by the last `DEC_DIGITS` command).
`INTEGER`	Digits and spaces.
`INTEGER_FILL`	Digits and spaces, right justified and zero filled.
`SIGN_DEC`	Signed decimal.
`SIGN_DEC_FILL`	Signed decimal, right justified and zero filled.
`TRANSMIT_ONLY`	No data may be entered unless the cursor control keys are used to access the field.
`UNRESTRICTED`	Any character.
`UPSHIFT`	Lowercase alphabetic changed to uppercase when entered.
`JUSTIFY`	right justify numeric types; left justify character types.
`MUST_FILL`	The field must be blank or filled entirely.
`REQUIRED`	The field must have an entry when ENTER is pressed.
`DEC_TYPE_EUR`	European number format.
`DEC_TYPE_US`	United States number format.
`DEC_DIGITS` `n`	Specifies number of digits to right of decimal point.

Here is a table showing the local edit terminal menu selection and associated VPLUS local edits.

Table 4-2 Local Edit Terminal Menu Selection

Local Edit	Terminal Menu Selection	Justify is used
`UNRESTRICTED`	0. `ALL CHARACTERS`	Left Justify
`ALPHABETIC`	1. `ALPHABETIC`	Left Justify
`UPSHIFT`	2. `AUTO UPSHIFT`	Left Justify
`ALPHANUMERIC`	3. `ALPHANUMERIC`	Left Justify
`INTEGER`	4. `INTEGER`	right justify
`SIGN_DEC`	5. `SIGNED DECIMAL`	right justify
`IMP_DEC`	6. `IMPLIED DECIMAL`	Ignore
`CONSTANT`	7. `CONSTANT`	Ignore
`INTEGER_FILL`	8. `INTEGER/FILL`	Ignore
`SIGN DEC FILL`	9. `SIGNED DECIMAL/FILL`	Ignore
`IMP_DEC_FILL`	10. `IMPLIED DECIMAL/FILL`	Ignore

Table 4-3 Local Edit Terminal Menu Selection with Defaults

Local Edit	Terminal Menu Selection	Default
`REQUIRED`	`REQUIRED`	`OPTIONAL`
`JUSTIFY`	`JUSTIFY`	`NO JUSTIFY`
`MUST_FILL`	`TOTAL FILL`	`NO TOTAL FILL`

For each field, the user may select one edit from Table 4-2 “Local Edit Terminal Menu Selection” and any combination of edits from Table 4-3 “Local Edit Terminal Menu Selection with Defaults” according to the following guidelines:

If no selection is made from Table 4-2 “Local Edit Terminal Menu Selection”, the default edit of UNRESTRICTED is used.
The CONSTANT and REQUIRED edits are incompatible, since the required data cannot be entered in the CONSTANT field.
The terminal executes all edits implied by field type before it checks for TOTAL_FILL. The MUST_FILL edit is always met by INTEGER_FILL,SIGN_DEC_FILL, and IMP_DEC_ FILL.
The effect of the JUSTIFY attribute on each of the field types is shown in Table 4-2 “Local Edit Terminal Menu Selection”

Table 4-4 Local Edit Terminal Menu Items

Local Edit	Terminal Menu Item	Menu Selection
`DEC_DIGITS` `n`	Implied Dec digits	0-9
`DEC_TYPE_EUR`	Decimal Type	EUR
`DEC_TYPE_US`	Decimal Type	US

Along with the selections from Table 4-2 “Local Edit Terminal Menu Selection” and Table 4-3 “Local Edit Terminal Menu Selection with Defaults” you may specify the number of decimal digits (DEC_DIGITS n) and select a decimal format (DEC_TYPE_US or DEC_TYPE_EUR). (Note that the DEC_DIGITS n setting may only be used with IMP_DEC or IMP_DEC_FILL edits.) Unlike other edits, DEC_DIGITS and DEC_TYPE edits are global terminal configurations that remain in effect until they are reset by another DEC_TYPE or DEC_DIGIT edit. Please note that VOPENTERM and VCLOSETERM do not reconfigure DEC_DIGIT and DEC_TYPE; these settings may carry over from one application to the next.

Example

                  ***Processing Specifications***
 
CONFIG                                \No characters may be entered
LOCALEDITS CONSTANT                   \from the keyboard.
CONFIG                                \Entered data must be in United States
LOCALEDITS DEC_TYPE_US,REQUIRED       \number format; the field must contain
                                     \data when ENTER is pressed.

LOCALEDITS

Technical documentation

» Table of Contents

» Index

Syntax

Parameters

Discussion

Example