HP 3000 Manuals

SDCreateEntType [ HP System Dictionary XL Intrinsics ] MPE/iX 5.0 Documentation


HP System Dictionary XL Intrinsics

SDCreateEntType 

Creates a new entity type in the dictionary structure.

Syntax 

     SDCreateEntType (Dcb,NewEntityType,Status)

Parameters 

Dcb                 Required input; type = DcbType 
                    This parameter passes information about the
                    dictionary to this intrinsic.  It is initialized by
                    the SDOpen intrinsic.

NewEntityType       Required input; type = NewNameType 
                    This parameter specifies the name of the entity type
                    to be created.

Status              Output; type = StatusType 
                    This parameter contains information indicating the
                    success or failure of the intrinsic call.  This
                    information is detailed in Table 3-1.

                    If this intrinsic is successful, the Status parameter
                    contains the following information, in addition to
                    the description contained in Table 3-1.

-------------------------------------------------
|          |                                    |
|  Bytes   |              Contain               |
|          |                                    |
-------------------------------------------------
|          |                                    |
| 17 - 20  | Internal entity type number        |
|          |                                    |
-------------------------------------------------

Discussion 

Every entity type has the following attributes associated with it after
it is created:

    scope-owner
    date-created
    date-changed
    scope-changed
    sensitivity
    id-number

These attributes, called special attributes, are associated by default
and can never be deleted from the entity type's attribute list.

The following restrictions apply when using this intrinsic:

   1.  Open mode--The dictionary must be opened in Exclusive 
       Customization mode.

   2.  Security--The current scope must be either the Dictionary
       Administrator scope or a scope with Extend capability.

   3.  Maximum Quantities--the maximum number of entity types allowed is
       256.

       _________________________________________________________________ 

       NOTE  In the future, Hewlett Packard will prefix all names of
             objects it adds to the core set with "HP".  To avoid
             potential name conflicts, do not create any entity types,
             relationship classes, attributes, scopes, domains, or
             versions prefixed with "HP".

       _________________________________________________________________ 


MPE/iX 5.0 Documentation