This chapter tells you how to set up the following environments on one or more personal computers:
Where appropriate, the chapter includes tips on installing third-party software, but for detailed installation instructions you must refer to the relevant product documentation. For information on tested versions of third-party software see the Third-party Software chapter of your Readme.
A component generation environment consists of:
When installing SOA Express, you should have chosen the options that best suit the types of applications you intend to modernize. Your installation should include one or both of the following:
Mainframe Express Enterprise Edition requires access to your legacy source files, and Mainframe Access is the recommended way to achieve this. Mainframe Access enables you to either offload the source files or access them in place. Mainframe Access has a client component and one or more server (mainframe) components.
In order to generate JavaBeans or EJBs, SOA Express requires:
For the requirements for .NET support, see the appendix SOA Express .NET in your Deployment Guide.
The SOA Express IDE supports the use of any SCC-compliant version manager to manage its project files.
To set up a component generation environment after installing SOA Express, do the following:
The following sections describe these steps in detail.
Do this only if you are using CICS and ECI, and will be generating JavaBeans or EJBs.
CICS Transaction Gateway can reside on the middle-tier, mainframe, or any other system. On the client tier, the only changes you need to make to be able to use CICS Transaction Gateway are to update your CLASSPATH (as described in Table 3-1) and set the properties in SOA Express to specify the relevant settings for CICS Transaction Gateway.
For more information on CICS Transaction Gateway, see the chapter ECI Middleware in this Configuration Guide.
Do this only if you will be generating JavaBeans or EJBs.
After installing the required class libraries, be sure to read the next section on Setting the PATH and CLASSPATH Environment Variables, because you may need to update your PATH and/or CLASSPATH environment variables.
SOA Express has been tested with each of the following JDK/JREs.
The JDKs for WebSphere are typically included on the WebSphere installation CDs.
Once you have installed a JDK or JRE, you must update your PATH and/or CLASSPATH environment variables.
If you are using WebSphere MQ, SOA Express requires IBM WebSphere MQ classes for Java.
Once you have installed the IBM WebSphere MQ classes for Java, you must update your PATH and CLASSPATH environment variables.
ECI Java classes are provided with the IBM CICS Transaction Gateway, and are located in the CTG\classes folder by default.
You need to add the servlet-api.jar file to your CLASSPATH. This file is supplied with some application servers (with Tomcat, for example, it is supplied in the tomcat\common\lib folder), but if your application server does not provide it, you can obtain it from the Apache Software Foundation's Jakarta project (jakarta.apache.org).
You need these only if you are intending to generate EJBs.
If you will be deploying your EJBs to WebSphere, you need to add WebSphere\AppServer\lib\j2ee.jar to your CLASSPATH.
Otherwise, you must install Sun's Enterprise Edition JDK and update your CLASSPATH.
You need this only if you intend to generate an XML interface to some or all of your beans.
After installing the IBM XML Parser for Java, you must update your CLASSPATH (see Table 3-1 for details).
You need this only if you intend to generate eBiz or Data Access Transactions that support MIDP-compliant client applications running on wireless devices.
In order to use the J2ME Wireless Toolkit, you will also need to install the Sun JDK (this is installed automatically with the Java 2 SDK).
You need these classes if you intend to generate Java application Web Services clients that target WebSphere.
You must update your CLASSPATH to point to the uddiv3client.jar file (see Table 3-1 for details).
For .NET, you need the Microsoft Core SDK Platform SDK.
Do this only if you will be generating .NET components.
Note: See the appendix SOA Express .NET in your Deployment Guide.
After installing the required software, be sure to read the next section on Setting the PATH and CLASSPATH Environment Variables, because you need to update your PATH environment variables.
You need WebSphere MQ Server, with amqmdnet.dll installed in the Global Assembly Cache.
Table 3-1 shows the paths you need to add to the PATH and CLASSPATH environment variables once you have installed the Java classes that you require.
Note: For .NET, see the appendix SOA Express .NET in your Deployment Guide.
Java Classes1 | Add to PATH | Add to CLASSPATH |
---|---|---|
ECI2 | not applicable |
CTG\classes\ctgclient.jar CTG\classes\ctgserver.jar CTG\classes\Cfwk.zip |
IBM JDK |
c:\jdk\bin; |
installation-directory\servlet-api.jar; y:\WebSphere\AppServer\lib\j2ee.jar3 |
Sun JDK Standard Edition |
c:\jdk1.3\bin; |
c:\jdk1.3\lib\tools.jar; |
Sun JDK Enterprise Edition | not applicable |
c:\j2sdkee1.2.1\lib\j2ee.jar; |
Java Servlet API | not applicable |
installation-directory\servlet-api.jar; |
WebSphere MQ classes for Java4 |
c:\mq\java\lib; |
c:\mq\java\lib\com.ibm.mq.jar; c:\mq\java\lib\connector.jar |
IBM XML Parser for Java5 | not applicable |
pathname\xmlParserAPIs.jar;
pathname\xercesImpl.jar; |
UDDI Classes | not applicable | See the section Setting the System CLASSPATH in the appendix Auto-deployment to WebSphere of your Deployment Guide. |
WebSphere | not applicable | See the section Setting the System CLASSPATH in the appendix Auto-deployment to WebSphere of your Deployment Guide. |
Footnotes:
We assume that the Java classes are installed on the c: drive, that you are using the most recent supported versions, and that you chose \mq\java as the installation path for the WebSphere MQ classes for Java. The IBM and Sun JDKs are alternatives; you can use one or the other, not both.
ctgserver.jar is only required if CICS Transaction Gateway is installed on the middle tier. Cfwk.zip is only required if SSLight security is being used. See your CICS Transaction Gateway documentation for more information.
servlet-api.jar is not supplied with early versions of WebSphere. In this case, we recommend you use servlet-api.jar from Tomcat's common\lib folder regardless of the application server being used.
To generate JavaBeans or EJBs for use with IBM WebSphere Application Server, the CLASSPATH must also include a path to WebSphere's j2ee.jar files We assume that this file is on the middle-tier computer where WebSphere is installed and accessible via a mapped drive (identified by the placeholder y: in the table). Of course, you can copy these files to the client tier if you prefer.
The XML Parser is required only for XML support. IBM frequently release new versions of the XML Parser and the version number is incorporated in the filename and the pathname. For this reason the table does not show a pathname for the XML Parser. We recommend that you download the latest version from the Apache Web site.
Mainframe Access has a client component and individually installable server (mainframe) components. A Mainframe Access client is installed automatically with SOA Express. The Mainframe Access servers are included on the Host Connectivity CD supplied with Mainframe Express Enterprise Edition. For further information about the Mainframe Access server components, see the Mainframe Tier chapter.
Mainframe Access uses the Micro Focus Common Communications Interface (CCI) to isolate itself from the underlying network protocol. For detailed instructions on configuring CCI, particularly if your mainframe does not support TCP/IP, refer to your Configuring CCI book.
For information on using Mainframe Access, refer to your Mainframe Access Installation and Usage Guide.
SOA Express supports any SCC-compliant version manager. To install a version manager, see your version manager documentation. Once a version manager is installed, the SOA Express IDE detects its presence and automatically enables the relevant menu items.
When you generate an eBiz or Data Access Transaction, you can choose to have SOA Express automatically create a default client. This generated client can be used to test your eBiz or Data Access Transactions. You may want to use your development environment as a test deployment environment.
The generated client is provided for testing purposes, and as example code which you can use as a starting point when writing your own production-quality client application.
For full details on clients and setting up a deployment environment, see your Deployment Guide.
If you want to enhance a generated Java client, or write your own, a Java development environment is required. The JavaBeans and EJBs produced by SOA Express can be employed by a Java application, a Java servlet or Java Server Pages (JSP). The JavaBeans or EJBs can be imported into any Java IDE, such as IBM's WebSphere Studio.
You will also require the IBM WebSphere MQ classes for Java or the ECI Java classes supplied with CICS Transaction Gateway. These classes are required because they are referenced by the JavaBeans and EJBs produced by SOA Express.
Note: See the appendix SOA Express .NET in your Deployment Guide.
If your eBiz or Data Access Transaction supports WAP-enabled client applications, the generated client is a WML file. There are many WAP SDKs available that you can use to enhance a generated client application or to write a client application from scratch. These toolkits generally contain a WML editor, a debugger and an emulator that you can use to perform preliminary testing on your application. Nokia, Ericsson, Motorola and openwave.com all provide such toolkits which can be downloaded from the appropriate Web site.
If your eBiz or Data Access Transaction supports MIDP-compliant client applications, you can use the J2ME Wireless Toolkit (which must be installed in order to generate such eBiz or Data Access Transactions) to enhance a generated client application or to write a client application from scratch. To use the J2ME Wireless Toolkit, you must install the Sun JDK, which is automatically installed as part of the Java 2 SDK Standard Edition.
This optional environment enables you to test your eBiz or Data Access Transactions with little or no impact on mainframe operations. This allows your business to continue as normal while you are developing your eBiz or Data Access Transactions.
A mainframe emulation environment consists of:
The CICS Option and IMS Option are emulators that enable you to emulate the CICS or IMS region that is running your legacy transactions.
The middleware software is the connection between the middle and mainframe tiers.
Mainframe Access enables you to either offload the legacy application's source files or access them in place. Mainframe Access has a client component and one or more server (mainframe) components.
To set up a mainframe emulation environment you must:
The following sections describe these steps in detail.
For instructions on configuring Mainframe Express for different testing scenarios, refer to the Testing eBiz Transactions and Data Access Transactions chapter in your User's Guide.
Follow the instructions in your IBM WebSphere MQ: Windows Quick Beginnings book to install WebSphere MQ Server from the WebSphere MQ Server installation CD. You must be logged on as an administrator. The default installation is acceptable.
After installing WebSphere MQ Server, you must define WebSphere MQ objects that correspond to the objects defined at the mainframe. See the WebSphere MQ Middleware chapter for more information.
Although it is simplest to use WebSphere MQ Server, you could use WebSphere MQ Client instead if you configured it to communicate with a WebSphere MQ Server on another machine, such as the mainframe.
Mainframe Access has a client component and individually installable server (mainframe) components. A Mainframe Access client is installed automatically with Mainframe Express; the Mainframe Access servers are included on the Host Connectivity CD supplied with Mainframe Express Enterprise Edition. For further information about the Mainframe Access server components, see the Mainframe Tier chapter.
Mainframe Access uses the Micro Focus Common Communications Interface (CCI) to isolate itself from the underlying network protocol. For detailed instructions on configuring CCI, refer to your Configuring CCI book.
For information on using the SourceConnect feature of Mainframe Access within Mainframe Express, refer to the chapter SourceConnect in your Mainframe Express Administrator's Guide.
Copyright © 2007 Micro Focus (IP) Ltd. All rights reserved.