Installed file structure

The following subsections describe the installed file structure of the adapter on Windows, OS/400, and Linux platforms.

For instructions on installing the adapter on these systems, see the WebSphere Business Integration Server Express installation guide for Windows, for Linux, or for OS/400. Table 1 describes the Windows file structures, Table 2 describes the OS/400 file structures, and Table 3 describes the Linux file structures used by the connector.

For more information on installing the connector component, refer to the following guides:

Installed file structure for Windows


Table 1. Installed Windows file structure for the connector

Subdirectory of %ProductDir% Description
connectors\XML Contains the connector CWXML.jar, CWProtocolHandler.jar, start_XML.bat and start_XML_service.bat files.
connectors\XML\Dependencies\Sun Contains jcert.jar, jnet.jar, and jsse.jar files that are required for https connections.
connectors\messages Contains the XMLConnector.txt file.
repository\XML Contains the CN_XML.txt file.
connectors\XML\Samples Contains java and xml files and sample business objects used for testing.
\lib Contains the WBIA. jar file.
\bin Contains the CWConnEnv.bat file.

Installed file structure for OS/400


Table 2. Installed OS/400 file structure for the connector

Subdirectory of %ProductDir% Description
connectors/XML Contains the connector CWXML.jar, CWProtocolHandler.jar and start_XML.sh files.
connectors/XML/Dependencies/Sun Contains the mail.jar file.
/QIBM/UserData/WBIServer43 Location for jcert.jar, jnet.jar and jsse.jar files that are required for https connections.
To use the Adapter for XML with your OS/400 system, you must obtain the appropriate jsse.jar, jnet.jar, and jcert.jar. files for use with IBM OS/400 V5R2, V5R3 and add them to this directory. These files are available as downloads from the Sun web site at:
http://java.sun.com/products/jsse/.
To set up these files, see the steps following this table.
connectors/messages Contains the XMLConnector.txt file.
repository/XML Contains the CN_XML.txt file.
connectors/XML/Samples Contains java and xml files and sample business objects used for testing.
/lib Contains the WBIA. jar file.
/bin Contains the CWConnEnv.sh file.

To use the XML adapter with encryption on OS/400, you must manually install some jar files that are not shipped with this product.

Perform the following steps to install the jar files in /QIBM/UserData/WBIServer43 to use the adapter with OS/400:

  1. Obtain the appropriate jsse.jar, jnet.jar, and jcert.jar. files for use with IBM OS/400 V5R2, V5R3 and from the Sun web site at:
    http://java.sun.com/products/jsse/
  2. Unzip the jsse jar to hard-disk which creates a jsse product directory. Under the jsse directory there is a /lib directory (for example: \jsse1.0.3_03\lib\) that contains the necessary jsse jars to run the adapter.
  3. Copy the three jar files in the /lib directory to the OS/400 IFS in the following location:
    /QIBM/UserData/WBIServer43
    (you can use Windows Explorer and copy to the IFS mapped drive).
  4. After the jars are copied to IFS, the owner of the jar files should be changed to QWBISVR43 with the following CL commands:

    CHGOWN OBJ('/QIBM/UserData/WBIServer43/jnet.jar') NEWOWN(QWBISVR43) RVKOLDAUT(*YES)

    CHGOWN OBJ('/QIBM/UserData/WBIServer43/jcert.jar') NEWOWN(QWBISVR43) RVKOLDAUT(*YES)

    CHGOWN OBJ('/QIBM/UserData/WBIServer43/jsse.jar') NEWOWN(QWBISVR43) RVKOLDAUT(*YES)

  5. The start_XML.sh script must be edited to include the jar files in the classpath.

    Edit the following file:
    /QIBM/UserData/WBIServer43/<ICSName>/connectors/
    <XMLBasedConnector>/start_XML.sh
    - where <ICSName> is the name of the ICS server on OS/400 for which the adapter is being configured for
    - where <XMLBasedConnector> is an XML connector
    for example: 'XMLConnector' (for the default), or 'MyXMLConnector 'if the user created a custom XML adaper named MyXMLConnector)

    Uncomment (remove the hash '#' character at the beginning of the line) line 30 to read:
    export JAVA_JSSE=/QIBM/UserData/WBIServer43/jcert.jar:/QIBM/UserData/
    WBIServer43/jnet.jar:/QIBM/UserData/WBIServer43/jsse.jar

    Uncomment line 43 to read:
    export JCLASSES=${JCLASSES}:${JAVA_JSSE}

Installed file structure for Linux


Table 3. Installed Linux file structure for the connector

Subdirectory of %ProductDir% Description
connectors/XML Contains the connector CWXML.jar,CWProtocolHandler.jar and start_XML.sh files.
connectors/XML/Dependencies/Sun Contains jcert.jar, jnet.jar, and jsse.jar files that are required for https connections.
connectors/messages Contains the XMLConnector.txt file.
repository/XML Contains the CN_XML.txt file.
connectors/XML/Samples Contains java and xml files and sample business objects used for testing.
/lib Contains the WBIA. jar file.
/bin Contains the CWConnEnv.sh file.

Installer adds an icon for the connector file to the IBM WebSphere Business Integration Adapters menu. For a fast way to start the connector, create a shortcut to this file on the desktop.

Copyright IBM Corp. 2004