epadmin-breakpoint

epadmin breakpoint target — Manages breakpoints in global transactions.

SYNOPSIS

epadmin [globalparameters] command breakpoint [commandparameters]

DESCRIPTION

Use the breakpoint target to pause and examine global transactions in transactional memory. This feature is available in both production and development modes. A breakpoint can be set for all transactions or for transactions with a specified name.

The following table defines the supported breakpoints.

Breakpoint Type Description
begin Transaction begin.
deadlock After a deadlock has occurred, but before the transaction has rolled back.
destroyed After a lock on an object has failed because the object was destroyed in another transaction while waiting for it.
promotion A write lock was promoted to a write lock.
contention Contention occurred which caused blocking, waiting to acquire the lock.
distribution A cluster scope query or remote method invocation was done.

The breakpoint target has eight 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 browse breakpoint

Use epadmin browse breakpoint to browse transactional memory for existing breakpoints. The browse command does not exit; it continues to look for newly hit breakpoints until it is explicitly terminated with an interrupt. As breakpoints are hit, they are displayed.

epadmin [sn|ad] browse breakpoint

epadmin callstack breakpoint

Displays the transaction and thread call stacks for transactions at breakpoints. For example:

epadmin [sn|ad] callstack breakpoint
epadmin [sn|ad] callstack breakpoint --identifier=8:110
epadmin [sn|ad] callstack breakpoint --name=MyTransaction
Command Parameter Description Required
identifier The transaction identifier of a transaction at a breakpoint to display. No. Default is all transactions at breakpoints.
name The name of a transaction at a breakpoint to display. No. Default is all transactions at breakpoints.

The identifier and name parameters are mutually exclusive.

epadmin clear breakpoint

Clears all transaction breakpoints or specified breakpoint by name or type

epadmin [sn|ad] clear breakpoint
epadmin [sn|ad] clear breakpoint --type=deadlock
epadmin [sn|ad] clear breakpoint --type=begin --name=MyTransaction
Command Parameter Description Required
type The type of transaction breakpoint to clear. See the list of supported breakpoint types above. No. Default is all breakpoint types.
name The name of the transaction breakpoint to clear. No. Default is all breakpoints.

epadmin continue breakpoint

Continue transactions from breakpoints.

epadmin [sn|ad] continue breakpoint
epadmin [sn|ad] continue breakpoint --identifier=8:110
epadmin [sn|ad] continue breakpoint --name=MyTransaction
Command Parameter Description Required
identifier The transaction identifier of a transaction at a breakpoint to continue. No. Default is all transactions at breakpoints.
name The name of a transaction at a breakpoint to continue. No. Default is all transactions at breakpoints.

The identifier and name parameters are mutually exclusive.

epadmin display breakpoint

Displays information about transactions at breakpoints.

epadmin [sn|ad] display breakpoint
epadmin [sn|ad] display breakpoint --identifier=8:110
epadmin [sn|ad] display breakpoint --name=MyTransaction
epadmin [sn|ad] display breakpoint --name=MyTransaction --locklimit=400
epadmin [sn|ad] display breakpoint --name=MyTransaction --locklimit=0
Command Parameter Description Required
identifier The transaction identifier of a transaction at a breakpoint to display. No. Default is all transactions at breakpoints.
name The name of a transaction at a breakpoint to display. No. Default is all transactions at breakpoints.
locklimit The maximum number of object locks to show. A value of 0 indicates no limit. No. Default is 100.

The identifier and name parameters are mutually exclusive.

epadmin list breakpoint

Lists the currently set breakpoints.

epadmin [sn|ad] list breakpoint

The list command does not take any parameters.

epadmin locks breakpoint

Displays the locks held by transactions at breakpoints.

epadmin [sn|ad] locks breakpoint
epadmin [sn|ad] locks breakpoint --identifier=8:110
epadmin [sn|ad] locks breakpoint --name=MyTransaction
epadmin [sn|ad] locks breakpoint --name=MyTransaction --locklimit=400
epadmin [sn|ad] locks breakpoint --name=MyTransaction --locklimit=0
Command Parameter Description Required
identifier The transaction identifier of a transaction at a breakpoint to display. No. Default is all transactions at breakpoints.
name The name of a transaction at a breakpoint to display. No. Default is all transactions at breakpoints.
locklimit The maximum number of object locks to show. A value of 0 indicates no limit. No. Default is 100.

epadmin set breakpoint

Sets a transaction breakpoint.

epadmin [sn|ad] set breakpoint --type=deadlock
epadmin [sn|ad] set breakpoint --type=begin --name=MyTransaction
Command Parameter Description Required
type The type of transaction breakpoint to set. See the list of supported breakpoint types above. Yes.
name The name of the transaction to set the breakpoint for. No, except for begin. Default is all transactions.