epadmin-globaltransaction

< Previous		Next >

epadmin-globaltransaction

epadmin globaltransaction target — Manages global transactions.

SYNOPSIS

epadmin [globalparameters] command globaltransaction [commandparameters]

DESCRIPTION

Use the globaltransaction target to show the transactions underway on the current node or cluster, to commit a local transaction, or to halt an underway transaction. See Transactions in the Architecture Guide to understand transactionality in the StreamBase Runtime.

The globaltransaction target has three commands:

The designation [sn|ad] in syntax examples is a reminder that this command requires either the global parameter ‑‑servicename or the ‑‑adminport and ‑‑hostname combination to identify the node or cluster of interest.

epadmin abort globaltransaction

Halts a local transaction initiated by a global transaction. The abort command cannot be run on the node initiating the global transaction; it can only be run on remote nodes involved in the global transaction. Use the display command to determine the identifier value to use.

epadmin [sn|ad] abort globaltransaction --identifier="serializable:98752449084876475:221:33:360614189986813"

Command Parameter	Description	Required
`identifier`	Global transaction identifier as reported by the display globaltranaction command.	Yes.

epadmin commit globaltransaction

Commits a local transaction initiated by a global transaction. The commit command cannot be run on the node initiating the global transaction; it can only be run on remote nodes involved in the global transaction. Use the display command to determine the identifier value to use.

epadmin [sn|ad] commit globaltransaction --identifier="serializable:98752449084876475:221:33:360614189986813"

Command Parameter	Description	Required
`identifier`	Global transaction identifier as reported by the display globaltranaction command.	Yes.

epadmin display globaltransaction

Displays global transactions running on the specified node or cluster.

epadmin [sn|ad] display globaltransaction
epadmin [sn|ad] display globaltransaction --verbose

Command Parameter	Description	Required
`verbose`	Boolean value controlling whether to include additional global transaction details. The `verbose` option only displays additional details if debug tracing is enabled for distribution.	No. Default value is `false`.