HP 3000 Manuals

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