WebSphere for z/OS V6 Connectivity Handbook

WebSphere for z/OS V6 Connectivity Handbook

by Louwe-Kooijmans Alex, Chris Backhouse, Sonpreet Bhatia, Michael Daubman, Denis Gabler, Mitch Johnson, Edward McCarthy, Bas Otten, Rajesh Ramachandran
Released December 2005
Publisher(s): IBM Redbooks
ISBN: None

Read it now on the O’Reilly learning platform with a 10-day free trial.

O’Reilly members get unlimited access to books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial

Book description

This IBM Redbooks publication (re)examines most connectivity scenarios between WebSphere Application Server for z/OS Version 6.01 and other application resources on z/OS and is an extension of and update on the WebSphere for z/OS V5 Connectivity Handbook, SG24-7064 .

This book covers various connectivity scenarios from architecture, application development, and infrastructure points of view. New scenarios are introduced using WebSphere Default messaging, Web services, and SQLJ. We also updated all scenarios with the usage of Rational Application Developer Version 6.

A brief summary of connectivity technology explained in this book is:
-Database access using JDBC and SQLJ
-JMS 1.1 and WebSphere Default messaging
-Calling DB2 Stored Procedures using SOAP
-Bi-directional Web services between WebSphere and CICS
-J2C connectors to CICS and IMS
-RMI-IIOP

The technology is explained using sample code, available as additional material for this book.

Please note that the additional material referenced in the text is not available from IBM.

Table of contents

  1. Notices
    1. Trademarks
  2. Preface
    1. The team that wrote this redbook
    2. Become a published author
    3. Comments welcome
  3. Summary of changes
    1. December 2005, Third Edition
  4. Chapter 1: Accessing DB2 using JDBC
    1. Topology
    2. Introduction to JDBC
      1. JDBC Driver architecture types
      2. JDBC with WebSphere Application Server for z/OS Version 6.01
      3. Configuring the IBM DB2 Universal Driver for JDBC and SQLJ
      4. Define the DB2 Universal JDBC driver provider
      5. Defining the DB2 Universal JDBC driver provider data source
    3. JDBC application programming
      1. Environment setup for communication with DB2 on z/OS
      2. Data sources in the deployment descriptors
    4. The TraderDB application
      1. Deploying the TraderDB Application
      2. Testing TraderDB with JDBC
  5. Chapter 2: Accessing DB2 using SQLJ
    1. Introduction to SQLJ
      1. JDBC versus SQLJ
      2. Application connection concepts
      3. Connection coding differences
      4. SQLJ coding
      5. General application flow
    2. Creating an SQLJ program in RAD
      1. Supplied material
      2. Migrating the Version 5 application
      3. Setting up the SQLJ environment
      4. Adding SQLJ support to our project
      5. Adding an SQLJ file to the project (1/2)
      6. Adding an SQLJ file to the project (2/2)
      7. Customization (1/2)
      8. Customization (2/2)
    3. Testing SQLJ in TraderDB
      1. Running the application
      2. Debugging potential problems
    4. SQLJ and QoS
      1. Performance
      2. Security
      3. Dynamic SQL is possible in SQLJ
  6. Chapter 3: Accessing IMS databases using JDBC
    1. IMS JDBC topology
    2. Configuring the servant region for ODBA
    3. Installing the IMS JDBC resource adapter
    4. Configuring connection factories
      1. Configuring a J2C connection factory resource
      2. Installing a custom service in the application server
    5. Installation verification with IMS DealerShip application
      1. Installing the IMS DealerShip application
      2. Using the IMS Dealership application
    6. Problem determination
  7. Chapter 4: Messaging
    1. Messaging within J2EE/JMS technology
      1. MQ concepts
      2. JMS concepts
    2. General overview of JMS provider types
      1. WebSphere Default messaging provider (1/2)
      2. WebSphere Default messaging provider (2/2)
      3. WebSphere MQ JMS provider
      4. Generic JMS provider
      5. V5 Default messaging JMS Provider
      6. Pros and cons of the four types of JMS providers
    3. Message Driven Beans
      1. MDB characteristics
      2. Listener service
      3. Activation specification
      4. MDB programming directives
    4. Messaging security
      1. Identity authentication
      2. Message Driven Bean identity
      3. Resource authorization
      4. Confidentiality and integrity
    5. Using the WebSphere MQ JMS provider and JMS 1.0
      1. Preparing the TraderMQ application
      2. Configuring the WebSphere MQ JMS provider (1/2)
      3. Configuring the WebSphere MQ JMS provider (2/2)
      4. Running TraderMQ on z/OS
    6. Using the WebSphere MQ JMS provider and JMS 1.1
      1. Converting the TRADERMQ application from JMS 1.0 to JMS 1.1
      2. Configuring an MQ (unified) connection factory
    7. Using the Default messaging JMS provider
      1. Application changes for using Default messaging
      2. Configuring the Default messaging JMS provider (1/4)
      3. Configuring the Default messaging JMS provider (2/4)
      4. Configuring the Default messaging JMS provider (3/4)
      5. Configuring the Default messaging JMS provider (4/4)
    8. The TraderMQ application environment
      1. JMS 1.0 TraderMQ using WebSphere MQ
      2. JMS 1.1 TraderMQ using WebSphere MQ
      3. JMS 1.1 TraderMQ using Default messaging
  8. Chapter 5: Introduction to J2EE Connector Architecture
    1. Connector components
    2. The Common Client Interface
      1. Establishing a connection to a resource
      2. Interacting with the resource
    3. Enabling Rational Application Developer for J2C
      1. Installing the J2EE Connector Tools feature
      2. Enabling the J2C feature in RAD
  9. Chapter 6: Developing J2C applications accessing CICS
    1. CICS Transaction Gateway topologies
    2. CICS J2C application development
      1. Backward compatibility
      2. Version 6 J2C CICS support
      3. Import TraderCICS ear
      4. Delete TraderCICSEJB2
      5. Generating J2C CICS Connector Code (1/3)
      6. Generating J2C CICS Connector Code (2/3)
      7. Generating J2C CICS Connector Code (3/3)
      8. Rational Application Developer Version 6 and meta-data
      9. Deprecated use of direct JNDI lookup
      10. Update the ejb-jar.xml
  10. Chapter 7: Developing J2C applications accessing IMS
    1. Preparing the project
    2. Create J2C Java Data Beans
    3. Creating a J2C Java Bean (1/2)
    4. Creating a J2C Java Bean (2/2)
    5. Creating an EJB J2C Java Bean (1/2)
    6. Creating an EJB J2C Java Bean (2/2)
      1. Exposing connection and interaction properties
    7. Generating SOA J2C Java Beans
      1. Create J2C Java Data Beans
      2. Create a J2C Java Bean (1/2)
      3. Create a J2C Java Bean (2/2)
      4. Creating a SOA J2C Java Bean
      5. Testing the SOA J2C Java Bean (1/2)
      6. Testing the SOA J2C Java Bean (2/2)
  11. Chapter 8: Configuring J2C for CTG
    1. Installing the CICS resource adapter
    2. Configuring connection factories
      1. Configuring a local J2C connection factory resource
      2. Configuring a remote CICS J2C factory resource
    3. Cell scope J2C connection factories
    4. Command-line CICS J2C definition
    5. Application deployment
    6. TranName and TPNName
      1. TranName
      2. TPNName
      3. Setting TranName and TPNName
    7. Security and CICS J2C Connector
      1. Defining an authentication alias
      2. Container-managed security
      3. Application-managed security
      4. CICS J2C security decision tree
    8. Performance and availability
    9. Problem determination
      1. Common errors
    10. Transaction management
  12. Chapter 9: Configuring J2C for IMS Connect
    1. IMS Connect topologies
    2. Configuring IMS Connect and IMS
      1. IMS Connect setup
      2. OTMA setup
    3. Installing the IMS Connect Resource Adapter
    4. Configuring connection factories
      1. Configuring a local J2C connection factory resource
      2. Configuring a remote IMS J2C factory resource
    5. Cell scope J2C connection factories
    6. Application deployment
    7. Implementing application security
      1. Connection properties
      2. Interaction properties
    8. Implementing infrastructure security
      1. RACF keyrings
      2. JSSE keyrings
      3. IMS Connect and SSL
    9. Configuration automation using Jython scripts
    10. Performance and availability
    11. Problem determination
      1. Common errors
      2. IMS Connect authorization and authentication support
    12. Transaction management
  13. Chapter 10: Introduction to Web services
    1. Introduction
    2. Service-Oriented Architecture
      1. Characteristics
      2. Web services verses Service-Oriented Architectures
    3. Web services
      1. Properties of a Web service
      2. Core standards
      3. Additional standards
    4. Simple Open Access Protocol (SOAP)
      1. Overview
      2. The three pillars of SOAP
      3. SOAP elements (1/2)
      4. SOAP elements (2/2)
    5. Web Services Definition Language (WSDL)
      1. WSDL document
      2. WSDL document anatomy
      3. WSDL definition
  14. Chapter 11: Web services using SOAP over HTTP
    1. An end-to-end Web service example
    2. Simple Example Web Services (SEWS) application
      1. WebSphere part of SEWS
      2. CICS part of SEWS
      3. Our system layout
      4. Supplied material
    3. Web service enabling SEWS for WebSphere
      1. Overview
      2. Web service-enable SnoopInfo Java Bean (1/2)
      3. Web service-enable SnoopInfo Java Bean (2/2)
      4. Test SEWS in Rational Application Developer Version 6
      5. Export Web service client code
    4. Development of Web service invoker
      1. Java Code that performs the WebSphere Web service call
      2. Java code that calls the CICS Web service
      3. Import the SnoopInfoBean client WAR file
    5. CICS - Web service-enable business logic
      1. Generate WSDL from a CICS business logic program
      2. Import WSDL into project
    6. CICS - Performing a Web service request
      1. Defining SnoopInfo Web service to CICS
    7. Web service definitions required in CICS
      1. DFHPIPE
      2. TCPIP and TCPIP Service
      3. URIMAP
      4. Pipeline
      5. WEBS (Webservice)
    8. Testing the SEWS application
      1. Running the Web service requestor application
      2. Test Web service call to SnoopInfo Bean in WebSphere
      3. Test Web service call to SnoopInfo in CICS
      4. Test Web service call from CICS to WebSphere
    9. Summary
  15. Chapter 12: Web services and SOAP over JMS
    1. Using SOAP over JMS
      1. Our system layout
      2. Supplied material
    2. Enabling SnoopEjb for SOAP over JMS
      1. Web service-enable the SnoopEJB
      2. Enabling SOAP over JMS support
      3. Exploring the new ejb-jar.xml
      4. Update the application.xml
      5. Update sewsWsDemo to invoke SnoopEjb Web service
      6. Update the web.xml
    3. Web service using SOAP over JMS in one cell
      1. Overview of definitions required
      2. Defining a SIB in WebSphere
      3. Define authentication alias
      4. Define queue
      5. Define JMS queue
      6. Define JMS queue connection factory
      7. Define JMS activation specification
      8. Definitions for the Web service driver application
      9. Testing in one server
      10. Preventing deprecated JNDI lookup
      11. Security errors without authentication alias
      12. Checking queue status
    4. Web service using SOAP over JMS between cells
      1. WebSphere servers used example
      2. Second server configuration
      3. Define authentication alias
      4. Define SIB in ws6483
      5. Define foreign bus in ws6483
      6. Define foreign bus in ws6481
      7. Verify inter-bus connectivity
      8. Define sewsQueue in ws6483
      9. Define JMS queue connection factory
      10. Define JMS queue
      11. Test using two WebSphere cells
    5. CICS to WebSphere using SOAP over JMS
      1. CICS prereqs
      2. Define foreign bus
      3. Define WebSphere MQ Link
      4. MQ definitions
      5. Define SnoopEjb Web service to CICS
      6. Test Web service - CICS to WebSphere
    6. WebSphere to CICS using SOAP over JMS
      1. WebSphere definitions
      2. MQSeries definitions
      3. CICS Web service
      4. Test Web service - WebSphere to CICS
    7. Summary
  16. Chapter 13: Integrating WebSphere and DB2 using Web services
    1. Calling a DB2 stored procedure as a Web service
      1. Why stored procedures
      2. When not to use stored procedures
      3. Developing the Trader sample application (1/4)
      4. Developing the Trader sample application (2/4)
      5. Developing the Trader sample application (3/4)
      6. Developing the Trader sample application (4/4)
      7. Enabling WebSphere to execute DB2 Web services
      8. Deployment and testing
    2. Calling a Web service from DB2
      1. Prerequisites for development and deployment
      2. Invoking the Web service consumer
      3. The Trader sample
    3. Summary
  17. Chapter 14: Connecting to WebSphere from IMS using SOAP
    1. Setup
      1. WebSphere requirements
      2. z/OS requirements
      3. IMS requirements
      4. Creating a default OMVS segment
    2. Generating Java code to access the Web service (1/3)
    3. Generating Java code to access the Web service (2/3)
    4. Generating Java code to access the Web service (3/3)
      1. Case of missing Web services menu
    5. Test the Web service
    6. Calling Web service from within IMS Java transaction
      1. Preparing RAD for use of ANT scripting
      2. Importing the IMS Java classes into the project classpath (1/2)
      3. Importing the IMS Java classes into the project classpath (2/2)
      4. Build the IMS Java transaction to call the Web service (1/2)
      5. Build the IMS Java transaction to call the Web service (2/2)
      6. Required WAS classes for calling a Web service
      7. Application settings in IMS PROCLIB
      8. Testing the IMS Java transaction from a 3270 terminal
      9. Test IMS Java transaction
      10. Automatic class reloading for testing
  18. Chapter 15: Using the RMI-IIOP protocol
    1. Calling EJBs and IIOP
      1. Basics of remote EJB invocation
      2. Supplied material
      3. ejbMagic application
      4. SnoopMagicEjb methods
      5. Understanding logical and direct JNDI lookups
      6. ejbMagic application - Logical EJB references
      7. Our system layout
    2. Running ejbMagic in one server
      1. URL to invoke the servlet
      2. Testing the ejbMagic application
    3. Running ejbMagic between two cells
      1. Call remote EJB test
      2. Handling corbanames
      3. Name space bindings
    4. CSI
  19. Appendix A: The Trader application explained
    1. Overview of Trader application
      1. Trader IMS and CICS applications and data stores
      2. Trader Web front-end user interface
      3. Trader Web front-end and back-end interface
      4. Packaging
    2. Deploying Trader applications to WebSphere for z/OS
    3. Running the Trader applications
    4. Additional configuration information
      1. Trader DB2 table definitions
    5. Trader VSAM file definitions
  20. Appendix B: Additional material
    1. Locating the Web material
    2. Using the Web material
      1. System requirements for downloading the Web material
      2. How to use the Web material
  21. Related publications
    1. IBM Redbooks
    2. Other publications
    3. Online resources
    4. How to get IBM Redbooks
    5. Help from IBM
  22. Index (1/3)
  23. Index (2/3)
  24. Index (3/3)
  25. Back cover

Product information

  • Title: WebSphere for z/OS V6 Connectivity Handbook
  • Author(s): Louwe-Kooijmans Alex, Chris Backhouse, Sonpreet Bhatia, Michael Daubman, Denis Gabler, Mitch Johnson, Edward McCarthy, Bas Otten, Rajesh Ramachandran
  • Release date: December 2005
  • Publisher(s): IBM Redbooks
  • ISBN: None