OpenTP1 Version 7 System Definition
XAR performance verification trace definition
Format
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] |
Command format
None
Function
The XAR performance verification trace definition defines the execution environment for acquiring XAR performance verification trace information.
Explanation
set format
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)
prf_information_level=1|0 ~<<1>>
Specify the display level of messages related to the XAR performance verification trace.
The following table shows the message IDs for the XAR performance verification trace and their display levels.
Message | Display level |
---|---|
KFCA26700-W | 0 |
KFCA26705-W | 0 |
KFCA26710-I | 1 |
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.
Command format
None
Note
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.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.