Operation (cont) [ Micro Focus COBOL System Reference, Volume 1 ] MPE/iX 5.0 Documentation
Micro Focus COBOL System Reference, Volume 1
Operation (cont)
Functions (cont)
ACCEPT/DISPLAY Options.
The following is a list of all the ACCEPT/DISPLAY options you can alter
from the Alter All Options menu or the Alter Individual Options menu.
The number for each option is the number displayed by the Alter All
Options and Alter Individual Options menus, described earlier in this
chapter. They are also referenced from other chapters in this manual.
1. User function keys enable/disable . Enables you to enable or
disable the user function keys. These are usually the function
keys on your keyboard. You can choose to:
1. Disable all user function keys. If you press a user
function key during an ACCEPT operation it is treated as an
invalid key. This is the default.
2. Enable all user function keys. If you press a user
function key during an ACCEPT operation, the ACCEPT
operation is terminated.
2. Range of data keys accepted.
You can specify which characters are to be allowed during input to
an ACCEPT operation. You are prompted to enter the number of the
option you require:
1. Characters with ASCII codes in the range 0 to 127 are
allowed.
2. Characters with ASCII codes in the range 0 to 255 are
allowed.
3. Characters with ASCII codes in the range 32 to 127 are
allowed.
4. Characters with ASCII codes in the range 32 to 255 are
allowed.
This is the default
If you enable characters within the range 0 to 31 using options 1
or 2, you may still not be able to enter some of these characters
into a field. This is because some of these characters may form
the start of some key sequences generated by function or cursor
keys. If these keys are enabled they have priority over the data
keys.
3. Prompt character.
Enables you to specify the character to be displayed in the empty
part of the field during an ACCEPT operation of a Screen Section
item, or an ACCEPT operation that specifies the PROMPT clause.
The system displays the selected character in all portions of the
field into which you have not yet entered data. The selected
character also serves to indicate the extent of the field.
This prompt character is used for all picture types except PIC G
and PIC N.
4. Prompt character in PIC G fields.
Enables you to specify the character to be displayed in the empty
part of a PIC G field during an ACCEPT operation of a Screen
Section item, or an ACCEPT operation that specifies the PROMPT
clause.
5. Predisplay of fields before an accept.
Enables you to specify whether you want the contents of data
fields to be displayed automatically before an ACCEPT statement.
If you do not specify automatic display of data fields before an
ACCEPT statement, the screen remains as it is. You can choose
between the following options:
1. Enables the predisplay of numeric-edited fields with
numeric editing when the cursor moves into them. No other
predisplay occurs.
2. Enables the predisplay of numeric fields with numeric
editing enabled when the cursor moves into them. No other
predisplay occurs.
3. Enables the predisplay of all fields immediately before
data is accepted into the field.
4. Predisplay of all fields before any data entry is allowed.
This is the default.
6. Accept in a SECURE field.
Enables you to specify how you want the cursor to behave, and what
you want the field to look like during an ACCEPT into a SECURE
field. Possible options are:
1. There is no display of characters on the screen as you
enter each character, but the cursor advances to the next
character position. This is the default.
2. An asterisk (*) is displayed as each character is entered,
and the cursor advances to the next character position.
3. A space is displayed as each character is entered, and the
cursor advances to the next character position.
7. Auto-skip between fields.
Enables you to specify whether you want the cursor to move to the
next field automatically when the current field is full. This
applies only to multiple data fields within one ACCEPT statement.
The options available to you are:
1. No auto-skip. You must press an explicit Tab or cursor key
(other than Backspace) to move to the next field.
2. Auto-skip enabled. If the current field is full, any
cursor movement, or pressing a character key, causes the
cursor to move to the next field. This is the default.
This option has no effect on ACCEPT operations on Screen Section
items. Auto-skip is off by default for these operations. You can
turn it on by specifying the AUTO clause in your source program.
See your Language Reference for details of the AUTO clause.
8. Termination of an accept.
Enables you to specify which actions terminate an ACCEPT
operation. You can specify the following to terminate an ACCEPT
operation:
1. Pressing the "terminate accept" key. This is the default.
2. Pressing the "next field" key when the cursor is in the
last field of an ACCEPT operation.
3. Keying or retyping a data character in the last available
character position of an ACCEPT operation, provided
auto-skip between fields is enabled.
This option controls only normal termination. Function keys still
terminate an ACCEPT operation if they are enabled.
9. Validation control if accept is terminated by a function key.
Enables you to specify whether validation clauses need to be
satisfied when terminating an ACCEPT using a function key. You
can choose between:
1. No validation takes place. This is the default.
2. Normal validation criteria must be satisfied for the
current field.
10. End of field effects.
Enables you to specify how you want the cursor to behave, if you
attempt to key data once a field is full. You can select one of
the following behaviors:
1. The cursor moves beyond the end of field, and overtyping is
rejected.
2. The cursor stays at the end of field, and overtyping is
rejected.
3. The cursor stays at the end of field, and overtyping is
allowed. This is the default.
11. Field overflow buffers enable/disable.
Enables you to specify whether data is to be saved in an overflow
buffer when displaced from the end of a field. You can choose
from the following behaviors:
1. Displaced data is saved in an overflow buffer. This is the
default.
2. Displaced data is not saved in an overflow buffer.
12. Auto-restore during backspace in replacement editing mode.
Enables you to specify the action of the Backspace key in
free-format fields, when in replacement editing mode. You can
choose from the following behaviors:
1. Auto-restore is enabled. Previously overtyped characters
are restored, as characters are deleted. This is the
default.
2. Auto-restore is disabled. Deleted characters are replaced
by spaces.
13. Accepts into numeric-edited fields.
Enables you to specify how you want numeric-edited fields to look
during an ACCEPT operation. You can choose from the following
behaviors:
1. Input is accepted as for alphanumeric fields and is
normalized to remove illegal characters on exit from the
field.
2. As for option 1, but you can enter only digits, signs,
decimal points and commas.
3. Numeric fields up to 32 characters long are accepted in
formatted mode. This means that characters other than
digits, signs and decimal points are rejected. Fields are
reformatted to show the editing symbols as data is entered.
Fields longer than 32 characters are accepted as in option
1. This is the default.
4. As in option 3, with the exception that fields longer than
32 characters are accepted as in option 2.
14. Accepts into non-edited numeric fields.
Enables you to specify how you want non-edited numeric fields to
look during an ACCEPT operation. You can choose from the
following behaviors:
1. Unsigned and embedded signed non-edited numeric fields with
PICTURE clauses of the form 9(m)V(n) are treated as though
they were a PIC 9(m) field followed by a PIC 9(n) field.
Fields with separate signs are treated as though they were
PIC S9(m+n). This is the default.
2. As in option 1 except that fields with a V in the PIC
clause are treated as PIC S9(m+n).
3. All non-edited numeric fields are treated as alphanumeric
fields.
If you specify a nonzero SIZE clause, all non-edited numeric
fields are treated as free-format fields, regardless of the
setting of this option.
15. Enable/Disable auto-clear or pre-clear.
Enables you to specify how you want a field to appear when the
cursor first enters it. You can specify any of the following
behaviors:
1. No pre-clear or auto-clear takes place. This is the
default.
2. Pre-clear mode. The field is cleared to spaces or zeros.
Pressing the Undo key restores the original contents of the
field.
3. Auto-clear mode. If, after the cursor enters a new field,
the first keystroke is a valid data character, then the
field is cleared to spaces or zeros before processing the
character. An invalid data character turns auto-clear mode
off. Pressing the Undo key restores the original contents
of the field.
4. As in option 2, except that pressing the Undo key does not
restore the original contents of the field.
16. Force field to be updated if it is not altered.
Enables you to specify how you want the contents of a field to
appear if you leave it without altering it. You can choose from
the following behaviors:
1. The data item is not updated if the field is not altered.
This is the default.
2. The data item is always updated even if the field is not
altered.
This option has effect only if the field is numeric or
numeric-edited and the original data item did not contain
any numeric data, or if the field is right justified and
the original contents of the field were not.
17. Remembering where the end of the field is.
Enables you to specify if Adis is to remember the position of the
last character in a field. You can choose from the following
behaviors:
1. Adis does not note the position of the last character.
This is the default.
2. Adis notes the position of the last character entered into
a field during an ACCEPT operation. This option is
required to provide justification of RM-style numeric
fields.
This option applies only if the prompt character is disabled.
18. RM-style numeric data entry.
Enables you to specify if you want your system to emulate RM/COBOL
style entry of numeric data items. You can choose from the
following behaviors:
1. The COBOL system entry of numeric data items is enabled.
This is the default.
2. The RM/COBOL style of numeric and numeric-edited data entry
is enabled. If this option is selected, all other numeric
and numeric-edited options are ignored.
19. Restricting maximumfield size to one line.
Enables you to specify if the size of fields in ACCEPT operations
is restricted to one line. You can choose from the following
behaviors:
1. Fields are not restricted to one line. This is the
default.
2. Fields are restricted to one line.
20. Control of cursor positioning after an ACCEPT.
Enables you to control where the cursor is placed at the end of an
ACCEPT operation. You can choose from the following behaviors:
1. The cursor is moved to the next character position
following the end of the current field. This is the
default.
2. The cursor is left at its current position.
21. Control of whether UPDATE clauses perform implicit CONVERT
operations.
Enables you to specify if a CONVERT clause is implied if you
specify an UPDATE phrase. You can choose from the following
behaviors:
1. The CONVERT clause is not implied. This is the default.
2. The CONVERT clause is implied.
This option is provided to enable you to emulate the behavior of
RM/COBOL V2.0 and V2.1.
22. Selection of the function key list to be used.
Enables you to specify which function key list your system is to
use to map control codes onto user function keys. You can choose
from the following behaviors:
1. The standard user function key list is to be used. This is
the default.
2. The compatibility function key list is to be used. The
list supplied with the COBOL system is the RM/COBOL
function key list, but you may alter this for compatibility
with any dialect of COBOL
23. Selection of the action for COLUMN + n clauses.
Enables you to determine the number of characters advanced by this
clause in the Screen Section. You can choose from the following
behaviors:
1.
A COLUMN +
1 clause causes the field to be displayed immediately after
the preceding field; there is no gap between the two
fields. This is the default.
2. A COLUMN + 1 clause leaves a one character gap between the
two fields.
COLUMN +n clauses, where n 1, are treated accordingly. You should
set this option to 2 if DG-style behavior is required.
24. Selection of the default action if no color specified.
Enables you to specify the default colors for Screen Section items
if no color is specified:
1. The default screen color is used; that is, the colors
specified in the last BLANK SCREEN clause. The initial
colors are white for foreground, and black for background.
This is the default.
2. Text is displayed with white foreground and black
background regardless of the default color
25. Control of whether cursor left/right keys can exit a field.
Enables you to control whether pressing the cursor left/right keys
when positioned at the start/end of a field move to the
previous/next field respectively. You can choose from the
following behaviors:
1. The keys move to the previous or next field. This the
default.
2. The keys cannot exit a field.
26. Left justification of free-format edited numerics.
Enables you to control whether free-format edited numeric fields
are left-justified as they are entered. You can choose from the
following behaviors:
1. The field is not left-justified. This is the default.
2. The field is left-justified, provided RM-numeric handling
is switched off. This is controlled by ACCEPT/DISPLAY
option 18.
27. Validation control on FULL/REQUIRED fields.
Enables you to control whether all fields with a FULL or REQUIRED
clause must have the appropriate conditions satisfied before
termination of an ACCEPT operation is possible. You can choose
from the following behaviors:
1. Any field which has not been changed by the user is not
validated. This is the default.
2. All fields with a FULL or REQUIRED clause must have valid
contents before an ACCEPT operation can be terminated.
28. Control of Adis keys defined as function keys.
Enables you to control how an Adis key behaves when defined as a
function key. You can choose from the following behaviors:
1. The mapping associated with the key determines the behavior
of the key. This option is provided for compatibility with
early Micro Focus products
2. Any Adis key set up as a function key terminates the ACCEPT
operation regardless of the function mapping. This the
default.
29. Control of the read screen option for an accept.
Enables you to control the facility that enables the initial
contents of an ACCEPT field to be read from the current screen
contents. You can choose from the following behaviors:
1. No screen READ occurs. The initial contents of the field
are unaltered. This is the default.
2. The initial contents of the field are read from the screen
provided that predisplay of the field is disabled. This is
controlled by ACCEPT/DISPLAY option 5.
30. Control of special action for Kanji modifier characters.
Enables you to control the behavior of the Kanji modifier
characters, daku-on and han-daku-on, if you specify them during an
ACCEPT operation. You can choose from the following behaviors:
1. The modifier characters are treated the same as all other
characters. This is the default.
2. If you enter a modifier character, the previous character
entered is examined by Adis to see if it can be modified.
If it can, it is replaced by the modified character.
This option is only relevant on Japanese double-byte character set
machines.
31. Selection of the units used when calculating timeout.
Enables you to specify the timeout in units of seconds or tenths
of a second.
1. The time specified for the TIMEOUT clause is in seconds.
This is the default.
2. The time specified for the TIMEOUT clause is in tenths of a
second.
32. Control of whether timeout is reset on each keystroke.
Enables you to specify that the TIMEOUT timer is reset every time
a character is input, or times out after a fixed time irrespective
of what is entered. You can choose from the following behaviors:
1. The timer is not reset. Timeout occurs at the specified
length of time after the ACCEPT operation is initiated.
This is the default.
2. The timer is reset each time a character is entered.
Configurable Adis ACCEPT Messages.
The Alter All Messages menu and the Alter Individual Messages menu enable
you to alter the messages displayed by Adis during an ACCEPT operation.
The following list shows the conditions that cause messages to be
displayed, and their default settings:
Abort - Y/N ?
The abort key has been pressed.
You must enter enough data to fill the entire field.
A field defined with the FULL clause is not completely filled.
You must not leave the field empty.
A field defined with the REQUIRED clause is left empty.
You are at the end of the field.
The cursor is at the end of a field.
The cursor is past the end of the field.
The cursor is past the end of a field.
You have lost data from the end of the field.
Data has been lost from the end of a field.
You cannot insert here.
Insertion is not possible at this point.
You cannot delete here.
Deletion is not possible at this point.
That keystroke has no meaning here.
An invalid key has been pressed.
There is no field beyond here.
There are no more fields to move to.
You cannot change character case here.
An attempt was made to change case in a place where changing case
is not allowed.
There is nothing available to retype.
An attempt was made to retype a character when there was nothing
available to retype.
There is nothing available to restore.
An attempt was made to restore a character when there was nothing
available to restore.
The leading part of the number is outside range.
The leading digits of a number are not in the valid range.
The trailing part of the number is outside range.
The trailing digits of a number are not in the valid range.
You have used a sign improperly here
A sign has been used incorrectly.
You cannot use a negative value here.
An attempt was made to use a negative value in an invalid place.
No message defined.
There is no room for a two-byte character.
You cannot use more than one decimal point.
An attempt was made to use more than one decimal point.
You must enter some numeric digits here.
An attempt was made to enter nonnumeric data into a numeric field.
MPE/iX 5.0 Documentation