The method of setting the system log of the EJB client application differs depending upon the command used to invoke the EJB client application.

• Using the cjclstartap command
  When using the cjclstartap command, set up the properties of the system log with the property file of the EJB client application (usrconf.properties).
  
• Using the vbj command
  When using the vbj command, set up the properties of the system log with a batch file or shell script file or with the command arguments.
  

You can change the attributes of the system log of an EJB client application by customizing either the option definition file for Java applications (usrconf.cfg), or the user property file for Java applications (usrconf.properties). The following table describes the items that can be changed and the keys of properties with which changes can be specified. This table also describes the necessity of specifying the properties that are to be specified in the execution commands of the EJB client application.

Table 3-15 Keys used to change the output destination and output level of the system log of an EJB client application

Items that can be changed	Key of the option definition file for Java applications	Key of the user property file for Java applications	Type
Log output destination#1	ejb.client.log.directory	ejbserver.client.log.directory	Variable
Name of the log output destination directory created in each EJB client application#1	ejb.client.ejb.log	ejbserver.client.ejb.log	Selective variable
Name of the log output destination subdirectory created in each process of the EJB client application#1	ejb.client.log.appid	ejbserver.client.log.appid	Selective variable
Termination of message output in standard output#2	ejb.client.log.stdout.enabled	--	Selective variable
Number of log files	--	ejbserver.logger.channels.define.channel-name#3.filenum	Selective variable
Log file size	--	ejbserver.logger.channels.define.channel-name#3.filesize	Selective variable
Log output level#4	--	ejbserver.logger.enabled.*	Selective variable
Output destination of the trace file of Cosminexus TPBroker	--	vbroker.orb.htc.tracePath	Selective variable
Number of trace files of Cosminexus TPBroker	--	vbroker.orb.htc.comt.fileCount	Selective variable
Number of entries in each trace file of Cosminexus TPBroker	--	vbroker.orb.htc.comt.entryCount	Selective variable

Legend:

Variable: The value must be specified according to the execution environment of the system.

Selective variable: Either specify the value according to the execution environment of the system or omit the specification.

--: Cannot be specified

#1

In usrconf.cfg, you can change the settings of the operation log, log operation log, exception information during the occurrence of a failure and maintenance information.

Furthermore, if the same items are set up in usrconf.cfg and usrconf.properties, the contents specified in usrconf.properties will be given priority.

#2

You can specify the settings to prevent the output of messages of the operation log, cjclstartap command log and startup process standard output information in standard output.

#3

The following names that indicate the type of the log are set up as channel names:

ClientMessageLogFile (Operation log) (File name: cjclmessagen.log)

ClientExceptionLogFile (Exception information during the occurrence of a failure) (File name: cjclexceptionn.log)

ClientMaintenanceLogFile (Maintenance information) (File name: cjclmaintenancen.log)

#4

When you set up the system properties using a shell script, you cannot specify the log output level (ejbserver.logger.enabled.* key).

Whether or not you can specify system properties will depend on the usage form of the EJB client application. The following table describes the relationship between the usage form of the EJB client application and system properties. Note that the numbers in Table 3-16 and Table 3-17 correspond to each other.

Table 3-16 Usage form of an EJB client application

Types of EJB client applications	Multiplicity of simultaneous startup of EJB client applications
	1 multiple	2 to 8 multiples	9 to 16 multiples
1 type	1.	2.	3.
2 types or more	4.	5.	6.

Table 3-17 Usage form of the EJB client application and system properties

System property specification	Types of EJB client application usage
	1.	2.	3.	4.	5.	6.
ejbserver.client.ejb.log	Available	Available	Required	Required	Required	Required
ejbserver.client.log.appid	Available	Not available	Not available	Available	Not available	Not available
ejbserver.client.log.directorynum	Available	Available	Required	Available	Available	Required

The description of the numbers specified in the above tables is as follows:

1. You can even specify the default directory in the ejbserver.client.ejb.log key.
   When the ejbserver.client.log.appid key is specified, the specification of the ejbserver.client.log.directorynum key will become invalid.
   
2. You can even specify the default directory in the ejbserver.client.ejb.log key.
   Because multiple EJB client applications are started simultaneously, do not specify the ejbserver.client.log.appid key. When you specify the ejbserver.client.log.directorynum key, make sure to specify the ejbserver.client.ejb.log key.
   
3. Make sure to specify the ejbserver.client.ejb.log key in each EJB client application. Because multiple EJB client applications are started simultaneously, do not specify the ejbserver.client.log.appid key. Specify the value of the ejbserver.client.log.directorynum key according to the multiplicity.
4. Make sure to specify the ejbserver.client.ejb.log key in each EJB client application.
   When the ejbserver.client.log.appid key is specified, the specification of the ejbserver.client.log.directorynum key will become invalid.
   
5. Make sure to specify the ejbserver.client.ejb.log key in each EJB client application. Because multiple EJB client applications are started simultaneously, do not specify the ejbserver.client.log.appid key.
   When you specify the ejbserver.client.log.directorynum key, make sure to specify the ejbserver.client.ejb.log key.
   
6. Make sure to specify the ejbserver.client.ejb.log key in each EJB client application. Because multiple EJB client applications are started simultaneously, do not specify the ejbserver.client.log.appid key. Specify the value of the ejbserver.client.log.directorynum key according to the multiplicity.