1. Transaction System Properties

The following describes transaction system properties.

  • jeus.tm.forcedReg

    Description

    Option to determine how a sub-coordinator registers a transaction with the root coordinator.

    • true: Registers the transaction immediately when it is connected.

    • false: Registers the transaction only when there is RM.

    Default

    true

  • jeus.tm.checkReg

    Description

    Option to check whether a subcoordinator successfully registered with the root coordinator.

    Default

    true

  • jeus.tm.disableJoin

    Description

    Option to join the resources from the same RM.

    Default

    false

  • jeus.tm.noLogging

    Description

    Option to store transaction information to be used by the transaction manager for recovery.

    • true: Logs are not stored.

    • false: Logs are stored.

    Default

    false

  • jeus.tm.ignore.broken.log.file

    Description

    With this option set to true, if the TM log file is broken and makes recovery impossible, JEUS detects the broken file and deletes the entire file. If recovery is attempted while the file broken, boot fails, which makes recovery unnecessary due to the broken file. Use this option when booting must be successful.

    Default

    false

  • jeus.tm.removeIncompleteTx

    Description

    Option to delete an XA resource from the recovery list after recovery is completed. To recover manually, set the value to false.

    Default

    false

  • jeus.tm.recoveryTrial

    Description

    Number of retries to recover the failed recovery resources.

    Recovery retries operate as a background job.

    Default

    30

  • jeus.tm.recoveryInterval

    Description

    Interval at which recovery of failed resources are attempted.

    Default

    120000 (Unit: ms)

  • jeus.tm.destroy-timeout

    Description

    When a transaction timeout is reached and a commit or rollback command is not received, transaction manager keeps the resource.

    Period in which to enable a cleanup job for the transaction. If timeout occurs, the destroy command is internally executed. Terminating executions are internally enabled for the transaction.

    Default

    1800000 (Unit: ms)

  • jeus.tm.destroy-timeout-check-interval

    Description

    Interval at which the destroy timeout process is checked.

    Operation of jeus.tm.destroy-timeout is checked at the specified interval.

    Default

    1800000 (Unit: ms)

  • jeus.tm.ots.recoveryInterval

    Description

    Interval at which OTS recovery is retried when the coordinator is not ready (msec).

    Default

    10000 (Unit: ms)

  • jeus.tm.ots.decisionTO

    Description

    Period in which to commit or rollback a transaction after the transaction is distributed and prepared for OTS.

    Default

    60000 (Unit: ms)

  • jeus.tm.net.address-mapping-properties

    Description

    File that contains the mappings of IP addresses to JEUS TM. For more information, refer to Transaction Communication Problem between Servers with Different IP Bands in JEUS Server Guide.

    Default

    Location of the file must be specified to use this function.

  • jeus.tm.profile.classes

    Description

    ProfileListener classes to be used for TM Profile.

    For detailed information on the profile function, refer to Transaction Profile Function in JEUS Server Guide.

    Default

    None

  • jeus.tm.ignore.xaEmulation-resume-suspend-exception

    Description

    When using XAEmulation, the suspend and resume funtions, which are available for XAResource, cannot be utilized.

    However, if the framework calls suspend or resume, an attempt to delist or enlist LocalXAResourceWrapper will result in an exception being thrown.

    Despite this, the overall logic will remain unaffected as LocalXAResourceWrapper will be bypassed.

    Default

    false

1.1. System Properties for TM Clients

Specifies system properties for client programs to use TM.

  • jeus.tm.not_use

    Description

    Option to use transaction managers.

    • true: For a client, this element is used when both JNDI is used and transactions are not used.

    • false: For a client, this element is used when JNDI and transactions are used.

    Default

    false

  • jeus.tm.version

    Description

    TM runtime version.

    • client: Uses a client TM.

    • server: Uses a server TM.

    Default

    client

  • jeus.tm.port

    Description

    TCP/IP port number to be used by the JEUS transaction manager.

  • jeus.tm.usenio

    Description

    Option to determine the I/O method between transaction managers.

    • true : NIO

    • false: Blocking I/O

    Default

    true

  • jeus.tm.tmMin

    Description

    Minimum size of the thread pool to be used by transactions.

    Default

    2

  • jeus.tm.tmMax

    Description

    Maximum size of the thread pool used by transactions.

    Default

    30

  • jeus.tm.activeto

    Description

    Period in which to commit or roll back after the transaction starts.

    If timeout occurs, the transaction is rolled back forcibly.

    Default

    600000 (Unit: ms)

  • jeus.tm.prepareto

    Description

    Period in which the root coordinator receives a Preparation Completed signal from a subcoordinator.

    If timeout occurs, the transaction is rolled back forcibly.

    Default

    120000 (Unit: ms)

  • jeus.tm.preparedto

    Description

    Period in which a subcoordinator waits for a decision after sending a Preparation Completed signal to the root coordinator.

    If timeout occurs, the subcoordinator continuously sends a Waiting for Decision signal to the root coordinator.

    Default

    60000 (Unit: ms)

  • jeus.tm.committo

    Description

    Period in which the root coordinator receives a response from a subcoordinator after sending a commit signal to the subcoordinator. If timeout occurs, the transaction is marked as an unresolved transaction.

    Default

    240000 (Unit: ms)

  • jeus.tm.recoveryto

    Description

    Period in which the root coordinator receives recovery information from a subcoordinator. If timeout occurs, the transaction is not processed.

    Default

    120000 (Unit: ms)

  • jeus.tm.incomplete.to

    Description

    Period in which to save unresolved transactions.

    Default

    86400000 (Unit: ms)

1.2. System Properties for Backward Compatibility

  • jeus.tm.propagation.recalculated-timeout

    Description

    Recalculated time period sent when transmitting a transaction to another container. It is calculated by subtracting the time period consumed before the transaction is actually transmitted from the active timeout period.

    This function is available in JEUS 6 Fix#9. Set this option to "false" for backward compatibility.

    Default

    false