The following is the flow of starting an EJB client application using the cjclstartap command:
- Specify the environment variables required for executing the EJB client application.
Among all the environment variables required for executing the EJB client application, specify only the environment variables that are required when you execute the EJB client application using the cjclstartap command. For details on the required environment variables, see 3.3.4 Specifying the environment variables required for executing an EJB client application.
- In the option definition file (usrconf.cfg) of the EJB client application, specify the Java options and the class path of the JAR files.
- Storage location of usrconf.cfg
- A sample of usrconf.cfg is saved in the following location. Copy this sample file to any location of your choice, and then use.
- In Windows
- Cosminexus-installation-directory\CC\client\templates\usrconf.cfg
- In UNIX
- /opt/Cosminexus/CC/client/templates/usrconf.cfg
- Specifying the JavaVM startup options
- Specify the JavaVM startup options in the add.jvm.arg key of usrconf.cfg. For details on the options that can be specified, see 16. JavaVM Startup Options in the uCosminexus Application Server Definition Reference Guide.
- Specifying the class path of the JAR files
- Specify the class path of the JAR file in the add.class.path key of usrconf.cfg. For details on the JAR files that you must specify in the class path, see 3.7.4 Specifying JAR files in the class path of the EJB client application.
- Specify the properties in the property file (usrconf.properties) of the EJB client application.
- Storage location of usrconf.properties
- A sample of usrconf.properties is saved in the following location. Copy this sample file to any location of your choice, and then use the file.
- In Windows
- Cosminexus-installation-directory\CC\client\templates\usrconf.properties
- In UNIX
- /opt/Cosminexus/CC/client/templates/usrconf.properties
- Specifying properties
- For details on the contents that can be specified in the properties, see 3.3.5 Specifying the property of an EJB client application. If necessary, also see 3.5.3 Precautions during the implementation of a transaction in the EJB client application, 3.8 System log output of an EJB client application, and 9.10 User log output settings for EJB client applications (when using the cjclstartap command) in the uCosminexus Application Server Expansion Guide.
- For details on the properties that can be specified, see 14.3 usrconf.properties (User property file for Java applications) in the uCosminexus Application Server Definition Reference Guide.
- When usrconf.cfg and usrconf.properties are saved in a location other than the current directory in which the cjclstartap command is executed, specify the absolute path of the storage location of usrconf.cfg and usrconf.properties with the environment variable CJCLUSRCONFDIR.
Save the created files usrconf.cfg and usrconf.properties in the same directory and specify the absolute path of that directory with the environment variable CJCLUSRCONFDIR.
This operation is not required when usrconf.cfg and usrconf.properties are saved in the current directory in which the cjclstartap command is executed. Proceed to step 5.
- Use the cjclstartap command to start the EJB client application.
For details on the cjclstartap commands, see cjclstartap (Starting Java applications) in the uCosminexus Application Server Command Reference Guide.
- Note
- When you use uCosminexus Client to create the EJB client environment, replace Cosminexus-installation-directory\CC in the storage directory with Cosminexus-installation-directory\CCL.
When false is set up in ejb.client.directory.shareable, and the cjclstartap command is executed, the work file that will be used by the command is created. If the work file is corrupt, the operation of the cjclstartap command or cjcldumpap command will not be guaranteed. The output destination of the work file and the file name are as follows:
- In Windows
- Current-directory\.cjclstartap.lock
- ejb-clien-log-directory\.ejbclientlog.lock
- Current-directory\cjclstartap.pid
- In UNIX
- Current-directory/.cjclstartap.lock
- ejb.client.log-directory/.ejbclientlog.lock
- Current-directory/cjclstartap.pid
- Current-directory/.COSMINEXUS_CC_EJBCLIENT_ProcessID
- Reference note
- You can also use the cjclstartap command to start Java applications. For details on how to start Java applications by using the cjclstartap command, see cjclstartap (Starting Java applications) in the uCosminexus Application Server Command Reference Guide.
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.