OpenTP1 Version 7 System Definition

[Contents][Index][Back][Next]

XA resource service definition

Format

set format

[set xar_eventtrace_level=ERR|INF|ALL]
[set xar_eventtrace_record=maximum-number-of-records-output-to-
                           the-XAR-event-trace-information-file]
[set xar_session_time=monitoring-time-for-idle-transaction-branches]
[set xar_msdtc_use=Y|N]
[set xar_prf_trace_level=acquisition-level-of-the-XAR-performance-verification-trace]

Command format

xarfile  -t online|backup
         -a physical-file-name

Function

The XA resource service definition defines the execution environment for managing transactions using the XA resource service.

Explanation

set format

xar_eventtrace_level=ERR|INF|ALL~<<ERR>>

Specify the output level of the XAR event trace information.

ERR
The error information is output to the XAR event trace.

INF
The error information and the normal information are output to the XAR event trace.

ALL
All the XAR event trace information including the error information and the normal information are output to the XAR event trace.

Hitachi recommends that you specify ERR in the production environment. If you specify a value other than ERR, the number of inputs and outputs increases, slowing down the processing.

xar_eventtrace_record=maximum-number-of-records-output-to-the-XAR-event-trace-information-file~<unsigned integer>((1-65535))<<8192>>

Specify the maximum number of records output to the XAR event trace information file.

xar_session_time=monitoring-time-for-idle-transaction-branches~<unsigned integer>((10-65535))<<180>> (unit: seconds)

Specify the length of time to monitor an idle transaction branch between End() and Prepare(). When the specified length of time expires, a message is output to roll back the transaction branch. The interval of monitoring the idle status is 10 seconds. Therefore, it may take a while before the idle status is detected.

xar_msdtc_use=Y|N ~<<N>>

Specify whether to use MSDTC linkage.

Y:
MSDTC linkage is used.

N:
MSDTC linkage is not used.

xar_prf_trace_level=acquisition-level-of-the-XAR-performance-verification-trace ~((((00000000-00000003)) <<00000003>>

Specify the acquisition level of the XAR performance verification trace. To specify multiple acquisition levels, specify the logical sum of the values for those acquisition levels.

For details about the XAR performance verification trace, see the description of troubleshooting in the manual OpenTP1 Description.

00000000:
The XAR performance verification trace is not acquired.

00000001:
The XAR performance verification trace (for event IDs 0x4a00 to 0x4a0f) is acquired at the entry and exit points of a transaction request from the application server.

00000002:
The XAR performance verification trace (for event IDs 0x4b00 to 0x4b0f) is acquired at the entry and exit points of OpenTP1 transaction processing.

You can use the prfget command to export the acquired trace to a file or use the prfed command to edit and output the acquired trace. For details about the prfget and prfed commands, see the manual OpenTP1 Operation.

This operand requires the installation of TP1/Extension 1. If this operand is specified when TP1/Extension 1 has not been installed, operation cannot be guaranteed.

Command format

The command format is described on the following page.