HP 3000 Manuals HP 3000 Manuals
MODIFY ENTITY
Modifies an entity.
Syntax
M[ODIFY] E[NTITY] entity-name
;E[NTITY-]T[YPE] = entity-type-name
[;A[TTRIBUTE-]L[IST]=([ attribute-name1=[attribute-value1]]
[,attribute-name2=[attribute-value2]]
.
.
.
[,attribute-nameN=[attribute-valueN]])]
[;C[OMMON] = [common-entity-name]]
.
Parameters
entity-name Name of the entity whose attributes are to be
modified.
entity-type-name Name of the type of the entity whose attributes are
to be modified.
attribute-name(N) Name of the attribute to be modified.
attribute-value(N) New value for the attribute being modified.
common-entity-name Name of the entity in the common domain whose
attributes are to be shared by the local domain
entity being modified. You cannot specify this
keyword if the dictionary is open in the common
domain. If you specify this parameter, then the
attribute list can only contain the following
attributes:
scope-owner Name of the new owner scope
sensitivity Specifies the access rights to the
entity
id-number A user-specified identification
number which is never checked for
uniqueness by System Dictionary
If you specify attributes other than these in the
attribute list, then you must not use this
parameter. If you specify COMMON and do not assign
a value to it, the existing link to the entity in
the common domain is deleted.
Description
System Dictionary automatically assigns values for the following
attributes. You cannot modify the values of these attributes.
date-created
date-changed
scope-changed
If the attribute is of type boolean, character, floating, or integer and
you specify the name, but do not assign a value, then the value from the
attribute's edit values is used. If the attribute does not have any edit
values, then the System Dictionary default value for the attribute's data
type is used.
boolean : false
character : ASCII blanks
floating : Floating point zero
integer : Binary zero
If the attribute is of type alias and you specify the name, but do not
assign a value, the alias value is deleted.
If the attribute is of type variable and you specify the name, but do not
assign a value, the variable length attribute's text is deleted.
If the attribute is of type boolean the only values allowed are true and
false (may be abbreviated T and F, respectively).
To modify or add a variable length attribute, you must specify the text
within quotes. If the attribute is already associated to the entity, the
original text is replaced with this new text. To replace only part of
the text, refer to the EDIT ENTITY command.
To create an alias attribute value, specify the alias attribute name and
assign it an alias value.
To modify an attribute of type alias or character, you must enclose the
value within quotes if it includes any invalid characters (See
"User-Defined Names" in Chapter 3) or is greater than 32 characters in
length.
If sensitivity is the attribute to be modified, the valid values are:
private Only the owner scope is allowed access to the entity,
unless it assigns access to other scopes by associating the
entity to the scope by means of the ADD SCOPE-ENTITY
command. This is the default.
read Any scope with read capability may read the entity. The
owner scope may, in addition, assign modify access to other
scopes by associating the entity to the scope by means of
the ADD SCOPE-ENTITY command.
modify Any scope with read capability may read the entity. Any
scope with create capability may read and modify the
entity.
If you modify the sensitivity from read or modify to private, all scopes
that previously had access to this entity will no longer have access,
unless the entity is explicitly associated with the scope.
If the entity is linked to an entity in the common domain, the
sensitivity for this entity cannot be changed to a sensitivity greater
than the sensitivity of the entity in the common domain.
To link the entity to an entity in the common domain, the current version
must be linked to a version in the common domain.
Open Mode: Shared-update or exclusive-update
Scope: DA scope or any scope with create capability and modify
access to the entity
Example
The following example deletes the alias attribute value for cobol-alias
and changes the type of file and minimum and maximum record sizes for the
file base01.
>MODIFY ENTITY base01;
>>ENTITY-TYPE = file;
>>ATTRIBUTE-LIST = (cobol-alias = ,
>>file-type = sequential,
>>min-record-size = 128,
>>max-record-size = 256).
>