HP System Dictionary/XL Utilities Reference Manual - Part 1 SDDBD (32256-90003)

Chapter 7 61

SDDBC Commands

DEFINE COMMAND

Before the schema and root ﬁle for an Image database can be created, the dictionary must

be opened. When opening the dictionary, the scope name and scope password are required.

Once the dictionary is opened, one can redeﬁne other options to change the environment

while in a session.

Syntax

DEFINE [;DICTIONARY=dictionary-filename]

[;SCOPE=scope-name]

[;PASSWORD=[scope-password]]

[;OPEN-MODE=open-mode]

[;NAME-MODE=name-mode]

[;DOMAIN=[domain-name]]

[;VERSION=version-name]

[;STATUS=version-status]

{.}

Parameters

dictionary-filename:

Filename of the dictionary to be opened. The default for this

parameter is SYSDIC if not speciﬁed when opening the dictionary.

scope-name:

Name of the scope to retrieve deﬁnitions from. This parameter is required

when opening the dictionary.

scope-password:

Gives access to the scope. Any characters are allowed in a password.If

a character in the password is NOT valid in other System Dictionary

names (i. e., is on the restricted list), the password must be entered inside

a pair of quotes to allow recognition of the 'restricted' characters.

If the SCOPE parameter is speciﬁed and the PASSWORD parameter is

not, you will be prompted for the password. For security reasons, the echo

is turned off and you are given three chances to enter the correct

password. If you are running the program interactively and the correct

password is not entered after three tries, the DEFINE command will

terminate and you will be returned to the highest prompt level. If you are

running the program in batch mode and the correct password is not

entered after three tries, the program will terminate. The password is

always read from $STDIN.

open-mode:

Speciﬁes which mode to open the dictionary with. The valid choices are:

read-allow-read

read-only

shared-update

exclusive-update