>ALTER ALL [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation
DICTIONARY 3000
>ALTER ALL
Changes all the options used for generating PASCAL data declarations for
the entities extracted from the Dictionary.
Prompts
The following prompts are issued when the command-subcommand ALTER ALL is
entered:
________________________________________________
| |
| DICTIONARY NAME (current dictionary)> |
| DICTIONARY PASSWORD> |
| SOURCE OUTPUT FILE (<current file)> |
| EXTRACT AS TYPE OR VAR (T/V)> |
| GENERATE COMMENTS (N/Y)> |
| GENERATE NAMES AS STRING CONSTANTS (N/Y)>|
| GENERATE TABLES FOR VPLUS EXTRACTS (N/Y)>|
| LOWER OR UPPER CASE (L/U)> |
________________________________________________
When ALTER ALL is used, the above prompts are issued one at a time.
(After a response is made to one prompt, the next prompt is issued.)
Note that the ALTER ALL command-subcommand generates all the prompts
issued for the other ALTER subcommands. The following explains each of
the above prompts in detail:
Discussion
DICTIONARY NAME (current Enter the Dictionary name, group and account to
dictionary)> be opened and used for further code generation.
DICTPDE displays the current Dictionary being
used in (current dictionary). Data and file
definitions are extracted from the new
Dictionary specified until a new ALTER DICT
command-subcommand is used.
Pressing [[RETURN]] in response to this prompt
indicates that the Dictionary as displayed in
(current dictionary) does not change. (The
password prompt will not be issued.)
If an invalid Dictionary is entered in response
to this prompt, DICTPDE will issue an error
message and reprompt for the Dictionary name.
DICTPDE will continue to prompt for the
Dictionary name until a valid Dictionary name
is entered or DICTPDE is terminated.
DICTIONARY PASSWORD> Enter the Dictionary password for the new
Dictionary to be used. The password entered
must grant at least REPORT level access to that
Dictionary. If the new Dictionary specified is
the same as the previous Dictionary, the
password prompt will not be issued.
If an invalid password is entered in response
to this prompt, DICTPDE will issue an error
message and reprompt for the Dictionary
password. DICTPDE will continue to prompt for
the Dictionary password until a valid password
is entered or DICTPDE is terminated.
When a new Dictionary name and valid password
are entered, DICTPDE closes the previous
Dictionary used and opens the new Dictionary to
be used.
SOURCE OUTPUT FILE Enter the name of the file to redirect output
(current output file)> to. This output includes the data declarations
generated by DICTPDE and, if specified, the
string constants generated for the entity
names. DICTPDE displays the current output
file as (current output file). (current output
file) will be DICTOUT unless otherwise
specified by an earlier ALTER OUTPUT
command-subcommand or an MPE file equation was
used to redirect DICTOUT.
Output may be directed to a new or existing
disc file (ASCII, fixed file of 80 bytes) or to
the terminal. If the specified file is a new
file, DICTPDE will build the file for you. If
the specified file already exists, DICTPDE will
issue a warning message and append the
generated source code to the existing contents
of the specified file. To direct this output
to the terminal instead of to a disc file,
enter $STDLIST in response to this prompt.
Pressing [[RETURN]] in response to this prompt
indicates that the output file does not change.
This means that if no previous output file had
been specified by an ALTER OUTPUT command, then
the output file would still be DICTOUT. If a
file had been specified by a previous ALTER
OUTPUT command, that file would remain the
output file.
EXTRACT AS TYPE OR VAR Enter T (or press [[RETURN]]) if the extracted
(T/V)> data definitions are to be generated as TYPE
data declarations. Enter V if the data
definitions extracted are to be generated as
VAR data declarations. Note that DICTPDE
assumes that the definitions are to be
generated as TYPE declarations unless V is
entered in response to this prompt.
Pressing [[RETURN]] in response to this prompt
indicates that the data definitions are to be
generated as TYPE data declarations.
GENERATE COMMENTS (N/Y)> Enter Y to generate comment lines which
describe the entities extracted from the
Dictionary. These comment lines are written to
the output file along with the data
declarations and, if specified, the string
constants generated for the file names.
DICTPDE assumes that comment lines are not
generated unless Y is entered in response to
this prompt.
Pressing [[RETURN]] in response to this prompt
indicates that no comment lines are generated
for the extracted entities from the Dictionary.
GENERATE NAMES AS STRING Enter Y if PASCAL string constants are to be
CONSTANTS (N/Y)> generated for the specified file names
extracted from the Dictionary. DICTPDE assumes
that string constants are not to be generated
for the file names unless Y is entered in
response to this prompt.
Pressing [[RETURN]] in response to this prompt
indicates that string constants are not to be
generated.
GENERATE TABLES FOR Enter Y to generate PASCAL arrays for the
VPLUS EXTRACTS (N/Y)> fields in a VPLUS form in addition to the data
declarations generated for the form. DICTPDE
assumes that no arrays are generated unless Y
is entered in response to this prompt.
Pressing [[RETURN]] in response to this prompt
indicates that no additional arrays are
generated for a VPLUS form.
LOWER OR UPPER CASE Enter U if the generated code is to be written
(L/U)> in UPPER CASE characters to the output file.
Enter L if the generated code is to be written
in LOWER CASE characters. DICTPDE assumes the
generated code will be written in LOWER CASE
characters to the output file unless U is
entered in response to this prompt.
Pressing [[RETURN]] in response to this prompt
indicates that the generated code will be
written in LOWER CASE characters to the output
file.
MPE/iX 5.0 Documentation