HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDDeleteAttr 

Deletes an attribute from the dictionary structure.

Syntax 

     SDDeleteAttr (Dcb,Attribute,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.

Attribute                 Required input; type = NameOrNumberType 
                          This parameter specifies the attribute to be
                          deleted.

PurgeFlag                 Required input by value; type = 1 byte Boolean 
                          This parameter specifies the action to take
                          with entity type/ attribute pairs, relationship
                          type/attribute pairs, variable length and alias
                          attribute values.

                          If the parameter is true, then this intrinsic
                          will also delete all of the pairs and values
                          with which the attribute is involved.

                          If the parameter is false, and there are any
                          pairs or values associated with the attribute
                          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 

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 attribute's owner scope.

   3.  Core set attributes cannot be deleted.


MPE/iX 5.0 Documentation