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

Chapter 11 91

SDVPD Commands

DEFINE Command

Before the forms ﬁle deﬁnitions can be loaded, the dictionary must be opened. When

opening the dictionary for the ﬁrst time, the scope name and scope password are required.

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]]

{.}

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 by which the deﬁnitions are to be

loaded. This parameter is required when opening the

dictionary for the ﬁrst time.

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. Specify

two consecutive quotes (“”) if a double quotation mark is

desired as part of the password.

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

command prompt. 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: