Jump To Close

Expand all Collapse all

Settings Close

• Language:

  English
• Format: Multi-page Single-page PDF

Language and Page Formatting Options

• Language:

  English
• Format: Multi-page Single-page PDF

Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

3.3.9. JBoss AS 7 and EAP 6 - Transactions Subsystem (Standalone) Service

Overview

Table 3.389. Overview

Description:	The transactions subsystem.
Singleton:	yes
Plugin:	JBossAS7

Child Resource Types

• Section 3.3.9.1, “JBoss AS 7 and EAP 6 - Log Store (Standalone) Service”

Connection Properties

Table 3.390. 

Name	Description	Required	Internal Name
Path		yes	path

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Metrics

Table 3.391. Metrics

Name	Type	Description	Internal Name
Number Of Nested Transactions	measurement	The total number of nested (sub) transactions created.	number-of-nested-transactions
Number Of Nested Transactions per Minute	measurement	The total number of nested (sub) transactions created.	number-of-nested-transactions
Number Of Timed Out Transactions	measurement	The number of transactions that have rolled back due to timeout.	number-of-timed-out-transactions
Number Of Timed Out Transactions per Minute	measurement	The number of transactions that have rolled back due to timeout.	number-of-timed-out-transactions
Number Of Committed Transactions	measurement	The number of committed transactions.	number-of-committed-transactions
Number Of Committed Transactions per Minute	measurement	The number of committed transactions.	number-of-committed-transactions
Number Of Transactions	measurement	The total number of transactions (top-level and nested) created	number-of-transactions
Number Of Transactions per Minute	measurement	The total number of transactions (top-level and nested) created	number-of-transactions
Number Of Heuristics	measurement	The number of transactions which have terminated with heuristic outcomes.	number-of-heuristics
Number Of Heuristics per Minute	measurement	The number of transactions which have terminated with heuristic outcomes.	number-of-heuristics
Number Of Aborted Transactions	measurement	The number of aborted (i.e. rolledback) transactions.	number-of-aborted-transactions
Number Of Aborted Transactions per Minute	measurement	The number of aborted (i.e. rolledback) transactions.	number-of-aborted-transactions
Number Of Inflight Transactions	measurement	The number of transactions that have begun but not yet terminated.	number-of-inflight-transactions
Number Of Inflight Transactions per Minute	measurement	The number of transactions that have begun but not yet terminated.	number-of-inflight-transactions
Number Of Application Rollbacks	measurement	The number of transactions that have been rolled back by application request. This includes those that timeout, since the timeout behaviour is considered an attribute of the application configuration.	number-of-application-rollbacks
Number Of Application Rollbacks per Minute	measurement	The number of transactions that have been rolled back by application request. This includes those that timeout, since the timeout behaviour is considered an attribute of the application configuration.	number-of-application-rollbacks
Number Of Resource Rollbacks	measurement	The number of transactions that rolled back due to resource (participant) failure.	number-of-resource-rollbacks
Number Of Resource Rollbacks per Minute	measurement	The number of transactions that rolled back due to resource (participant) failure.	number-of-resource-rollbacks

Note

You must use the internal name to reference Traits in Dynamic Group Definition expressions.

Configuration Properties

Table 3.392. 

Name	Description	Required	Internal Name
Relative To	References a global path configuration in the domain model, defaulting to the JBoss Application Server data directory (jboss.server.data.dir). The value of the 'path' attribute will treated as relative to this path. Use an empty string to disable the default behavior and force the value of the 'path' attribute to be treated as an absolute path. The default value is jboss.server.data.dir.	no	relative-to
Process Id Uuid	Indicates whether the transaction manager should use a UUID based process id.	no	process-id-uuid
Socket Binding	Used to reference the correct socket binding to use for the recovery environment.	no	socket-binding
Jts	If true this enables the Java Transaction Service. The default value is false.	no	jts
Object Store Path	Denotes a relative or absolute filesystem path denoting where the transaction manager object store should store data. By default the value is treated as relative to the path denoted by the 'relative-to' attribute. The default value is tx-object-store.	no	object-store-path
Path	Denotes a relative or absolute filesystem path denoting where the transaction manager core should store data. By default the value is treated as relative to the path denoted by the 'relative-to' attribute. The default value is var.	no	path
Process Id Socket Binding	The name of the socket binding configuration to use if the transaction manager should use a socket-based process id. Will be 'undefined' if 'process-id-uuid' is 'true'; otherwise must be set.	no	process-id-socket-binding
Default Timeout	The default timeout. The default value is 300.	no	default-timeout
Process Id Socket Max Ports	The maximum number of ports to search for an open port if the transaction manager should use a socket-based process id. If the port specified by the socket binding referenced in 'process-id-socket-binding' is occupied, the next higher port will be tried until an open port is found or the number of ports specified by this attribute have been tried. Will be 'undefined' if 'process-id-uuid' is 'true'. The default value is 10.	no	process-id-socket-max-ports
Recovery Listener	Used to specify if the recovery system should listen on a network socket or not. The default value is false.	no	recovery-listener
Status Socket Binding	Used to reference the correct socket binding to use for the transaction status manager.	no	status-socket-binding
Node Identifier	Used to set the node identifier on the core environment. The default value is 1.	no	node-identifier
Enable Tsm Status	Whether the transaction status manager (TSM) service, needed for out of process recovery, should be provided or not. The default value is false.	no	enable-tsm-status
Object Store Relative To	References a global path configuration in the domain model, defaulting to the JBoss Application Server data directory (jboss.server.data.dir). The value of the 'path' attribute will treated as relative to this path. Use an empty string to disable the default behavior and force the value of the 'path' attribute to be treated as an absolute path. The default value is jboss.server.data.dir.	no	object-store-relative-to
Enable Statistics	Whether statistics should be enabled. The default value is false.	no	enable-statistics

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Operations

none

Package Types

none

3.3.9.1. JBoss AS 7 and EAP 6 - Log Store (Standalone) Service

Overview

Table 3.393. Overview

Description:	Representation of the transaction logging storage mechanism.
Singleton:	yes
Plugin:	JBossAS7

Child Resource Types

• Section 3.3.9.1.1, “JBoss AS 7 and EAP 6 - Transactions (Standalone) Service”

Connection Properties

Table 3.394. 

Name	Description	Required	Internal Name
Path		yes	path

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Metrics

none

Configuration Properties

Table 3.395. 

Name	Description	Required	Internal Name
Type	Specifies the implementation type of the logging store.	no	type

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Operations

Table 3.396. Metrics

Name	Description
Probe	Scan for new transaction logs. This operation will creates a child for each pending transaction.

Package Types

none

3.3.9.1.1. JBoss AS 7 and EAP 6 - Transactions (Standalone) Service

Overview

Table 3.397. Overview

Description:	The persistent information that the transaction manager stores for the purpose of recovering a transaction in the event of failure. The probe operation will add and remove transactions from the model as the corresponding real transactions start and finish the prepare and commit phases. A stuck transaction will remain in the model until either it is completed or explicitly removed by the delete operation.
Singleton:	no
Plugin:	JBossAS7

Child Resource Types

• Section 3.3.9.1.1.1, “JBoss AS 7 and EAP 6 - Participants (Standalone) Service”

Connection Properties

Table 3.398. 

Name	Description	Required	Internal Name
Path		yes	path
Include Runtime		yes	includeRuntime

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Metrics

none

Configuration Properties

Table 3.399. 

Name	Description	Required	Internal Name
Age In Seconds	The time since this transaction was prepared or when the recovery system last tried to recover it.	no	age-in-seconds
Id	The id of this transaction.	no	id
Jmx Name	The JMX name of this transaction.	no	jmx-name
Type	The type name under which this record is stored.	no	type

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Operations

Table 3.400. Metrics

Name	Description
Delete	Remove this transaction log. WARNING after this operation the transaction manager will have no knowledge of the transaction and will therefore never be able to recover it. If you are sure that the transaction is complete then the operation is safe. The representation of the transaction log is removed from the model too.

Package Types

none

3.3.9.1.1.1. JBoss AS 7 and EAP 6 - Participants (Standalone) Service

Overview

Table 3.401. Overview

Description:	The resources that did work in a transaction.
Singleton:	no
Plugin:	JBossAS7

Child Resource Types

none

Connection Properties

Table 3.402. 

Name	Description	Required	Internal Name
Path		yes	path
Include Runtime		yes	includeRuntime

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Metrics

none

Configuration Properties

Table 3.403. 

Name	Description	Required	Internal Name
Eis Product Name	The JCA enterprise information system's product name.	no	eis-product-name
Eis Product Version	The JCA enterprise information system's product version	no	eis-product-version
Jmx Name	The JMX name of this participant.	no	jmx-name
Jndi Name	JNDI name of this participant.	no	jndi-name
Status	Reports the commitment status of this participant (can be one of Pending, Prepared, Failed, Heuristic or Readonly).	no	status
Type	The type name under which this record is stored.	no	type

Note

You must use the internal name to reference Configuration Properties in Dynamic Group Definition expressions.

Operations

Table 3.404. Metrics

Name	Description
Recover	If this record is in a heuristic state then attempt to replay the commit phase of the 2PC transaction.
Refresh	Refresh the management view of the attributes of this participant record by querying the transaction log. (Note that the read-resource operaton only reads the model, hence the need for this refresh operation).

Package Types

none