INITIATING DICTCDE [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation
DICTIONARY 3000
INITIATING DICTCDE
DICTCDE can be initiated from within a session or from within a job
stream. The following describes how to execute DICTCDE interactively
(from within a session). For information on how to execute DICTCDE from
within a job stream, see Changing Input, List and Output Files discussed
later in this section.
DICTCDE assumes that the Dictionary resides in DICT.PUB of the logon
account. To redefine the Dictionary, you can use an MPE file equation or
you can use the option provided by DICTCDE to change the Dictionary.
(The Dictionary option is discussed in detail later in this section.)
To execute DICTCDE, enter the following MPE command:
RUN DICTCDE.PUB.SYS
After the DICTCDE banner is displayed, the following message and prompt
are issued:
Type ? at any prompt for help
Dictionary password>
The above message indicates that the Help facility can be invoked by
entering a question mark (?) in response to any prompt. The Help
facility gives a brief description of the prompt in question.
Enter the password for the Dictionary. If the Dictionary password is
entered incorrectly or is an invalid password for the Dictionary, DICTCDE
will issue the following error message:
Password is invalid
DICTCDE will then continue to prompt for the Dictionary password until a
valid password is entered. If [[RETURN]] is pressed in response to this
prompt, DICTCDE will terminate.
If DICTCDE cannot open the Dictionary, the following error message are
issued:
ERROR: Cannot open dictionary dictionary name
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. DICTCDE will then ask for a new
Dictionary to be entered and will also prompt for the password for that
Dictionary.
Once the specified Dictionary and password have been accepted by DICTCDE,
the following prompt is issued:
Copylib file name>
Enter the COBOL copylib file name to which you are directing the
generated source code. The copylib file name may be up to 35 characters
maximum and may be fully qualified and have a lockword. The name must be
a valid MPE file name. If the specified copylib file already exists,
DICTCDE will open that copylib file and append any source code generated
to the contents of that file. If the specified file name exists, but it
is not in KSAM copylib format, DICTCDE will issue an error message and
then reprompt for the copylib file name. If the specified file name does
not exist, DICTCDE will issue the following prompt:
File filename does not exist, create it (N/Y)>
Enter Y to create the specified copylib file. If N, ], ]], [[RETURN]],
or [[CONTROL]] Y is entered in response to this prompt, DICTCDE will
again prompt for the Copylib file name.
Since a COBOL copylib is in KSAM file format, a key file must be
associated with the KSAM copylib file. Before DICTCDE creates a new KSAM
copylib file, you are prompted for the key file name for the new copylib
as follows:
Key file name>
Enter the copylib key file name (8 characters maximum) for the new
copylib file. This file will be created in the group and account you
logged on with. Since this file can not be qualified, you should log on
to the group and account you would like this file to be created in.
If ], ]], [[RETURN]] or [[CONTROL]] Y is entered in response to this
prompt, DICTCDE will reprompt for the copylib file name.
If [[RETURN]] is pressed in response to the Copylib file name prompt,
DICTCDE will terminate.
MPE/iX 5.0 Documentation