PK_MARK_goto   


PK_ERROR_code_t PK_MARK_goto
(
--- received arguments ---
PK_MARK_t       mark            --- mark to go to
)


This function returns the modeller to the state when the given mark was
created.


Specific Errors:
    PK_ERROR_rollback_not_started   Neither PK nor partitioned rollback active
    PK_ERROR_bad_mark               The given mark is invalid
    PK_ERROR_frustrum_failure       (potentially FATAL) The frustrum returned
                                    an error


If it is not possible to rollback, the function raises an error, and
leaves the model unchanged, except that in the case of partitioned rollback,
some partitions may have been rolled. If the failure is due to a 'disk full'
error from the frustrum, the application could make more space available
and retry the operation.

In the case of partitioned rollback, the following interface parameters will
be unaffected. Other interface parameters will be rolled back.

    Interface checking on/off
    Journalling on/off
    Roll forward on/off
    Tag limit

If the forward option was not selected, then all forward marks become
invalidated.

This function should only be called when PK rollback has been started
with PK_MARK_start or partitioned rollback has been started with
PK_DELTA_register_callbacks.