Operation (cont.) [ Micro Focus COBOL System Reference, Volume 1 ] MPE/iX 5.0 Documentation
Micro Focus COBOL System Reference, Volume 1
Operation (cont.)
Functions (cont.)
Function Descriptions.
This section describes the functions available in Adiscf.
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 3-9
with the Alter All 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.
Figure 3-9: Alter All ACCEPT/DISPLAY 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 3-10
with 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.
Figure 3-10: The Alter All Messages Menu
Use the cursor keys (^ and v) 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 descibed in the section
Menus. For a description of the functions available on this menu see
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 Hightlighting.
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 Set CRT-UNDER Highlighting to Blink, Set CRT-UNDER Highlighting
to Bold, Set CRT-UNDER Highlighting to Reverse Video and Set CRT-UNDER
Highlighting 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
Alter Insert/Replace Indicator, Alter Off End of Field Indicator and
Alter Auto Clear Indicator.
Alter Individual ACCEPT/DISPLAY Option.
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 F2=Previous Page to return to the page of
original options. The first screen of options is shown in Figure 3-11
with the Alter Individual Options menu.
Figure 3-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 (^ and v). 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 Options menu. See the section ACCEPT/DISPLAY Options
for a list of all available options.
Alter Individual Message.
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 F2=Previous Page to return to the page of original
messages. The first screen of message is shown in Figure 3-12 with the
Alter Individual Messages menu.
Figure 3-12: The Alter Individual Message Menu
Type the number of the message you want to change, or position the cursor
on the relevant line, using the cursor keys (^ and v). 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 (^ and v) 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 Message.
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 (^ and v) 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 3-13
with the Alter Message/Indicator Positions menu.
Figure 3-13: The Alter Message/Indicator Positions Menu
Use the cursor keys (<- -> ^ and v) 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
3-14, and the tab stops ruler is shown in Figure 3-15.
Figure 3-14: 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 3-15: The Tab Stops Ruler
Choose Configuration.
Displays the available configurations, with the one currently active
appearing highlighted. This screen is shown in Figure 3-16 with 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 (^ and v). 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, Adis 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.
Figure 3-16: The Choose Menu
Delete Configuration.
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 v).
The list of configurations is shown in Figure 3-17.
When you have highlighted the configuration you want to delete, press
Enter. The configuration is deleted from adisctrl 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. 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 (<- and ->) to position the
cursor over the tab stop to be deleted.
Figure 3-17: The Delete Configuration Menu
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 3-18 with
the Enable/Disable Adis Keys menu.
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 (<-, ->, ^, v) to move from field to field on the
screen and enter the required letter in the field(s) you wish to alter.
Figure 3-18: the Enable/Disable Adis Keys Menu
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 Adiscf altogether if you
are at the Adiscf main menu. Where both Escape and Enter are available
options, Escape exits without makeing 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 3-19.
The configurations listed in Figure 3-19 may vary according to the
version of the software.
The configuration currently loaded appears highlighted on your screen.
In Figure 3-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 (^ and v) 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.
Figure 3-19: The Load Menu
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. For more information see
the section 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.
Displays a page of supported Adis functions. Press F2=Next Page to see a
page of further functions, then F2=Previous Page to return to the page of
original functions. The first page of mappings displayed is shown in
Figure 3-20 with the Alter Function Mappings menu.
Figure: 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:
Field Description
-------------------------------------------------------
Validate field 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 field 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
field the function to which the associated
key is currently mapped. Enter the
number of the required function if
you wish to alter this.
Press F2=Next Page to display a page of further function mappings, shown
in Figure 3-21.
Move between the fields using the cursor keys (<-, ->, ^, and v) When you
have made your changes, press Enter to return you 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.
Figure 3-21: Alternative Function Mapping Options
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. 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. See The Delete
Menu for more information on deleting configuration options.
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 Adiscf
main menu. Alternatively, press Escape to return to the Adiscf main menu
without saving.
Set 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.
MPE/iX 5.0 Documentation