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:
Table 1. Installed Windows file structure for the connector
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:
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)
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}
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.