WebSphere V5 for Linux on zSeries connectivity handbook / [Viviane Anavi-Chaput ... et al.].

Format:

Book

Contributor:

Anavi-Chaput, Viviane.

International Business Machines Corporation. International Technical Support Organization.

Series:

IBM redbooks.

IBM redbooks

Language:

English

Subjects (All):

Java (Computer program language).

WebSphere.

Linux.

Physical Description:

xvi, 346 p. : ill.

Edition:

1st ed.

Place of Publication:

Poughkeepsie, NY : IBM, International Technical Support Organization, 2004.

Language Note:

English

System Details:

text file

Summary:

This IBM Redbooks publication discusses Linux-based Java applications connecting to z/OS and VSE backend environments on zSeries. This book describes the implementation and deployment of Websphere Application Server, Java frontend applications, and the J2EE connectors needed on Linux for zSeries to connect to backend applications, such as CICS, IMS, DB2 and MQ on zSeries. This book explains the J2EE Connector architecture and provides the following comprehensive connector scenarios for connections to both z/OS and VSE backend environments: - CICS Transaction Gateway - IMS Connect - WebSphere MQ - JDBC to DB2 - SOAP to CICS

Contents:

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.

Notes:

"June 2005."

"SG24-7042-00."

Includes bibliographical references and index.

OCLC:

137342259