company logo

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.

Return value:  Success ( logical  )

Implementation details

  1. - 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

  2. to list
  3. - 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

  4. to list
  5. - 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

  6. to list
  7. - 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

  8. to list