Hitachi

uCosminexus Application Server Definition Reference Guide


6.2.1 admin.properties (Management command properties file)

Organization of this subsection

(1) Format

Specify the key as follows:

Key-name=value
Specification method
  • The string up to the linefeed is a value.

  • The line beginning with a hash mark (#) is a comment.

  • If you define a line without a value, the line is ignored.

  • If the value specified is not within the range, the value outside the range is used. If a value is not specified, the previous value is used. In such cases, a warning message appears on the console.

(2) File storage location

Note that hereafter Cosminexus-installation-directory\CC\cjmsp (In Windows) or /opt/Cosminexus/CC/cjmsp (In UNIX) are represented as <CJMSP_HOME>.

(3) Functionality

Specifies the log output of management commands.

Note that property values are validated even before initialization of the log. If an invalid value is specified as a property in this file, the log contents are output only to the console and not to the log file.

To change the following properties, the changed contents are enabled when all log files under <CJMSP_HOME>\var\admin\log directory (In Windows) or <CJMSP_HOME>/var/admin/log directory (In UNIX) are deleted.

(4) Specifiable keys

The following are the keys that can be specified. Note that "If value is not specified" in the table refers to the value of a non-specified key, and "VR" refers to the version of Application Server for which the keys are introduced or changed.

Key name

Contents

Specifiable value

If a value outside the range is specified

If the value is not specified

VR

admin.logger.ExceptionLogFile.filenum

Specify the maximum number of log files to be created.

1 to 16

2

2

08-50

admin.logger.ExceptionLogFile.filepath

Specify the absolute path of the storage location of the log file.

The file is created automatically with the name, cjmsadmin_errN.log. N refers to the number of log files.

If the specified directory does not exist, Cosminexus JMS Provider displays a warning message and default contents are applied. Also, if the default directory does not exist, Cosminexus JMS Provider creates a default directory and enables its use.

Specify a path with read and write permission. If a path with only read permission is specified, the default contents are applied. If the default path has only read permission, the operation fails.

For details about the characters and length of the path that can be specified as the directory name, see the limitations of OS to be used.

Note that if you specify \ in the path, specify as \\ and escape.

path-name

  • In Windows

    <CJMSP_HOME>\var\admin\log

  • In UNIX

    <CJMSP_HOME>/var/admin/log

  • In Windows

    <CJMSP_HOME>\var\admin\log

  • In UNIX

    <CJMSP_HOME>/var/admin/log

08-50

admin.logger.ExceptionLogFile.filesize

Specify the maximum value for the log file size in bytes.

8192 to 4194304

1048576

1048576

08-50

admin.logger.MessageLogFile.filenum

Specify the maximum value of the number of files to be created.

1 to 16

2

2

08-50

admin.logger.MessageLogFile.filepath

Specify the absolute path of the storage location of the log file.

The file is created automatically with the name, cjmsadmin_msgN.log. N refers to the number of log files.

If the specified directory does not exist, Cosminexus JMS Provider displays a warning message and default contents are applied. Also, if the default directory does not exist, Cosminexus JMS Provider creates a default directory and enables its use.

Specify a path with read and write permission. If a path with only read permission is specified, the default contents are applied. If the default path has only read permission, the operation fails.

For details about the characters and length of the path that can be specified as the directory name, see the limitations of OS to be used.

Note that if you specify \ in the path, specify as \\ and escape.

path-name

  • In Windows

    <CJMSP_HOME>\var\admin\log

  • In UNIX

    <CJMSP_HOME>/var/admin/log

  • In Windows

    <CJMSP_HOME>\var\admin\log

  • In UNIX

    <CJMSP_HOME>/var/admin/log

08-50

admin.logger.MessageLogFile.filesize

Specify the maximum value of the log file size.

8192 to 4194304

1048576

1048576

08-50

admin.logger.MessageLogFile.trace.level

Specify the log level.

Information is recorded in the log file on the basis of the specified level.

The following strings can be specified:

  • ERROR

  • WARNING

  • INFO

ERROR

ERROR

08-50