ProcessRollback

ProcessRollback initiates a process rollback. When used inside a TurboIntegrator process, this function throws out all pending edits and cancels further processing. An error message appears in the tm1server.log and tm1processorerrorXXX.log files.

Note: In IBM® Planning Analytics version 2.0.8 or later, when a TurboIntegrator process rolls back and restarts, the process is now represented in the tm1server.log file as three steps: starting, restarting because of lock contention or rollback, and then finishing.

An entry is added to the tm1server.log file that shows the TurboIntegrator process as restarting due to lock contention or rollback instead of just starting. This logging is enabled by default without setting any specific debug options.

When used in a single-commit mode chore, ProcessRollback throws out all pending edits from all previous processes and continues execution at the next process in the chore. If lock contention is encountered after the call to ProcessRollback, the entire chore is restarted.

When used in a multi-commit mode chore, ProcessRollback throws out all pending edits from the current process and then continues execution at the next process in the chore. Changes that have already been committed cannot be rolled back. If lock contention is encountered after the call to ProcessRollback, only the current process is restarted.

This function is valid in TM1® TurboIntegrator processes only.

Syntax

ProcessRollback;

Arguments

None.