Adis

Configuring Your Keyboard

Chapter 5: Configuring Enhanced ACCEPT and DISPLAY

This chapter describes how you configure the enhanced ACCEPT and DISPLAY.

5.1 Overview

The Adis Configuration utility enables you to alter the default behavior of the enhanced ACCEPT and DISPLAY statements as described in your Language Reference

The Adis module can be configured to change behavior in many areas. Full details on Adis are provided in the chapter Adis. Adis contains an internal set of defaults which it uses unless the file ADISCTRL is present. Configuration changes ADISCTRL, not the defaults internal to Adis.

ADISCTRL is the configuration database for the Adis module. 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 Adis uses.

ADISCTRL contains all of the machine-independent information required by Adis. This includes:

• How ACCEPT and DISPLAY statements are to be executed.
  
  
• The messages output by Adis in response to errors.
  
  
• Which keys are enabled or disabled.

You can alter any of the configurations held in ADISCTRL using the the Adis Configuration utility. 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 the Adis Configuration utility to select which one of these configurations you wish to use (use the Choose option on the main menu of the Adis Configuration utility).

The configurations supplied with your COBOL system include:

• Default Configuration.

  This is exactly the same as the configuration built into Adis that is used at run time if no ADISCTRL file is found. This provides the standard mode of operation during execution of ACCEPT and DISPLAY statements.

• RM Compatibility.

  This configuration should be selected if your program was originally written in RM/COBOL V2.0. This configuration provides a very close emulation of the action of ACCEPT and DISPLAY statements in RM COBOL.

• DG ICOBOL Compatibility.

  This is provided to emulate the action of ACCEPT and DISPLAY statements under Data General's ICOBOL.

• IBM V1.0 Compatibility.

  This is provided to emulate IBM COBOL V1.0. It is not a close emulation, especially in the action of ACCEPT operations into numeric and numeric-edited fields.

• Microsoft V2 Compatibility.

  This is provided to emulate Microsoft COBOL V2.2. It is not a close emulation, especially in the action of ACCEPT operations into numeric and numeric-edited fields.

See the Compatibility Guide for full details on RM, DG ICOBOL, IBM and Microsoft compatibility.

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.

5.2 Invoking the Adis Configuration Utility

To invoke the Adis Configuration utility, enter the command line:

adiscf

The utility searches for ADISCTRL, first in the current directory and then in the directory specified by COBDIR. If one exists, the Adis Configuration utility reads in the configuration currently selected for use by Adis. If ADISCTRL does not exist, the following message is displayed on your screen:

adisctrl does not exist - Defaults used

The Adis Configuration utility has a set of default values built into it. These are used if ADISCTRL does not exist.

If the message:

Old style adisctrl found. Converting to new format.

is displayed, the Adis Configuration utility has located an ADISCTRL file from an earlier product. This file is of a different format. However, the Adis Configuration utility can read the old format and convert it. Once files have been converted to the new format, versions of Adis supplied with previous versions of the COBOL system can no longer read them.

5.3 Menus

The Adis Configuration utility menus are organized to provide rapid access to its most commonly used functions.

You can access a help menu from any 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 Adis Configuration utility.

5.3.1 The Adis Configuration Utility Main Menu

Once you have invoked the Adis Configuration utility it displays its main menu and the information line, as shown in Figure 5-1.

Figure 5-1: The Adis Configuration utility Main Menu

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

• Alter any aspect of a configuration.
  
  
• Load a configuration.
  
  
• Save a configuration.
  
  
• Delete a configuration.
  
  
• Choose a configuration for Adis to use when running your programs.

5.3.2 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 5-2.

Figure 5-2: The Adis Key Control Menu

This menu enables you to perform the following actions:

• Alter the function performed by a specific key.
  
  
• Make a key act as an Adis function key.
  
  
• Disable a key completely.

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.

5.3.3 The Alter Accept/Display Options Menu

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

Figure 5-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.

5.3.4 The Alter All Messages Menu

Pressing F2=All Messages or A from the Alter Messages menu displays the Alter All Messages menu. This menu is shown with its associated screen in Figure 5-10 later in this chapter.

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.

5.3.5 The Alter All ACCEPT/DISPLAY Options Menu

Pressing F2=All Options or A from the Alter Accept/Display Options menu displays the Alter All Options menu. This menu is shown with its associated screen in Figure 5-9 later in this chapter.

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.

5.3.6 The Alter Configuration Menu

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

Figure 5-4: The Alter Configuration Menu

5.3.7 The Alter Crt-Under Highlighting Menu

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

Figure 5-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.

5.3.8 The Alter Function Mappings Menu

Pressing F3=Function Mappings from the Adis Key Control menu displays the Alter Function Mappings menu. This menu is shown with its associated screen in Figure 5-20 later in this chapter.

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

5.3.9 The Alter Indicators Menu

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

Figure 5-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.

5.3.10 The Alter Individual Messages Menu

Pressing F3=Individual Messages or I from the Alter Messages menu displays the Alter Individual Messages menu. This menu is shown with its associated screen in Figure 5-12 later in this chapter

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.

5.3.11 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 is shown with its associated screen in Figure 5-11 later in this chapter.

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

5.3.12 The Alter Message/Indicator Positions Menu

Pressing F7=Positions on the Alter Configuration menu displays the Alter Message/Indicator Positions menu. This menu is shown with its associated screen in Figure 5-13 later in this chapter.

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.

5.3.13 The Alter Messages Menu

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

Figure 5-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 messages or individual ones.

5.3.14 The Alter Tab Stops Menu

Pressing F4=Tab Stops from the Alter Configuration menu displays the Alter Tab Stops menu. This menu is shown in Figure 5-14 later in this chapter.

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 <left-arrow> and <right-arrow> to move the cursor along the ruler.

5.3.15 The Choose Configuration Menu

Pressing F6=Choose from the main menu displays the Choose Configuration menu. This menu is shown with its associated screen in Figure 5-16 later in this chapter.

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

5.3.16 The Delete Configuration Menu

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

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

5.3.17 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 is shown with its associated screen in Figure 5-18 later in this chapter.

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

5.3.18 The Load Configuration Menu

Pressing F3=Load or L from the main menu displays the Load Configuration menu. This menu is shown with its associated screen in Figure 5-19 later in this chapter.

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.

5.3.19 The Save Menu

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

Figure 5-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 the Adis Configuration utility without first saving any changes you have made to a configuration, you are asked to confirm that this is what you wish to do.

5.4 Functions

The functions of the Adis Configuration utility are accessed from menus. The function-names are sometimes abbreviated on the menu; however, this description uses the full names. The following section contains a quick reference listing of all the functions available in the Adis Configuration utility. This list is followed by detailed descriptions of these functions.

5.4.1 Function Access

The following table lists the available functions in alphabetical order and indicates the keys you must press to access them. Thus, to determine the path to access a given function, follow the sequence of keystrokes. For example, to reach the Alter Individual ACCEPT/DISPLAY Options function from the main menu, you press F2=Alter, F3=Accept/Display Options and F3=Individual Options.

5.4.2 Function Descriptions

This section describes the functions available in the Adis Configuration utility.

Add New Tab Stop

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. See the section Map Adis Keys for details of mapping Adis keys.

Alter ACCEPT/DISPLAY Options

Displays the Alter ACCEPT/DISPLAY Options menu which is described in the section Menus. For a description of the functions available on this menu see Alter All ACCEPT/DISPLAY Options and Alter Individual ACCEPT/DISPLAY Options.

Alter All ACCEPT/DISPLAY Options

Displays a description of each option and its current value in turn, one option per screen. The first option displayed is shown in Figure 5-9 with the Alter All ACCEPT/DISPLAY Options menu.

Figure 5-9: The Alter All ACCEPT/DISPLAY Options Menu

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.

See the section ACCEPT/DISPLAY Options for a list of all the available options.

Alter All Messages

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. The first message is shown in Figure 5-10 with the Alter All Messages menu.

Figure 5-10: The Alter All Messages Menu

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. Pressing Escape returns you to the Alter Messages menu, abandoning any change made to the current message.

Alter Auto Clear Indicator

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 (<up-arrow> and <down-arrow>) 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

Displays the Alter Configuration menu which is described in the section Menus. For a description of the functions available on this menu see the sections Alter CRT-UNDER Highlighting, Alter ACCEPT/DISPLAY Options, Alter Tab Stops, Alter Indicators, Alter Messages, Alter Position of Messages and Indicators and Alter Key Control.

Alter CRT-UNDER Highlighting

Displays the Alter CRT-UNDER Highlighting menu which is described in the section Menus. For a description of the functions available from this menu see the sections Set CRT-UNDER Attribute to Blink, Set CRT-UNDER Attribute to Bold, Set CRT-UNDER Attribute to Reverse Video and Set CRT-UNDER Attribute to Underscore.

Alter Indicators

Displays the Alter Indicators menu which is described in the section Menus. For a description of the functions available on this menu see the sections Alter Insert/Replace Indicator, Alter Off End of Field Indicator and Alter Auto Clear Indicator.

Alter Individual ACCEPT/DISPLAY Options

Displays a screen of ACCEPT/DISPLAY options you can change. The currently selected option is highlighted. Press F2=Next Page to see a page of further options, then press F2 again to return to the page of original options. The first screen of options is shown in Figure 5-11 with the Alter Individual ACCEPT/DISPLAY Options menu.

Figure 5-11: The Alter Individual ACCEPT/DISPLAY Options Menu

Type the number of the option you want to change or position the cursor on the relevant line using the cursor keys (<up-arrow> and <down-arrow>). 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 press Enter. Press Escape to return to the Alter Individual ACCEPT/DISPLAY Options menu. See the section ACCEPT/DISPLAY Options for a list of all available options.

Alter Individual Messages

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. The first screen of message is shown in Figure 5-12 with the Alter Individual Messages menu.

Figure 5-12: The Alter Individual Messages Menu

Type the number of the message you want to change, or position the cursor on the relevant line, using the cursor keys (<up-arrow> and <down-arrow>). 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.

See the section Configurable Adis ACCEPT Messages for a list of all error messages that you can change.

Alter Insert/Replace Indicator

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 (<up-arrow> and <down-arrow>) 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

Displays the Adis Key Control menu which is described in the section Menus. For a description of the functions available on this menu see Enable/Disable Adis Keys and Map Adis Keys.

Alter Messages

Displays the Alter Messages menu which is described in the section Menus. For a description of the functions available on this menu see Alter All Messages and Alter Individual Messages.

Alter Off End of Field Indicator

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 (<up-arrow> and <down-arrow>) 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

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. The entry fields are shown in Figure 5-13 with the Alter Message/Indicator Positions menu.

Figure 5-13: The Alter Message/Indicator Positions Menu

Use the cursor keys (<left-arrow>, <right-arrow>, <up-arrow> and <down-arrow>) 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. See the sections Alter All Messages and Alter Individual Messages for details of configuring the text for messages.

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

Displays the Alter Tab Stops menu, which is described in the section Menus, and the tab stops ruler. The Alter Tab Stops menu is shown in Figure 5-14, and the tab stops ruler is shown in Figure 5-15.

Figure 5-14: The Alter Tab Stops Menu

For a description of the functions available on this menu see Add New Tab Stop, Delete Tab Stop and Save New Tab Stop Settings.

Figure 5-15: The Tab Stops Ruler

Choose Configuration

Displays the available configurations, with the one currently active appearing highlighted. This screen is shown in Figure 5-16 with the Choose Configuration menu.

Figure 5-16: The Choose Configuration Menu

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 (<up-arrow> and <down-arrow>). 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 main menu. When you next run a program using your COBOL system, Adis automatically uses the configuration you have just chosen. Alternatively, you can press Escape to return to the main menu without choosing a new configuration.

Delete Configuration

Displays the existing configurations, with the current configuration appearing highlighted. Highlight the configuration you wish to delete by entering its number at the prompt, or by using the cursor keys (<up-arrow> and <down-arrow>). The list of configurations is shown in Figure 5-17.

Figure 5-17: The Delete Configuration Menu

When you have highlighted the configuration you want to delete, press Enter. The configuration is deleted from ADISCTRL and you are returned to the main menu. Alternatively you can press Escape to return to the 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. See the section Choose Configuration for more information on choosing configurations.

Delete Tab Stop

Deletes the tab stop (represented by T) at the current cursor position. You should first have used the cursor keys (<left-arrow> and <right-arrow>) to position the cursor over the tab stop to be deleted.

Enable/Disable Adis Keys

Displays a list of all functions provided by the Adis keys, together with the current status of each key. This list is shown in Figure 5-18 with the Enable/Disable Adis Keys menu.

Figure 5-18: The Enable/Disable Adis Keys Menu

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

Use the cursor keys (<left-arrow>, <right-arrow>, <up-arrow> and <down-arrow>) 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 Adis Key Control menu and save your changes. Press Escape to return to the Adis Key Control menu, abandoning any changes you have made.

Escape

Returns to the higher level menu or exits from the Adis Configuration utility altogether if you are at the 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

Displays a list of available configurations, as shown in Figure 5-19.

Figure 5-19: The Load Menu

The configurations listed in Figure 5-19 may vary according to the version of the software.

The configuration currently loaded appears highlighted on your screen. In Figure 5-19, the currently loaded configuration is the Default Configuration. To select a configuration, either enter its number at the prompt or use the cursor keys (<up-arrow> and <down-arrow>) 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. The Adis Configuration utility loads the configuration you have selected into memory from ADISCTRL.

You are then returned to the 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 main menu.

Map Adis Keys

Displays a page of supported Adis functions. Press F2=Next Page to see a page of further functions, then press F2 again to return to the page of original functions. The first page of mappings displayed is shown in Figure 5-20 with the Alter Function Mappings menu.

Figure 5-20: The Alter Function Mappings Menu

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:

Press F2=Next Page to display a page of further function mappings, shown in Figure 5-21.

Figure 5-21: Alternative Function Mapping Options

Move between the fields using the cursor keys ( <left-arrow>, <right-arrow>, <up-arrow> and <down-arrow>). When you have made your changes, press Enter to return to the Adis Key Control menu and save your changes. Press Escape to return to the Adis Key Control menu if you do not wish to save your changes, or you have made none.

Overwrite Existing Configuration

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. The Adis Configuration utility 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 main menu. Alternatively, press Escape to return to the 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. See The Delete Configuration Menu for more information on deleting configurations.

Save

Displays the Save menu which is described in the section Menus. For a description of the functions available on this menu see Save New Configuration and Overwrite Existing Configuration.

Save New Configuration

Saves your configuration as a new configuration within ADISCTRL. 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 main menu. Alternatively, press Escape to return to the main menu without saving.

Save New Tab Stop Settings

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

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

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

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

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.

5.4.2.1 ACCEPT/DISPLAY Options

The following is a list of all the ACCEPT/DISPLAY options you can alter from the Alter All ACCEPT/DISPLAY Options menu or the Alter Individual ACCEPT/DISPLAY 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.

The options are:

1. User function keys enable/disable .

   Enable or disable 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.

   Characters 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 through 127 are allowed.
      
      
   2. Characters with ASCII codes in the range 0 through 255 are allowed.
      
      
   3. Characters with ASCII codes in the range 32 through 127 are allowed.
      
      
   4. Characters with ASCII codes in the range 32 through 255 are allowed. This is the default.
      
      

   If you enable characters within the range 0 through 31 using options 1 or 2, you still might 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.

   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 .

   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.

   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.

   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.

   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 <left-arrow>) 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.

   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.

   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.

    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.

    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.

    Specify the action of the Backspace 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.

    Specify how you want numeric-edited fields to look during an ACCEPT operation. You can choose from the following options:
    
    

    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.

    Specify how you want non-edited numeric fields to look during an ACCEPT operation. You can choose from the following options:
    
    

    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.

    Specify how you want a field to appear when the cursor first enters it. You can specify any of the following options:
    
    

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

    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.

    Specify whether Adis is to remember the position of the last character in a field. You can choose from the following options:
    
    

    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.

    Specify whether 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.

    Specify whether 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.

    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.

    Specify whether 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.

    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.

    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.

    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.

    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.

    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.

    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.

    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 Adis keys defined as function keys.

    Control how an Adis 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 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.

    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.

    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.

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

32. Selection of the units used when calculating timeout.

    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.

    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.

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

Adis

Configuring Your Keyboard