Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
IMS Enterprise Suite
2.2 SOAP Gateway
June 2013
With thanks to Ken Blackman
Alison Coughtrie - European IMS Architecture T...
Important Disclaimer
© Copyright IBM Corporation 2013. All rights reserved.
U.S. Government Users Restricted Rights - Use,...
• SOAP Gateway Overview
• SOAP Gateway 2.2 Enhancements
– Advanced installation and maintenance
– Graceful shutdown
– WS-S...
IMS Enterprise Suite
• Part of the IMS SOA Integration Suite
– Collection of IMS middleware functions and tools
– Availabl...
IMS SOAP Gateway
• A light weight Web Service solution for IMS TM access without a Java EE
Server
• Integrates IMS assets ...
IMS SOAP Gateway – Web Service Provider
• .NET Client Invokes IMS COBOL Application as a Web Service
IMS SOAP Gateway …wit...
IMS SOAP Gateway – Web Service Consumer
IMS SOAP
Gateway
0Resume
TPIPE TP1
token
DEST1
TP1
HWS1
HWSXMLA0
XMLCNV1D
Descript...
Runtime and Development Environment
Runtime EnvironmentRuntime Environment z/OS
IMS ConnectIMS SOAP Gateway IMS
IMS
Applic...
Rational Developer for System z
• Two limited use licenses (without support) of IBM Rational Developer for
System z are pr...
SOAP Gateway 2.2 enhancements
© 2013 IBM Corporation10
The new installation architecture
• In Version 2.2, the SOAP Gateway installation is divided into three
components:
© 2013...
• Server is divided into three components
– Imsserver – can be mounted as READ only
• Contains the servers executable code...
What is IBM Installation Manager for z/OS?
• IBM Installation Manager has been used
on distributed platforms for many year...
Installing multiple copies of SOAP Gateway
• The SOAP Gateway repository is a
compressed file (.zip file) that you
obtain ...
The new installation process
© 2013 IBM Corporation15
The new installation process
© 2013 IBM Corporation16
Before the installation,
you will need to apply
PTF UK79476
to upgra...
Advanced installation and maintenance
• Enhanced migration support of server properties
– the -migrate command is enhanced...
Graceful Shutdown
• Enhanced Server shutdown
– Graceful shutdown: Process all in-flight messages before the
shutdown
• Blo...
Multiple Connection Bundles for Synchronous Callout Applications
• Multiple connection bundles for synchronous callout app...
IMS
ConnectA
Datastore
IMS1
TCP/IPIMS SOAP Gateway Server
SOAP
HTTP
Soap
IMS1
Appl
ICAL
HTTP Port
8080
Port
9998
Connectio...
WS-Security
• WS-Security SAML unsigned tokens for synchronous callout applications
– Originating Userid (PSTUSID) for the...
IMS
SOAP
Gateway
IMS SOAP Gateway WS-Security SAML unsigned tokens for
synchronous callout applications
z/OS
IMS
TM/CTL
Se...
Transaction Tracking
• SOAP Gateway transaction tracking IDs and logging
– SOAP Gateway can attach 40 byte horizontal trac...
Transaction tracking
• SOAP Gateway transaction tracking IDs and logging
– SOAP Gateway can generate a unique vertical cor...
Transaction tracking
• SOAP Gateway transaction tracking IDs and logging
– Activate and configure tracking IDs
• iogmgmt -...
Transaction tracking
• SOAP Gateway transaction tracking IDs and logging
– Remote IBM Tivoli Composite Application Manager...
End-to-end Transaction Tracking – Provider Scenario
(correlation based on Tracking ID)
IMS ES 2.2
SOAP
Gateway
IMS
Connect...
SOAP Log – Input Message
© 2013 IBM Corporation28
BPE Trace
© 2013 IBM Corporation29
IMS Log Record
© 2013 IBM Corporation30
IMS Log Record
© 2013 IBM Corporation31
SOAP Log – Output Message
© 2013 IBM Corporation32
Transaction Events Information
© 2013 IBM Corporation33
JMX Monitoring
• Java Management Extensions (JMX) instrumentation for SOAP Gateway
– Standard JMX instrumentation for the ...
JMX MBean interface for web service provider monitoring
• C:..IMS Enterprise Suite V2.2SOAP Gatewayjavabin
– JConsole.exe
...
JConsole sample output
© 2013 IBM Corporation36
IMS ES 2.2 SOAP Gateway New Samples
• IMS Exchange web site updated - Link:
ibm.com/developerworks/mydeveloperworks/blogs/...
Cobol Top Down
• Target Market
– IMS Customers who want to quickly get synchronous callout running with SOAP
Gateway.
– SO...
Design
© 2013 IBM Corporation39
Prerequisites
• Software requirements
– Enterprise Suite V2.2 SOAP Gateway
– IMS V11 or IMS V12 with integrated IMS Connec...
Any Questions?
© 2013 IBM Corporation41
Upcoming SlideShare
Loading in …5
×

IMS09 IMS ES SOAP Gateway - IMS UG June 2013 Sydney

902 views

Published on

Published in: Technology
  • Be the first to comment

  • Be the first to like this

IMS09 IMS ES SOAP Gateway - IMS UG June 2013 Sydney

  1. 1. IMS Enterprise Suite 2.2 SOAP Gateway June 2013 With thanks to Ken Blackman Alison Coughtrie - European IMS Architecture Team © 2013 IBM Corporation1
  2. 2. Important Disclaimer © Copyright IBM Corporation 2013. All rights reserved. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. THE INFORMATION CONTAINED IN THIS PRESENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS PRESENTATION, IT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE. THE INFORMATION ON NEW PRODUCTS IS FOR INFORMATIONAL PURPOSES ONLY AND MAY NOT BE INCORPORATED INTO ANY CONTRACT. THE INFORMATION ON ANY NEW PRODUCTS IS NOT A COMMITMENT, PROMISE, OR LEGAL OBLIGATION TO DELIVER ANY MATERIAL, CODE OR FUNCTIONALITY. THE DEVELOPMENT, RELEASE, AND TIMING OF ANY FEATURES OR FUNCTIONALITY DESCRIBED FOR OUR PRODUCTS REMAINS AT THE SOLE DISCRETION OF IBM. IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS PRESENTATION OR ANY © 2013 IBM Corporation2 FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS PRESENTATION OR ANY OTHER DOCUMENTATION. NOTHING CONTAINED IN THIS PRESENTATION IS INTENDED TO, NOR SHALL HAVE THE EFFECT OF, CREATING ANY WARRANTIES OR REPRESENTATIONS FROM IBM (OR ITS SUPPLIERS OR LICENSORS), OR ALTERING THE TERMS AND CONDITIONS OF ANY AGREEMENT OR LICENSE GOVERNING THE USE OF IBM PRODUCTS AND/OR SOFTWARE. IBM, the IBM logo, ibm.com, Information Management, IMS, and z/OS are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at ibm.com/legal/copytrade.shtml Other company, product, or service names may be trademarks or service marks of others.
  3. 3. • SOAP Gateway Overview • SOAP Gateway 2.2 Enhancements – Advanced installation and maintenance – Graceful shutdown – WS-Security Topics © 2013 IBM Corporation3 – Support for multiple connection bundles for synchronous callout applications – Transaction tracking – Java Management Extensions (JMX) Monitoring
  4. 4. IMS Enterprise Suite • Part of the IMS SOA Integration Suite – Collection of IMS middleware functions and tools – Available for download from IMS Enterprise Suite Web page ibm.com/software/data/ims/soa-integration-suite/enterprise-suite/ • Packaging method for the most current versions of selected IMS SOA Integration Suite components – IMS Enterprise Suite SOAP Gateway © 2013 IBM Corporation4 – IMS Enterprise Suite SOAP Gateway – IMS Enterprise Suite DLIModel Utility plug-in – IMS Enterprise Suite Connect APIs for Java and C – IMS Enterprise Suite IMS Explorer for Development – IMS Enterprise Suite JMS API • Latest Version 2.2 – SOAP Gateway 2.2.0.1 is equivalent to APAR PM78757
  5. 5. IMS SOAP Gateway • A light weight Web Service solution for IMS TM access without a Java EE Server • Integrates IMS assets into a Service Oriented Architecture • Provides end-to-end interactions between IMS transactions and Web services clients in an On Demand environment • Enables IMS as a Provider and Consumer of Web Services • Secure • SOAPSOAP A standardized way ofA standardized way of using XML to defineusing XML to define both a message and theboth a message and the target applicationtarget application © 2013 IBM Corporation5 • Utilizes Advanced Tooling – Utilizes Rational Developer for System z tooling to create converters for transforming XML messages to IMS messages and vice versa – No need to change existing IMS application code Web Service Client (.NET, SAP, java, etc.) IMS SOAP Gateway IMS IMS Connect z/OS HTTP / SOAP TCP/IP / XML Windows/AIX/Linux/z/OS SOAP Envelope with XML message XML message IMS message XMLXML TransformerTransformer target applicationtarget application
  6. 6. IMS SOAP Gateway – Web Service Provider • .NET Client Invokes IMS COBOL Application as a Web Service IMS SOAP Gateway …with XML Adapter XMLXML <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> z/OS IMS Connect IMS SOAP Gateway Adapter Task Manager Byte ArrayByte Array IMS O 32 0IVTNO DISPLAY LAST1 SOAPSOAP <?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> © 2013 IBM Corporation6 SOAP Clients (Java, SAP, .NET) HTTP/ SOAP <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> Manager XML Adapter COBOL Converters Web Service TCP/IP IMS Application O T M A 93 0 ENTRY WAS DISPLAYED DISPLAY LAST1 FIRST1 8-111-11111 D01/R01 0001 <?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> The IMS Application can remain unchanged
  7. 7. IMS SOAP Gateway – Web Service Consumer IMS SOAP Gateway 0Resume TPIPE TP1 token DEST1 TP1 HWS1 HWSXMLA0 XMLCNV1D Descriptor HWS1 IMS Connect IMS OTMA TPIPE TP1 IMS Application 1 XML Adapter 3 Bytes XML 2 Send Request Msg with a correlation token AIBTDLI Descriptor name Timeout IMS SOAP Gateway can act as a Web Services Caller for IMS, as well as provide its traditional role as a Web Services Server for © 2013 IBM Corporation7 ACK 5 Send Response 8 Web Service Provider Invoke Web Service57 token XML XML Adapter HWSXMLA0 XML Converter XMLCNV1D 10 Bytes IWAIT with timer4 Send Only Response Msg with token 6 Lookup Web Service info from Correlator file 9 Internal flow External flow Server for IMS
  8. 8. Runtime and Development Environment Runtime EnvironmentRuntime Environment z/OS IMS ConnectIMS SOAP Gateway IMS IMS Application Adapter Task Manager XML Adapter Web ServiceSOAP Clients (Java, SAP, .NET) HTTP/SOAP TCP/IP O T M A SOAP Specifies connection & security properties e.g. IMS Connect host name, IMS connect port, IMS datastore, SSL info. © 2013 IBM Corporation8 COBOL/PLI Converters SOAP Gateway Deployment Utility COBOL/PLI Converters COBOL Copybook /PLI structure Correlator File .XML UDDI Registry Execution Generation Development EnvironmentDevelopment Environment –– IBM Rational Developer for System z (RDz)IBM Rational Developer for System z (RDz) Web Service Description Language file – XML document specifies location of the service and how the input & output messages should appear in order to invoke the service Connection Bundle Specifies transaction & runtime properties e.g. XML converter name, connection bundle, timeout, IMS tran code WSDL
  9. 9. Rational Developer for System z • Two limited use licenses (without support) of IBM Rational Developer for System z are provided for each physical System z mainframe for which IMS Version 10, Version 11, or Version 12 is licensed. Terms and conditions are outlined in the Rational Developer for System z licensing information. Rational Developer for System z IMS Edition can be downloaded from the IMS Enterprise Suite download website. V8.0.3 is the last version for which an IMS edition is made available to IMS customers. For newer versions, you can download the trial version for © 2013 IBM Corporation9 customers. For newer versions, you can download the trial version for an evaluation period of 90 days from ibm.com/developerworks/downloads/r/rdz/.
  10. 10. SOAP Gateway 2.2 enhancements © 2013 IBM Corporation10
  11. 11. The new installation architecture • In Version 2.2, the SOAP Gateway installation is divided into three components: © 2013 IBM Corporation11
  12. 12. • Server is divided into three components – Imsserver – can be mounted as READ only • Contains the servers executable code – Imsbase – can be mounted as READ and WRITE • Contains the servers configurations and log – Imssoap - can be mounted as READ and WRITE • Contains the user-deployed web service-related files • WSDL's, correlators, connection bundles – Benefits • Advanced installation and maintenance © 2013 IBM Corporation12 • Easier to apply maintenance • Allocate additional disk space when more web services are added without disrupting server • IBM® Installation Manager for z/OS® V1.5.3 – Supports centralized repository delivered through the SMP/E process – Benefits • Simplifies maintenance process • Multiple SOAP Gateway server instances – Share a single instance of the Java™ Virtual Machine (JVM) – Benefits • Reduces the amount of storage required for each additional server instance
  13. 13. What is IBM Installation Manager for z/OS? • IBM Installation Manager has been used on distributed platforms for many years for installing IBM products and applying updates • It installs from a repository – A repository contains a repository.config file that stores the © 2013 IBM Corporation13 repository.config file that stores the metadata on how to install and lay out the selected packages on the system • More and more IBM z/OS products are using IBM Installation Manager for z/OS, including WebSphere Application Server for z/OS • IBM IM for z/OS is included in IMS ES 2.2 order
  14. 14. Installing multiple copies of SOAP Gateway • The SOAP Gateway repository is a compressed file (.zip file) that you obtain after you go through the standard SMP/E process – Accessible through FTP, HTTP or shared disk SOAP Gateway repository HTTP, FTP, shared disk © 2013 IBM Corporation14 shared disk • The Installation Manager for z/OS will connect to the repository and install SOAP Gateway • You can install multiple copies of SOAP Gateway from the same SMP/E managed repository LPAR 1 LPAR 2 LPAR 3 LPAR 4 Installation Manager Installation Manager SOAPSOAP SOAP SOAPSOAP SOAPSOAP Sysplex
  15. 15. The new installation process © 2013 IBM Corporation15
  16. 16. The new installation process © 2013 IBM Corporation16 Before the installation, you will need to apply PTF UK79476 to upgrade to V 1.5.3 of the Installation Manager.
  17. 17. Advanced installation and maintenance • Enhanced migration support of server properties – the -migrate command is enhanced to support the migration of server properties and web services • supports the migration of existing server properties • propagates the server configuration to multiple server instances • Go to the directory where the V2.2 SOAP Gateway management utility is : install_dir/imsserver/deploy. © 2013 IBM Corporation17 : install_dir/imsserver/deploy. – For z/OS or Linux: ./iogmgmt -migrate path_to_2.1_install_dir – For Windows: iogmgmt -migrate path_to_2.1_install_dir • Benefits – Eliminates the need to reconfigure the server Note: If the imsserver component is read-only, you must change it to read/write mode before you run the migration tool.
  18. 18. Graceful Shutdown • Enhanced Server shutdown – Graceful shutdown: Process all in-flight messages before the shutdown • Blocks inbound web service requests • Interrupts IMS Connect socket to stop further Outbound callout requests • After 5 minutes, the server forces a shutdown © 2013 IBM Corporation18 • After 5 minutes, the server forces a shutdown – Immediate shutdown • Discards any in-flight messages and immediately stops the server • Benefits – Graceful shutdown ensures all web service requests or callout requests are processed before the server goes down
  19. 19. Multiple Connection Bundles for Synchronous Callout Applications • Multiple connection bundles for synchronous callout applications – Allows synchronous callout response messages to be returned to the correct originating IMS Connect • Management Utility command to specify multiple connection bundles iogmgmt –corr … –d callout_connection_bundle_name1, callout_connection_bundle_name2, . . . • Benefit © 2013 IBM Corporation19 • Benefit – Enables use of multiple IMS Connects for outbound processing
  20. 20. IMS ConnectA Datastore IMS1 TCP/IPIMS SOAP Gateway Server SOAP HTTP Soap IMS1 Appl ICAL HTTP Port 8080 Port 9998 Connection Bundle(CBA) Port = 9998 host = .... Correlator1 CBB Multiple Callout Connection Bundles © 2013 IBM Corporation20 Soap Client ICAL Correlator2 CBA,CBB Connection Bundle(CBB) Port = 9989 host = .... IMS ConnectB Datastore IMS1 Port 9989 iogmgmt -corr –u –r correlator2 –d CBA,CBB
  21. 21. WS-Security • WS-Security SAML unsigned tokens for synchronous callout applications – Originating Userid (PSTUSID) for the IMS synchronous callout application is passed to the external web service for further authentication and authorization – Benefit • Provides message-level security for synchronous callout • WS-Security enhancement for Provider web services – © 2013 IBM Corporation21 – Support for Security Assertion Markup Language (SAML) 2.0 sender- vouches signed tokens – Benefit • Provides additional message integrity for service provider processing • Extends SOAP Gateway support of WS-Security standards SAML is an XML-based standard developed by Security Services Technical Committee (SSTC) of Organization for the Advancement of Structured Information Standards (OASIS).
  22. 22. IMS SOAP Gateway IMS SOAP Gateway WS-Security SAML unsigned tokens for synchronous callout applications z/OS IMS TM/CTL Services IMS Connect HWS1 Web Service Application Program ICAL DEST1 Resume TPIPE TPS TPS DEST1 TPS HWS1 HWSXMLA0 CORTKN USERA XML USERA Initiating Client USERA CORTKN USERA Java © 2013 IBM Corporation22 HWS1 DEST1 OTMA HWSXMLA0 XMLCNV1D ACK Send_ONLY HWSXMLA0 XML Converter XMLCNV1D CORTKN USERA XML USERA Request data Response data XML USERA XML USERA Connection Bundle TPS USERA CORTKN USERA Custom Authentication
  23. 23. Transaction Tracking • SOAP Gateway transaction tracking IDs and logging – SOAP Gateway can attach 40 byte horizontal tracking ID to inbound web service request • ID is sent with the inbound request through IMS Connect to the target IMS application and returned with the response message to SOAP Gateway – IMS Connect tracking ID captured by the IMS Connect Event Recorder exit routine (HWSTECL0) • This information can be consumed by the IBM IMS Connect Extensions for z/OS Note: Transaction tracking is not supported for callout messages © 2013 IBM Corporation23 • This information can be consumed by the IBM IMS Connect Extensions for z/OS and equivalent tools • For IMS 12 requires APAR PM69983/UK82576 applied to IMS Connect – IMS log records for transactions include the tracking ID • IBM IMS Performance Analyzer for z/OS and IBM IMS Problem Investigator for z/OS, or equivalent tools, to inspect IMS log records – Benefits • Correlates transactions between SOAP Gateway, IMS Connect, and IMS • Provides information for diagnostic purposes
  24. 24. Transaction tracking • SOAP Gateway transaction tracking IDs and logging – SOAP Gateway can generate a unique vertical correlation ID for every incoming request • used to correlate all of the SOAP Gateway message processing events associated with a service provider request using a single unique ID • Vertical ID is in the SOAP Gateway transaction log file if enabled – The vertical ID is always unique and is not user configurable © 2013 IBM Corporation24 – The vertical ID is always unique and is not user configurable • Can be propagated to a remote IBM Tivoli® Composite Application Manager for Transactions (ITCAM) if one is configured – Note: the vertical ID is not used to identify the message at other points in the application pathway – Benefits • Provides information for diagnostic purposes
  25. 25. Transaction tracking • SOAP Gateway transaction tracking IDs and logging – Activate and configure tracking IDs • iogmgmt -tracking -on command – View SOAP Gateway tracking and monitoring functions • iogmgmt -view -soapgatewayproperties – SOAP Gateway server transaction log file • © 2013 IBM Corporation25 • provides a complete record of every request made to a SOAP Gateway – includes both horizontal and vertical IDs • iogmgmt -tranLog -on -fileMaxAge 1
  26. 26. Transaction tracking • SOAP Gateway transaction tracking IDs and logging – Remote IBM Tivoli Composite Application Manager for Transactions (ITCAM) data collector • provides for remote monitoring • 1. Start the remote transaction collector. – Note host name (or IP address) and port number of the transaction collector. © 2013 IBM Corporation26 collector. • 2. Start the IMS SOAP Gateway ITCAM TTAPI function iogmgmt -tranAgent -on –address server_address -port server_port remote transaction collector server host address and port number Note: Before you can use this command, you must activate SOAP Gateway-to-IMS tracking IDs for the server with the iogmgmt - tracking -on command.
  27. 27. End-to-end Transaction Tracking – Provider Scenario (correlation based on Tracking ID) IMS ES 2.2 SOAP Gateway IMS Connect O T M A IMS 13 IMS App Horizontal Tracking ID + (XML) request data message exits* Horizontal Tracking ID + message data Tracking ID Horizontal Tracking ID + (XML) response data + CSM Horizontal Tracking ID + Transaction Tracking API Request with optional tracking ID response Route / generate Tracking ID Soap Client © 2013 IBM Corporation27 event exit * message data IMS Log record SOAP Gateway Transaction log Transaction Tracking API Monitoring data* Horizontal and Vertical Tracking IDs ITCAM IMS Connect Extensions IMS Connect Extensions journal Problem Investigator Performance Analyzer IMS Performance Analyzer IMS Problem Investigator records events with Tracking ID Tracking ID Horizontal and Vertical Tracking IDs
  28. 28. SOAP Log – Input Message © 2013 IBM Corporation28
  29. 29. BPE Trace © 2013 IBM Corporation29
  30. 30. IMS Log Record © 2013 IBM Corporation30
  31. 31. IMS Log Record © 2013 IBM Corporation31
  32. 32. SOAP Log – Output Message © 2013 IBM Corporation32
  33. 33. Transaction Events Information © 2013 IBM Corporation33
  34. 34. JMX Monitoring • Java Management Extensions (JMX) instrumentation for SOAP Gateway – Standard JMX instrumentation for the SOAP Gateway JVM health-check information • includes heap memory and CPU utilization – SOAPGatewayProviderMonitorMBean • provides an interface to get statistics SOAP Gateway web service provider workload – Does not include callout or WebSphere Business Events statistics © 2013 IBM Corporation34 – Does not include callout or WebSphere Business Events statistics – enable monitoring functions with the SOAP Gateway management utility • iogmgmt – mbeans – port xxx • The xxxx value is the JMX listening port for MBean requests – Remote monitoring application • JConsole provides generic remote monitoring application • user-supplied JMX-compatible monitoring application • Benefit – Provides JMX monitoring functions
  35. 35. JMX MBean interface for web service provider monitoring • C:..IMS Enterprise Suite V2.2SOAP Gatewayjavabin – JConsole.exe IMS ES 2.2 SOAP Gateway © 2013 IBM Corporation35 Provider Monitor MBean Apache Tomcat MBeansJConsole JMX-compatible monitoring application JVM
  36. 36. JConsole sample output © 2013 IBM Corporation36
  37. 37. IMS ES 2.2 SOAP Gateway New Samples • IMS Exchange web site updated - Link: ibm.com/developerworks/mydeveloperworks/blogs/8a337b1c-3c0c-48a5-b7cc- 7f805884dbb9/tags/soap?lang=en © 2013 IBM Corporation37
  38. 38. Cobol Top Down • Target Market – IMS Customers who want to quickly get synchronous callout running with SOAP Gateway. – SOAP customers who want to have multi-operation support for synchronous callout. • Challenge Addressed – Remove the need for COBOL copybook to generate artifacts for synchronous callout. – Remove requirement to manually map between XSD data types and COBOL data types. • © 2013 IBM Corporation38 • Solution – Parts needed for synchronous callout can be generated from a single WSDL. – Multiple operations defined in WSDL are now supported within the callout correlators. • Business Value – Ease setup of synchronous callout for SOAP Gateway. – Reduce errors that may occur when manually creating COBOL copy book needed for callout. – Support multiple operations for callout.
  39. 39. Design © 2013 IBM Corporation39
  40. 40. Prerequisites • Software requirements – Enterprise Suite V2.2 SOAP Gateway – IMS V11 or IMS V12 with integrated IMS Connect SPE (PM69983, PM76333) • Tooling – IBM Rational® Developer for System z™ Version 8.5.1 or later – © 2013 IBM Corporation40 – Installation Manager V1.5.3 or later
  41. 41. Any Questions? © 2013 IBM Corporation41

×