HP 3000 Manuals HP 3000 Manuals
LOCALEDITS
Used to stipulate edits to be done within the terminal.
Syntax
LOCALEDITS {edit1,edit2,...editn}
Parameters
edit Table 4-2 lists available local edits along with their
meanings. Refer back to Table 4-1 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/V 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/V ignores them.
The last three decimal edits in Table 4-2 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/V) 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/V "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-2. Terminal Local Edits
--------------------------------------------------------------------------------------------
| | |
| 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/V local edits.
Table 4-3. Local Edits Corresponding to Field Type Selections
in the Terminal Edit Checks Menu
-----------------------------------------------------------------------------------------------
| | | |
| 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-4. Local Edits Corresponding to Attribute Selection
in the Terminal Edit Checks Menu
-----------------------------------------------------------------------------------------------
| | | |
| 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-3 and any
combination of edits from Table 4-4 according to the following
guidelines:
1. If no selection is made from Table 4-3, the default edit of
UNRESTRICTED is used.
2. The CONSTANT and REQUIRED edits are incompatible, since the
required data cannot be entered in the CONSTANT field.
3. 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.
4. The effect of the JUSTIFY attribute on each of the field types is
shown in Table 4-3.
Table 4-5. Local Edits Corresponding to Format Mode Selections
in the Terminal Configuration Menu
-----------------------------------------------------------------------------------------------
| | | |
| 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-3 and Table 4-4, 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.