Initiating DICTPDE [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation
DICTIONARY 3000
Initiating DICTPDE
DICTPDE can be initiated from within a session or from within a job
stream. When initiated from within a session, DICTPDE can be executed to
accept commands from a command file or DICTPDE can be run interactively
(commands are entered at the terminal). When initiated from within a job
stream, DICTPDE can be executed to accept commands from a command file or
from the job stream itself.
The following describes how to execute DICTPDE interactively (from within
a session). For information on how to execute DICPTDE to accept commands
from a command file (either in a session or a job stream) see Changing
Input, List and Output Files later in this section.
DICTPDE assumes that the Dictionary resides in DICT.PUB of the logon
account. To redefine the Dictionary, you can use an MPE file equation or
the ALTER DICT command-subcommand. (ALTER DICT is discussed in detail
later in this section.)
To execute DICTPDE, enter the following MPE command:
RUN DICTPDE.PUB.SYS
After the DICTPDE banner is displayed, the following prompt is issued:
DICTIONARY PASSWORD>
Enter the password for the Dictionary. If the Dictionary password was
entered incorrectly or was an invalid password for that Dictionary,
DICTPDE will issue the following error message:
*DICT ERROR: INVALID PASSWORD. CAN NOT OPEN DICTIONARY!
The DICTIONARY PASSWORD prompt will then be reissued.
If DICTPDE can not open the Dictionary, the following error message will
be issued:
*DICT ERROR: CAN NOT OPEN DICTIONARY!
Check to see that the Dictionary is in the correct group and account. If
a file equation was used to redirect the Dictionary, check that the
Dictionary name was entered correctly. DICTPDE will then issue a prompt
that identifies the current Dictionary and asks for a new Dictionary to
be entered. Once the specified Dictionary and password have been
accepted, DICTPDE will issued an ">" which indicates that the utility is
in command mode. If you are not able to open a Dictionary to be used for
code generation, you must enter a colon (:) or hit CONTROL Y to
terminate DICTPDE. Otherwise, DICTPDE will continue to prompt for a
Dictionary name and password until a specified Dictionary can be opened.
Once DICTPDE is in command mode, you may enter any of the DICTPDE
commands.
Table 6-1 lists the DICTPDE commands and gives a brief description of
their function.
Table 6-1. The DICTPDE commands
------------------------------------------------------------------------------------------
| |
| COMMAND FUNCTION |
| |
| ALTER Changes an option for generating declarations. |
| |
| EXIT Terminates the DICTPDE utility. |
| |
| GENERATE Generates PASCAL declarations for element and file |
| definitions in the Dictionary, and for the VPLUS |
| COMAREA and IMAGE parameters. |
| |
| HELP Provides a description of the DICTPDE commands. |
| |
| LIST Displays the entities extracted from the |
| Dictionary. |
| |
------------------------------------------------------------------------------------------
Table 6-2 shows the DICTPDE Commands and their respective subcommands.
Table 6-2. The DICTPDE Commands and Their Subcommands
---------------------------------------------------------------------------------------------
| |
| ALTER EXIT GENERATE HELP LIST |
| | | | | | |
| | | | | | |
| All (None) Comarea ALTER All |
| Dict Element EXIT Element |
| Kind File GENERATE File |
| Name Imageparms HELP |
| Output LIST |
| Shift |
| Text |
| Vplus |
| |
---------------------------------------------------------------------------------------------
MPE/iX 5.0 Documentation