© 2007 ibm corporation ibm software group accessing ims transactions through websphere and the ims...

53
© 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical Leader [email protected]

Post on 15-Jan-2016

223 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

© 2007 IBM Corporation

IBM Software Group

Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter

Hélène LyonSouth-Europe IMS Technical [email protected]

Page 2: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

2 © 2007 IBM Corporation

IBM Software Group

IMS Connect

Appl.

IMS

TM

. . . Appl.

IMS Database Manager

DB2

IMS Message Queues

APPC/MVS

VTAM(LU0 LU1 LU2 LU6.1 LU6.2) TCP/IP for zOS

z/OS

WMQ

Telnet

B B

D D

MFS P

D

IMS Transaction No presentation layer

Access to Resource Managers (RM)

IMS DB, DB2, MQ Very simple design

Get Input MessageRM callsISRT Output Message

IMS Database Hierarchical design

JDBC access

XML datastore

IMS MFS Description of input and output

messages and device map

Not used in client/server implementations

B

D

P

DB2 Stored Proc.

WMQ

IMS Architecture

Page 3: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

3 © 2007 IBM Corporation

IBM Software Group

Agenda

Overview of JCA and IMS TM Resource Adapter

Socket Connections & Socket Types

Connection Management

Security Management

Transaction Management

Last enhancements

Supermember

Hold queue management

PurgeAsyncOutput and ReRoute and Retrieve

Alternate destination

Some IMS V10 Enhancements

SOA Composite Application

Accessing SOA applications from IMS (Callout)

Page 4: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

4 © 2007 IBM Corporation

IBM Software Group

J2EE Architecture

Java 2 Platform, Enterprise Edition

A standards-based architecture to enable development of multi-tier distributed applications

J2EE Connector Architecture (J2C/JCA)

Enables standard API use for all access to any EIS

Simplifies application component development

Graphic HereEJBs

J2EE Core Services

Web Container EJB Container

WebBrowser

Client

RM

I /

IIO

P

HT

TP

/ H

TT

PS

JDB

C /

JCA

Res

ou

rce

Ad

apte

rs

EnterpriseInformationSystem(e.g. IMS)

JSPs

Servlets

Page 5: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

5 © 2007 IBM Corporation

IBM Software Group

J2EE Connector Architecture

J2EE Server

EnterpriseBean

ResourceAdapter

Managers:

• Transaction• Connection• Security

WebComponent

CCIApplication

Contract

SPISystem

ContractsEIS

The application API

Page 6: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

6 © 2007 IBM Corporation

IBM Software Group

JCA - IMS Resource Adapter

IMS Connector for Java (renamed to IMS TM Resource Adapter)

Provides connectivity to IMS Transactions

With an option to use a global transaction scope between the 2 business logic parts (distributed Two-Phase Commit)

Solution Benefits

The “Direct Connection” Choice!

Prereqs installation of IMS Connect

No changes to IMS applications The “Strategic” option for IMS Lab

From any WebSphere platform, z/OS or distributed with J2EE Quality of Services

IMSConnect

IMS TM resource

AdapterTCP/IP

WASIMS

Appls.

OTMA

IMS DB

DB2

B DB

http://www-306.ibm.com/software/data/db2imstools/imstools/imsjavcon.html

SOAP

Other

Page 7: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

7 © 2007 IBM Corporation

IBM Software Group

WebSphere Application Server

IMS TMIMS TMResourceResourceAdapterAdapter

Managers:

• Connection • Transaction • Security

WebService

CCIApplication

Contract

SPISystem

Contracts IMS Connect

TCP/IPor LocalOption

WebComponent

EnterpriseBean

Windows / AIX / Solaris / Linux / zLinux / HP_UX and z/OS

IMS Connect

DB2

OTMA

OTMA

IMS

IMS App

IMS DB

IMS DB

IMS

IMS App

JCA - IMS Resource Adapter …

Page 8: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

8 © 2007 IBM Corporation

IBM Software Group

z/OS1

z/OS2

Linux for System z

Windows / AIX / Solaris / Linux and z/OS

WebSphereApplication

ServerIMS Resource

Adapter

WebSphereApplication

Server

IMS ResourceAdapter

WebSphereApplication

ServerIMS Resource

Adapter

IMS

TCP/IP

XCF

XCF

IMS

IMS

IMS Connect

IMS Connect

IMS Connect

B D

B D

B D

Local

IMS TM Resource Adapter – Flexible and Scalable

TCP/IP or Local OptionLocal Option has been

stabilized and no new future enhancements

Page 9: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

9 © 2007 IBM Corporation

IBM Software Group

IMS TM Resource Adapter – Features at a glance

Supports J2EE Connector Architecture (JCA) 1.0 & 1.5

Supports various types of interactions and programming models with IMS Invokes IMS transactions or commands

Conversational and non-ConversationalMFS, COBOL, C, *PLI

SendRev, Send Only

Retrieve Asynchronous output

Options for handling undelivered output messages: purge or rerouteSingle no wait, single wait

Commit mode 1 or 0 processing

SyncLevel none or Confirm Alternate Client ID

Connection Management Connection pooling

Handles execution or socket timeouts

Transaction Management Global z/OS RRS transaction support

and Distributed XA transaction support with Two Phase Commit

Security Management J2EE EIS Sign-on

SSL, RACF key ring

Enhancements in complex environment Sysplex distributor environment zWAS 64 bit support. for local option

(soon)

Callout (V10) Make IMS application as a client to

access J2EE applications

Page 10: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

10 © 2007 IBM Corporation

IBM Software Group

Socket Connections

In a managed environment, all socket connections between IMS TMRA and IMS Connect are persistent:

Reusable connections available from connection pools

Connection is disconnected when

Error occurred (except execution timeout), or,

Cleaned up by connection manager based on connection pool properties Two types of persistent socket connections

Shareable persistent (recommended)– IMS TM Resource Adapter generates clientID

Dedicated persistent *– Client application provides socket identifier using IMSInteractionSpec property clientID

In a non-managed environment, connections are disconnected after each interaction There is no pooling of connection

Connection cannot be reused

*Dedicated Connections will be stabilized and no new enhancements. Recommend to use Sharable connections

Page 11: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

11 © 2007 IBM Corporation

IBM Software Group

Socket Connections …

IMSTMRA

IMSConnect

Dedicated persistent

Shareable persistent

CLIENT01

HWSABC01

HWSXYZ05

HWS22Q0T

CLIENT01

WebSphereApplication Server

Duplicate ClientId

Page 12: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

12 © 2007 IBM Corporation

IBM Software Group

Connection Management

Connection Pooling

Connections expensive to create

Connection Manager creates pool for each Connection Factory

Unused connection objects returned to pool for re-use

Connection Management Properties

Specify how application server manages pool

Purge policy specifies how to purge connections when communications error is detected – EntirePool or FailingConnectionOnly

Minimum connections

Maximum connections

Reap time

Unused timeout

Aged timeout

Page 13: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

13 © 2007 IBM Corporation

IBM Software Group

Types of Interactions

Invoking IMS Transaction or Commands

Send_Receive or Send Only

Execution and Socket timeouts

Retrieve Asynchronous Output Message (Resume Tpipe)

Retrieve asynchronous output messages from IMS OTMA Asynchronous Hold Queue

IMSRequestType

IMS_REQUEST_TYPE_IMS_TRANSACTION

Non-conversational transactions

IMS conversational IMS_REQUEST_TYPE_IMS_COMMAND

IMS_REQUEST_TYPE_MFS_TRANSACTION *

Message Format Service (MFS)

* Not currently supported in RAD

Page 14: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

14 © 2007 IBM Corporation

IBM Software Group

Types of Interactions …

Commit Modes

Send-then-commit (Commit Mode 1)

Used to run non-recoverable IMS transaction

Commit-then-send (Commit Mode 0)

Allows clients to run IMS transaction with recoverable output message

ACK/NAK is sent internally by IMS TM Resource Adapter

ClientID Socket type IMS Interaction Verb SyncLevel

CM1 N/A(internally generated)

Shareable persistent

SYNC_SEND_RECEIVE None or Confirm

Syncpt*

CM0 N/A(internally generated)

Shareable persistent

SYNC_SEND_RECEIVESYNC_SENDSYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT or SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT

Confirm

User-specified clientID

Dedicated persistent

SYNC_SEND_RECEIVESYNC_SENDSYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT or SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT

* Not externalize – used only when transactionality requested

Page 15: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

15 © 2007 IBM Corporation

IBM Software Group

CLIENT IMS

Transaction inserted to SMB

Ouput Sent (No response requested)Commit Confirmed sent(Synchpoint has completed)

MPP

GU, IOPCB.ISRT,IOPCB...Synchpoint Starts

Synchpoint Completes

CLIENT IMSTransaction inserted to SMB

Ouput Sent Response requested

Commit Confirmed sent(Synchpoint has completed)

MPP

GU, IOPCB.ISRT,IOPCB...Synchpoint Starts

Synchpoint Completes

Send transaction input

Send transaction input

ACK

Sync Level of NONE

Sync Level of CONFIRM

Send-Then-Commit Flow (CM1)

Types of Interactions …

Wait …

Page 16: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

16 © 2007 IBM Corporation

IBM Software Group

CLIENT IMS

Send transaction input

ACK

Transaction inserted to SMB

ACK

Ouput enqueued to TPIPE

Output sent with response requested

Output dequeued

MPP

GU, IOPCB...ISRT,IOPCB...Synchpoint StartsSynchpoint Completes

Types of Interactions …

Commit-Then-Send Flow (CM0)

Page 17: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

17 © 2007 IBM Corporation

IBM Software Group

Security Management

J2EE provides end-to-end security model for J2EE applications to access EIS securely

IMS TM Resource Adapter supports

Authentication: User ID and Password

Application Component - Component-Managed Sign-on

Application Server - Container-Managed Sign-on

Encryption using SSL

Provides reliable, secure communication between IMS TM Resource Adapter and IMS Connect

– End user’s userID or password not used for SSL security

Page 18: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

18 © 2007 IBM Corporation

IBM Software Group

Security Management - EIS Sign-on

IMSConnect

IMSConnect

IMS

OTMA

WebSphere Application Server

EnterpriseBean

EnterpriseBean

IMSResourceAdapter

IMSResourceAdapter

Res-auth = Container

Pass User ID and Password of Container-managed authentication alias to IMS Resource Adapter

Send User ID and Password to IMS Connect

If RACF = Y, call RACF to authenticate User ID and Password

RACFRACF

z/OS

SecurityManager

SecurityManager

(Windows, AIX, Solaris, Linux, Linux for z/OS, z/OS)

Page 19: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

19 © 2007 IBM Corporation

IBM Software Group

Security Management - WAS z/OS Thread Identity

IMSConnect

IMSConnect

IMS

OTMA

WebSphere Application Server z/OS

EnterpriseBean

EnterpriseBean

IMSResourceAdapter

IMSResourceAdapter

Res-auth = ContainerRunAs = Caller or System or Role

Pass the already authenticated Security Token of Run-As Identity to IMS Resource Adapter

Send Security Token to IMS Connect

Bypass authentication as user is already verified

RACFRACF

z/OS

SecurityManager

SecurityManager

Local Option

Authenticate UserIDwith RACF

Page 20: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

20 © 2007 IBM Corporation

IBM Software Group

Transactionality

Capability that allows IMS transactions to participate as a resource in two-phase commit external transactions Requires a syncpoint coordinator

RRS on z/OS and/or an external coordinator, e.g.,IBM WAS (Websphere Application Server)

Requires client code that uses IMS TMRA

Local Environment WAS, IMS Connect, IMS, and RRS must be in the same

z/OS image **

Distributed environment (Global XA transaction) IMS Connect, RRS and IMS must all exist in the same z/OS image *

Remote environments use XA

IMS Connect

Acts as an extension to RRS and is the SDRM (Server Distributed Syncpoint Manager)

Assists RRS in communicating with other syncpoint coordinators

Acts as the CRM (Communications Resource Manager)

WAS Server platform + IC4J

Protocol Global Trans

Distributed TCP/IP YES*

zLINUX TCP/IP on Hipersockets

YES*

z/OS TCP/IP YES*

z/OS Local Option YES **

Page 21: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

21 © 2007 IBM Corporation

IBM Software Group

Transactionality – Distributed XA 2PC Commit

IMSConnect

IMSConnect

IMS

OTMA

WebSphere Application Server

IMSResourceAdapter

IMSResourceAdapter

Transaction Attribute = TX_REQUIRED

z/OSResource Recovery

Service (RRS)

Resource RecoveryService (RRS)

TransactionManager

TransactionManager

SPISystem

Contracts

TCP/IP

Debit $100 from Checking

Credit $100to Savings

EnterpriseBean

EnterpriseBean

Single unit of work

DB2DB2

Checking Account

Saving Account

XA

(Windows, AIX, Solaris, Linux, Linux for z/OS, z/OS)

1. Uses IMS RA to invoke IMS transaction

2. Executes SQL stmts to DB2

3. Commits the Unit of work. WAS Transaction Manager, coordinates the unit of work with IMS and DB2 using XA and two phase commit.

Page 22: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

22 © 2007 IBM Corporation

IBM Software Group

Transactionality – z/OS RRS 2PC Commit

IMSConnect

IMSConnect

IMS

OTMA

WebSphere Application Server z/OS

IMSResourceAdapter

IMSResourceAdapter

Transaction Attribute = TX_REQUIRED

z/OSResource Recovery

Service (RRS)

Resource RecoveryService (RRS)

TransactionManager

TransactionManager

LocalOption

Debit $100 from Checking

Credit $100to Savings

EnterpriseBean

EnterpriseBean

Single unit of work

DB2DB2

Checking Account

Saving Account

1. Uses IMS RA to invoke IMS transaction

2. Executes SQL stmts to DB2

3. Commits the Unit of work. WAS Transaction Manager, using RRS, coordinates the unit of work with IMS and DB2 using two phase commit.

Page 23: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

23 © 2007 IBM Corporation

IBM Software Group

IMS IMS TM ResourceAdapter

Router

IMSIMSConnectConnect

Socket

Execution

Timeouts

Socket Timeout

Time IMS TM Resource Adapter waits for IMS Connect to return transaction output

Used for network problems

Per interaction

Encompasses Execution Timeout

Execution Timeout

Time IMS Connect waits for IMS to return transaction output.

Used for IMS hangs

Per interaction.

Page 24: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

24 © 2007 IBM Corporation

IBM Software Group

Agenda

Overview of JCA and IMS TM Resource Adapter

Socket Connections & Socket Types

Connection Management

Security Management

Transaction Management

Last enhancements

Supermember

Hold queue management

PurgeAsyncOutput and ReRoute and Retrieve

Alternate destination

Some IMS V10 Enhancements

SOA Composite Application

Accessing SOA applications from IMS (Callout)

Page 25: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

25 © 2007 IBM Corporation

IBM Software Group

IMS OTMA Hold Queues

An OTMA Client can request, at Client Bid time, that OTMA allows each TPIPE to have a “special” queue, normally referred to as a Hold Queue

Requested by IMS Connect

Hold Queues are for Commit Mode 0 only Used when a message can not be immediately delivered

A message on a hold queue will only be sent by IMS when explicitly requested with a RESUME TPIPE from the client

Hold Queue is used in following cases OTMA client (or its remote client) returns a negative acknowledgement to IMS

Input to OTMA specifies “Send Only”, but IMS application creates a reply

An IMS application creates a message - other than the reply message itself - for an OTMA destination using an Alternate PCB

The name that identifies a Hold Queue has two components The OTMA Client name

A Remote Client ID which equals the TPIPE name

In other words, each OTMA Client has its own Hold Queues in IMS

To retrieve a message on a hold queue, the remote client must issue the RESUME TPIPE request through the OTMA client to which it is queued

Page 26: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

26 © 2007 IBM Corporation

IBM Software Group

IMS Connect A

IMS Connect B

Member A(async msgs)

Member B(async msgs)

??

IMS

Asynchronous Output – Super Member A super member is a special OTMA member to keep the IMS Connect

asynchronous messages for a set of IMS Connects SMEMBER= on the HWS statement

Benefit IMS asynchronous output messages are sharable for a set of IMS Connects.

The end users are not aware of this feature.

Ensures asynchronous output messages available to any instance of IMS Connect running in a Parallel Sysplex environment

IMS Connect A(with

supermember)

IMS Connect B(with

supermember)

Member A

Member B

IMS

SuperMember

(async msg)

(async msg)

Page 27: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

27 © 2007 IBM Corporation

IBM Software Group

ABC

IMS Connect TMEMBER = ICON2

SMEMBER = XYZ

ABC

ICON1 ICON2

IMSA IMSB

ABC.ICON1.IMSAABC.XYZ

RECEIVE_ASYNCOUTPUTCOMMIT MODE=0CLIENT ID=ABC

Client Application With

Super Member Support

IMS Connect TMEMBER = ICON1

SMEMBER = XYZ

Hold queue orReroute queue

SysplexDistributor

Asynchronous Output – Super Member …

Page 28: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

28 © 2007 IBM Corporation

IBM Software Group

Asynchronous Messages – Purge or Reroute

Asynchronous messages appears on a hold queue when Undelivered commit mode 0 output messages (e.g. during timeout or secondary

outputs)

Secondary output from program-to-program switch (primary interaction can be Commit Mode 1 or Commit Mode 0)

Application inserts to ALT PCB

Handling Purge

The output is discarded from the current queue (OTMA TPIPE)This is the default option

Reroute

The output is moved from the current queue to a user specified destinationCan be retrieved asynchronously

Retrieving Two modes: Single no wait, single wait

Dedicated Client name vs Alternate Client ID

Page 29: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

29 © 2007 IBM Corporation

IBM Software Group

ABC

ABC

EarlierSupport

IMS ConnectTMEMBER=ICON1

ABC

ICON1 ICON2

IMSA IMSB

ABC.ICON1.IMSAABC.ICON2.IMSB

SysplexDistributor

SEND_RECEIVECOMMIT MODE=0

CLIENTID=ABC

Client application

IMS ConnectTMEMBER=ICON2

Hold or Reroute queue

Asynchronous Messages – Purge or Reroute …

Page 30: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

30 © 2007 IBM Corporation

IBM Software Group

Asynchronous Messages – Purge or Reroute …

New options supported on shareable persistent socket connections only

PurgeAsyncOutput

IMSInteractionSpec property: purgeAsyncOutput

TRUE (default) means purge undeliverable CommitMode 0 output

FALSE means queue undeliverable CommitMode 0 output to:– “reRoute” Tpipe if specified, or

– Tpipe with name of shareable persistent socket connection

reRoute

Used only when purgeAsyncOutput is FALSE

IMSInteractionSpec properties: reRoute and reRouteName

TRUE causes undelivered Commit Mode 0 output to be queued to Tpipe whose name matches specified reRouteName

FALSE (default) causes undelivered Commit Mode 0 output to be queued to Tpipe whose name matches generated clientID of shareable persistent socket connection

Page 31: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

31 © 2007 IBM Corporation

IBM Software Group

Asynchronous Messages – Retrieve

Use Interaction Verb SYNC_RECEIVE_ASYNCOUTPUT_xx

Two modes

SINGLE

Retrieves one message per interaction if a message available at the time of the request

SINGLE_WAIT

Retrieves one message per interaction

Will wait for a specified time for message to appear on the hold queue

Specify hold queue name

using the Client ID property with dedicated connection

using the Alternate Client ID (reRoute Name) property with sharable connections

Page 32: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

32 © 2007 IBM Corporation

IBM Software Group

Asynchronous Messages – Alternate Client ID Support

When WAS application issues a RESUME TPIPE, it can use a shareable socket and specify an Alternate Client ID

Enables application to use a shareable socket to retrieve asynchronous output messages that are queued to any specified clientID undelivered CM0 output

ALTPCB output messages

Simplifies writing of server application (“listener”) that retrieves messages for one or more hold queues

With this support, it is now possible to use shareable sockets in every case, and so avoid problems associated with Sysplex Distributor

IMS V10 adds new security check for RESUME TPIPE Check the userid associated with input message is authorised to access specified

TPIPE (alternate client ID)

Page 33: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

33 © 2007 IBM Corporation

IBM Software Group

Asynchronous Messages – Alternate Client ID Support …

In this example, a SEND_ONLY transaction is used to create a message on a hold queue, which is then retrieved by exploiting the alternate clientID support

CM0 and Shareable sockets used in both cases

IMS TM Resource Adapter IMS

Output

MSG1MSG1

TPIPEHWSABC02

Output

MSG1MSG1

execute() send

ACK

receive

CLIENT1

• MSG1MSG1

SOCKET IDHWSABC01

IMS Connect

execute()For CLIENT1For CLIENT1

send

Retrieve options are “Single wait ” or “Single no wait”

SYNC_RECEIVE_ASYNCOUTPUT

SYNC_Send_Only

Java Client

Java Client

SOCKET IDHWSABC02

Reroute=CLIENT1

IOPCB

HOLDQ

TPIPEHWSABC01

Appl Appl Pgm1Pgm1

Page 34: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

34 © 2007 IBM Corporation

IBM Software Group

Other Related Enhancements

OTMA provides Flood Control (PK04461 for V8, PK04463 for V9)

Partial retrofit of an IMS V10 enhancement

/START TMEMBER member_name INPUT nnnnn

Where nnnnn is maximum number of messages from the OTMA client that can be in process

TPIPE Storage Clean Up (PQ99983 for V8, PK00386 for V9)

A Tpipe will be removed if is has been IDLE for two consecutive checkpoints

Page 35: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

35 © 2007 IBM Corporation

IBM Software Group

Agenda

Overview of JCA and IMS TM Resource Adapter

Socket Connections & Socket Types

Connection Management

Security Management

Transaction Management

Last enhancements

Supermember

Hold queue management

PurgeAsyncOutput and ReRoute and Retrieve

Alternate destination

Some IMS V10 Enhancements

SOA Composite Application

Accessing SOA applications from IMS (Callout)

Page 36: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

36 © 2007 IBM Corporation

IBM Software Group

IMS SOA composite business application support

Asynchronous Callout to EJB

Enterprise Workload Manager (EWLM)

Ping support 

CM0 Ignore PURG

Resume Tpipe Security

RACF Mixed Case Password

Page 37: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

37 © 2007 IBM Corporation

IBM Software Group

Asynchronous Callout Allows IMS application to act as a client by issuing ISRT ALTPCB to send the callout request

Conversational Composite Business Application Ability to create conversational business process application

Enterprise Workload Manager (EWLM) Ability to track workflow from WAS

RACF Password Change Ability to change RACF password after expiration

Ping Determine IMS Connect availability

CM0 Ignore PURG Provides CM1 and CM0 consistent output message processing

Resume TPipe Security Authorized retrieval on output messages

LLLL | IRM | OTMA | LLZZ HWSPWCH old-password/new-password1/new-password2 | EOM

LLLL | IRM | OTMA User Data (EWLM 64 byte correlator) | LLZZ TRANCODE data | EOM

ITRA - IMS 10 enhancements

Page 38: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

38 © 2007 IBM Corporation

IBM Software Group

IMS Callout Support

IMS Applications can call an external application

ALTPCB ISRT (for asynchronous processing only in IMS or APPC)

MQ calls

TCP/IP sockets calls

APPC calls

Use caution when executing synchronously

Ties up region and its associated control blocks, and potentially holds locks on DB data

Some customers have been asking for additional techniques typical of web based solutions

First provided in IMS V10

Page 39: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

39 © 2007 IBM Corporation

IBM Software Group

IMS V10 Callout Support

Asynchronous outbound support from IMS applications using ALTPCB

1. Asynchronous Callout to EJB Customer provides “listener code” in JCA EJB application

2. Asynchronous Callout to Message Driven Bean (MDB) Use JCA 1.5 inbound architecture support – MDB acts as listener, and

calls appropriate service or routine

End-to-end tooling available

3. Outbound Web Services support in IMS SOAP Gateway IMS SOAP Gateway acts as listener and calls Web Service

WDz tooling used to read WebService Description and generate IMS message definition and XML transformation routine

In each case, a reply from the called service will be processed by a new IMS transaction

Another Txn

EJB /Web Service

IMS

IMS Application

z/OS

Anyplatform

Callout

InitiatingClient

IMS Resource Adapter

Page 40: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

40 © 2007 IBM Corporation

IBM Software Group

IMS Application 1

IMSConnect

WAS(IMS TMResourceAdapter)

•IMS Connect clients

BMP trans, MSC, ISC

Non-IMS Connect input trans from MQ via OTMA, SNA via APPC, LU0, LU6.2 or Terminal

ISRTALTPCB

IMS SOAP

Gateway

HoldQ

Other callout alternatives: MQ, DB2, APPC, JMP/IIOP

Web Service

OTMA Destination Routing

OTMA Resume Tpipe Security

Resume Tpipe with Alternate Client ID

EJB

MDB

IMS Application 2

IMS

output

IMS V10 Callout Support …

Page 41: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

41 © 2007 IBM Corporation

IBM Software Group

Credit Check

Process Loan App

Complete Loan

Decline Loan App

SOA Composite Business Applications (IMS V10) For IMS conversations

Conversation ID uncoupled from connection

Supports easy integration of IMS conversational transactions into SOA Composite Business Applications developed in WID

Better support for connection sharing and management

Page 42: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

42 © 2007 IBM Corporation

IBM Software Group

How do I get IMS TM Resource Adapter?

Rational Application Developer v 6.0

http://www.ibm.com/developerworks/rational/products/rad/

WebSphere Integration Developer v 6.0

http://www.ibm.com/software/integration/wid/

IMS Integration Suites

http://www.ibm.com/software/data/ims/toolkit/

Access to information and download runtimes for:

IMS TM Resource Adapter

IMS MFS Solutions

IMS SOAP Gateway

Articles of interest

http://www.ibm.com/developerworks/rational/library/05/0920_nigul/Generating a J2C bean using RAD

Page 43: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

43 © 2007 IBM Corporation

IBM Software Group

Final Thoughts

Service Oriented Architecture has revolutionized the way business is done

Standard interfaces and qualities of service inherent in SOA have made integration of IT assets and heterogeneous systems a reality

IMS is well positioned as a major player in this space with a variety of technologies that project IMS assets into the SOA foundation model

IMS JDBC and XML-DB/XQuery

IMS DB resource adapter

IMS TM resource adapter

IMS SOAP Gateway

Additional web services support for MFS based transactions

Page 44: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

44 © 2007 IBM Corporation

IBM Software Group

More on application development tools

Page 45: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

45 © 2007 IBM Corporation

IBM Software Group

Development Tools Transitioning from the past

• Integration Developer

• Compose Business Integration solutions

• Use JCA 1.5 IMS Resource Adapter

• Deploy to WebSphere Process Server

• J2EE/Integration Developer

• Build Integration applications

• Use JCA 1.0 IMS Resource Adapter

• Deploy to WAS

• Java/J2EE developer

• Build J2EE applications

• Use JCA 1.0 or 1.5 IMS Resource Adapter

• Deploy J2EE apps to WAS

WSAD-IE v 5.1.1Rational Application

Developer (RAD)

WebSphere

Integra

tion

Developer (

WID

)

J2EE developers using WSAD-IE today would likely transition to RAD

Integration developers using WSAD-IE today would likely transition to WID

Page 46: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

46 © 2007 IBM Corporation

IBM Software Group

Rapid Application Development

Page 47: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

47 © 2007 IBM Corporation

IBM Software Group

RAD - J2C Feature

1. Map the message

Generate Data binding classes for data transformation

Transform Java/Web Service data types to IMS application data types

2. Build the Bean

Generate Java classes for interaction

Connect and invoke IMS transaction

3. Wrap the app

Wrap Java classes as J2EE or Web Service

Make your IMS transaction accessible as Web Services or from J2EE application

Page 48: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

48 © 2007 IBM Corporation

IBM Software Group

RAD - J2C Feature - Mapping the message

‘Green screen’ COBOL copybook

Page 49: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

49 © 2007 IBM Corporation

IBM Software Group

RAD - J2C Feature - Wrapping the Web Service

Java data binding WSDL

Page 50: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

50 © 2007 IBM Corporation

IBM Software Group

Service Component Architecture

Based on J2EE

Service Components

Service Data Objects

Programming model for building business processes in a service oriented way

Value

Lowers the barriers for a developer to enter the world of SOA and become productive

J2EE and Web Service skills not required to create sophisticated business applications

Makes the experienced J2EE developers more productive.

SDO

ServiceComponent

Page 51: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

51 © 2007 IBM Corporation

IBM Software Group

WebSphere Integration Developer (WID) Tooling

Test&

Deploy

Import

EnterpriseDiscovery

ConfigureWire

Page 52: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

52 © 2007 IBM Corporation

IBM Software Group

Simplify and accelerate the development of integrated applications

Implements Service Component Architecture technology and business process choreography

Industry-standard service-oriented architecture

WebSphere Integration Developer (WID) Tooling …

Page 53: © 2007 IBM Corporation IBM Software Group Accessing IMS Transactions through WebSphere and the IMS TM Resource Adapter Hélène Lyon South-Europe IMS Technical

53 © 2007 IBM Corporation

IBM Software Group

WID - Building a Web Service

1. Map the message

2. Build the bean

3. Wrap the application as a web service

4. Integrate into a flow (business process)

Service (IMS)

Service (JavaMail)

Service (J2EE)

Service (JavaMail)