company logo

DataSource :: accessPath - ACCESS_PATH option

An access path to a collection may be defined in order to refer to a collection instead to a complete database or object space. The option is mainly used in copy utilities in order to define the data source for a copy operation.

Return value:  Extent path ( odaba::String & )

An extent path may simply refer to an extent, but also to a local collection in the database (property path). Thus, an extent path may contain just a name, but also a sequence of path elements separated by '.' in order to refer to far properties.

In order to pass no extent path, an empty string ( String() ) has to be passed.

Implementation overview

Implementation details

  1. Get access path currently set
    odaba::String DataSource  :: accessPath (  )

    The function returns the access path currently set in the property.

  2. to list
  3. Set new access path
    odaba::String DataSource  :: accessPath ( odaba::String &vExtentPath )

    The function allows changing the value set in the access path. This will set only the value in the access path property but not change the property handle opened for the previous access path. In order to activate the new access path, openProperty() has to be called.

    • vExtentPath - Extent path

      An extent path may simply refer to an extent, but also to a local collection in the database (property path). Thus, an extent path may contain just a name, but also a sequence of path elements separated by '.' in order to refer to far properties.

      In order to pass no extent path, an empty string ( String() ) has to be passed.

  4. to list