driving the business value through ims connect1 - ims ug april 2013 san ramon

®

Driving the Business Value

through

IMS Connect

© 2013 IBM Corporation

IMS Connect

Yuhui Li

IMS Connect is the integrated TCP/IP gateway to all of IMS

z/OS

IMSIMSXCF

IMS

Transaction manager

Database

manager

OT

MA

IMS Control Center client

IMS TM

SCIOperationsManager

DataPower

Other vendor

solutions

T

C

P

2

CONNECTCONNECT

Exit

XCF

Database

IMS APP

OT

MA

IMS TM

Resource Adapter

IMS SOAP Gateway

IMS Universal DB

Resource Adapter/

Drivers

SCI

OD

BM

Activejournal

IMS Connect

API Clients

P

/

I

P

IMS ConnectExtensions

Web

Serv

ice

.NET

Client

Client

Web service clients

Java/J2EE Client

Java dev

Direct Database access

Developers

Java /J2EE Developer

Solutions

WID RAD

IMS TM

Resource

Adapter

MFS SOA

WebSphere

Solutions

DLI

Model

Utility

WebSphere

IMS

Universal

DB

IMS ConnectTCP/IP

Transaction

manager

Database

manager

IMS Connect plays the key role of IMS SOA Integration Solutions

OD

BM

TCP/IP

DRDA

3

Web

Serv

ice

Client Developer

Application developer

SAP Client

CICS Developer

DB2 Developer

Java class Library

Direct

SOAP

IMS SOAP

Gateway

RDz

DLI

Model

Utility

DB2

SP/CICS

Resource

Adapter

IMS

Database

SQLXQuery

DL/IDL/ISOAP

manager

IMS APP

OT

MA

OD

BM

IMS

Universal

JDBC

Driver

IMS

Universal

JDBC

Driver

OD

BA

/DR

A

IMS

JDR

Resource

Adapter

Web 2.0 Mashup

HTTP IMS

Web 2.0

WebSphere

RE

ST

Serv

ice

InforShpere Mashup

DLI

Model

Utility

Business value of IMS Connect

– Supports TCP/IP sockets access to IMS TM and IMS DB� No requirement to modify existing IMS applications

– Provides a high performance strategic base for new connection technologies

4

technologies� IMSPLEX� Callout

- Provides SMP/E installability and serviceability

– Offers a structure interface and a high level programming interface to TCP/IP client applications

� For applications via IMS SOAP Gateway, IMS TM Resource Adapter, user-written client applications, and Java application for DB requests.

®

IMS Connect Basic for Applications


Configuration to IMS/TM via OTMA

XCF Group Name IMS systems

I

C

O

N

N

0

1

IMS Connect

OTMA=Y

GRNAME=IMSXCF

TCPIP Network

IMSXCFICA

IMSV10

Application specifies:

Host DNS name,

IMS Connect Port

T

C

P

/

I

P

Host DNS

name3336

OTMA=Y

GRNAME=IMSXCF

OTMANM=IMSPROD3IMSPROD3ICA1

6

IMS Connect configuration (HWSCFGnn) member resides in IMS.PROCLIB

HWS (ID=ICONN01,RACF=N,)

TCPIP (ECB=Y,HOSTNAME=TCPIP,PORTID=(3336),EXIT=(HWSSMPL1,HWSIMSO1))

DATASTORE(ID=IMSA,MEMBER=ICA,GROUP=IMSXCF,TMEMBER=IMSV10)

DATASTORE(ID=IMSB,MEMBER=ICA1,GROUP=IMSXCF,TMEMBER=IMSPROD3)

1 GRNAME=IMSXCF

OTMANM=IIMSV10IMS Connect Port

(e.g. 3336)

and Datastore ID

(e.g. IMSA or IMSB)

Support one-to-many and many-to-one connection!

Configuration to IMS/DB via ODBM

IMS systems

I

C

O

N

N

0

1

IMS Connect

T

C

P

/

I

P

999

DRDAApplicationRequestor

TCP/IPClient

IMS/DB

IMS/DB

ODBMODBA

ODBMODBA

7

ODACCESS=(ODBMAUTOCONN=Y|N,ODBMTMOT=,DRDAPORT=(ID=,KEEPAV=,PORTTMOT=),

IMSPLEX=(MEMBER=,TMEMBER=))

1 IMS/DB

Support one-to-many and many-to-one connection!

Message Flow for an IMS/TM Transaction

IMS Connect

T

C

PUser Exits:- Translation ASCII /

Clients using SOCKETS API:

- Input message:

8

O

T

M

A

IMS

OTMA headers

+ input msg

P

/

I

P

- Translation ASCII /

EBCDIC

- Validation

- Conversion between

client message format

and OTMA message

format

- Prepare output

message format

OTMA headers

+ output msg

� Formatted message header to

communicate with IMS Connect

� Client message (can include

OTMA headers)

- Output message can consist of

one or more predefined structures

Message Flow for an IMS/DB Request

IMS Connect

T

C

PUser Exits:-For security

Clients using SOCKETS API:

- Input message:

9

O

D

B

A

IMS

ODBM

+ input msg

P

/

I

P

-For security

-For ODBM selection

ODBM

+ output msg

� DRDA message

-Output message

- DRDA message

ODBM

IMS Connect acts like a router between the client and the IMS Open Database Manager (ODBM).

Distributed clients would now have the option of going directly to IMS Connect for IMS DB requests

LPAR A

LPAR BWebSphere

IMS ConnectIMS

CTL IMS DB

IMS

PCS

C

I

O

D

B

A

ODBM

ODBM

XCFJ

C

A

1.5

T

C

P/

I

P

S

O

A

P

10

LPAR C

z/OSAny TCP/IP-enabled environment

IMS Connect

S

C

I

TCP/IP

XCFIMS DB

CTLPCS

C

I

O

D

B

A

IMS DBCTL

IMS

PCS

C

I

O

D

B

A

ODBM

JDBC TCP/IP

DL/I TCP/IP

Roll Your Own TCP/IP

XCF

IMS Universal DB resource adapter

Custom DRDA client application

IMS Universal DL/I driver

IMS Universal JDBC driver

IMS Connect Client Application Protocol

� TCP/IP Socket Type

– Transaction socket

• Socket remains open for only one transaction

– Persistent socket

• Socket remains open for multiple transactions until client closes the socket

11

• Socket remains open for multiple transactions until client closes the socket

IMS Connect Client Application Protocol for Transaction

� IMS Commit Modes

– Commit-then-send (CM0)

• IMS commits changes to IMS databases before sending a response back to IMS Connect.

– Send-then-commit (CM1)

12

– Send-then-commit (CM1)

• IMS sends the response back to the client before committing the changes to the IMS databases.

IMS Connect Client Application Protocol for Transaction

� Synchronization Levels

– SyncLevel None – No acknowledgement

– SyncLevel Confirm – ACK/NAK required

– SyncLevel Sync – ACK is required and RRS is needed to provide 2 phase commit processing

15

commit processing

Client IMS Connect IMS

Input Tran Input Tran

OutputOutput

Acknowledgment ???

®

Key Functions of IMS Connect


IMS Connect for IMS SOAP Gateway

ConnectIMS

IMS SOAP Gateway

AdapterTask

Manager

Z/OS

32 0IVTNO DISPLAY LAST1

<?xml version="1.0"?><soap:Envelope>

<soap:Body><INPUTMSG><in_ll>32</in_ll><in_zz>0</in_zz><in_trcd>IVTNO</in_trcd><in_cmd>DISPLAY</in_cmd><in_name1>LAST1</in_name1>

</INPUTMSG></soap:Body>

</soap:Envelope>

<INPUTMSG><in_ll>32</in_ll><in_zz>0</in_zz><in_trcd>IVTNO</in_trcd><in_cmd>DISPLAY</in_cmd><in_name1>LAST1</in_name1>

</INPUTMSG>

SOAP XML Byte array

17

Microsoft.NET Client

XMLAdapter

IMSAppTCP/IPHTTP/SOAP

XML Converters

IMS WebService

<?xml version="1.0"?><soap:Envelope>

<soap:Body><cbl:OUTPUTMSG>

<out_ll>93</out_ll><out_zz>0</out_zz><out_msg>ENTRY WAS DISPLAYED</out_msg><out_cmd>DISPLAY</out_cmd><out_name1>LAST1</out_name1><out_name2>FIRST1</out_name2><out_extn>8-111-1111</out_extn><out_zip>D01/R01</out_zip><out_segno>0001</out_segno>

</cbl:OUTPUTMSG> </soap:Body>

</soap:Envelope>

<cbl:OUTPUTMSG><out_ll>93</out_ll><out_zz>0</out_zz><out_msg>ENTRY WAS DISPLAYED</out_msg><out_cmd>DISPLAY</out_cmd><out_name1>LAST1</out_name1><out_name2>FIRST1</out_name2><out_extn>8-111-1111</out_extn><out_zip>D01/R01</out_zip><out_segno>0001</out_segno>

</cbl:OUTPUTMSG>

93 0

ENTRY WAS DISPLAYED

DISPLAY

LAST1 FIRST1

8-111-11111

D01/R01 0001

IMS SOAP

GATEWAY

IMS Synchronous Callout z/OS

IMS

DB

OT

MA

TM/CTLIMS

Connect

WebSphereIMSTM

resource

adapter

Application Program

MPP/JMP/IFP/BMP/JBP

18

GATEWAY

Database

Services

OT

MA Services

Connect

TCP/IP

user-written

Client

ICAL

OTMADescriptor

Synchronous Callout via IMS Connect

� Capability

– IMS applications can invoke external applications and synchronously receive a response in the same IMS transaction instance

– New DLI call - ICAL

• AIBTDLI call provides synchronous callout request

19

– Timeout capability

• Control the time for synchronous callout processing

– Relieve 32K segmentation limitation

• IMS Connect and OTMA handle buffer and segmentation internally

– V10 APARs PK71135 ,PK74168

IMS Connect API

IMS Connect

API

IMS Connect

API

IMS Connect

API

Client Application

IMS Connect

Windows or z/OS

OT

IMS App

z/OS

IMS

20

APIAPI T

MA

IMS App

IMS App

IMS App

IMS Connect API…

� A simplified callable interface for interaction with IMS Connect

– Architected on top of the sockets layer

• Through a set of extensible profiles that define the connections and types of interactions to be performed

– And a set of both high-level and low-level methods for performing those interactions with IMS Connect

21

� Addresses the complexities of writing RYO applications

• Experience in TCP/IP socket programming

– Including connection management

• Understanding the IRM header and the possible flags as well as settings

• Familiarity with the IMS Connect application protocols and their impact on all the possible types of interactions

� See IMS Enterprise Suite V1R1 for details

Coupling

FacilityIMS IMSIMS

Connect

DB2 ControlCenter

IMS SOAPGateway

IMS Connect supports z/OS Sysplex Distributor for workload balance

22

Sys

ple

x D

istr

ibuto

r

ATM

Super

Member

IMS IMSIMS

Connect

WebSphere

Gateway

Dist. TCP/IPAPP

Z/OS TCP/IPAPP

Note: Super member can be used to shared asynchronous output messages

Transfer $100 from

Checking to Savings

Resource Recovery Resource Recovery Services (RRS)Services (RRS)

Web Web

ComponentComponent

Transaction Transaction

ManagerManager

WebSphere Application Server for z/OS

1,4

z/OS

IMS Connect Supports 2-phase commit for IMS/TM and IMS/DB

23

IMSIMS

ConnectConnect

IMSIMS

DB2DB2

Checking

Account DB

Savings

Account DB

IMS

Resource

Adapter

Enterprise BeanEnterprise Bean

2. Debit $100 from 2. Debit $100 from CheckingChecking

3. Credit $100 to Savings3. Credit $100 to Savings

1. Begin Transaction1. Begin Transaction

4. Commit Transaction4. Commit Transaction

2

3

2

1,4

Local

Option

TCP/IP

IMS Connect Security

� IMS Connect performs authentication of the user.

– RACF=Y (ICON configuration PROCLIB member)

• IMS Connect makes authentication call to RACF

• Each request from IMS Connect client must contain a user ID and password or a RACF PassTicket.

� OTMA performs authorization of the user.

– OTMASE= (DFSPBxxx PROCLIB member)

– /SECURE OTMA FULL/CHECK/NONE

24

IMS ConnectIMS

TM/DBCan I

Connect to you?

Userid

Password

Authentication

Checking for userid

And password

(may call user-written

Security exit)

Transaction

And Command

Authorization

Checking

IMS Connect Security...

� Passticket support– Provides an encrypted alternative to sending a password

� Trusted User support– Bypasses security check for messages from 'trusted' users even with RACF=Y

� IMS Connect SSL

– SSLPORT= (ICON configuration PROCLIB member)

25

– SSLPORT= (ICON configuration PROCLIB member)

• Only one SSL port can be specified.

� z/OS SSL

– Application Transparent Transport Layer Security(AT-TLS)

• No limitation on number of SSL ports

IMS Connect Supports OTMA Input Timeout

� IMS OTMA Input Timeout function allows IMS input messages to expire and be deleted prior to processing

� Addresses the situation when unexpected delays in the network or in IMS result in a remote client timeout before receiving a reply message

– Response is no longer required but the transactions remain queued in IMS for processing

26

for processing

� Provide capability to expire unprocessed transactions

- Reduce cost of processing transactions when clients no longer care

(see V10 IMS PK78195 + OTMA PK74017 + ICON PK74024 )

NetworkATM

IMS

TIMEOUT (reply not needed)

Auto Reconnect for TCP/IP, OTMA, and ODBM

� Automatic reconnection to TCP/IP, OTMA, and ODBM when network becomes available after a failure

– Auto reconnect for TCP/IP is a IMS V11 function. It eliminates the need for operator intervention, e.g., OPENPORT command

• Minimizes recovery time for connections after a network outage

27

IMS ConnectTCP/IP

OTMA

ODBM

Cancel Clientid to Reestablish a Failed Connection

� Addresses the issue of “Duplicate Clientid” when client becomes disconnected from IMS Connect and tries to re-connect

� Faster, automated way to reestablish a failed connection

• Cancels an existing socket connection and establishes a new socket connection with the same Client ID. V9 PK70327, V10 PK73829, V11 in base

• Simpler that the cancel timer alternative

IMS Client IMS

28

Connect

Connection Break

Re-Connect

Send w/ Cancel Client ID

Connect

Receive State

Connect

Receive

Client IMS Connect

Cancel Client ID solution (new)

Connect

Connection Break

Send connection with same clientid

Send Cancel timer

Connect

Connect

Receive State

Client idStill active

Duplicate client

Cleanup

Connect

Client IMS Connect

HWS0742W

Cancel Timer solution (previous)

Failover support for multiple clients via IMS Connect

– Allows multiple Resume TPIPEs to exist for a given TMEMBER/TPIPE and will flow asynchronous messages to subsequent clients when the first client terminates

– V10 APARs PK80756/PK80758

WebSphere Application Server

TPIPE1

29

IMS Connect

IMS

EJB / MDB

Web ServiceProvider

(e.g. Microsoft.NET)

IMS TM Resource Adapter


EJB / MDB

IMS TM Resource Adapter

TPIPE1

IMS Connect support for OTMA Flood Detection

IMS Connect exploitation of OTMA flood monitoring support:

• Processes the new flood protocol messages

• Updates its data store entry (XIBDS)

• Records new data store events for warning and severe

status

30

ATMIMS ConnectA

IMS

OTMA

Resource Monitor

Heartbeat msg

with resource info

80% flood

reached msg

Available in V10: APAR PK70458 and PK70960


EJB /

MDB

IMS TM

Resource

Adapter

IMS1 with flood

IMS Connect support for OTMA Flood Detection…•Provides the information to vendor applications and user exits that can access the

information and redirect the transaction requests to a different IMS if needed

31

IMSSOAP

Gateway

IMS ConnectRoll-your-own

z/OS Application

Web Service

Provider

IMS Connect

IMS2TransactionsRedirect to IMS2

®

Summary


z/OS

IMSIMS

CONNECTCONNECTXCF

IMS

Transaction manager

IMS APP

Database

manager

OT

MA

IMS Control Center client

IMS TM

Resource Adapter

SCIOperationsManager

DataPower

Other vendor

solutions

T

C

P

/

IMS Connect is the integrated TCP/IP gateway to all of IMS

33

- Becomes the TCP/IP gateway to both IMS/TM and IMS/DB- Achieves high transaction rate- Supports IBM solutions, e.g., WebSphere, SOAP Gateway and DataPower client for IMS, and other vendor solutions to access IMS applications

ExitDatabase

IMS SOAP Gateway

IMS Universal DB

Resource Adapter/

Drivers

SCI

OD

BM

IMS Connect

API Clients

I

P

IMS ConnectExtensions

driving the business value through ims connect1 - ims ug april 2013 san ramon

Technology