6.8.7 File operations adapter runtime-environment property file
- Organization of this subsection
(1) Format
[messagelog-level={0|10|20}]
[methodtrace-level={1|2|3|4|5}]
[methodtrace-filenum=number-of-maintenance-log-files]
[methodtrace-filesize=maximum-size-of-one-maintenance-log-file]
[exptrace-filenum=number-of-exception-log-files]
[exptrace-filesize=maximum-size-of-one-exception-log-file]
[readLock.retry.count=lock-retry-count-when-shared-lock-cannot-be-obtained]
[readLock.retry.interval=lock-retry-interval-when-shared-lock-cannot-be-obtained]
[writeLock.retry.count=lock-retry-count-when-dedicated-lock-cannot-be-obtained]
[writeLock.retry.interval=lock-retry-interval-when-dedicated-lock-cannot-be-obtained]
[transform.limitsize=input-file-size-for-stopping-file-transformation]
[transform.timeout=timeout-value-for-stopping-file-transformation]
[compress.inputfile.limitsize=input-file-size-for-stopping-file-compression]
[compress.outputfile.limitsize=output-file-size-for-stopping-file-compression]
[compress.timeout=timeout-value-for-stopping-file-compression]
[extract.inputfile.limitsize=input-file-size-for-stopping-file-extraction]
[extract.outputfile.limitsize=output-file-size-for-stopping-file-extraction]
[extract.timeout=timeout-value-for-stopping-file-extraction]
[writeList.outputfile.limitsize=output-file-size-for-stopping-file-list-write]
(2) Function
Specifies information such as the output levels of the message and trace logs for the operations of the file operations adapter in the execution environment.
(3) File storage location
Service-platform-installation-directory\CSC\config\adpfop\service-ID.properties
(4) Specifiable properties
(a) Message log
messagelog-level={0|10|20} ~ <<10>>
Specifies the output levels for the message log. The following table lists the output information and the output levels:
|
Output information |
Output level |
||
|---|---|---|---|
|
0 |
10 |
20 |
|
|
Error information
|
Y |
Y |
Y |
|
Warning information
|
O |
Y |
Y |
|
Information
|
O |
O |
O |
- Legend:
-
Y: Information is output.
O: Only important log messages are output.
(b) Maintenance log
methodtrace-level={1|2|3|4|5} ~ <<3>>
Specifies the output levels for the maintenance log. The following table lists the output information and the output levels:
|
Output information |
Output level |
||||
|---|---|---|---|---|---|
|
1 |
2 |
3 |
4 |
5 |
|
|
Entrance and exit information for the requester service method (class name, method name, argument, return value) |
N |
Y |
Y |
Y |
Y |
|
Entrance and exit information for the external (such as BP) interfaces (class name, method name, argument, return value) |
N |
N |
Y |
Y |
Y |
|
Entrance and exit information for the interfaces within the components (class name, method name, argument, return value) |
N |
N |
N |
Y |
Y |
|
Debug information (information such as the branching of processing) |
N |
N |
N |
N |
Y |
- Legend:
-
Y: Information is output.
N: Information is not output.
methodtrace-filenum=number-of-maintenance-log-files ~ <Numeric character> ((1 to 16)) <<8>>
Specifies the number of maintenance log files.
methodtrace-filesize=maximum-size-of-one-maintenance-log-file ~ <Numeric character> ((4096 to 2147483647)) <<2097152>>
Specifies the maximum size of one maintenance log file in bytes.
(c) Exception log
exptrace-filenum=number-of-exception-log-files ~ <Numeric character> ((1 to 16)) <<8>>
Specifies the number of exception log files.
exptrace-filesize=maximum-size-of-one-exception-log-file ~ <Numeric character> ((4096 to 2147483647)) <<2097152>>
Specifies the maximum size of one exception log file in bytes.
(d) Acquiring a lock
readLock.retry.count=lock-retry-count-when-shared-lock-cannot-be-obtained ~ <Numeric character> ((0 to 1024)) <<0>>
Specifies the lock retry count when a shared lock cannot be obtained.
readLock.retry.interval=lock-retry-interval-when-shared-lock-cannot-be-obtained ~ <Numeric character> ((1 to 1024)) <<1>>
Specifies the lock retry interval when a shared lock cannot be obtained, in seconds.
writeLock.retry.count=lock-retry-count-when-dedicated-lock-cannot-be-obtained ~ <Numeric character> ((0 to 1024)) <<0>>
Specifies the lock retry count when a dedicated lock cannot be obtained.
writeLock.retry.interval=lock-retry-interval-when-dedicated-lock-cannot-be-obtained ~ <Numeric character> ((1 to 1024)) <<1>>
Specifies the lock retry interval when a dedicated lock cannot be obtained, in seconds.
(e) Other
transform.limitsize=input-file-size-for-stopping-file-transformation ~ <Numeric character> ((0 to 2147483647)) <<62914560>>
Specifies the maximum size of the input file that is to be transformed with the file transformation operation, in bytes. If the input file exceeds the maximum size, an error message (KDEC80051-E) is displayed and the processing ends. If you specify 0, the file size becomes unlimited.
transform.timeout=timeout-value-for-stopping-file-transformation ~ <Numeric character> ((0 to 86400)) <<60>>
Specifies the timeout value for the segmented processing method in the file transformation operation, in seconds. If the time that has elapsed from the start of the file transformation operation to the completion of the processing of all the separated records exceeds the specified timeout value, an error message (KDEC80052-E) is displayed and the processing ends.
Note that this property is ignored even if specified for the batch processing method.
A timeout does not occur if you specify 0.
compress.inputfile.limitsize=input-file-size-for-stopping-file-compression ~ <Numeric character> ((1-9223372036854775807)) <<4294967296>>
Specifies the maximum size (in bytes) of the input file to be compressed with the file compression operation. The specification of the maximum value is treated as unlimited. If the input file exceeds the maximum size, an error message (KDEC80105-E) is displayed and the processing ends.
compress.outputfile.limitsize=output-file-size-for-stopping-file-compression ~ <Numeric character> ((1-9223372036854775807)) <<4294967296>>
Specifies the maximum size (in bytes) of the output file to be compressed with the file compression operation. The specification of the maximum value is treated as unlimited. If the output file exceeds the maximum size, an error message (KDEC80106-E) is displayed and the processing ends.
compress.timeout=timeout-time-for-stopping-file-compression ~ <Numeric character> ((0-86400)) <<60>>
Specifies the timeout value (in seconds) for conversion in the file conversion operation. If the time that has elapsed from the start of the file conversion operation until the file is compressed exceeds the specified timeout value, an error message (KDEC80107-E) is displayed and the processing ends.
A timeout does not occur if you specify 0.
extract.inputfile.limitsize=input-file-size-for-stopping-file-extraction ~ <Numeric character> ((1-9223372036854775807)) <<4294967296>>
Specifies the maximum size (in bytes) of the input file to be extracted with the file extraction operation. The specification of the maximum value is treated as unlimited. If the input file exceeds the maximum size, an error message (KDEC80126-E) is displayed and the processing ends.
extract.outputfile.limitsize=output-file-size-for-stopping-file-extraction ~ <Numeric character> ((1-9223372036854775807)) <<4294967296>>
Specifies the maximum size (in bytes) of the output file to be extracted with the file extraction operation. The specification of the maximum value is treated as unlimited. If the output file exceeds the maximum size, an error message (KDEC80127-E) is displayed and the processing ends.
extract.timeout=timeout-time-for-stopping-file-extraction ~ <Numeric character> ((0-86400)) <<60>>
Specifies the timeout value (in seconds) for extraction in the file extraction operation. If the time that has elapsed from the start of the file extraction operation until the file is extracted exceeds the specified timeout value, an error message (KDEC80128-E) is displayed and the processing ends.
A timeout does not occur if you specify 0.
writeList.outputfile.limitsize=output-file-size-for-stopping-file-list-write ~ <Numeric character> ((0 to 214743647)) <<62914560>>
Specifies the maximum size (in bytes) of the output file to which file list information is to be output with the file list write operation. If the output file exceeds the maximum size, an error message (KDEC80106-E) is displayed and the processing ends. If you specify 0, the file size is unlimited.
(5) Example of coding
An example of coding is as follows:
messagelog-level=10 methodtrace-level=3 methodtrace-filenum=8 methodtrace-filesize=2097152 ...