14.3 usrconf.properties (User property file for Java applications)

Organization of this section
(1) Format
(2) File storage location
(3) Functionality
(4) Keys for customizing the Java applications
(5) Examples of coding

(1) Format

J2SE property file 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.
  • You cannot add alphanumeric strings such as spaces and comments after the value. If you add such values, they will be considered as invalid.
(Example) key-name=value#comment
  • Use the ISO 8859-1 character encoding according to the Java specifications for the characters to be encoded.
  • If the format does not conform to Java specifications, the Java application might fail to start.
    (Example) When the format contains an invalid Unicode escape sequence (the string after "\u" is not an appropriate Unicode hexadecimal value).

(2) File storage location

#
This is the directory specified in the user definition file storage location environment variable (CJCLUSRCONFDIR). Always specify this environment variable before executing the cjclstartap command. For details on the environment variable settings required to execute EJB client applications, see <3.3.4 Environment variable settings required to execute EJB client applications in the manual uCosminexus Application Server EJB Container Functionality Guide.

(3) Functionality

This file specifies the system properties of the JavaVM that executes the Java application when you use the cjclstartap command.

If you specify the same key in the usrconf.properties file and in -D of add.jvm.arg of the usrconf.cfg file, the value specified in usrconf.properties is given priority.

If you change the contents of this file while the Java application is running, the changes are applied only when the Java application is started next.

(4) Keys for customizing the Java applications

You can customize the operations of the Java applications by setting values for the following system property keys in the start command of the Java application:

The keys are classified and explained as follows:

The following table lists the keys that you can specify in the usrconf.properties file for the Java applications:

Note
The following contents are explained:
  • Overview of the keys that you can specify in the usrconf.properties file for the Java applications
    Of the keys that can be specified, those that are common with the usrconf.properties file for the J2EE server are not explained in detail here.
    For details on the common keys, see 2.4 usrconf.properties (User property file for J2EE servers). In the case of Java applications, read 'Java application' in place of 'J2EE server'.
    This subsection also explains the details of keys, if the specification contents and the keys for J2EE server differ greatly.
  • Differences with the keys for J2EE server (when the keys and the specification contents of the usrconf.properties file for J2EE server are different)
    This subsection explains the details about the keys when specifications for the Java application keys and the J2EE server keys are different. If differences are not specifically coded, specify the same contents as the keys of the usrconf.properties file for the J2EE server. Note the differences in the Difference column.
  • Details of the usrconf.properties file-specific keys for the Java application
    This subsection explains the details of the usrconf.properties file-specific keys for the Java applications.
(a) Keys beginning with ejbserver.application

The keys that begin with ejbserver.application and can be specified in the usrconf.properties file for Java applications are listed below. For details on the keys that are common with the usrconf.properties file for the J2EE server, see 2.4(5)(b)Keys beginning with ejbserver.application.

Key nameDifferenceContentsDefault value
ejbserver.application.userlog.CJLogHandler.handler-name#1.appnameNoneSpecify the default application name that is output to the AppName field.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.autoFlush.enabledUniqueSpecify whether flush is to be carried out after the message is output.
If you specify true:
The flush command will be executed for every message.
If you specify false:
The flush command will not be executed.
This specification is not necessary when you do not use CJMPMessageFileHandler. Do not specify true when java.util.logging.Handler.flush() is explicitly invoked in the application program.
false
ejbserver.application.userlog.CJLogHandler.handler-name#1.countNoneSpecify the number of log files.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.encodingNoneSpecify encoding of the character strings to be output.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.filterNoneSpecify the filter to be used with its full name, including the package name.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.formatterNoneSpecify the formatter that you will use along with its full name, including the package name.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.levelNoneSpecify an upper-limit of a log collection level.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.limitNoneSpecify the capacity of a log file.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.msgidNoneSpecify the default message ID that is output to the MsgID field.--
ejbserver.application.userlog.CJLogHandler.handler-name#1.pathExistsSpecify a value from 1 to 255 bytes for the prefix of a log file name. Specify the path as a relative path. Do not specify a single-byte numeric value at the end of the path name.
The value obtained by adding "xx (an integer between 1 to 16).log" to the prefix specified in this key forms the name of the trace information file.
The single-byte alphanumeric characters specified in the path are not case-sensitive. Specify the length of the path value, such that the total of the following A + B + C values is within the range of the value:
  • A (in Windows): log-output-destination-root (value of ejbserver.client.log.directory)\user\ (by default, Cosminexus-installation-directory\CC\client\logs\user\)
  • A (in UNIX): log-output-destination-root (value of ejbserver.client.log.directory) /user/ (by default, /opt/Cosminexus/CC/client/logs/user/)
  • B: Length of the prefix specified by the user
  • C: Six characters of "xx.log"

Apart from the above, note the following when specifying the path:
  • Double-byte codes of native cannot be used in the Properties file, therefore, acquire and specify the Unicode strings by using native2ascii.
  • Do not specify as an absolute path. Do not use "..\" ("../" in Unix) of a relative path.
  • If the path includes Japanese characters, JavaVM needs to be running in an environment where the locale settings enable the processing of Japanese characters.
You cannot set the same path as another handler. If you set the same path, the handler is not created.
--
ejbserver.application.userlog.CJLogHandler.handler-name#1.separatorNoneUse the CJSimpleFormatter and specify a separator to output a message in one sentence.--
ejbserver.application.userlog.loggersNoneDeclare the names of the loggers to be used.--
ejbserver.application.userlog.Logger.logger-name#2.filterNoneSpecify the full name including the package name of the filter used in the logger.--
ejbserver.application.userlog.Logger.logger-name#2.handlersNoneSpecify the handler class for the specified logger name.--
ejbserver.application.userlog.Logger.logger-name#2.levelNoneSpecify the log output level of the logger.--
ejbserver.application.userlog.Logger.logger-name#2.useParentHandlersNoneSpecify whether the log record is to be transmitted from the logger that received the log record to the handler connected to the parent logger.--
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(b) Keys beginning with ejbserver.application.
Unique:
This is a key specific to the usrconf.properties file for Java applications. For details about keys, see the Contents column.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(b) Keys beginning with ejbserver.application.
#1
Use the handler name to differentiate between the property values. Specify a class character set from 1 to 1024 bytes beginning with a single-byte alphanumeric character for the handler name. If you specify default, handler name indicates a property that is recognized as the common default value by all CJLogHandler.
#2
Logger name has "." that is specified for getting the instances of logger by Logger.getLogger (logger-name). Logger name must be declared beforehand in the ejbserver.application.userlog.loggers property. For details on the logger name, follow the specifications of java.util.logging.Logger.
Specify a class character set from 1 to 1024 bytes beginning with a single-byte alphanumeric character for the handler name. If you specify default, handler name indicates a property that is recognized as the common default value by all CJLogHandler.
The properties identified by the logger names are used for initializing the logger class of the user log functionality.
If a logger name ends with .handlers, there may be confusion when the properties of ejbserver.application.userlog.Logger.logger-name.handlers are specified, and therefore, Hitachi recommends that you do not end a logger name with ".handlers".

(b) Keys beginning with ejbserver.client

The keys that begin with ejbserver.client and can be specified in the usrconf.properties file for the Java application are listed below. For details on the keys that are common with the usrconf.properties file for the J2EE server, see 2.4(5)(c)Keys beginning with ejbserver.client.

When using uCosminexus Client, read the storage directory Cosminexus-installation-directory\CC as Cosminexus-installation-directory \CCL.

Key nameDifferenceContentsDefault value
ejbserver.client.ctm.RequestPriorityNoneSpecify the priority (priority order) for extracting the request accumulated in the queues within CTM.--
ejbserver.client.ejb.logUniqueSpecify a value from 1 to 16 bytes for the name of the log output directory of the messages output by the Java application under the directory specified in the ejbserver.client.log.directory key. You can specify only single byte alphanumeric characters, underscore (_), and hyphen (-). You use a slash (/) as the directory path delimiter. When using multiple Java applications, specify the log output destinations for every EJB application.
When the specified directory name or file name does not have access permission, the message KDJE51003-E is output in standard output and cjlogger.log file and the Java application is terminated.
The output destination for some logs cannot be changed with this key. To change the log output destination, specify the ejb.client.ejb.log key in the option definition file for Java applications (usrconf.cfg).
None
ejbserver.client.log.appidUniqueSpecify a value from 1 to 16 bytes for the log output subdirectory of the Java application.
You can specify only single byte alphanumeric characters, underscore (_), and hyphen (-). When this key is specified, the same subdirectory is used every time and therefore, the subdirectory is not deleted. If you use this key in the cases where you do not invoke one Java application many times, then you can manage the log file in an exclusive subdirectory. Do not specify this key when concurrently invoking multiple applications.
If the specified string exceeds 16 bytes, the message KDJE51002-W is output to the cjlogger.log file and normal value is used.
The output destination for some logs cannot be changed with this key. To change the log output destination, specify the ejb.client.log.appid key in the option definition file for Java applications (usrconf.cfg).
None
ejbserver.client.log.directoryUniqueSpecify a value from 1 to 200 bytes for the absolute path of the log output destination of the Java application.
You can specify only single byte alphanumeric characters, underscore (_), hyphen (-), and space (). You can specify space only in Windows. To specify a directory containing whitespace#, enclose the path with double quotation marks ("). For example, when setting C:\logs\ejb client, specify the path as follows:

ejbserver.client.log.directory="C:\logs\ejb client"

When the specified path exceeds 200 bytes, the message KDJE51001-W is output to the cjlogger.log file and the normal value is used. When a path is not specified, the message KDJE51002-W is output to the cjlogger.log file and the normal value is used.
When there is no access permission to the directory or when the file name is specified, the message KDJE51003-E is output to standard output and cjlogger.log file and the Java application is terminated.
In the case of using normal value, if you invoke the Java application by using Java other than the Cosminexus Developer's Kit for Java, the message KDJE51004-W is output to the cjlogger.log file and Java application execution directory is used.
In Windows, you cannot specify a path that includes a UNC name. In UNIX, you cannot specify a path of an nfs-mounted disk.
The output destination for some logs cannot be changed with this key. To change the log output destination, specify the ejb.client.log.directory key in the option definition file for Java applications (usrconf.cfg).
None
ejbserver.client.log.lockIntervalUniqueSpecify the retry interval (unit: milliseconds) as integers from 0 to 2147483647​ for failure in an attempt of exclusive processing of log files. If the specified value is out of the range or is not an integer, the message KDJE51002-W is output to the cjlogger.log file and the default value is used. This key is used when the Java application operating in the shared subdirectory mode terminates after the output of the message KDJE90002-E to the cjlogger.log file.10
ejbserver.client.log.lockRetryCountUniqueIf the exclusive process of the log file fails, specify the retry frequency (unit: times) in integers from 0 to 2147483647​. If the specified value is out of the range and is not an integer, the message KDJE51002-W is output to the cjlogger.log file and the default value is used. This key is used when the Java application operating in the shared subdirectory mode terminates after the output of the message KDJE90002-E to the cjlogger.log file.1000
ejbserver.client.transaction.clientNameUniqueSpecify a string from 1 to 128 characters for the client name used by the transaction service. You can specify single byte alphanumeric characters, (0-9, A-Z, a-z), underscore (_) and hyphen (-).
You need to specify a client name that is different for each process of the Java application.
Moreover, you need to specify a client name that is different from the name of the J2EE server operating on the same machine.
None
ejbserver.client.transaction.enabledUniqueSpecify whether transaction is to be used in the Java application.
If you specify true:
The transaction can be used.
If you specify false:
The transaction cannot be used.
false
Legend:
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(c) Keys beginning with ejbserver.client.
Unique:
This is a key specific to the usrconf.properties file for Java applications. For details about keys, see the Contents column.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(c) Keys beginning with ejbserver.client.
#
Whitespace imply single-byte spaces, tabs, LF (0x0a), CR (0x0d) or FF (0x0c).

(c) Keys beginning with ejbserver.container

The keys that begin with ejbserver.container and can be specified in the usrconf.properties file for the Java application are listed below. For details about the usrconf.properties file for J2EE servers and the common keys, see 2.4(5)(h) Keys beginning with ejbserver.container.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Key nameDifferenceContentsDefault valueRelated information
ejbserver.container.rebindpolicyNoneSpecify re-connection and re-sending of requests in the EJB client, in the case of a communication failure when invoking the EJB method.--2.13 Invoking the EJB remote interface in EJB Container Functionality Guide
Legend:
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(h) Keys beginning with ejbserver.container.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(h) Keys beginning with ejbserver.container.

(d) Keys beginning with ejbserver.distributedtx

The keys that begin with ejbserver.distributedtx and can be specified in the usrconf.properties file for the Java application are described below. For details about the keys that are common with the usrconf.properties file of J2EE servers, see 2.4(5)(k) Keys beginning with ejbserver.distributedtx.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Key nameDifferenceContentsDefault valueRelated information
ejbserver.distributedtx.ots.status.directory1ExistsSpecify the directory for storing the status file of the in-process transaction service and the backup of the status file as maintenance data. You use a forward slash (/) as the path delimiter.
When an absolute path is specified in the application server, the path begins from the following directory:
  • In Windows
    Cosminexus-working-directory\ejb\server-name
  • In UNIX
    Cosminexus-working-directory/ejb/server-name
When an absolute path is specified in the Java, the path begins from the execution directory of the Java.
You need to specify a different directory so that the path does not overlap with the path of other J2EE servers or other Java application processes running on the same machine.
None3.4 Managing transactions in Common Container Functionality Guide
ejbserver.distributedtx.ots.status.directory2NoneWhen replicating the status file of in-process transaction service, specify a directory that stores the backup of spare status files and the spare status files used as maintenance data.--3.4 Managing transactions in Common Container Functionality Guide
ejbserver.distributedtx.recovery.portExistsSpecify an integer from 1 to 65535 for the fixed port number that is used for transaction recovery. If an invalid value is specified and when the specified port is already being used, an error occurs in the initialization process.None
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(k) Keys beginning with ejbserver.distributedtx.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(k) Keys beginning with ejbserver.distributedtx.
Blank column:
Related information does not exist.

(e) Keys beginning with ejbserver.jndi

The keys that begin with ejbserver.jndi and can be specified in the usrconf.properties file for the Java application are listed below. For details on the keys that are common with the usrconf.properties file for the J2EE server, see 2.4(5)(r) Keys beginning with ejbserver.jndi.

Key nameDifferenceContentsDefault value
ejbserver.jndi.cacheExistsSpecify whether to implement the caching of distributed objects.
For caching:
Specify on.
For not cashing:
Specify off.
You need to specify com.hitachi.software.ejb.rmi.PortableRemoteObject in the javax.rmi.CORBA.PortableRemoteObjectClass key and com.hitachi.software.ejb.rmi.Util in the javax.rmi.CORBA.UtilClass key.
off
ejbserver.jndi.cache.intervalExistsIn the case of caching of distributed objects, specify an integer from 0 to 2147483647​ (units: seconds) as the interval for clearing the cache. If you specify a value other than a number from 1 to 2147483647​, the cache is not cleared. You need to specify com.hitachi.software.ejb.rmi.PortableRemoteObject in the javax.rmi.CORBA.PortableRemoteObjectClass key and com.hitachi.software.ejb.rmi.Util in the javax.rmi.CORBA.UtilClass key.
When using the failure detection functionality of the Naming Service, Hitachi recommends you to specify a short interval value (60 seconds).
--
ejbserver.jndi.cache.interval.clear.optionNoneDecide the operations to be performed in the cache area of naming, after the lapse of the interval.--
ejbserver.jndi.namingservice.group.listNoneDefine the group of logical naming service that is to be searched during the round-robin search.--
ejbserver.jndi.namingservice.group.specify-group-name.providerurlsNoneSpecify the root location of the Naming Service of each group.--
ejbserver.jndi.request.timeoutNoneSpecify the timeout period of communication with the Naming Service.--
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(r) Keys beginning with ejbserver.jndi.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(r) Keys beginning with ejbserver.jndi.

(f) Keys beginning with ejbserver.jta

The keys that begin with ejbserver.jta and can be specified in the usrconf.properties file for the Java application are listed below:

Key nameDifferenceContentsDefault value
ejbserver.jta.TransactionManager.defaultTimeOutExistsSpecify the transaction timeout default value (units: seconds) of the transaction that has been started in the Java application in the following range:
In 1.4 mode:
1 to 2147483647​
--
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(t) Keys beginning with ejbserver.jta.

(g) Keys beginning with ejbserver.logger

The keys that begin with ejbserver.logger and can be specified in the usrconf.properties file for the Java application are listed below:

Key nameDifferenceContentsDefault value
ejbserver.logger.channels.define.channel-name#.filenumExistsSpecify the number of log files of the Java application.
Specify integers from 1 to 64.
To change the number, stop all the processes that are generating output to the corresponding log file and either move the log file and the log management file under the mmap directory to a different directory or delete the files.
2
ejbserver.logger.channels.define.channel-name#.filesizeExistsSpecify integers from 4096 to 16777216​.
To change the size, stop all the processes that are generating output to the corresponding log file and either move the log file and the log management file under the mmap directory to a different directory or delete the files.
1048576​
ejbserver.logger.enabled.*ExistsSpecify the log level. Specify either one or more from among Error, Warning, Information and Debug.
If you specify only one log level, only the log of the applicable log level is output. When specifying more than one log levels, demarcate each level-name string with a comma (,).
Note that you cannot specify this key when you set the system properties using shell script.
Error
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
#
You can set the following names as channel name:
ClientMessageLogFile, ClientExceptionLogFile, ClientMaintenanceLogFile, EJBContainerLogFile, UserOutLogFile, or UserErrLogFile.
For details on obtaining materials, see <2.3 Acquiring data in the manual uCosminexus Application Server Maintenance and Migration Guide.

(h) Keys beginning with ejbserver.rmi

The keys that begin with ejbserver.rmi and can be specified in the usrconf.properties file for the Java application are listed below. For details about the keys that are common in the usrconf.properties file for J2EE servers, see 2.4(5)(y) Keys beginning with ejbserver.rmi.

Key nameDifferenceContentsDefault value
ejbserver.rmi.request.timeoutNoneSpecify timeout period (unit: seconds) when communicating between clients and the server.--
Legend:
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(y) Keys beginning with ejbserver.rmi.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(y) Keys beginning with ejbserver.rmi.

(i) Keys beginning with ejbserver.security

The keys that begin with ejbserver.security and can be specified in the usrconf.properties file for the Java application are listed below:

Key nameDifferenceContentsDefault value
ejbserver.security.service.urlUniqueSpecify the CORBA naming service that is connected to the J2EE server that performs the security authentication processing. Specify this key in the case of performing the authentication processing with the J2EE server that is connected to a naming service other than the naming service specified in java.naming.provider.url. Note that you need to specify the name of the J2EE server to be connected beforehand in the ejbserver.serverName key.
Specify the name using the corbaname format. When the name is not specified, the naming service specified in java.naming.provider.url is used.
(Specified format)
corbaname::host-name-of-the-naming-service:port-number-of-the-naming-service
corbaname::localhost:900
Legend:
Unique:
This is a key specific to the usrconf.properties file for Java applications. For details about keys, see the Contents column.

(j) Keys beginning with ejbserver.server

The keys that begin with ejbserver.server and can be specified in the usrconf.properties file for the Java application are listed below. For details about the keys that are common in the usrconf.properties file for J2EE servers, see 2.4(5)(z) Keys beginning with ejbserver.server.

Key nameDifferenceContentsDefault value
ejbserver.serverNameUniqueSpecify the name of the J2EE server that connects to the Java application.None
ejbserver.server.prf.PRFIDNoneSpecify the PRF identifier.--
Legend:
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(z) Keys beginning with ejbserver.server.
Unique:
This is a key specific to the usrconf.properties file for Java applications. For details about keys, see the Contents column.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default values, see 2.4(5)(z) Keys beginning with ejbserver.server.

(k) Keys beginning with ejbserver.stdoutlog

The keys that begin with ejbserver.stdoutlog and can be specified in the usrconf.properties file for Java applications are as follows. For details about the keys that are common with the usrconf.properties file of J2EE servers, see 2.4(5)(ab) Keys beginning with ejbserver.stdoutlog.

Key nameDifferenceContentsDefault value
ejbserver.stdoutlog.autoflushNoneSpecify whether to enable the automatic flush functionality of the user output log and user error log.--
Legend:
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about keys, see 2.4(5)(bb) Keys beginning with ejbserver.stdoutlog.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about default values, see 2.4(5)(bb) Keys beginning with ejbserver.stdoutlog.

(l) Keys beginning with https

The keys that begin with https and can be specified in the usrconf.properties file for Java applications are as follows. For details on the keys that are common with the usrconf.properties file for J2EE servers, see 2.4(5)(ae) Keys beginning with https.

Key nameDifferenceContentsDefault value
https.cipherSuitesNoneSpecify the recommended cipher suite to be used with HttpsURLConnection.--
https.protocolsNoneSet up the protocol to be used with HttpsURLConnection.--
Legend:
None:
This key is common to the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details on the keys, see 2.4(5)(ae) Keys beginning with https.
--:
This is a default value common to the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details on the default values, see 2.4(5)(ae) Keys beginning with https.

(m) Keys beginning with java

The keys that begin with java and that can be specified in the usrconf.properties file for the Java application are listed below. For details about the usrconf.properties file for J2EE servers and the common keys, see 2.4(5)(ff) Keys beginning with java.

Key nameDifferenceContentsDefault value
java.naming.factory.initialExistsSpecify the factory class for the implementation class of the context delegated by InitialContext of JNDI. The operation for each set value is as follows:
com.hitachi.software.ejb.jndi.InsContextFactory:
Specify this context when normal search functionality is used instead of the JNDI round-robin search functionality.
com.hitachi.software.ejb.jndi.GroupContextFactory:
Specify this context when the JNDI round-robin search functionality is used during execution of applications (EJB) in the J2EE server.
The key is compatible with the values used in the earlier versions (com.hitachi.software.ejb.jndi.spi.cosnaming.CNCtxFactory).
--
java.naming.provider.urlUniqueSpecify the host name and the port number of the CORBA naming service used by the Java application. The CORBA naming service used here is the one that is used by the J2EE server invoked from the corresponding Java application.
Furthermore, this key is compatible with the protocol (iioploc or iiopname) used in the old versions.
(Specified format)
corbaname::[host-name]:[port-number]
None
javax.xml.datatype.DatatypeFactoryUniqueSpecify the implementation class name of javax.xml.datatype.DatatypeFactory.com.cosminexus.jaxp.impl.parsers.jaxp.datatype.DatatypeFactoryImpl
javax.xml.parsers.DocumentBuilderFactoryUniqueSpecify the implementation class name of javax.xml.parsers.DocumentBuilderFactory.com.cosminexus.jaxp.impl.parsers.jaxp.DocumentBuilderFactoryImpl
javax.xml.parsers.SAXParserFactoryUniqueSpecify the implementation class name of javax.xml.parsers.SAXParserFactory.com.cosminexus.jaxp.impl.parsers.jaxp.SAXParserFactoryImpl
javax.xml.transform.TransformerFactoryUniqueSpecify the implementation class name of javax.xml.transform.TransformerFactory.com.cosminexus.jaxp.impl.transform.processor.TransformerFactoryImpl
javax.xml.xpath.XPathFactory\:http\://java.sun.com/jaxp/xpath/domUniqueSpecify the implementation class name of javax.xml.xpath.XPathFactory.com.cosminexus.jaxp.impl.xpath.jaxp.XPathFactoryImpl
javax.xml.validation.SchemaFactory\:http\://www.w3.org/2001/XMLSchemaUniqueSpecify the implementation class name of javax.xml.validation.SchemaFactory.com.cosminexus.jaxp.impl.parsers.jaxp.validation.XMLSchemaFactory
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
Unique:
This is a key specific to the usrconf.properties file for Java applications. For details about keys, see the Contents column.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about keys, see 2.4(5)(ff) Keys beginning with java.

(n) Keys beginning with org

The keys that begin with org and can be specified in the usrconf.properties file for the Java application are listed below:

Key nameDifferenceContentsDefault value
org.w3c.dom.DOMImplementationSourceListUniqueSpecify the implementation class name of org.w3c.dom.DOMImplementationSourceList.com.cosminexus.jaxp.impl.parsers.dom.DOMXSImplementationSourceImpl
org.xml.sax.driverUniqueSpecify the implementation class name of org.xml.sax.driver.com.cosminexus.jaxp.impl.parsers.parsers.SAXParser
org.xml.sax.parserUniqueSpecify the implementation class name of org.xml.sax.parser.org.xml.sax.helpers.XMLReaderAdapter
Legend:
Unique:
This is a key specific to the usrconf.properties file for Java applications. For details about keys, see the Contents column.

(o) Keys beginning with vbroker

The keys that begin with vbroker and can be specified in the usrconf.properties file for the Java application are described below. For details about the keys that are common in the usrconf.properties file for J2EE servers, see 2.4(5)(hh) Keys beginning with vbroker.

Key nameDifferenceContentsDefault value
vbroker.ce.iiop.ccm.htc.readerPerConnectionNoneSpecify whether to control the closing of the connections when a timeout occurs during the invocation of the EJB method defined as the remote interface.
If true is specified
The closing of the connection will be controlled when the timeout occurs.
If false is specified
The closing of the connection will not be controlled when the timeout occurs.
false
vbroker.orb.htc.comt.entryCountNoneSpecify an upper limit of the entry count for one communication trace file of the Cosminexus TPBroker.--
vbroker.orb.htc.comt.fileCountNoneSpecify an upper limit value of the communication trace file count for Cosminexus TPBroker.15
vbroker.orb.htc.tracePathExistsSpecify a range of 1 to 210 bytes for the path of the output destination of Cosminexus TPBroker trace files. Specify a unique path for each Java application. You need to create comtrc and mdltrc as the subdirectories of the specified path beforehand. In the case of default output destination, the subdirectories comtrc and mdltrc are created automatically when the Java application is invoked for the first time.
Use a forward slash (/) as the delimiter in the directory path. For example, specify as follows to set up /temp/work as the work directory:
vbroker.orb.htc.tracePath=/temp/work
  • In Windows
    value-of-ejbserver.client.ejb.log-directory\TPB\logj
  • In UNIX
    value-of-ejbserver.client.ejb.log.directory/TPB/logj
Legend:
Exists:
There is a difference in the keys of the usrconf.properties file for Java applications and the keys of the usrconf.properties file for J2EE servers. For details about keys, see the Contents column.
None:
This key is common in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the default value, see 2.4(5)(hh) Keys beginning with vbroker.
--:
This is a common default value in the usrconf.properties file for Java applications and the usrconf.properties file for J2EE servers. For details about the keys, see 2.4(5)(hh) Keys beginning with vbroker.

(5) Examples of coding

java.naming.provider.url=corbaname::localhost:900
ejbserver.serverName=MyServer