File operations adapter runtime-environment property file

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]

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.

File storage location

Service-platform-installation-directory\CSC\config\adpfop\service-ID.properties

Specifiable properties

(1) 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 informationOutput level
01020
Error information
  • Cause of an exception or an error
YYY
Warning information
  • Information such as the problem that occurred
OYY
Information
  • Content of the messages and arguments
  • Change in the HCSC-Messaging status (when starting or stopping)
  • During command reception and completion of execution
  • Event notification
OOO
Legend:
Y: Information is output.
O: Only important log messages are output.

(2) 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 informationOutput level
12345
Entrance and exit information for the requester service method (class name, method name, argument, return value)NYYYY
Entrance and exit information for the external (such as BP) interfaces (class name, method name, argument, return value)NNYYY
Entrance and exit information for the interfaces within the components (class name, method name, argument, return value)NNNYY
Debug information (information such as the branching of processing)NNNNY
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.

(3) 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.

(4) 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.

(5) 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-4294967296)) <<4294967296>>

Specifies the maximum size (in bytes) of the input file to be compressed with the file compression operation. 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-4294967296)) <<4294967296>>

Specifies the maximum size (in bytes) of the output file to be compressed with the file compression operation. 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-4294967296)) <<4294967296>>

Specifies the maximum size (in bytes) of the input file to be extracted with the file extraction operation. 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-4294967296)) <<4294967296>>

Specifies the maximum size (in bytes) of the output file to be extracted with the file extraction operation. 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.

Example of coding

An example of coding is as follows:

messagelog-level=10
methodtrace-level=3
methodtrace-filenum=8
methodtrace-filesize=2097152​
...