HP 3000 Manuals HP 3000 Manuals
Operation
This section tells you how to invoke and use Adiscf.
Invoking Adiscf
To invoke Adiscf, enter the command line:
component
where:
component is the program-name for the system component to be
invoked, in this case Adiscf:
DOS and OS/2 Windows UNIX
adiscf adsicfw adiscf
NOTE Where you specify the command line depends upon the operating
system you are running in. For example, in Windows and OS/2, if
you have created a group for COBOL, you double click on the
appropriate program icon to invoke the component. Full details on
the alternative methods of invoking system tools in your
environment are provided in the chapter Introduction.
The utility searches for adisctrl, first in the current directory and
then in the COBOL system directory. If one exists, Adiscf 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
Adiscf 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, Adiscf has located an adisctrl file from an earlier
product. This 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 Adis supplied with previous versions of the COBOL
system can no longer read them.
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.
The Adiscf Main Menu.
Once you have invoked Adiscf it displays its main menu and the
information line, as shown in Figure 3-1.
![[]](../../pic3k/M015145/FFN23c50.gif)
Figure 3-1: The Adiscf Main Menu
The Adiscf main menu provides access both 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.
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
![[]](../../pic3k/M015145/FFN33c50.gif)
Figure 3-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.
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.
![[]](../../pic3k/M015145/FFN43c50.gif)
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.
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 3-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.
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 is shown with its
associated screen in 3-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.
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.
![[]](../../pic3k/M015145/FFN53c50.gif)
Figure 3-4: The Alter Configuration Menu
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.
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.
![[]](../../pic3k/M015145/FFN63c50.gif)
Figure 3-5: The Alter CRT-UNDER Highlighting Menu
The Alter Function Mappings Menu.
Pressing F3=Mappings or M from the Adis Key Control menu displays the
Alter Function Key Mappings menu. This menu is shown with its associated
screen in Figure 3-20 later in this chapter.
This menu enables you map Adis keys so that they perform different
functions to those originally associated with that key.
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.
![[]](../../pic3k/M015145/FFN73c50.gif)
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.
The Alter Individual Messages Menu.
Pressing F3=Messages or I from the Alter Messages menu displays the Alter
Individual Messages menu. This menu is shown with its associated screen
in Figure 3-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 to the next screen of
available messages, and press F2=Previous Page to see the original screen
of messages.
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 3-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).
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 3-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 for them to be displayed, this menu also
enables you to alter the position on the screen at which they are
displayed.
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.
![[]](../../pic3k/M015145/FFN83c50.gif)
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.
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 3-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 [[backspace]] and -> and Tab keys to move the cursor along the
ruler.
The Choose Menu.
Pressing F6=Choose from the Adiscf main menu displays the Choose
Configuration menu. This menu is shown with its associated screen in
Figure 3-16 later in this chapter.
This menu enables you to choose the configuration to be used by Adis when
you run your programs.
The Delete Menu.
Pressing F5=Delete or D from the main Adiscf 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.
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 3-18 later in this chapter.
This menu enables you to control which of the functions performed by the
Adis keys are enabled.
The Load Configuration Menu.
Pressing F3=Load from the Adiscf main menu displays the Load
Configuration menu. This menu is shown with its associated screen in
Figure 3-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.
The Save Menu.
Pressing F4=Save from the Adiscf main menu displays the Save menu. This
menu is shown in Figure 3-8.
![[]](../../pic3k/M015145/FFN93c50.gif)
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.
Functions
Adiscf functions 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 Adiscf. This list is followed by detailed
descriptions of these functions.
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 Adiscf main menu, you press F2=Alter, F3=Accept/Display
Options and F3=Individual Options.
Function Menu Access Keys
-----------------------------------------------------
Add New Tab Stop F2, F4, F2
Alter ACCEPT/DISPLAY\Options F2, F3
Alter All ACCEPT/DISPLAY F2, F3, F2
Options
Alter All Messages F2, F6, F2
Alter Auto Clear Indicator F2, F5, F4
Alter Configuration F2
Alter CRT-UNDER Highlighting F2, F2
Alter Indicators F2, F5
Alter Individual F2, F3, F3
ACCEPT/DISPLAY\Option
Alter Individual Message F2, F6, F3
Alter Insert/Replace F2, F5, F2
Indicator
Alter Key Control F2, F8
Alter Messages F2, F6
Alter Off End of Field F2, F5, F3
Indicator
Alter Position of Messages F2, F7
and Indicators
Alter Tab Stops F2, F4
Choose Configuration F6
Delete Configuration F5
Delete Tab Stop F2, F4, F3
Enable/Disable Adis Keys F2, F8, F2
Escape Escape
Map Adis Keys F2, F8, F3
Load Configuration F3
Overwrite Existing F4, F3
Configuration
Save F4
Save New Configuration F4, F2
Save New Tab Stop Settings F2, F4, F4
Table 3-0. (cont.)
Function Menu Access Keys
Set CRT-UNDER Attribute to F2, F2, F5
Blink
Set CRT-UNDER Attribute to F2, F2, F2
Bold
Set CRT-UNDER Attribute to F2, F2, F4
Reverse Video
Set CRT-UNDER Attribute to F2, F2, F3
Underscore