DBObjectHandle :: RenameExtentRef - Rename extent reference
When changing an extent name in a schema definition, which is already in production, the extent name has to be changed in all production databases, too. The new extent name passed in sNewName has to be the same name as the new name for the extent definition in the schema.
The original name passed in sExtentName might be defined within a namespace or in the global scope by preceding the extent name with the scope name. The new name (sNewName) will be defined in the same namespace, i.e. renaming an extent does not support changing the namespace. When the new name is defined with a scope name, this will be ignored.
The function should be called, only, for databases which have been opened exclusive. No extent must be opened before calling the function.
Implementation overview
- - internal feature (not documented)
DBObjectHandle :: RenameExtentRef ( extnames, nsid, newnames ) - - internal feature (not documented)
DBObjectHandle :: RenameExtentRef ( scope_name, extnames, newnames ) - - internal feature (not documented)
DBObjectHandle :: RenameExtentRef ( extnames, newnames ) - - internal feature (not documented)
DBObjectHandle :: RenameExtentRef ( tkey, newnames )
Implementation details
-
- internal feature (not documented)
logical DBObjectHandle  :: RenameExtentRef ( NString &extnames, int32 nsid, NString &newnames )
- extnames
- Extent name
The name contains the name of the extent, only. It does not contain a namespace scope.
Notes:retval checked for const &NString
- nsid - - internal feature (not documented)
- newnames
- New name
String that defines the new name/key for a object that is about to be renamed or copied
to list
- extnames
- Extent name
-
- internal feature (not documented)
logical DBObjectHandle  :: RenameExtentRef ( NString &scope_name, NString &extnames, NString &newnames )
- scope_name
- Name of a Scope
Defines the name of a scope (in some cases the name of a namespace)
eg
'std::algorithm'
'std' (::string)
- extnames
- Extent name
The name contains the name of the extent, only. It does not contain a namespace scope.
Notes:retval checked for const &NString
- newnames
- New name
String that defines the new name/key for a object that is about to be renamed or copied
to list
- scope_name
- Name of a Scope
-
- internal feature (not documented)
logical DBObjectHandle  :: RenameExtentRef ( NString &extnames, NString &newnames )
- extnames
- Extent name
The name contains the name of the extent, only. It does not contain a namespace scope.
Notes:retval checked for const &NString
- newnames
- New name
String that defines the new name/key for a object that is about to be renamed or copied
to list
- extnames
- Extent name
-
- internal feature (not documented)
logical DBObjectHandle  :: RenameExtentRef ( TypeKey &tkey, NString &newnames )
- tkey - - internal feature (not documented)
- newnames
- New name
String that defines the new name/key for a object that is about to be renamed or copied
to list