HP 3000 Manuals HP 3000 Manuals
SDModifyScope
Modifies a scope.
Syntax
SDModifyScope (Dcb,Scope,Password,NewScopeName,NewOwnerScope,
NewScopeRights,NewPassword,Status)
Parameters
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
Scope Required input; type = NameOrNumberType
This parameter specifies the scope to be
modified.
Password Required input; type = ScopePasswordType
This parameter specifies the scope's current
password.
NewScopeName Required input; type = NameType
This parameter specifies the new name of the
scope. A blank string passed for this
parameter indicates no change in scope name.
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.
NewScopeRights Required input; type = ScopeRightsType
This parameter specifies the new list of
capabilities given to the scope. ScopeRights
are assigned by number, as follows:
1 = Secure capability
2 = Extend capability
3 = Create capability
4 = Read capability
5 = Domain capability
6 = Version Control capability
If the first four bytes of this parameter are
set to binary zero, no change will be made to
the scope rights of the scope being modified.
NOTE : More information about scope rights is
located in Chapter 5 of Volume 1 of the HP
System Dictionary/XL General Reference Manual
(32256-90004).
NewPassword Required input; type = ScopePasswordType
This parameter specifies the scope's new
password. A blank string passed for this
parameter indicates no change in the password.
To specify a blank password, set this parameter
to the null value (a forward slash '/') left
justify, and right blank fill.
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 Exclusive Update mode.
2. Security--The current scope must be as shown in the table below to
accomplish the tasks listed in the table.
* Only the dictionary administrator scope can modify a scope
without providing the old password. The current scope can
modify any scope it owns if it provides the password.
* The dictionary administrator scope is owned by the core set
and cannot be deleted. It has all scope rights, which cannot
be modified. However, the DA scope can change its own
password and external name.
* The current scope can change its own password, but not its
scope rights, scope name, or scope owner.
* Only scope rights which are not currently being used can be
removed. Example 1 : A scope which owns a domain cannot have
its Domain capability removed, but a scope which owns no
domains can have its Domain capability removed. Example 2 :
A scope which owns another scope cannot have Secure capability
removed.
* The current scope cannot add scope rights to another scope
that it does not have itself.
Example : Scope S has scope rights Extend, Create, and Read.
It cannot add scoperight Domain to scope R, because it doesn't
have Domain itself.
3. Only the external name will be changed, even if the current name
mode is internal. Internal names are fixed, and used for
reference only.
4. The new owner scope cannot be owned, either directly or
indirectly, by the scope being modified.
---------------------------------------------------------------------------
| | |
| Current Scope | Capabilities (can modify :) |
| | |
---------------------------------------------------------------------------
| | |
| DA | new scope name |
| | new owner scope |
| | new scope rights |
| | new password |
| | |
---------------------------------------------------------------------------
| | |
| Scope-Owner | new scope name |
| | new owner scope |
| | new scope rights |
| | new password |
| | |
---------------------------------------------------------------------------
| | |
| Any current scope | new scope password |
| | |
---------------------------------------------------------------------------
* See last item under Security, above.