Open topic with navigation

TIBCO ActiveSpaces® - Enterprise Edition 5.0.0

# Checkpoint Properties

You cannot write data into a checkpoint after it has been created, but ActiveSpaces provides the ability to query or retrieve data contained in a checkpoint.

ActiveSpaces supports the following properties for checkpoints:

TIBDG_SESSION_PROPERTY_STRING_CHECKPOINT_NAME

The property is set so that a named checkpoint is used as the data source for the session's read operations (GET, Iterator, Queries, or Statements). Write operations (PUT, DELETE) do not support this property.

TIBDG_TABLE_PROPERTY_STRING_CHECKPOINT_NAME

Set this property so that a named checkpoint is used as the data source for the read operations (GET or Iterator) of a table. Write operations (PUT and DELETE) do not support this property. If this property is not set, the table uses the checkpoint name specified on the session, if any. If this property is set, it overrides any checkpoint name set on the session.

TIBDG_GRIDMETADATA_PROPERTY_STRING_CHECKPOINT_NAME

The property is set so that a named checkpoint is used when retrieving metadata for the data grid or tables.

TIBDG_STATEMENT_PROPERTY_STRING_CONSISTENCY

Set this property to `TIBDG_STATEMENT_CONSISTENCY_SNAPSHOT` when using checkpoints for reading data. Since a checkpoint is already globally consistent, you must not use global consistency when reading or querying with checkpoints.

See the API documentation on the following methods:

- tibdgConnection_CreateSession
- tibdgConnection_GetGridMetadata
- tibdgSession_CreateStatement
- tibdgTable_CreateIterator
- tibdgTable_Get

TIBDG_SESSION_CHECKPOINT_NAME_LATEST

Use this special checkpoint name with the `TIBDG_SESSION_PROPERTY_STRING_CHECKPOINT_NAME` property to refer to the latest successful checkpoint known by the proxy. This name is useful for clients that want to read from the latest checkpoint without knowing the checkpoint name, or for grids that are configured to create periodic checkpoints automatically.

TIBDG_TABLE_CHECKPOINT_NAME_LATEST

Use this special checkpoint name with the `TIBDG_TABLE_PROPERTY_STRING_CHECKPOINT_NAME` property to refer to the latest successful checkpoint known by the proxy. This property is useful for clients that want to read from the latest checkpoint without knowing the checkpoint name, or for grids that are configured to create periodic checkpoints automatically.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO ActiveSpaces® - Enterprise Edition

Copyright © 2009-2025. Cloud Software Group, Inc. All Rights Reserved.