blob: 92c17d4d749797097f27d4111e63a1178aaa59c5 [file] [log] [blame]
type=page
status=published
title=rollback-transaction
next=rotate-log.html
prev=restore-domain.html
~~~~~~
= rollback-transaction
[[rollback-transaction-1]][[GSRFM00223]][[rollback-transaction]]
== rollback-transaction
Rolls back the named transaction
[[sthref2008]]
=== Synopsis
[source]
----
asadmin [asadmin-options] rollback-transaction [--help]
[--target target]
transaction_id
----
[[sthref2009]]
=== Description
The `rollback-transaction` subcommand rolls back the named transaction.
Before you can roll back a transaction, you must do the following:
1. Enable monitoring using the `set` subcommand. For example:
+
[source]
----
asadmin> set clstr1-config.monitoring-service.module-monitoring-levels.transaction-service=HIGH
----
2. Use the `freeze-transaction-service` subcommand to halt in-process
transactions.
3. Look up the active transactions using the `get` subcommand with the
`--monitor` option. For example:
+
[source]
----
asadmin> get --monitor inst1.server.transaction-service.activeids-current
----
This subcommand is supported in remote mode only.
[[sthref2010]]
=== Options
asadmin-options::
Options for the `asadmin` utility. For information about these
options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
Displays the help text for the subcommand.
`--target`::
This option specifies the target on which you are rolling back the
transactions. Valid values are `server` or any other clustered or
stand-alone instance.
[[sthref2011]]
=== Operands
transaction_id::
Identifier for the transaction to be rolled back.
[[sthref2012]]
=== Examples
[[GSRFM741]][[sthref2013]]
==== Example 1   Using rollback-transaction command
[source]
----
% asadmin rollback-transaction 0000000000000001_00
Command rollback-transaction executed succeessfully
----
[[sthref2014]]
=== Exit Status
0::
command executed successfully
1::
error in executing the command
[[sthref2015]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:freeze-transaction-service.html#freeze-transaction-service-1[`freeze-transaction-service`(1)],
link:recover-transactions.html#recover-transactions-1[`recover-transactions`(1)],
link:unfreeze-transaction-service.html#unfreeze-transaction-service-1[`unfreeze-transaction-service`(1)],
"link:administration-guide/transactions.html#GSADG00022[Administering Transactions]" in {productName} Administration Guide
"https://eclipse-ee4j.github.io/jakartaee-tutorial/#transactions[Transactions]"
in The Jakarta EE Tutorial