11.3.1 cosminexus.xml

The cosminexus.xml file is a property file describing the Cosminexus Application Server-specific definition information related to the applications. You can create cosminexus.xml for each application.

By including cosminexus.xml in the archive-format applications and importing or re-deploying the applications, and by including cosminexus.xml in the exploded archive-format applications and starting the applications, you can execute the applications with the Cosminexus Application Server-specific definition information specified.

For the applications containing cosminexus.xml, the DD information and the Cosminexus Application Server-specific information are managed separately. Therefore, when you edit the Cosminexus Application Server-specific information, you need not edit the DD information. With the applications containing cosminexus.xml, the command-based application attribute settings need not be specified on the J2EE server.

The following figure shows the concept of the applications containing cosminexus.xml.

Figure 11-1 Conceptual diagram of the applications containing cosminexus.xml

[Figure]

The following figure shows an example of associating the cosminexus.xml and DD definitions.

Figure 11-2 Example of associating the cosminexus.xml and DD definitions

[Figure]

The following is a description of the figure. In this example, the resource references from the EJB-JAR are resolved and the resource properties are set up using cosminexus.xml. Note that the numbers in the description correspond to the numbers in the figure.

  1. Identify the target EJB-JAR with <module-name>. In this example, adder.jar is set as the target.
  2. Associate the DD (ejb-jar.xml) and cosminexus.xml of adder.jar. In this example, the target Session Bean (MyAdder) is specified in <ejb-name>.
  3. Resolve the resource references of the resource (MyRef) being referenced with the Session Bean (MyAdder). Specify the resource display name (DBC) in <linked-to> as the reference location for the name specified in <res-ref-name>.
  4. Specify the properties for the resource (DBC). Note that the properties of the resource adapters included in the J2EE application can be specified in cosminexus.xml.

By including and importing this cosminexus.xml in the J2EE application, you need not resolve the resource references and set the resource adapter properties on the J2EE server.