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

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
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
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