HP 3000 Manuals HP 3000 Manuals
IMAGE Command
The IMAGE command is used to specify the IMAGE database whose definitions
are to be loaded into the dictionary.
Syntax
IMAGE [;DATABASE=data-base-name]
[;PASSWORD=[password]]
[;OPEN-MODE=open-mode]
[;BACK-REFERENCE=back-reference-flag]
[;SENSITIVITY=sensitivity]
[;COMPATIBILITY-LEVEL=compatibility-option]
[;OPTION=flow-control-option]
[;QUIET]
[;VERBOSE]
{.}
Parameters:
data-base-name: Name of the IMAGE database whose definitions
are to be loaded. Any previously opened
database is closed and the new database is
opened. In order to open the database, at
least one of the three parameters, DATABASE,
PASSWORD, or OPEN-MODE, must be specified.
password: The IMAGE database password which gives access
to the database. Any previously opened
database will be closed and the database
specified by the new password will be opened.
If you intend to include any SDDBD separator
characters (" ", ";", "=", ".") in the
password, you must enclose the password in
quotes. If you want to include a quote in the
password, use two consecutive quotes ("").
The database creator password (";") can be
specified by entering "PASSWORD=;", i. e., the
parameter with no value.
If the IMAGE command specified contains the
DATABASE parameter, and not the PASSWORD the
password is prompted for. You will be given
three chances to give a correct password. If
you fail to do so in session mode, no IMAGE
database will be opened, and the command prompt
(>) is displayed. In batch mode, if you fail
to give the correct password, the program will
be immediately terminated. When the password
is prompted for, SDDBD reads the password value
from $STDINX regardless of whether the input
has been redirected or not.
open-mode: The IMAGE database open mode. As with the
PASSWORD or DATABASE parameters, any old
database is closed and the new database is
opened. The default is 8 (read access). See
the IMAGE Database Management System Reference
Manual (32215-90003) for more information on
the available IMAGE database open modes.
back-reference-flag: Sets the value of the back-reference-flag
attribute on the record contains element
relationship. Valid values are:
ON
OFF
If BACK-REFERENCE = ON, then the
back-reference-flag attribute is set to true.
If BACK-REFERENCE = OFF, back-reference-flag is
set to false. The default is ON.
If BACK-REFERENCE = ON, the values of the
following relationship attributes are to be
retrieved from the element entity:
element-type
display-length
decimal
blank
justify
edit-mask (variable length)
entry-text (variable length)
heading-text (variable length)
Note that the back-reference-flag attribute
only documents the location from which the
attributes should be retrieved. The System
Dictionary intrinsics will not go to the entity
to retrieve the above attributes, even if
back-reference-flag is set to true. It is each
program's responsibility to perform this
"detour" when retrieving the relationship
attributes.
If, however, back-reference-flag is set to
false, the relationship level attribute values
are to be retrieved directly from the
relationship.
It is useful to set back-reference-flag to ON
when you wish to document the fact that the
relationship attributes should always be
retrieved from the element entity. In this
way, any changes in the entity attribute values
will automatically be reflected on the
relationship level.
sensitivity: The sensitivity attribute with which each IMAGE
definition is loaded. The following values are
valid:
READ
MODIFY
PRIVATE
The default is READ.
compatibility Enables different sets of attributes to be checked for
-option determining compatibility of old element definitions.
The following options are available:
IMAGE-COMPATIBILITY
COMPLETE
If IMAGE-COMPATIBILITY is selected, then SDDBD will
check only the count, byte-length, and element-type
attribute values for compatibility. If COMPLETE is
selected, then SDDBD will also check the display-length
attribute value for compatibility. The default is
IMAGE-COMPATIBILITY.
flow-control Determines the manner in which loading will be handled
-option: when conflicts arise.
The following values are available:
PROMPT Displays the following prompt when a
conflict is found:
Skip, Replace, enter New name, or
Terminate (S/R/N/T)? >
SKIP The new definition is skipped and
not loaded.
REPLACE The new definition will replace the
old definition. The old definition
and all the relationships involving
it will be permanently deleted.
NEW A prompt for a new name is issued.
The name entered will become the
name of the entity and the original
name is assigned to the image-alias
attribute.
TERMINATE The loading process terminates
immediately.
PROMPT is the default for session mode; whereas, SKIP is
the default for batch mode.
QUIET VERBOSE Allows monitoring of the loading process, if desired.
VERBOSE produces a message for each entity and
relationship processed. To suppress the reporting of
the entities and relationships that are successfully
loaded, specify the QUIET option. The default is QUIET.
Example:
>IMAGE DATABASE=supply;
>>PASSWORD=ship;
>>OPEN-MODE=8;
>>BACK-REFERENCE=OFF;
>>SENSITIVITY=PRIVATE;
>>OPTION=NEW;
>>VERBOSE.
>