HP 3000 Manuals

SDDBD'S FILES [ HP SYSTEM DICTIONARY XL UTILITIES-Part 1 SDDBD ] MPE/iX 5.0 Documentation


HP SYSTEM DICTIONARY XL UTILITIES-Part 1 SDDBD

SDDBD'S FILES 

The Input File 

SDDBD accepts input from the file, SDIN. It can also take input from
another MPE file by redirecting SDIN with a file equation prior to
issuing the RUN command:

     :FILE SDIN=input file 

If SDIN does not exist, or has not been redirected to another file,
$STDINX (or your terminal) will be used as the input file.

The log file (see "The Log File" below) can be saved and renamed and then
used as the input file the next time SDDBD is run.

SDOUT Report File 

SDDBD records the summarized information about the entities added,
replaced, etc., in a file with the formal file designator, SDOUT. SDOUT
can also be redirected to another MPE file by using the following file
equation:

     :FILE SDOUT = output file 

When SDDBD is run, if SDOUT is not found and there is no file equation
for SDOUT, then SDDBD creates SDOUT as a temporary file.  Upon
termination of the program, the contents of this temporary file will be
output to $STDLIST, and the file is deleted thereafter.

On the other hand, if an old SDOUT is found, the user in session mode
will be asked to confirm overwriting of the old file.  In jobs, the old
file is automatically overwritten.

SDOUT Report 

When the output is formatted, each record in the report has the following
format:

     <Entity name> <IMAGE Alias> <Entity type> <Attributes> <Action>

Attribute Output Format.  Attributes are listed for the IMAGE data items,
data sets, and records.  The format for each of these attribute types is
shown below.

Data Item Attribute Format.  For IMAGE data items, the attributes are
formatted as follows:

     <element-type> (<byte-length>, <display-length>, <count>)

Data Set Attribute Format.  The attributes for data sets are formatted as
follows:

     <image-dataset-type>

The available data set types are:

M                for manual master data sets
A                for automatic master data sets
D                for detail data sets

Record Attribute Format.  The attributes for records are formatted as
follows:

     <blanks> (<byte-length>)

Action Report.  SDOUT report lists the action that occurred for each
entity as it was encountered during the loading process.  The Action
column in the report may show one of the values listed below:

SKIPPED          The new definition was skipped because a SKIP was
                 requested for conflict occurrences.

REPLACED         The existing definition was modified to the new
                 definitions' attribute values.

ADDED            The new definition was successfully added to the System
                 Dictionary.

TERMINATED       The loading process terminated at this entity because of
                 a conflict.The entity with the TERMINATED action was not
                 loaded.

ERROR            An error has occurred while loading the definition.This
                 usually represents a more serious error.

OLD USED         A compatible entity definition was found in the
                 dictionary, and the new entity definition was not
                 loaded.  The relationships were still established using
                 the old definition.

The Log File 

When SDDBD is executed, all valid commands are logged to a file with the
formal file designator, SDLOG. This enables you to save the commands and
use them at a later date.

The REDO command and any invalid commands are not logged, but the command
edited and executed through REDO is logged.  In addition, any responses
to prompts (either valid or invalid) will be omitted from the log file.

When SDDBD is run in a session, if SDLOG already exists, SDDBD will ask
for permission to overwrite the old log file.  If the response is
negative, logging is disabled.  In batch mode, the old file is
automatically overwritten.  If no old log file is found and no file
equation for SDLOG is found, SDDBD will create the file.  This file is
temporary, however, and must be saved to become a permanent file.  If
SDLOG is newly created, you will receive a message telling you to save
the file upon termination of the program.


MPE/iX 5.0 Documentation