6.13.2 Mail adapter command definition file
- Organization of this subsection
(1) Format
[mailadp.command.messagelog.filepath=directory-to-output-command-message-log]
[mailadp.command.messagelog.filenum=number-of-command-message-log-files]
[mailadp.command.messagelog.filesize=maximum-size-of-one-command-message-log-file]
[mailadp.command.messagelog.level={10|20|30}]
(2) Function
This file is used to specify information such as the output destination and the output levels of the message log for the commands used with the mail adapter.
Create the mail adapter command definition file with the name adpmailcommand.properties.
(3) File storage location
- The template file is stored at the following location:
Service-platform-installation-directory\CSC\config\mail\templates\adpmailcommand.properties
- The mail adapter command definition file is stored at the following location:
Service-platform-installation-directory\CSC\config\mail
(4) Specifiable properties
mailadp.command.messagelog.filepath=directory-to-output-command-message-log~ <Character strings (including two-byte characters) and spaces>
Specifies an absolute path for the directory to output the command message log.
Use the characters / or \\ as directory delimiters. If the directory is not specified, or if the specified folder does not exist, the log is output to service-platform-installation-directory\csc\log\adapter\command.
mailadp.command.messagelog.filenum=number-of-command-message-log-files ~ <Numeric character> ((1 to 64)) <<2>>
Specifies the number of command message log files.
mailadp.command.messagelog.filesize=maximum-size-of-one-command-message-log-file ~ <Numeric character> ((4096 to 16777216)) <<1048576>>
Specifies the maximum size of one command message log file in bytes.
mailadp.command.messagelog.level={10|20|30} ~ <<20>>
Specifies the output levels for the command message log. The following table lists the output information and the output levels:
|
Output information |
Description |
Output level |
||
|---|---|---|---|---|
|
10 |
20 |
30 |
||
|
Error information |
Cause of an exception or an error |
Y |
Y |
Y |
|
Warning information |
Information such as the problem that occurred |
|||
|
Information |
Content of arguments During command reception and completion of execution Event notification |
|||
|
Stack trace information |
Stack trace for error |
N |
Y |
Y |
|
Debug information |
Debug information for error |
N |
N |
Y |
- Legend:
-
Y: Information is output.
N: Information is not output.
(5) Example of coding
An example of coding of the mail adapter command definition file is as follows:
mailadp.command.messagelog.filepath=C:\\Program Files\\Hitachi\\Cosminexus\\csc\\log\\adapter\\command mailadp.command.messagelog.filenum=2 mailadp.command.messagelog.filesize=1048576 mailadp.command.messagelog.level=20
(6) Notes
-
Two-byte characters are interpreted as invalid strings. Therefore, you must convert such characters by using the following hjdk.native2ascii.jar tool.
service-platform-installation-directory\jdk\bin\java -jar service-platform-installation-directory\jdk\lib\hcompatlib\hjdk.native2ascii.jar input-file-path output-file-path
For details about the hjdk.native2ascii.jar tool, see the JDK documentation.
-
Note the following when you specify the path:
-
Do not specify a path that contains characters expressing a relative path or a parent directory (..\ or ../) or characters expressing a current directory (.\ or ./).
-
Do not specify a path containing a symbolic link.
-
In Windows, do not specify a path containing a UNC format, an NTFS stream name, or a reserved device name. The path characters are not case sensitive.
-