HP 3000 Manuals

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


HP System Dictionary XL Intrinsics

SDModifyDomain 

Modifies a domain.

Syntax 

     SDModifyDomain (Dcb,Domain,NewDomainName,NewOwnerScope, 
                      Sensitivity,Status)

Parameters 

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

Domain                    Required input; type = NameOrNumberType 
                          This parameter specifies the domain to be
                          modified.

NewDomainName             Required input; type = NameType 
                          This parameter specifies the new external name
                          of the domain.  A blank string passed for this
                          parameter indicates no name change.

NewOwnerScope             Required input; type = NameOrNumberType 
                          This parameter specifies the new owner scope.
                          A blank string passed for this parameter
                          indicates no change in owner scope.

Sensitivity               Required input by value; type = 4 byte Integer 
                          This parameter specifies the new sensitivity of
                          the domain, as follows:

                            0 = no change

                            1 = Private.  Only the DA scope, the domain's
                            owner scope, or an associated scope has
                            access to the domain.

                            2 = Public.  Any scope can access the domain.

Status                    Output; type = StatusType 
                          This parameter contains information indicating
                          the success or failure of the intrinsic call.
                          This information is detailed in Table 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 either Shared Update 
       mode or Exclusive Update mode.

   2.  Security--The current scope must be either the Dictionary
       Administrator scope or the domain's owner scope.

   3.  Sensitivity--the sensitivity of the domain must be Public for a
       scope other than the DA scope, the domain's owner scope, or an
       associated scope to access the domain.

   4.  Core set domains cannot be modified, except for external names.
       These can be modified only by the Dictionary Administrator.


MPE/iX 5.0 Documentation