HP 3000 Manuals HP 3000 Manuals
DICT3000 COMMAND
The DICT3000 command is used to specify the Dictionary/V dictionary whose
definitions are to be converted into the System Dictionary format. It
also enables you to enter other parameters related to the definition
loading process. It is assumed that the person running SDCONV is the
creator of the dictionary. If this is not the case, the command will
fail.
Note that the DICT3000 command will attempt to use defaults for any two
of the NAME, PASSWORD, and OPEN-MODE parameters if they are not specified
in the command. In other words, you must actually specify at least one
of the three to open the dictionary. Otherwise, the command will fail.
The command has the following format:
DICT3000 parameter-1meter-2;...parameter-n.
As in the SYSDIC command, the ending period completes the command. The
following parameters are accepted by this command:
NAME Parameter
This parameter specifies the name of the Dictionary/V dictionary whose
definitions are to be converted. It has the format:
NAME = <Dictionary/V dictionary name>
OPEN-MODE Parameter
This parameter is used to specify the Dictionary/V dictionary open mode,
and has the following format:
OPEN-MODE = <open mode>
As with the PASSWORD or NAME parameter, this parameter causes any open
dictionary to be closed, and the dictionary with the new open-mode to be
opened. The value should be between 1 and 8 as explained in the
TurboIMAGE/V manual. The default for this parameter is 8.
SCOPE-OWNER Parameter
When loading Dictionary/V definitions into the System Dictionary, a
number of items may be mapped into the scope-owner System Dictionary
attribute. Most of the Dictionary/V entity definitions have the
xxxx_RESP field which contains the name of the user who is responsible
for maintaining the particular entity. On the other hand, every
Dictionary/V entity and relationship has the IDENTITY-CREATE field.
Through the SCOPE-OWNER parameter, you can have the RESPONSIBLE field,
IDENTITY-CREATE field, or the current logon scope name mapped into the
scope-owner attribute. This parameter takes the following form:
SCOPE-OWNER = RESPONSIBLE or IDENTITY-CREATE or LOGON
If RESPONSIBLE is assigned, the responsible user's name will be first
examined. If it is blank, then the value of the IDENTITY-CREATE field
will be used for the scope-owner attribute. If IDENTITY-CREATE is
specified, the value of that field will automatically be used. If LOGON
is assigned, then the System Dictionary logon scope (the value of SCOPE
parameter for the SYSDIC command) is used. Note that if either
RESPONSIBLE or IDENTITY-CREATE is specified, value of the field is
examined to see if such a scope exists in the System Dictionary. If not,
the new scope is first created, the System Dictionary scope is switched
to the new one, and then the definition is loaded. The default for this
parameter is LOGON.
NOTE Do not specify the RESPONSIBLE and IDENTITY-CREATE if the logon
scope does not have the capability to create scope (secure scope
capability). Specifying either one of these without the capability
will result in an operational error at loading time.
BACK-REFERENCE Parameter
This parameter enables you to link the attributes of the RECORD contains
ELEMENT relationship or ELEMENT contains ELEMENT relationship to the
child ELEMENT entity's attributes. If this switch is ON, the
back-reference-flag attribute of the relationship is set to true, and the
attributes that have corresponding attributes on the element entity will
contain undefined values. On the other hand, if BACK-REFERENCE = OFF,
then the back-reference-flag attribute is set to false, and the
relationship attributes that have corresponding attributes on the child
ELEMENT entity will be initialized with values of the entity attributes.
The attributes common between the relationship and the entity are listed
below:
element-type
display-length
decimal
blank
justify
edit-mask (variable length attribute)
entry-text (variable length attribute)
heading-text (variable length attribute)
Note that no matter what the value of BACK-REFERENCE parameter is, the
description variable length attribute on the relationship will always
contain the description text from the Dictionary/V dictionary, i.e.,
SDCONV assumes that the description attribute never "back-references."
This parameter has the following format:
BACK-REFERENCE = ON or OFF.
The default is ON.
ALIAS Parameter
In Dictionary/V, only some relationship types have the ALIAS field, while
in the System Dictionary, each entity/relationship can have a number of
aliases associated to it. Therefore, when mapping this Dictionary/V
ALIAS field, SDCONV must choose the most appropriate System Dictionary
alias field for the particular relationship. For example, if you are
converting an entry from the FILE-ELEMENT detail set (relationship) with
the file type = MAST, then the obvious System Dictionary destination
alias is the image-alias, since the file in question is an TurboIMAGE/V
file. However, for some others, the destination is not so clear. Hence,
SDCONV provides the ALIAS parameter with which you can specify which
System Dictionary alias will be the destination of the Dictionary/V ALIAS
field with unclear destination. Check the description of detail set
conversion to see whether a particular ALIAS field in Dictionary/V has a
fixed alias destination.
The format of the parameter is
ALIAS = COBOL, IMAGE, PASCAL, STANDARD, VPLUS or HPSQL
The table below shows what each parameter value stands for.
parm value destination alias
COBOL cobol-alias
IMAGE image-alias
PASCAL pascal-alias
STANDARD standard-alias
VPLUS vplus-alias
HPSQL hpsql-alias
The default for this parameter is STANDARD.
SENSITIVITY Parameter
This parameter specifies the sensitivity attribute with which each System
Dictionary definition is created. You can assign READ, MODIFY, or
PRIVATE to the sensitivity parameter in the following fashion:
SENSITIVITY = READ or MODIFY or PRIVATE
If you issue LOAD with PRIVATE SENSITIVITY and SCOPE-OWNER = RESPONSIBLE
or IDENTITY-CREATE, SDCONV will issue an error message and does not
proceed with the loading process, because such a combination may cause
problems while creating relationships. For example, If entity E1 created
by scope S1 , entity E2 by scope S2 , then, S2 needs at least the READ
sensitivity to establish a relationship between E1 and E2 . Hence, the
PRIVATE sensitivity will be considered invalid altogether if SCOPE-OWNER
is not LOGON. The default for this parameter is READ.
PACK-DESCRIPTION Parameter
This parameter specifies how the DESCRIPTION text which is returned from
Dictionary/V will be converted to System Dictionary. This parameter has
the following form:
PACK DESCRIPTION = ON or OFF
If ON is specified, extra trailing blanks will be removed from each line
of text, and, to save storage space, line boundaries will be ignored. If
OFF is specified, text will be converted line by line as it is stored in
the dictionary. Although it requires more storage space than ON, OFF is
useful for maintaining column or outline format when converting text.
The default for this parameter is OFF.
QUIET/VERBOSE Switch
Sometimes, it is helpful to see how the loading process is proceeding.
If you specify the VERBOSE switch, a message will be given for each
entity and relationship processed. The QUIET switch, on the other hand,
suppresses the report of successful entity/relationship definition
loading. QUIET/VERBOSE switch is specified in the following fashion:
QUIET; or VERBOSE;
The default is QUIET.