Dictionary/3000 Reference Manual (32244-90001)

196 Chapter6
The Dictionary DICTPDE Utility
>ALTER OUTPUT
>ALTER OUTPUT
Changes the output file that the PASCAL data declarations will be written to.
Prompts
The following prompt is issued when the command-subcommand ALTER OUTPUT is
entered:
SOURCE OUTPUT FILE (current output file )>
SOURCE OUTPUT FILE (current
output file)> Enter the name of the file to redirect output 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 specified otherwise by an earlier ALTER OUTPUT command-
subcommand or an MPE file equation 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,
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.
Discussion
ALTER OUTPUT allows you to change the output file to a specified disc file or to the
terminal without using an MPE file equation to redirect DICTOUT. (The file equation is
used before running DICTPDE.) DICTPDE also allows you to alternate the output files
while running DICTPDE. For instance, VAR declarations could be generated and written
to one output file and TYPE declarations could be generated and written to a different file.
Then all VAR declarations would be kept in one file and all TYPE declarations would be
kept in a different file. (See the ALTER KIND command-subcommand for alternating the
kinds of declarations generated.)
Example
>alter output
SOURCE OUTPUT FILE (DICTOUT)> pasout.pub.howe
The output file is changed fromDICTOUT toPASOUT.PUB.HOWE. Any subsequent code
generated will be written toPASOUT.PUB.HOWE until a newALTER OUTPUT
command-subcommand is used.