C.2 Work directory of the batch server
A batch server creates directories or files by using the server names in a work directory. The directory names, file names and the path length have an upper limit, and the batch server cannot operate normally if the entire work directory does not fit into the entire path. This section describes the structure of a work directory and the formulas used to estimate the path length of a work directory.
- Organization of this subsection
(1) Structure of the work directory of the batch server
The work directory of the batch server is the work area required for operating the batch server. Information such as user password information and information of the imported resource adapter is stored in this work area.
-
A batch server has an exclusive directory structure for each batch server under the work directory. This allows you to specify common directories for multiple batch servers.
-
If you move the work directory to another machine, the batch server on another machine cannot recognize the work directory.
-
In a work directory, you cannot use a path name containing a two-byte code.
-
The default work directories are as follows:
-
For Windows
Cosminexus-installation-directory\CC\server\public
-
For Unix
/opt/Cosminexus/CC/server/public
You can change the work directory by using the ejb.public.directory parameter in the configuration tag of the logical J2EE server (j2ee-server) of the Easy Setup definition file.
-
A batch server has the following work directories:
-
J2EE resource
-
J2EE resource adapter (configuration related)
-
J2EE resource adapter (deployment related)
Note that 2. and 3. are same as that of the J2EE server. For details see, Appendix C.1 (1)(d) J2EE resource adapter (configuration related) and Appendix C.1 (1) (e) J2EE resource adapter (deployment related).
The following subsection describes the structure of the work directory of the J2EE resource. The subsection also describes the directory structure after executing the migration command.
(a) J2EE resource
The following figure shows the directory structure with the description of each directory. The numbers mentioned in the figure correspond to the numbers mentioned in the description. Also, if the same directory contains various types of files, only the longest file name is listed.
-
This directory is created for each RAR file. The directory name is given based on the RAR file name.
-
The RAR files are stored with a 17 digit number.rar file name.
(b) Directory structure of batch server after executing migration command
When you execute the migration command of the batch server, a directory with the name work directory_old is created under the work directory, and the files in the work directory of the earlier version are saved in that directory. This directory structure is same as the directory structure after executing the migration command of the J2EE server. For details, see Appendix C.1 (1) (h) Directory structure of the J2EE Server or Web container server (compatibility functionality), after executing the migration command. In this case, read the term "J2EE server" as "batch server".
(c) Directory structure of resource adapter after executing migration command
When you execute the migration command of the resource adapter, a directory with the name rarupdate_bk is created, and resource adapter files of each batch server are saved in that directory. For details on the directory structure of a resource adapter after executing the migration command, see Appendix C.1(1)(i) Directory structure of the resource adapter after executing migration command.
(2) Formulas for estimating the path length of the work directory
The following are the formulas for estimating the path length of the work directory (unit: bytes). Adjust various parameters so that all of these formulas are satisfied. Also, the maximum path length used in these formulas is the path length limit specified for the OS. For details on the path length limit of the OS, check your OS documents.
Note that the maximum path length in Windows is 259 bytes.
-
A+2 × B+C+D+61 ≤ maximum path length
-
A+2 × B+C+E+34 ≤ maximum path length
-
E+F+18 ≤ maximum path length
- Legend:
-
A: Path length up to the work directory
B: Length of the work directory name
C: Length of the longest server name
D: Length of the longest file name among the imported RAR file names
E: Length of the longest resource adapter display name
F: Length of the log file output directory path (value specified with the ejb.Server.log.directory parameter in the configuration tag of the logical J2EE server (j2ee-server) of the Easy Setup definition file