set format

[set prf_file_size=XAR-performance-verification-trace-information-file-size]
[set prf_information_level=1|0]
[set prf_file_count=number-of-generations-for-XAR-performance-verification-trace-information-files]

None

The XAR performance verification trace definition defines the execution environment for acquiring XAR performance verification trace information.

prf_file_size=XAR-performance-verification-trace-information-file-size ~<unsigned integer> ((1024-1048576)) <<10240>> (units: kilobytes)

Specify the size of an XAR performance verification trace information file.

Normally, trace information is output to regular files in OpenTP1. The number of generations of this file is specified by the prf_file_count operand in the XAR performance verification trace definition. When all generations have been used, the oldest file is overwritten with new trace information. Accordingly, old trace information is lost as time passes. You can increase the interval at which the oldest file is overwritten by increasing the value of this operand.

You can use the following formula to calculate the size of one trace file acquired during the execution of a transaction (units: bytes):

Size of one file ^# = 128 + (384 x (4 + number of RPC calls performed in one transaction) x number of transactions)

#:

The amount of trace information varies depending on conditions such as whether transactions are optimized.

prf_information_level=1|0 ~<<1>>

Specify the display level of messages related to the XAR performance verification trace.

0

Messages related to the XAR performance verification trace whose display level is 0 (warning and error messages) are output to syslog.

1

Messages related to the XAR performance verification trace whose display level is 1 or lower are output to syslog.

The following table shows the message IDs for the XAR performance verification trace and their display levels.

To suppress the output of messages whose display level is 0, set the DCSYSLOGOUT environment variable to 0 in the system common definition or the performance verification trace definition. If the DCSYSLOGOUT environment variable is specified in both the system common definition and the performance verification trace definition, the specification in the system common definition takes precedence.

For details about the DCSYSLOGOUT environment variable, see the description of the DCSYSLOGOUT environment variable in Log service definition.

prf_file_count=number-of-generations-for-XAR-performance-verification-trace-information-files ~<unsigned integer> ((3-256)) <<3>>

Specify the number of generations for the XAR performance verification trace information file.

None

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.