HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDDeleteEntType 

Deletes an entity type from the dictionary structure.

Syntax 

     SDDeleteEntType (Dcb,EntityType,PurgeFlag,Status)

Parameters 

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

EntityType                Required input; type = NameOrNumberType 
                          This parameter specifies the entity type to be
                          deleted.

PurgeFlag                 Required input by value; type = 1 byte Boolean 
                          This parameter specifies the action to take
                          with the relationship types which use this
                          entity type.

                          If the parameter is true, then this intrinsic
                          will delete all of the relationship types which
                          use the entity type.

                          If the parameter is false, and there are any
                          relationship types associated with the entity
                          type being deleted, this intrinsic will fail.

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,
                          located in Chapter 3 of this manual.

Discussion 

All entities of the type specified in the EntityType parameter will be
deleted from the dictionary.  All relationships in which the specified
entity type is involved will also be deleted.

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 the entity type's owner scope.

   3.  Core set entity types cannot be deleted.


MPE/iX 5.0 Documentation