VPLUS Command [ HP SYSTEM DICTIONARY XL UTILITIES-Part 3 SDVPD ] MPE/iX 5.0 Documentation
HP SYSTEM DICTIONARY XL UTILITIES-Part 3 SDVPD
VPLUS Command
The VPLUS command is used to specify the VPLUS forms file whose
definitions are to be loaded into System Dictionary, plus other
parameters related to the definition loading process.
Syntax
VPLUS [;FORMSFILE=formsfile-name]
[;SENSITIVITY=sensitivity]
[;CHAR=char-conv-option]
[;HYPHEN=hyphen-option]
[;COMPATIBILITY-LEVEL=compatibility-option]
[;CHECK-ELEM-TYPE=check-elem-type-option]
[;OPTION=flow-control-option]
[;QUIET]
[;VERBOSE]
{.}
Parameters:
formsfile-name: Name of the VPLUS forms file whose definitions are to
be loaded into System Dictionary. Note that when you
issue a VPLUS command, the forms file is open only
when the FORMSFILE parameter is included. There is
no default for this parameter.
sensitivity: Specifies the sensitivity attribute with which each
VPLUS definition is loaded. The following attributes
are available:
READ
MODIFY
PRIVATE
The default is READ.
char-conv-option: Enables conversion of data types of all non-character
forms file fields in System Dictionary into either
type "X" or type "9". The following options are
available:
OFF
X or ON
9
When OFF is selected, no conversion is done. When X
or ON is selected, all non-character fields in the
dictionary are converted to type "X" and the
byte-length attribute value is set to that of the
display-length attribute value. When "9" is
selected, all fields of VPLUS character type DIG that
are in the dictionary are converted to type "9" and
all other VPLUS fields are converted to type "X".
When 9 is selected, the byte-length attribute value
is also set to that of the display-length attribute
value. The default is OFF.
hyphen-option: Enables conversion of underscores to hyphens. This
parameter should be set to ON if the forms file's
element definitions will be used by other subsystems
that do not recognize the underscore as a part of a
name (e. g., IMAGE). The following options are
available:
ON
OFF
The default is OFF.
check-elem-type- Specifies whether element type checking should be
option: included in determining compatibility of old element
definitions. The following options are available:
ON
OFF
If ON is selected, the element type of the old
element definitions will be checked. The old
definition will be considered compatible only if the
element types are the same. However, if this
parameter is OFF, the element type is not included in
the determination of compatibility of old element
definitions. As a result, more compatible element
definitions may be encountered if OFF is specified.
The default is ON.
compatibility- Enables different sets of attributes to be checked
option: for determining compatibility of old element
definition. The following options are available:
VPLUS-COMPATIBILITY
COMPLETE
If VPLUS-COMPATIBILITY is selected then SDVPD will
check only the display-length attribute value for
compatibility. If COMPLETE is selected then SDVPD
will check the display-length, element-type,
byte-length, and decimal attribute values for
compatibility. The default is VPLUS-COMPATIBILITY.
flow-control- Determines the manner in which loading will be
option: handled 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 vplus-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 reporting of the
entities and relationships successfully loaded,
specify the QUIET option.
Example:
> VPLUS
>> FORMSFILE = earnings;
>> SENSITIVITY = read;
>> CHAR = OFF;
>> HYPHEN = ON;
>> OPTION = SKIP;
>> QUIET.
>
MPE/iX 5.0 Documentation