HP 3000 Manuals HP 3000 Manuals
Operation
This section tells you how to invoke and use the ADISCF utility.
Invoking the ADISCF Utility
To invoke
ADISCF, enter the
command line:
adiscf
The utility searches for an ADISCTRL database, 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 an
ADISCTRL file 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 file found. Converting to new format.
is displayed, then ADISCF has located an ADISCTRL file from an earlier
product. This file will be 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.
Using the ADISCF Utility
Once you have invoked ADISCF it displays its
initial menu and the information line, as shown in Figure 21-1 .
![[]](../../pic3k/M013032/FFN193c50.gif)
Figure 21-1. The Main Menu
The information line lists information concerning which menu you are on
or, if you are on the main menu, which configuration is currently loaded
(the "Default Configuration" in this case). Each menu contains a similar
information line as you will discover while using the ADISCF utility.
To select the option you require from the main menu press the relevant
function key or letter:
F1 or H Invokes the help facility. This facility is
available for each menu. It displays a screen with
information on the current menu's features.
F2 or A Alters the currently loaded configuration. You
must load a configuration before you can alter it.
F3 or L Loads a particular configuration from the ADISCTRL
database into memory.
F4 or S Saves the new configuration you have written, in
the ADISCTRL database.
F5 or D Deletes a configuration from the ADISCTRL database.
F6 or C Chooses the configuration to be used by ADIS at run
time.
Escape Escapes from the ADISCF utility and returns to the
operating system. If you have changed a
configuration since it was last saved, you are
asked to confirm that you wish to leave the ADISCF
program without saving your changes in the ADISCTRL
database.
Once you select an option, ADISCF displays a submenu for that particular
option. The information line contains the name of that submenu and the
value currently selected for that feature. For example, Figure 21-2
shows what is displayed if you select Alter-Crt Under-Highlighting with
Underline selected.
![[]](../../pic3k/M013032/FFN203c50.gif)
Figure 21-2. The Alter-Crt-Under-Highlighting Menu
The following sections describe the submenus available to you when you
select one of the options from the main menu.
The Alter Option.
Selecting the Alter option by pressing F2 on the main menu allows you to
alter all or part of a configuration. You must load the configuration
you wish to alter by using the Load option before entering this option.
When you have altered the configuration, you must remember to save it
using the Save option, otherwise your changes will be lost. By pressing
the relevant function key on the Alter Configuration menu you can change:
F2 The way your programs display text when you use the
CRT-UNDER phrase
F3 One or all of the ACCEPT/DISPLAY options
F4 TAB stops
F5 Indicator texts
F6 Message texts
F7 Positions at which indicator and message texts are
displayed
F8 ADIS key mappings
The following sections give details of how you can change these features.
Altering CRT-UNDER-HIGHLIGHTING Options
Pressing F2 on the Alter Configuration menu displays the submenu which
allows 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.
Press the relevant key to select the option of your choice:
F2 Intensity
- text appears bold
F3 Underscore
- (the default) text is underlined
F4 Reverse Video
- text appears in reverse video
F5 Blink
- text appears blinking
Press Escape to return to the Alter Configuration menu.
Altering ACCEPT/DISPLAY Options
Pressing F3 on the Alter Configuration menu displays the submenu which
allows 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.
Press F2 to alter all of the ACCEPT/DISPLAY options. A description of
each option and its current value is displayed in turn, one option per
screen. Press Enter to cycle from one screen to the next or Escape to
return to the menu. To alter the value of an option, type the number of
the choice you require at the relevant prompt on each screen. You can
alter as few or as many options as you wish.
Press F3 to alter individual ACCEPT/DISPLAY options. This displays a
list of the available options with a number by the side of each. Press
F2 to toggle to the next page of options. Type the number of the option
you want to alter, or position the cursor on the relevant line by using
the cursor up and down keys.
Press the Enter key to select the option you require. A description of
that option and its current value is displayed. To alter the value of an
option, type the number of the choice you require at the relevant prompt
and press the Enter key. Press Escape to return to the menu.
The following is a list of all the
ACCEPT/DISPLAY options you can alter:
*
User function keys enable/disable - allows you to disable or
enable the
user function keys. These are usually the function keys on your
keyboard. You can choose:
1 Disables all user function keys. If you press a user
function key during an ACCEPT it is treated as an invalid
key
2 The default. Enables all user function keys. If you press
a user function key during an ACCEPT, the accept is
terminated
*
Range of
data keys accepted - you can specify which characters are to be
allowed during input to an ACCEPT. 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 The default. Characters with ASCII codes in the range 32 to
255 are allowed
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.
* Prompt character - allows you to specify the character to be
displayed in the empty part of the field during a Screen Section
accept or Procedure Division accept 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.
It is used for all picture types except PIC G.
* Prompt character in PIC N or PIC G fields
- allows you to specify the character to be displayed in the empty
part of a PIC N or PIC G field during a SCREEN SECTION accept or
PROCEDURE DIVISION accept that specifies the PROMPT clause.
*
Pre-display of fields before an accept - allows 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 Pre-display of numeric-edited fields with numeric editing
enabled (when the cursor moves into them). No other
pre-display occurs
2 Pre-display of numeric fields with numeric editing enabled
(when the cursor moves into them). No other pre-display
occurs
3 Pre-display of all fields immediately before data is
accepted into the field
4 The default. Pre-display of all fields before any data
entry is allowed
* Accept in a SECURE field
- allows 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 The default. No display of characters is shown on the
screen as you enter each character, but the cursor advances
to the next character position
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
* Auto-skip between fields
- allows you to specify whether you want the cursor to move to the
next field automatically when the current field is full. This
applies only to multiple data fields within one ACCEPT statement.
The options available to you are:
1 No auto-skip. You must press an explicit field-tab or
cursor key (other than backspace) to move to the next field
2 The default. 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 option has no effect on Screen Section ACCEPT
operations. Auto-skip is off by default for these
operations. You can turn it on by specifying the AUTO
phrase
in your source program.
* Termination of an accept
- allows you to specify which actions terminate an ACCEPT:
1 The default. Pressing the "terminate accept" key
2 Pressing the "next field" key when the cursor is in the last
field of an accept
3 Keying or retyping a data character in the last available
character position of an accept (provided auto-skip between
fields is enabled)
This option controls only normal termination. Function keys
still terminate an ACCEPT, if they are enabled.
* Validation control if accept is terminated by a function key
- allows you to specify whether validation clauses need to be
satisfied when terminating an ACCEPT using a function key. You
can choose between:
1 The default. No validation takes place
2 Normal validation criteria must be satisfied for the current
field
* End of field effects
- allows 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 default. The cursor stays at the end of field, and
overtyping is allowed
* Field overflow buffers enable/disable
- allows you to specify whether data is to be saved in an overflow
buffer when displaced from the end of a field:
1 The default. Displaced data is saved in an overflow buffer
2 Displaced data is not saved in an overflow buffer
* Auto-restore during backspace in replacement editing mode
- allows you to specify the action of the backspace key in
free-format fields, when in replacement editing mode:
1 The default.
Auto-restore is enabled. Previously overtyped characters
are restored, as characters are deleted
2 Auto-restore is disabled. Deleted characters are replaced
by spaces
* Accepts into numeric-edited fields
- allows you to specify how you want numeric-edited fields to look
during an
ACCEPT:
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 or commas
3 The default. 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
4 As in option 3, with the exception that fields longer than
32 characters are accepted as in option 2
* Accepts into non-edited numeric fields
- allows you to specify how you want non-edited numeric fields to
look during an ACCEPT:
1 The default. Unsigned and embedded signed non-edited
numeric fields with PIC 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)
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 non-zero SIZE clause, all non-edited
numeric fields are treated as free-format fields, regardless
of the setting of this option.
* Enable/Disable auto-clear or pre-clear
- allows you to specify how you want a field to appear when the
cursor first enters it:
1 The default. No pre-clear or auto-clear takes place
2 Pre-clear mode. The field is cleared to spaces or zeros.
Pressing the
UNDO key restores the original contents of the field
3 Auto-clear mode. If, after the cursor enters a new field,
the first keystroke is a valid data character, then the
field is cleared to spaces or zeros before processing the
character. An invalid data character turns auto-clear mode
off. Pressing the UNDO key restores the original contents
of the field
4 As in option 2, except that pressing the UNDO key does not
restore the original contents of the field
* Force a field to be updated if it is not altered
- allows you to specify how you want the contents of a field to
appear if you leave it without altering it:
1 The default. The data item is not updated if the field is
not altered
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
* Remember where the end of field is
- allows you to specify if ADIS is to remember the position of the
last character in a field:
1 The default. ADIS does not note the position of the last
character
2 ADIS notes the position of the last character entered into a
field during an ACCEPT. This option is required to provide
justification of RM-style numeric fields
This option applies only if the prompt character is
disabled.
* RM-style numeric data entry - allows you to specify if you want
your system to emulate RM/COBOL style entry of numeric data items:
1 The default. The COBOL system entry of numeric data items
is enabled
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
* Restricting maximum field size to one line - allows you to specify
if the size of ACCEPT fields is restricted to one line:
1 The default. Fields are not restricted to one line
2 Fields are restricted to one line
* Control of cursor positioning after an ACCEPT - allows you to
control where the cursor is placed at the end of an ACCEPT
operation:
1 The default. The cursor is moved to the next character
position following the end of the current field
2 The cursor is left at its current position
* Control of whether UPDATE clauses perform implicit CONVERTS -
allows you to specify if a CONVERT clause is implied if you
specify an
UPDATE phrase:
1 The default. The CONVERT clause is not implied
2 The CONVERT clause is implied
This option is provided to enable you to emulate the
behavior of RM/COBOL, versions 2.0 and 2.1.
* Selection of the function key list to be used - allows you to
specify which function key list your system is to use to map
control codes onto user function keys:
1 The default. The standard user function key list
2 The compatibility function key list. 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
* Selection of the action for COLUMN+n clauses - allows you to
determine the number of characters advanced by this clause in the
Screen Section:
1 The default.
COLUMN+
1 will cause the field to be displayed immediately after the
preceding field; there is no gap between the two fields
2 COLUMN+1 will leave a one-character gap between the two
fields
COLUMN+n clauses, where n > 1, are treated accordingly.
This option should be set to 2 if DG-style behavior is
required.
* Selection of the default action if no color specified - allows 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
2 Text is displayed with white foreground and black background
regardless of the default color
* Control of whether cursor left/right keys can exit a field -
allows you to control whether pressing the cursor left/right keys
when positioned at the start/end of a field will move to the
previous/next field respectively:
1 The default. The keys will move to the previous/next field
2 The keys cannot exit a field
* Left Justification of free-format edited numerics - allows you to
control whether free-format edited numeric fields are
left-justified as they are entered:
1 The default. The field is not left-justified
2 The field is left-justified provided RM-numeric handling is
switched off
* Validation control on FULL/REQUIRED fields - allows you to control
whether all fields with FULL or REQUIRED defined must have the
appropriate conditions satisfied before termination of an accept
is possible:
1 The default. Any field which has not been changed by the
user is not validated
2 All fields with FULL or REQUIRED must have valid contents
before the accept can be terminated
* Control of ADIS keys defined as function keys - allows you to
control how an ADIS key behaves when defined as a function key:
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 The default. Any ADIS key set up as a function key will
terminate the accept regardless of the function mapping
* Control of the read screen option for an accept - allows you to
control the facility that allows the initial contents of an accept
field to be read from the current screen contents:
1 The default. No screen read occurs. The initial contents
of the field are unaltered
2 The initial contents of the field are read from the screen
provided that pre-display of the field is disabled
* Control of special action for Kanji modifier characters
- allows you to control the behavior of the Kanji modifier
characters, daku-on and han-daku-on, if you specify them during an
ACCEPT operation:
1 The default. The modifier characters are treated the same
as all other characters
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 is only relevant if a double-byte character set is in
use.
* Selection of the units used when calculating TIMEOUT on an accept
- allows you to state the timeout in units of seconds or tenths of
a second:
1 Units used are seconds
2 Units used are tenths of a second
* Control of the timer used to calculate accept TIMEOUT - allows 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:
1 The timer is never reset. Timeout will occur at the
specified length of time after the accept is initiated
2 Timeout is reset to its original value each time a character
is entered.
Press Escape to return to the Alter Configuration menu.
Altering Tab Stop Options
Pressing F4 on the Alter Configuration menu displays the submenu which
allows you to set up to 96 tab stops (used at run time). This submenu
displays 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-left and
cursor-right keys to move the cursor along the ruler. Press one of the
following keys to perform the function of your choice:
F2 Set Tab Stop - sets a tab stop at the current
cursor position. A "T" is displayed to show the
new tab stop
F3 Delete Tab Stop - deletes any existing tab stop at
the current cursor position. The "T" showing its
position is also deleted
F4 Finish Editing Tab Stops - saves the changes you
have made to the positions of the tab stops, and
returns to the Alter Configuration menu
Press Escape to return to the Alter Configuration menu.
Altering Indicators
Pressing F5 on the Alter Configuration menu displays the submenu which
allows 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.
Press one of the following keys to select the message you wish to alter:
F2 Insert/Replace - allows you to create your own messages for the
insert/replace indicators and the clear insert/replace indicators
F3 Off end of field - allows you to create your own messages for the
off-end-of-field and clear off-end-of-field indicators
F4 Auto Clear - allows you to create your own messages for the
auto-clear and clear auto-clear indicators
Alter the message, and press Enter to accept the changes and return to
the menu. Alternatively, pressing Escape causes any changes to be
ignored.
Only a limited amount of space in a configuration is available for
indicator message text. If the new messages which you create are
too large to fit into the amount of space you have left in your
configuration, the following warning is displayed:
There is not enough room for that indicator text
If you receive this warning, you must write a shorter message.
Once you have successfully entered your messages press Escape to return
to the Alter Configuration menu.
Altering Messages
Pressing F6 on the Alter Configuration Menu displays the Altering
Messages submenu which allows 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.
Press F2 to alter all of the messages. The current text of each message
and the conditions under which it is output are displayed in turn; one
message per screen. Press Enter to cycle from one screen to the next or
press Escape to return to the menu. To alter any message simply type the
text of the new message at the prompt on the relevant screen. You can
alter as few or as many messages as you wish.
Press F3 to alter individual messages. This displays a list of the
currently defined messages with a number by the side of each. Press F2
to toggle to the next screen of available messages. Type the number of
the message you want to change, or position the cursor on the relevant
line, using the cursor up and down keys. Press Enter to select that
message. The message currently configured for that
error condition is displayed. Simply type the new message at the prompt
on the screen. Press Enter to return to the list of messages.
You can alter the messages for the following conditions:
Abort confirmation when the ABORT key is pressed
Field must be completely filled
Field must not be left empty
The cursor is at the end of field
The cursor is past the end of field
Data has been lost from end of field
Insertion is not possible at this point
Deletion is not possible at this point
Keystroke is invalid at this point
No more fields beyond this point
Character case conversion is invalid here
Nothing available to retype
Nothing available to restore
Leading digits are not in valid range
Trailing digits are not in valid range
Sign has been used incorrectly
Negative value cannot be entered here
No room for a two byte character
No more than one decimal point is allowed
Numeric digits must be entered here
Only a limited amount of space in a configuration is available for
message texts.
If the new messages which you create are too large to fit into the amount
of space you have left in your configuration, the following warning is
displayed:
There is not enough room for that message
If you receive this warning, you must write a shorter message.
Once you have successfully entered your messages press Escape to return
to the Alter Configuration menu.
Altering Message and Indicator Positions
Pressing F7 on the Alter Configuration menu displays the submenu which
allows you to control if you want the messages and indicators, normally
displayed by ADIS during an ACCEPT operation, to be displayed or not. It
also allows you to alter the position on the screen at which they are
displayed, if you choose for them to be displayed.
Use the cursor keys to move around the screen from field to field. If
you wish error messages or a specific indicator to be displayed during an
ACCEPT operation enter Y at the relevant field. Enter N if you do not
wish them to be displayed. Note that 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 delete
any text currently configured for this message. Enter the Altering
Messages submenu to do this.
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 lines and columns 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 will cause 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 if you do not wish to save your changes, or have
made none.
Altering ADIS Key Control
Pressing F8 on the Alter Configuration menu displays the submenu which
allows you to alter the function performed by any specific key, make a
key act as an ADIS function key, or disable it completely. An ADIS
function key is a key which is used during an ACCEPT operation to perform
an editing function; for example move the cursor.
Press F2 to enable or disable ADIS control keys. A list of all the
functions performed by the ADIS function keys is displayed, together with
the current status of each key. You can alter the status of any key to
be one of the following:
D disabled - that key does not perform its associated
function during an ACCEPT operation
E enabled - that key performs its associated function
during an ACCEPT operation
F function key - that key acts as a function key
during an ACCEPT operation
Use the cursor keys to move from field to field on the screen and type
the required letter in the field(s) you wish to alter.
Press F3 to display a list of all the available function keys and their
current editing function. The function normally associated with a key
need not be: you can map any function to any key. Each function key has
three fields associated with it which you can alter:
Mapping field 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 wish to
alter this.
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.
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.
The table below shows the default settings of each of the above fields
for all of the ADIS function keys.
ADIS Function Key Mapped to:
No. Name Validate Align No. Name
0 Terminate accept [Y] [N] [ 0] Terminate accept
1 Terminate program [Y] [N] [ 1] Terminate program
2 Carriage Return [Y] [N] [ 0] Terminate accept
3 Cursor left [Y] [N] [ 3] Cursor left
4 Cursor right [Y] [N] [ 4] Cursor right
5 Cursor up [Y] [N] [ 5] Cursor up
6 Cursor down [Y] [N] [ 6] Cursor down
7 Move to start of screen [Y] [N] [ 7] Move to start of screen
8 Move to next tab stop [Y] [N] [ 11] Move to next field
9 Move to previous tab [Y] [N] [ 12] Move to previous field
10 Move to end of screen [Y] [N] [ 10] Move to end of screen
11 Move to next field [Y] [N] [ 11] Move to next field
12 Move to previous field [Y] [N] [ 12] Move to previous field
13 Change case of character [Y] [N] [ 13] Change case of character
14 Backspace (erase) [Y] [N] [ 14] Backspace (erase)
character
15 Retype erased character [Y] [N] [ 15] Retype erased character
16 Insert single character [Y] [N] [ 16] Insert single character
17 Delete character [Y] [N] [ 17] Delete character
18 Restore deleted [Y] [N] [ 18] Restore deleted character
19 Clear to end of field [Y] [N] [ 19] Clear to end of field
20 Clear field [Y] [N] [ 20] Clear field
21 Clear to end of screen [Y] [N] [ 21] Clear to end of screen
22 Clear screen [Y] [N] [ 22] Clear screen
23 Set insert mode [Y] [N] [ 58] Insert toggle
24 Set replace mode [-] [-] [255] Undefined
25 Reset field (Undo) [Y] [N] [ 25] Reset field (Undo)
26 Move to start of field [Y] [N] [ 26] Move to start of field
Other values that can be mapped to:
55: RM Clear Field 56: RM Back Space 57: RM Tab
58: Insert Toggle 59: Replace Toggle 60: ForwardsTab
61: Backwards Tab 62: Restore 255: Undefined
Press Enter in either submenu once you have made your entries, to return
to the Alter Configuration menu and save your changes.
Press Escape in either submenu to return to the Alter Configuration menu
if you do not wish to save your changes, or you have made none.
The Load Option.
Selecting the Load option by pressing F3 on the main menu loads an
existing configuration into memory. You must load a configuration into
memory before you can make any changes to that particular configuration.
When you select the Load option ADISCF displays a screen on which the
available configurations in ADISCTRL are listed, as shown in Figure 21-3
.
Note: The configurations listed in Figure 21-3 may vary according
to the version of the software.
The configuration currently loaded appears highlighted on your screen.
In the above example this is the Default Configuration. To select the
configuration which you require, enter its number at the prompt, or
position the cursor on the line specifying the required configuration,
using the cursor-up and cursor-down keys. You will notice that 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 selected the configuration you require, press the Enter
key.
ADISCF
loads the configuration you have selected into memory from the ADISCTRL
file.
You are then returned to the main menu. You will notice that the
configuration you have just selected appears on the information line.
You can now alter this configuration by selecting the Alter option.
![[]](../../pic3k/M013032/FFN213c50.gif)
Figure 21-3. The Load Menu
The Save Option.
Once you have altered a configuration, using the Alter option, pressing
F4 on the main menu allows 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.
Press the relevant key to select the option of your choice:
F2 New configuration - saves your configuration as a
new configuration within ADISCTRL. You are prompted
to type the name of this configuration.
F3 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. This line now appears
highlighted.
Once you have made your entry, press the Enter key in either submenu to
return to the main menu and
save your configuration.
Press Escape in either submenu to return to the main menu if you do not
wish to save your configuration.
Note that you can store up to 16 configurations in ADISCTRL. If you try
to save more than this number you will 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.
The Delete Option.
To delete an existing configuration from the ADISCTRL file, select the
delete option on the main menu by pressing F5.
ADISCF then displays a screen listing the existing configurations. The
current configuration appears highlighted. Choose the configuration you
wish to delete by entering its number to the prompt, or by using the
cursor up and down keys.
Press Enter to delete the selected configuration. You are now returned
to the main menu and the selected configuration is deleted from the
ADISCTRL file.
Note: You cannot delete the configuration which is currently selected.
If you wish to delete this you must first use the Choose option
to choose an alternative configuration.
The Choose Option.
Select the
Choose option from the main menu by pressing F6. This allows you to
choose the configuration to be used by ADIS when you run your programs.
ADISCF displays a screen which lists the available configurations. The
one currently active appears 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 up and
down keys. This line now appears highlighted.
Press Enter to choose the selected configuration. This configuration
becomes the active configuration and you are returned to the main ADISCF
menu. When you next run a program using your COBOL system, ADIS will
automatically use the configuration you have just chosen.
Press Escape to return to the main menu if you do not wish to choose a
configuration. The current configuration is still used by ADIS when you
next run a program using your COBOL system.