4.3.1 Importing the resource adapter

You import the resource adapter.

Note that when importing independent resource adapters other than those provided by Application Server, import the resource adapters as per the description given in Notes.

Execute the following command to import the resource adapters:

Execution format

cjimportres [server-name] [-nameserver provider-URL] -type rar -f file-path

Example of execution

cjimportres MyServer -type rar -f mqcadpt.rar

For details on the cjimportres command, see cjimportres (import resource) in the uCosminexus Application Server Command Reference Guide.

Note:

• You cannot import the RAR file with a DD not conforming to the specifications of J2EE Connector 1.0. You can only import a RAR file with a DD conforming to the specifications of J2EE Connector 1.0. Check whether the DD is as per the DTD and then import the resource adapter.

  The following figure shows the procedure for importing the resource adapters:

  Figure 4‒1: Procedure for importing the resource adapter (RAR)

#1

The DD is handled as a validated XML document. Therefore, an error occurs either when the DOCTYPE declaration in the DD is wrong, or when the DD does not comply with the DTD specifications published by Sun Microsystems Inc.

#2

An error occurs when a value based on the J2EE Connector specifications is not specified in the DD. For details, see 4.1.26 Setting DB Connector (when using CUI) in the uCosminexus Application Server System Setup and Operation Guide.

If a message is output, see the manual uCosminexus Application Server Messages and take measures.

• The RAR file name specified when importing the resource adapter is used as the directory name in the work directory. The JAR file or the native library in the RAR file is deployed in the work directory. Specify the RAR file name and the file names in the RAR file so that the path length of the work directory does not reach the limit specified for the platform. For estimating the path length of the work directory for a system that executes J2EE applications, see C.1 Work directory of the J2EE server in the uCosminexus Application Server System Setup and Operation Guide. For estimating the path length of the work directory for a system that executes batch applications, see C.2 Work directory of the batch server in the uCosminexus Application Server System Setup and Operation Guide.

• When the <display-name> tag of ra.xml is not set, the Display name is decided on the basis of the RAR file name.

• Do not include files with the following names in the RAR file:

  rar.properties

  fileinfo.properties

  META-INF/hitachi-ra.xml

To Page Top