Front cover -- Contents -- Notices -- Trademarks -- Preface -- The team that wrote this redbook -- Become a published author -- Comments welcome -- Chapter 1. J2EE connector architecture overview -- 1.1 J2C overview -- 1.1.1 Resource adapter -- 1.1.2 Common client interface -- 1.1.3 System contracts -- 1.1.4 Application contracts -- 1.1.5 Deployment and packaging protocols -- 1.2 System contracts -- 1.3 Connection management -- 1.3.1 Connection pooling -- 1.3.2 Managed access to the resource adapter -- 1.3.3 Non-managed access to the resource adapter -- 1.4 Transaction management -- 1.4.1 Global transactions -- 1.4.2 Local transactions -- 1.4.3 One-phase commit optimization -- 1.4.4 Local transactions versus one-phase commit optimization -- 1.5 Security management -- 1.5.1 Terminology -- 1.5.2 Security model overview -- 1.6 Common client interface -- 1.6.1 Enterprise application integration -- 1.7 Deployment and packaging -- 1.7.1 Packaging of the resource adapter module -- 1.7.2 Deployment descriptor -- 1.7.3 Deploying the resource adapter -- Chapter 2. Introducing the connectors test environment -- 2.1 System configurations -- 2.1.1 Hardware -- 2.1.2 Software -- 2.2 Frontend environment -- 2.3 Backend environments -- 2.3.1 z/OS -- 2.3.2 VSE -- 2.4 Connector scenarios overview -- 2.4.1 The Trader application scenarios -- Chapter 3. The Trader applications -- 3.1 Introducing the Trader application -- 3.1.1 Trader application components -- 3.1.2 Trader datastores -- 3.1.3 Trader frontend GUI -- 3.1.4 Trader Web frontend architecture -- 3.1.5 Packaging -- 3.1.6 Dependencies -- 3.1.7 Trader connector paths -- 3.1.8 Downloading Trader application modules -- 3.2 Running Trader in WSAD.IE test environment -- 3.2.1 Configuring the test server in WSAD.IE -- 3.2.2 Runing Trader application in WSAD.IE test environment.

3.2.3 Configuring DB2 tables in the test environment -- 3.2.4 Running Trader application in WSAD.IE test environment -- 3.3 Deploying Trader application -- 3.3.1 Installing Trader application -- 3.3.2 Running Trader application -- 3.4 Trader DB2 table definitions -- 3.5 Trader VSAM file definitions -- 3.6 Trader CICS Transaction Gateway usage -- 3.7 WebSphere Studio Integration Edition hints and tips -- Chapter 4. WebSphere Application Server setup -- 4.1 Planning for WebSphere Application Server setup -- 4.1.1 Space requirements for installation -- 4.1.2 WebSphere MQ client for Linux on zSeries -- 4.2 Installing WebSphere MQ Client for Linux on zSeries -- 4.2.1 Verifying the MQ Client installation -- 4.2.2 Testing the MQ installation -- 4.3 Installing WebSphere Application Server -- 4.3.1 Installing with the installation wizard GUI -- 4.3.2 Getting started -- Chapter 5. CICS J2EE connectors -- 5.1 Overview of the test environment -- 5.1.1 CICS connection to z/OS -- 5.1.2 CICS connection to VSE -- 5.2 Setting up the CTG on Linux for zSeries -- 5.2.1 Installing the CTG on Linux for zSeries -- 5.2.2 Configuring the CTG on Linux for zSeries -- 5.3 Setting up the CICS regions on z/OS and VSE -- 5.3.1 Setting up the CICS TS for z/OS environment -- 5.3.2 Setting up the CICS TS for VSE environment -- 5.3.3 Testing the CTG to VSE CICS/TS connectivity -- 5.4 Testing the connectivity from Linux for zSeries -- 5.4.1 Testing the connections -- 5.4.2 Creating a simple TestECI program on Linux for zSeries -- 5.5 Configuring WebSphere for CICS connections -- 5.5.1 Installing the resource adapter -- 5.5.2 Configuring a J2C connection factory for z/OS -- 5.5.3 Configuring a J2C connection factory for VSE -- 5.5.4 Deploying the application in WebSphere -- 5.5.5 Implementing application security in WebSphere -- 5.6 Problem determination -- 5.6.1 Common errors.

Chapter 6. Using SOAP to communicate with CICS -- 6.1 SOAP overview -- 6.1.1 SOAP on z/OS -- 6.1.2 SOAP on VSE -- 6.2 Configuring CICS on VSE for SOAP support -- 6.2.1 Step 1: Specify TCP/IP=YES in CICS setup -- 6.2.2 Step 2: Define the symbolic name of VSE to TCP/IP -- 6.2.3 Step 3: Define the TCP/IP service -- 6.2.4 Step 4: Activate the ASCII to EBCDIC converter -- 6.3 Compiling the SOAP service on VSE -- 6.4 Testing the SOAP communication -- 6.4.1 Software prerequisites for the Java SOAP client -- 6.4.2 Implementing a Java-based SOAP client -- 6.4.3 Running the Java-based SOAP client -- 6.5 Writing your own SOAP programs on VSE -- 6.6 Considerations for using SOAP in WebSphere -- Chapter 7. DB2 connectors -- 7.1 DB2 Connect scenario -- 7.2 Installing DB2 Connect V8.1 -- 7.2.1 Simple connect to DB2 for z/OS -- 7.2.2 Simple connect to DB2 for VSE -- 7.3 Customizing WebSphere Application Server for DB2 Connect -- 7.3.1 Updating the WebSphere Application Server startup script -- 7.3.2 Configuring a WebSphere data source -- 7.4 Deploying TraderDB in WebSphere Application Server -- Chapter 8. WebSphere MQ connectors -- 8.1 Introducing the MQ environment -- 8.1.1 MQ-CICS bridge -- 8.1.2 MQ-IMS bridge -- 8.2 WebSphere MQ setup on Linux for zSeries frontend -- 8.3 WebSphere MQ setup on z/OS backend -- 8.3.1 Configuring queues and channels on z/OS -- 8.3.2 Configuring queues and channels on Linux for zSeries -- 8.4 WebSphere MQ setup on VSE backend -- 8.4.1 Configuring queues and channels on Linux for zSeries -- 8.4.2 Defining MQ resources to Linux for zSeries -- 8.4.3 Shell script to define the Linux-VSE connection -- 8.5 Configuring VSE for MQ -- 8.5.1 Defining the VSAM data files -- 8.5.2 Defining the MQ files to CICS using RDO -- 8.5.3 Defining MQ resources to VSE/ESA -- 8.5.4 Defining MQ local queues on VSE -- 8.5.5 MQ troubleshooting.

8.6 Configuring the MQ connector in WebSphere -- 8.6.1 Defining a WebSphere MQ queue connection factory -- 8.6.2 Defining WebSphere MQ queue destinations -- 8.6.3 Defining message listeners -- 8.6.4 Deploying TraderMQ application to WebSphere -- 8.6.5 Defining resources for VSE in WebSphere -- Chapter 9. IMS J2EE connectors -- 9.1 IMS connectors overview -- 9.1.1 IMS Connect -- 9.1.2 IMS Connector for Java -- 9.2 Installing IMS Connector for Java -- 9.3 Installing the IMS resource adapter in WebSphere Application Server -- 9.4 Configuring IMS J2C connection factories -- 9.5 Deploying TraderIMS application in WebSphere Application Server -- 9.6 IMS Connect configuration -- 9.7 Testing TraderIMS application -- 9.8 Problem determination -- 9.8.1 Common errors -- 9.9 Thread identity support -- Chapter 10. VSE Java-based connector to access VSAM data -- 10.1 VSE Java-based connectors overview -- 10.1.1 Client-server components -- 10.2 Installing the VSE Java-based connector -- 10.2.1 Client -- 10.2.2 Server -- 10.3 Using VSE Connector Client as resource adapter -- 10.3.1 Defining a resource adapter -- 10.3.2 Related servlet code -- 10.4 Using the VSE connector client as a JDBC provider -- 10.4.1 Defining a JDBC provider -- 10.4.2 Related servlet code -- 10.5 Setting up sample data for Trader -- 10.5.1 Installing the VSE Navigator -- 10.5.2 Installing the VSAM maptool -- 10.5.3 Creating the sample VSAM files -- 10.5.4 Creating the VSAM maps -- 10.5.5 Populating the sample VSAM files -- 10.6 Installing an application in WebSphere -- 10.6.1 Setting up an EAR file in the Application Assembly Tool -- 10.6.2 Deploying the EAR file in WebSphere Administrative Console -- 10.7 Configuring for SSL secure connections -- 10.7.1 Installing Keyman/VSE -- 10.7.2 Generating keys and certificates -- 10.7.3 Uploading certificate items to VSE.

10.7.4 Transferring the keyring file to WebSphere -- 10.7.5 Checking VSE keyring library -- 10.7.6 Defining an SSL connection factory in WebSphere -- 10.7.7 Adding SSL resource reference in EAR file -- 10.7.8 Redeploying the EAR file -- 10.7.9 Configuring VSE Connector Server for SSL -- 10.7.10 Restarting VSE Connector Server -- 10.7.11 Changing your servlet code to support SSL -- 10.7.12 Configuring an SSL JDBC data source -- 10.7.13 Considerations on SSL key lengths -- 10.7.14 Considerations on different SSL scenarios -- 10.8 Problem determination -- 10.8.1 Activating stdout trace in WebSphere -- 10.8.2 Tracing a servlet -- Chapter 11. VSE Java-based connector to access DL/1 data -- 11.1 DL/I database access overview -- 11.1.1 Prerequisites for the DL/1 connector -- 11.1.2 The DL/I example -- Chapter 12. VSE VSAM Redirector connector -- 12.1 VSAM Redirector connector overview -- 12.2 Client-server components -- 12.3 Installing the Redirector server -- 12.3.1 Downloading the Redirector server -- 12.3.2 Installing the Redirector server -- 12.3.3 Configuring the Redirector server -- 12.3.4 Starting the Redirector server -- 12.4 General setup using the HtmlHandler -- 12.4.1 Step 1: Decide on the VSAM source file -- 12.4.2 Step2: Create a new file as target file -- 12.4.3 Step 3: Configure and activate Redirector client exit -- 12.4.4 Step 4: Modify the HtmlHandler Java source -- 12.4.5 Step 5: Create a sample VSAM application -- 12.4.6 Step 6: Run the REPRO job -- 12.4.7 Step 7: Check the HTML output file. -- 12.5 Special setup for Trader using the DB2 handler -- 12.5.1 Providing VSAM map definition -- 12.5.2 Populating the sample VSAM files -- 12.5.3 Preparing for creating DB2 tables -- 12.5.4 Creating DB2 tables -- 12.5.5 Setting up the VSE side -- 12.5.6 Testing the setup -- 12.5.7 Checking the target DB2 table.

12.5.8 Trader scenario with redirected VSAM files.