PreviousEnhanced ACCEPT/DISPLAY Syntax Keyboard Configuration Utility (Keybcf)Next

Chapter 3: Configuring Adis Using Adiscf

One of the powerful features of the enhanced ACCEPT/DISPLAY syntax (Adis) is that it can be configured to tailor the behavior of ACCEPT and DISPLAY statements. Full configuration is possible using the Adiscf utility via the adisctrl file produced by this utility.

adisctrl is the configuration database for the enhanced ACCEPT/DISPLAY syntax. It can hold up to a maximum of 16 configurations, any of which are available to you. An entry at the start of adisctrl determines which configuration the enhanced ACCEPT/DISPLAY syntax uses.

adisctrl contains all of the machine-independent information required by the enhanced ACCEPT/DISPLAY syntax. This includes:

You can alter any of the configurations held in adisctrl using the configuration utility Adiscf. This utility is designed around a hierarchy of menus. These menus appear at the bottom of your screen and list the options available to you at any time.

The adisctrl file that is supplied with your COBOL system contains a number of configurations that are set up to emulate different dialects of COBOL. Most of the time you do not need to do anything other than use Adiscf to select which one of these configurations you wish to use (use the Choose option on the main menu of Adiscf).

The configurations supplied with your COBOL system include:

If you do want to create your own configuration, we recommend that you do not change any of the supplied configurations directly. Instead, you should save the configuration you want to change under a different name and make changes to that.

If you create a custom adisctrl file, it must be accessible to your program (in the current directory or the directory specified by the COBDIR environment variable at run time. If it is not, defaults are used.

The enhanced ACCEPT/DISPLAY syntax contains an internal set of defaults which it uses unless the file adisctrl is present. Applications that operate successfully using these default options can be shipped without the adisctrl file.

3.1 Invoking Adiscf

To invoke Adiscf, enter the command line:

adiscf

The diagram below shows the search mechanism used at run time to determine which configuration options Adis is to use.

Unless your applications all use the same nondefault configuration, you are advised to work without the adisctrl file, if possible, and only to create it in the current directory if it is needed.

If the following message is displayed, Adiscf has located an adisctrl file from an earlier product.

Old style adisctrl found. Converting to new format.

This adisctrl file is of a different format. However, Adiscf can read the old format and convert it. Once files have been converted to the new format, versions of the enhanced ACCEPT/DISPLAY syntax supplied with previous versions of the COBOL system can no longer read them.

Remember that during installation, the default adisctrl file is copied to the COBOL system directory. If you wish to alter the default configuration, you are advised to move adisctrl into your current directory before changing it, and not return it to the COBOL system directory.

Configuration changes adisctrl, not the defaults internal to the enhanced ACCEPT/DISPLAY syntax.

3.2 Menus

The Adiscf menus are organized to provide rapid access to the most commonly used Adiscf functions.

You can access a help menu from any Adiscf menu by pressing F1=Help. This calls the help screen for the option from which it is called.

The menus described in this section appear in alphabetical order according to the menu-name. The name of a menu is displayed on the left-hand side of the information line.

The information line lists information concerning which menu you are on or, if you are on the main menu, which configuration is currently loaded. Each menu contains a similar information line as you will discover while using the Adiscf utility.

3.2.1 The Adiscf Main Menu

Once you have invoked Adiscf it displays its main menu and the information line, as shown in Figure 3-1.


Figure 3-1: The Adiscf Main Menu

The Adiscf main menu provides access to a number of submenus, enabling you to perform the following actions:

3.2.1.1 The Adis Key Control Menu

Pressing F8=Key Control from the Alter Configuration menu displays the Adis Key Control menu. This menu is shown in Figure 3-2.


Figure 3-2: The Adis Key Control Menu

This menu enables you to perform the following actions:

where an Adis function key is a key which is used during an ACCEPT operation to perform an editing function; for example, to move the cursor.

3.2.1.2 The Alter Accept/Display Options Menu

Pressing F3=Accept/Display Options from the Alter Configuration menu displays the Alter Accept/Display Options menu. Figure 3-3 shows the Alter Accept/Display Options menu.


Figure 3-3: The Alter Accept/Display Options Menu

This menu enables you to specify how you want the cursor to behave, and what you want the fields to look like, during an ACCEPT operation. You can choose to alter all the available options or individual ones.

3.2.1.3 The Alter All Messages Menu

Pressing F2=All Messages or A from the Alter Messages menu displays the Alter All Messages menu.

This menu enables you to change the messages Adis displays when certain conditions (such as the cursor being at the end of a field) occur.

3.2.1.4 The Alter All Options Menu

Pressing F2=All Options or A from the Alter Accept/Display Options menu displays the Alter All Options menu.

This menu enables you to change a set of options (such as the range of data keys allowed during an ACCEPT operation) that determine the behavior of the ACCEPT and DISPLAY operations.

3.2.1.5 The Alter Configuration Menu

Selecting the Alter menu by pressing F2=Alter from the Adiscf main menu enables you to alter all or part of a configuration. Figure 3-4 shows the Alter Configuration Menu.


Figure 3-4: The Alter Configuration Menu

3.2.1.6 The Alter Crt-Under Highlighting Menu

Pressing F2=Crt-Under Highlighting from the Alter Configuration menu displays the Alter Crt-Under Highlighting menu. Figure 3-5 shows the Alter Crt-Under Highlighting menu.


Figure 3-5: The Alter Crt-Under Highlighting Menu

This menu enables you to alter the type of highlighting that is used with the DISPLAY ... UPON CRT-UNDER statement, the DISPLAY ... WITH UNDERLINE statement, or when the UNDERLINE clause is used in the Screen Section of your programs.

3.2.1.7 The Alter Function Mappings Menu

Pressing F3=Function Mappings or M from the Adis Key Control menu displays the Alter Function Mappings menu.

This menu enables you to map Adis keys so that they perform different functions to those originally associated with that key.

3.2.1.8 The Alter Indicators Menu

Pressing F5=Indicators from the Alter Configuration menu displays the Alter Indicators menu. This menu is shown in Figure 3-6.


Figure 3-6: The Alter Indicators Menu

This menu enables you to alter the text displayed by Adis during an ACCEPT operation to indicate various conditions. The text for each message can be up to 32 characters long. Once you have typed your own message press Enter to make that change.

3.2.1.9 The Alter Individual Messages Menu

Pressing F3=Individual Messages or I from the Alter Messages menu displays the Alter Individual Messages menu.

This menu displays a list of the currently defined messages with a number by the side of each. Press F2=Next Page to see the next screen of available messages, then press F2 again to see the original screen of messages.

3.2.1.10 The Alter Individual Options Menu

Pressing F3=Individual Options or I from the Alter Accept/Display Options menu displays the Alter Individual Options menu.

This menu enables you to change one of the options controlling the use of the ACCEPT and DISPLAY operations (such as the range of data keys enabled during an ACCEPT operation).

3.2.1.11 The Alter Message/Indicator Positions Menu

Pressing F7=Positions on the Alter Configuration menu displays the Alter Message/Indicator Positions menu.

This menu enables you to control whether or not the messages and indicators normally displayed by Adis during an ACCEPT operation are displayed. If you choose to display them, this menu also enables you to alter the position on the screen at which they are displayed.

3.2.1.12 The Alter Messages Menu

Pressing F6=Messages from the Alter Configuration menu displays the Alter Messages menu. This menu is shown in Figure 3-7.


Figure 3-7: The Alter Messages Menu

This menu enables you to alter the text of messages displayed by Adis during an ACCEPT operation, to indicate various error conditions. You can choose to alter all the available options or individual ones.

3.2.1.13 The Alter Tab Stops Menu

Pressing F4=Tab Stops from the Alter Configuration menu displays the Alter Tab Stops menu.

This menu enables you to set up to 96 tab stops to be used at run time. The Tab Stops screen shows a ruler at the top of the screen on which the current positions of tab stops are shown by the letter T. Use the cursor keys Ü and Þ to move the cursor along the ruler.

3.2.1.14 The Choose Configuration Menu

Pressing F6=Choose from the Adiscf main menu displays the Choose Configuration menu.

This menu enables you to choose the configuration to be used by Adis when you run your programs.

3.2.1.15 The Delete Configuration Menu

Pressing F5=Delete or D from the Adiscf main menu displays the Delete Configuration menu. This menu is shown with its associated screen in Figure 3-17 later in this chapter.

This menu enables you to delete an existing configuration from the adisctrl file.

3.2.1.16 The Enable/Disable Adis Keys Menu

Pressing F2=Enable/Disable Adis Keys or D from the Adis Key Control menu displays the Enable/Disable Adis Keys menu.

This menu enables you to control which of the functions performed by the Adis keys are enabled.

3.2.1.17 The Load Configuration Menu

Pressing F3=Load from the Adiscf main menu displays the Load Configuration menu.

This menu enables you to load an existing configuration into memory. You must load a configuration into memory before you can make any changes to that particular configuration.

3.2.1.18 The Save Menu

Pressing F4=Save from the Adiscf main menu displays the Save menu. This menu is shown in Figure 3-8.


Figure 3-8: The Save Menu

Once you have altered a configuration, using the Alter menu, this menu enables you to save your changes.You must do this if you wish to use the new version of your configuration. If you attempt to leave Adiscf without first saving any changes you have made to a configuration, you are asked to confirm that this is what you wish to do.

3.3 Adiscf Functions

Adiscf functions are accessed from menus. The following table lists the available functions in alphabetical order, describes them in detail, and indicates the keys you must press to access them.

Add New Tab Stop F2, F4, F2 Sets a tab stop at the current cursor position. A T is displayed to show the position of the new tab stop. During an ACCEPT operation, Tab only moves to the next tab stop if it is mapped to the "Move to next tab stop" function.
Alter ACCEPT/DISPLAY Options F2, F3 Displays the Alter ACCEPT/DISPLAY Options menu.
Alter All ACCEPT/DISPLAY Options F2, F3, F2 Displays a description of each option and its current value in turn, one option per screen.

Press Enter to move from one screen to the next or Escape to return to the Alter Accept/Display Options menu. To alter the value of an option, type the number of the choice you require at the relevant prompt. You can alter as few or as many options as you wish.

Alter All Messages F2, F6, F2 Displays in turn the current text of each message and the conditions under which it is output; one message per screen. Press Enter to cycle from one screen to the next.

To alter a message, type the text of the new message at the prompt on the relevant screen, then press Enter to save the new message and return you to the Alter Messages menu. You can alter as few or as many messages as you wish. PressingEscape returns you to the Alter Messages menu, abandoning any change made to the current message.

Alter Auto Clear Indicator F2, F5, F4 Displays the current text for the auto clear and clear auto clear indicators. The auto clear indicator is displayed during an ACCEPT operation if the first character entered into a field would cause the field to be cleared before the character is placed into it. The clear auto clear indicator is displayed at the end of an ACCEPT operation to remove the auto clear indicator if it is currently displayed.

Use the cursor keys (Ý and ß) to move between the two fields. Press Enter to save your changes, or Escape to leave the Alter Auto Clear Indicator menu without altering either of the indicators.

Alter Configuration F2 Displays the Alter Configuration menu.
Alter CRT-UNDER Hightlighting F2, F2 Displays the Alter CRT-UNDER Highlighting menu.
Alter Indicators F2, F5 Displays the Alter Indicators menu.
Alter Individual ACCEPT/DISPLAY Option F2, F3, F3 Displays a screen of ACCEPT/DISPLAY options you can change. The currently selected option is highlighted. PressF2=Next Page to see a page of further options, then pressF2 again to return to the page of original options.

Type the number of the option you want to change or position the cursor on the relevant line using the cursor keys ( and ). Press Enter to select that option.

A description of that option and its current value is then displayed. To alter the value of an option, type the number of the choice you require at the relevant prompt and pressEnter. Press Escape to return to the Alter Individual Options menu.

Alter Individual Messages F2, F6, F3 Displays a screen of messages you can change. The currently selected message is highlighted. Press F2=Next Page to see a page of further options, then press F2 again to return to the page of original messages.

Type the number of the message you want to change, or position the cursor on the relevant line, using the cursor keys (Ý and ß). Press Enter to select that message. The message currently configured for that error condition is displayed. Type the new message at the prompt on the screen. Press Enter to save the message you have typed and return to the list of messages, or press Escape to abandon any change you have made and return to the list of messages.

Alter Insert/Replace Indicator F2, F5, F2 Displays the current text for the insert, replace and clear insert/replace indicators. The insert indicator is displayed when insert mode is active during an ACCEPT operation. The replace indicator is displayed if replace mode is active during an ACCEPT operation. The clear insert/replace indicator is displayed at the end of an ACCEPT operation to remove whichever of the two other indicators is currently displayed.

Use the cursor keys (Ý and ß) to move between the three fields. Press Enter to save your changes, or Escape to leave the Alter Insert/Replace Indicator menu without altering any of the indicators.

Alter Key Control F2, F8 Displays the Enhanced ACCEPT/DISPLAY Syntax Key Control menu.
Alter Messages F2, F6 Displays the Alter Messages menu.
Alter Off End of Field Indicator F2, F5, F3 Displays the current text for the off end of field and clear off end of field indicators. The off end of field indicator is displayed during an ACCEPT operation if the next character entered would be beyond the end of the field. The clear off end of field indicator is displayed at the end of an ACCEPT operation to remove the indicator that is currently displayed.

Use the cursor keys (Ý and ß) to move between the two fields. Press Enter to save your changes, or Escape to leave the Alter Insert/Replace Indicator menu without altering any of the indicators.

Alter Position of Messages and Indicators F2, F7 Displays the four categories of messages and indicators whose positioning you can alter, along with input fields for you to enter the relevant positioning for each category.

Use the cursor keys (Ü, Þ, Ý and ß) to move around the screen from field to field. If you want error messages or a specific indicator to be displayed during an ACCEPT operation enter Y in the relevant field. Enter N if you do not want them to be displayed. Even if you choose not to display error messages, the abort confirmation message is always displayed when the Abort key is pressed during an ACCEPT operation, unless you use the Alter Messages Menu to specifically alter the text associated with this message.

If you choose to display the messages or any specific indicators, you can alter the default positions at which they are displayed on your screen during an ACCEPT operation. Use the cursor keys to position the cursor in the relevant fields and type the new line and column at which you wish the messages or indicator to be displayed.

Line 1 column 1 is the top left-hand corner of your screen.

If you configure more than one indicator to be displayed at the same position, and more than one needs to be displayed at the same time, the off end of field and auto clear indicators take priority over the insert/replace indicator.

Selecting line 255 for any indicator causes the indicator to be displayed on the bottom line of the screen, regardless of the actual length of the screen.

Press Enter once you have made your entries, to return to the Alter Configuration menu and save your changes. Press Escape to return to the Alter Configuration menu, abandoning any changes you have made.

Alter Tab Stops F2, F4 Displays the Alter Tab Stops menu.
Choose Configuration F6 Displays the available configurations, with the one currently active appearing highlighted.

Choose the configuration you require either by entering its number at the prompt, or by positioning the cursor on the relevant configuration name using the cursor keys (Ý and ß). This line now appears highlighted.

When you have highlighted the configuration you want to choose, press Enter. The highlighted configuration becomes the active configuration and you are returned to the Adiscf main menu. When you next run a program using your COBOL system, the enhanced ACCEPT/DISPLAY syntax automatically uses the configuration you have just chosen. Alternatively, you can press Escape to return to the Adiscf main menu without choosing a new configuration.

Delete Configuration F5 Displays the existing configurations, with the current configuration appearing highlighted. Highlight the configuration you wish to delete by entering its number to the prompt, or by using the cursor keys (Ý and ß).

When you have highlighted the configuration you want to delete, press Enter. The configuration is deleted fromadisctrl and you are returned to the Adiscf main menu. Alternatively you can press Escape to return to the Adiscf main menu without deleting a configuration.


Note: You cannot delete the configuration which is currently selected. If you wish to delete this you must first use the Choose menu to choose an alternative configuration.


Delete Tab Stop F2, F4, F3 Deletes the tab stop (represented by T) at the current cursor position. You should first have used the cursor keys (Ü and Þ) to position the cursor over the tab stop to be deleted.
Enable/Disable Enhanced ACCEPT/DISPLAY Syntax Keys F2, F8, F2 Displays a list of all functions provided by the enhanced ACCEPT/DISPLAY syntax keys, together with the current status of each key.

You can alter the status of any key to be one of the following:

Status Description
D Disabled - the key does not perform its associated function during an ACCEPT operation.
E Enabled - the key performs its associated function during an ACCEPT operation.
F Function key - the key acts as a function key during an ACCEPT operation.

Use the cursor keys (Ü, Þ, Ý and ß) to move from field to field on the screen and enter the required letter in the field(s) you wish to alter.

Press Enter once you have made your entries, to return to the Enhanced ACCEPT/DISPLAY Syntax Key Control menu and save your changes. Press Escape to return to the Enhanced ACCEPT/DISPLAY Syntax Key Control menu, abandoning any changes you have made.

Escape Escape Returns to the higher level menu or exits from Adiscf altogether if you are at the Adiscf main menu. Where both Escape and Enter are available options, Escape exits without making the update you have keyed in, whereas Enter makes the update and then exits.
Load Configuration F3 Displays a list of available configurations.

The configurations may vary according to the version of the software.

The configuration currently loaded appears highlighted on your screen. To select a configuration, either enter its number at the prompt or use the cursor keys (Ý and ß) to position the cursor on the line specifying the required configuration. When you move the cursor to another configuration, that configuration appears highlighted on the screen, and its number appears at the prompt position at the bottom of your screen.

Once you have highlighted the configuration you require, press Enter. Adiscf loads the configuration you have selected into memory from adisctrl.

You are then returned to the Adiscf main menu. The configuration you have just selected appears on the information line. You can now alter this configuration by selecting the Alter menu.

If you do not want to select a configuration to load, pressing Escape returns you to the Adiscf main menu.

Map Adis Keys F2, F8, F3 Displays a page of supported enhanced ACCEPT/DISPLAY syntax functions. Press F2=Next Page to see a page of further functions, then press F2 again to return to the page of original functions.

This function enables you to alter the function normally associated with a key. You can map any function to any key. Each function key has three fields associated with it which you can alter:

Field Description
Validate If you set this field to Y, all validation criteria must be satisfied before the cursor can leave a field during an ACCEPT operation. If you enter N, validation criteria are not checked during an ACCEPT operation.
Align By default this field is set to N. If set to Y, a field is cleared from the current cursor position to the end of the field during an ACCEPT operation. Numeric fields are aligned to the decimal point, if it is to the right of the current cursor position.
Mapped Number This field contains the number of the function to which the associated key is currently mapped. Enter the number of the required function if you want to alter this.

Press F2=Next Page to display a page of further function mappings.

Move between the fields using the cursor keys (Ü, Þ, Ý and ß). When you have made your changes, press Enter to return to the Enhanced ACCEPT/DISPLAY Syntax Key Control menu and save your changes. Press Escape to return to the Enhanced ACCEPT/DISPLAY Syntax Key Control menu if you do not wish to save your changes, or you have made none.

Overwrite Existing Configuration F4, F3 Saves your configuration in adisctrl with the same name as an existing configuration. Use this option with care as it overwrites the existing configuration with that name. Adiscf displays a numbered list of the existing configurations. Type the number of the configuration you want to overwrite, or position the cursor on the relevant line, using the cursor up and down keys. Press Enter to save the configuration to the name you have specified and to return to the Adiscf main menu. Alternatively, press Escape to return to the Adiscf main menu without saving.

You can store up to 16 configurations in adisctrl. If you try to save more than this number you receive the message:

The configuration file is full - No new entries allowed

If you receive this message you must either delete or overwrite an existing configuration before you can save any others.

Save F4 Displays the Save menu.
Save New Configuration F4, F2 Saves your configuration as a new configuration withinadisctrl. You are prompted to type the name of this configuration. Press Enter to save the configuration to the name you have entered and to return to the Adiscf main menu. Alternatively, press Escape to return to the Adiscf main menu without saving.
Save New Tab Stop Settings F2, F4, F4 Saves the changes you have made to the positions of the tab stops, and returns to the Alter Configuration menu.
Set CRT-UNDER Attribute to Blink F2, F2, F5 Specifies that the attribute to be used when a DISPLAY ... UPON CRT-UNDER statement is executed is blinking. The word BLINK appears on the information line.
Set CRT-UNDER Attribute to Bold F2, F2, F2 Specifies that the attribute to be used when a DISPLAY ... UPON CRT-UNDER statement is executed is bold. The word INTENSITY appears on the information line.
Set CRT-UNDER Attribute to Reverse Video F2, F2, F4 Specifies that the attribute to be used when a DISPLAY ... UPON CRT-UNDER statement is executed is reverse video. The words REVERSE VIDEO appear on the information line in reverse video.
Set CRT-UNDER Attribute to Underscore F2, F2, F3 Specifies that the attribute to be used when a DISPLAY ... UPON CRT-UNDER statement is executed is underscore. The word UNDERSCORE appears on the information line.

3.4 Configurable 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.

  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:

  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 all 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 the key set as the tab key, or a cursor key (other than Ü) 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 the AUTO clause for details.

  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 options:

    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 options:

    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 theBackspace key in free-format fields, when in replacement editing mode. You can choose from the following options:

    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 options:

    a Input is accepted as for alphanumeric fields and is normalized to remove illegal characters on exit from the field.
    b As for option a, but you can enter only digits, signs, decimal points and commas.
    c 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 a. This is the default.
    d As in option c, with the exception that fields longer than 32 characters are accepted as in option b.

  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 options:

    a 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.
    b As in option a except that fields with a V in the PIC clause are treated as PIC S9(m+n).
    c 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 options:

    a No pre-clear or auto-clear takes place. This is the default.
    b Pre-clear mode. The field is cleared to spaces or zeros. Pressing the Undo key restores the original contents of the field.
    c Auto-clear mode. If 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.
    d As in option b, 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 options:

    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 the enhanced ACCEPT/DISPLAY syntax is to remember the position of the last character in a field. You can choose from the following options:

    1 The enhanced ACCEPT/DISPLAY syntax does not note the position of the last character. This is the default.
    2 The enhanced ACCEPT/DISPLAY syntax 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 options:

    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 maximum field 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 options:

    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 options:

    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 CONVERTs.

    Enables you to specify if a CONVERT clause is implied if you specify an UPDATE phrase. You can choose from the following options:

    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 options:

    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 options:

    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.
    3 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.
    3 Text is displayed with either white foreground and black background, or using the colors set by the last BLANK SCREEN clause.

  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 options:

    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 options:

    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 options:

    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 the enhanced ACCEPT/DISPLAY syntax keys defined as function keys.

    Enables you to control how an enhanced ACCEPT/DISPLAY syntax key behaves when defined as a function key. You can choose from the following options:

    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 enhanced ACCEPT/DISPLAY syntax 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 options:

    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 whether concealed fields are skipped.

    Enables you to control circumstances in which you can skip concealed fields. You can choose from the following options:

    1 Concealed fields are not skipped. This is the default.
    2 Concealed fields are skipped.

  31. 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 options:

    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 the enhanced ACCEPT/DISPLAY syntax 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.

  32. 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.

  33. 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 options:

    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.

3.5 Configurable Adis Messages

The Alter All Messages menu and the Alter Individual Messages menu enable you to alter the messages displayed by the enhanced ACCEPT/DISPLAY syntax during an ACCEPT operation.

The following list shows the conditions that cause messages to be displayed:

Abort - Y/N ?

You must enter enough data to fill the entire field.

You must not leave the field empty.

You are at the end of the field.

The cursor is past the end of the field.

You have lost data from the end of the field.

You cannot insert here.

You cannot delete here.

That keystroke has no meaning here.

There is no field beyond here.

You cannot change character case here.

There is nothing available to retype.

There is nothing available to restore.

The leading part of the number is outside range.

The trailing part of the number is outside range.

You have used a sign improperly here.

You cannot use a negative value here.

No message defined.

You cannot use more than one decimal point.

You must enter some numeric digits here.


Copyright © 1998 Micro Focus Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
PreviousEnhanced ACCEPT/DISPLAY Syntax Keyboard Configuration Utility (Keybcf)Next