IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

by Jouko Jantti, Jordi Guillaumes i Pons, Gen Sasaki, Egide Van Aerschot, Andres Wolf Andreoni
Released February 2006
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

IBM Information Management System (IMS) is the IBM premier transaction and hierarchical database management system.

Connectivity has always been a priority with IMS. IMS exploits the latest technologies to address customers' requirements for accessing IMS transactions and data. This IBM Redbooks publication is about IMS connectivity.

This book provides a general overview of the IMS Open Transaction Manager Access (OTMA) function and extensive information about IMS Connect and its usage, including a chapter that describes the IMS Connect Extensions product and how you can enhance the IMS Connect operating environment with it.

This book provides a broad understanding of IMS Connector for Java. We cover some special considerations, such as using the conversational transactions, rerouting, and timeout support, as well as programming roll-your-own clients without using IMS Connector for Java.

We also introduce Open Database Access and provide examples of using it with stored procedures and with IMS Remote Database Services. As for future directions, we also include a chapter about the IMS SOAP Gateway. This book updates and adds to the information in the previous book "IMS e-business Connectors: A Guide to IMS Connectivity," SG24-6514.

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. Chapter 1: IMS connectivity in an on demand environment
    1. Addressing the components of the on demand strategy
    2. IMS in the On Demand Operating Environment
    3. Solutions for IMS connectivity
    4. The organization of this book
  4. Chapter 2: Open Transaction Manager Access
    1. OTMA client
    2. OTMA message structure
    3. Commit processing message flows
      1. Commit-then-send (commit mode 0) flow
      2. Send-then-commit message (commit mode 1) flows
      3. IMS commit mode 1 message processing
    4. Implementing OTMA
    5. OTMA security issues
    6. Super member support for IMS Connect
      1. Super member feature availability
      2. Defining the super member feature
      3. Using the super member feature
    7. OTMA callable interface
      1. OTMA C/I initialization
      2. OTMA C/I security
      3. OTMA C/I restrictions
      4. Compiling and binding requirements for OTMA C/I
      5. Call functions implemented by OTMA C/I
    8. DSNAIMS stored procedure for OTMA C/I access
    9. WebSphere MQ as an OTMA client
  5. Chapter 3: IMS Connect overview
    1. Introduction to IMS Connect
    2. IMS Connect architecture
    3. A brief history and evolution of IMS Connect
      1. ITOC: The predecessor to IMS Connect
      2. IMS Connect Version 1.1
      3. IMS Connect Version 1.2
      4. IMS Connect Version 2.1
      5. IMS Version 9 integrated IMS Connect - IMS Connect Version 2.2
    4. IMS Connect clients
    5. IMS Control Center
  6. Chapter 4: Configuring IMS Connect
    1. Introduction
    2. Installing IMS Connect
    3. Configuring IMS Connect
      1. IMS Connect start procedure
      2. Authorizing IMS Connect and BPE to the APF
      3. Updating the program properties table
      4. Creating the IMS Connect configuration member (1/2)
      5. Creating the IMS Connect configuration member (2/2)
      6. Defining IMS Connect security
      7. Installing the default user exits into IMS Connect resource library
    4. IMS Control Center support
      1. IMS Connect configuration for IMS Control Center support
      2. IMS Control Center configuration
    5. Confirming IMS Connect install with the sample Java client (1/2)
    6. Confirming IMS Connect install with the sample Java client (2/2)
  7. Chapter 5: IMS Connect operations
    1. IMS Connect REPLY commands
      1. CLOSEHWS
      2. OPENDS or STARTDS
      3. OPENIP or STARTIP
      4. OPENPORT or STARTP
      5. RECORDER
      6. SETRACF
      7. SETRRS
      8. STOPCLNT
      9. STOPDS
      10. STOPIP
      11. STOPPORT
      12. VIEWDS
      13. VIEWHWS
      14. VIEWIP
      15. VIEWPORT
      16. VIEWUOR
    2. IMS Connect MODIFY commands
    3. IMS Connect BPE commands
    4. IMS command support for IMS Connect and OTMA
      1. /DISPLAY OTMA
      2. /DISPLAY TMEMBER tmember_name TPIPE tpipe_ID
  8. Chapter 6: Accessing IMS Connect
    1. IMS Connect in Parallel Sysplex environment
    2. Load Balancer
    3. Virtual IP address (VIPA)
    4. Static VIPA
    5. Dynamic VIPA takeover
    6. Dynamic VIPA takeback
    7. Application-specific dynamic VIPA
    8. Sysplex Distributor
    9. IMS Connect load balancing and failover
    10. Retrieving output messages
    11. The whole picture
  9. Chapter 7: IMS Connect programming model
    1. IMS Connect message structures
      1. IMS Request Message (IRM)
      2. Request Status Message (RSM)
      3. Complete Status Message (CSM)
      4. Request Mod Message (RMM)
    2. IMS Connect sample message flows
      1. Non-conversational transaction, CM=0, sync level=confirm
      2. Non-conversational transaction, CM=1, sync level=none
      3. Non-conversational transaction, CM=1, sync level=confirm
      4. Conversational transaction, CM=1, sync level=confirm
      5. Send-only transaction, CM=0, sync level=confirm
      6. The CANCEL TIMER request
    3. Socket connections and settings
      1. Persistent sockets
      2. Transaction sockets
      3. Non-persistent sockets
    4. Asynchronous output support
      1. What is asynchronous output?
      2. Implementing asynchronous output support
      3. SINGLE message control
      4. SINGLE WAIT message control
      5. NOAUTO message control
      6. AUTO message control
      7. Purge not deliverable
      8. Reroute request
  10. Chapter 8: IMS Connect security
    1. General security overview
    2. IMS Connect security
      1. Connecting IMS Connect to OTMA
      2. User verification
      3. User exit security
      4. Local option security
    3. OTMA security
  11. Chapter 9: IMS Connect user exit support
    1. IMS Connect components and user exits
    2. IMS Connect communication with user exits
    3. User exits supported
      1. IMS Connect TCP/IP user message exit (HWSIMSO0 and HWSIMSO1)
      2. Sample user message exit (HWSSMPL0 and HWSSMPL1)
      3. Difference between HWSIMSO0/SMPL0 and HWSIMSO1/SMPL1
      4. IMS Connector for Java user message exit (HWSJAVA0)
      5. IMS Connect IMSplex message exits (HWSCSLO0 and HWSCSLO1)
      6. Security exit (IMSLSECX)
      7. User initialization exit routine (HWSUINIT)
      8. Event recording user exit (HWSTECL0)
    4. Message structures between IMS Connect and user exits
      1. Input message from client and passed to exit
      2. Input message returned from message exit
      3. Output message from IMS Connect to IMS Connector for Java client
      4. Output message: IMS Connect to non-IMS Connector for Java client
    5. IMS Connect DRU exit for asynchronous output support
      1. ALTPCB ISRT message routing flow using OTMA exits
      2. How IMS Connect communicates with the DRU exit
      3. HWSYDRU0 sample DRU exit
      4. Debugging the IMS OTMA exits
  12. Chapter 10: IMS Connect diagnostics
    1. IMS Connect recorder trace
      1. Enabling IMS Connect recorder trace
      2. Starting and stopping the IMS Connect recorder trace
      3. Printing out the recorder trace
      4. Interpreting the recorder trace printout
      5. Example of recorder trace output
    2. IMS Connect traces
      1. BPE configuration
      2. Formatting incore trace tables
    3. IMS Connect Dump Formatter
      1. IMS Connect Dump Formatter activation
      2. Accessing the IMS Connect Dump Formatter
      3. Using the IMS Connect Dump Formatter
  13. Chapter 11: IMS Connect Extensions
    1. Introduction to IMS Connect Extensions
    2. Event collection and reporting
      1. Activate event collection
      2. Journal management
      3. IMS Connect event records
      4. Event Collection print utility
      5. Recorder trace utility
      6. Active session utility
      7. IMS Performance Analyzer IMS Connect reports (1/2)
      8. IMS Performance Analyzer IMS Connect reports (2/2)
      9. IMS Problem Investigator
    3. Workload management
      1. Transaction routing
      2. Workload balancing
      3. Transaction pacing
    4. Status Monitor
      1. System view
      2. Port view
      3. Form definition
    5. Security
    6. User exits management
      1. User exits definition
      2. User exits commands
    7. IMS Connect problem determination
      1. NODELAYACK issues
      2. Incorrect message length
      3. Client fails to ACK message
      4. Timeout issues
      5. Duplicate clients
    8. Highlights of IMS Connect Extensions Version 1 Release 2
      1. Status Monitor: Active sessions
      2. Programming interface for user applications
      3. Primary datastore routing
      4. Journal and journal print enhancements
      5. Client services exit
      6. Enhanced tracing
  14. Chapter 12: IMS Connector for Java
    1. J2EE Connector architecture (JCA)
      1. System contracts
      2. Common Client Interface
      3. Resource adapter module
    2. JCA infrastructure and API
      1. Connection management
      2. Transaction management
      3. Other JCA v1.5 items
      4. Interaction with EIS
      5. Security
      6. Summary
    3. Building applications that use IMS Connector for Java
      1. Introduction
      2. Connection properties
      3. Interaction properties
      4. Use considerations (1/2)
      5. Use considerations (2/2)
      6. Summary
  15. Chapter 13: IMS Connector for Java rerouting and timeout support
    1. Asynchronous message processing
    2. Messages inserted to ALTPCB
    3. Multiple and timed out IOPCB responses
      1. Discarding the non-delivered messages
      2. Rerouting the non-delivered messages
  16. Chapter 14: Building roll your own clients
    1. Basic structure of a simple IMS Connect client program
    2. IMS Connect message structures
      1. The IMS Connect input message
      2. The IMS Connect output message
    3. IMS Connect Unicode support
      1. Transaction code translation
      2. Output message including Unicode data from IMS Connect
      3. Message structures for Unicode support
    4. Complete pseudocode samples
      1. Commit mode 1 send-receive programming
      2. Commit mode 0 send-receive programming
      3. Commit mode 0 RESUME TPIPE programming
    5. Detailed code examples
      1. C example (1/2)
      2. C example (2/2)
      3. Java example (1/2)
      4. Java example (2/2)
  17. Chapter 15: IMS Connect client diagnostics
    1. No response from IMS or IMS Connect
      1. Hanging clients
      2. TCP/IP socket timeouts
      3. IMS Connect execution timeouts
    2. Error messages from IMS
    3. Wrong status codes from IMS Connect
      1. Duplicate clientID (reason code 56)
      2. OTMA protocol error (reason code 36)
      3. Other errors
    4. Exceptions in IMS Connector for Java applications
      1. Naming (JNDI)-related errors
      2. Connection pool-related errors (1/2)
      3. Connection pool-related errors (2/2)
    5. Diagnosing problems related to sockets
      1. IMS Connect and IMS Connector for Java parameters for sockets
      2. z/OS UNIX System Services parameters for sockets
  18. Chapter 16: IMS MFS Web Services
    1. IMS MFS Web Services introduction
    2. IMS MFS Web Services development process overview
    3. IMS MFS Web Services supported features
      1. Supported device types
      2. Supported MFS statements
    4. IMS MFS Web Services limitations
    5. Adding operations, messages, and bindings
    6. Creating an enterprise service
    7. Deploying an MFS-based IMS enterprise service
  19. Chapter 17: IMS MFS Web Enablement
    1. How does IMS MFS Web Enablement work?
    2. IMS MFS XML Utility
      1. Overview of the MFS XML Utility
      2. User modes
      3. Invoking the MFS XML Utility
    3. IMS MFS Web Enablement runtime support
      1. MFS Web Enablement features and functions
      2. MFS Servlet
      3. MFS Adapter
    4. Installing the instance servlet WAR file
    5. Accessing the deployed instance servlet
    6. Sample MFS style sheets
    7. Instructions to Web-enable IMS Phonebook application
      1. Step 1: Parsing the MFS source file with MFS XML Utility
      2. Step 2: Generating an instance servlet
      3. Step 3: Generating a WAR file
      4. Step 4: Configuring WebSphere Application Server
      5. Step 5: Deploying the application WAR file
      6. Step 6: Invoking the instance servlet
      7. Step 7: Invoking the Phonebook application
      8. Step 8: Logging out
  20. Chapter 18: IMS SOAP Gateway
    1. IMS SOAP Gateway introduction
    2. Making your IMS application a Web service
      1. Creating a WSDL file for your IMS application
      2. Deploying WSDL and configuring properties with IMS SOAP Gateway
      3. Writing the client application
  21. Chapter 19: Open Database Access
    1. Accessing IMS databases through the ODBA
    2. The database resource adapter (DRA)
    3. Setting up the DRA and the ODBA interface
      1. Creating the ODBA DRA startup table
      2. Loading and running ODBA in the z/OS application region
      3. Linking application programs
      4. Establishing and defining security
    4. Writing ODBA application programs
      1. General application program flow
      2. Making calls to IMS
      3. The application interface block (AIB)
      4. DL/I calls in the ODBA application
      5. Server program structure and the unit of recovery
    5. Considerations for using ODBA
      1. Restrictions
      2. Multiple access to IMS subsystems
      3. IMS Fast Path resource usage
      4. The commit scope change and IMS resource occupancy
      5. RRS logging performance
    6. Problem determination
      1. Finding the problem
      2. IMS initialization errors
      3. Running errors
      4. The application interface block
    7. IBM-supplied ODBA infrastructures
      1. DB2 stored procedure
      2. WebSphere Application Server for z/OS and IMS Remote Data Access
      3. WebSphere Information Integrator Classic Federation for z/OS
    8. Summary of IBM-supplied ODBA infrastructures
  22. Chapter 20: ODBA from DB2 stored procedures
    1. A short introduction to DB2 stored procedures
    2. DB2 stored procedures’ use of ODBA
    3. Sample ODBA using DB2 stored procedures
      1. Provided sample jobs
      2. Provided sample source codes
    4. Step-by-step instructions for using the sample
      1. Step 1: Creating an IMS DRA startup table
      2. Step 2: Setting up the DB2 stored procedure address space for ODBA
      3. Step 3: Creating the WLM application environment
      4. Step 4: Building the stored procedure by DSNTEJ61
      5. Step 5: Defining the IMS environment
      6. Step 6: Running the stored procedure by DSNTEJ62
      7. Step 7: Analyzing the output
    5. Commands for ODBA DB2 stored procedure environment
      1. IMS commands
      2. DB2 commands
      3. z/OS Workload Manager commands
      4. RRS panel utility
    6. Sample Java client application for ODBA stored procedure
  23. Chapter 21: IMS Remote Database Services
    1. The big picture of the IMS Java environment
      1. IMS dependent regions
      2. IBM products on the z/OS environment
    2. IMS JDBC interface
      1. The layered set of IMS Java class libraries
      2. The basic concepts of relational access to hierarchical databases
      3. Comparison of DL/I access and IMS JDBC SQL access
      4. Supported SQL keywords
      5. IMS Java SQL usage (1/2)
      6. IMS Java SQL usage (2/2)
    3. DLIModel utility
      1. Example of using the DLIModel utility
      2. DLIModel utility plug-in
      3. Example of using the DLIModel utility plug-in
    4. Remote Database Services
      1. Remote Database Services components
      2. Client/server interaction
      3. Security
    5. Sample IMS RDS access
      1. Step 1: Creating the IMS DRA startup table
      2. Step 2: Setting up WebSphere Application Server for z/OS subsystem
      3. Step 3: Installing the metadata class for the sample application
      4. Step 4: Setting up application server for distributed platforms environment
      5. Step 5: Developing the sample application (1/2)
      6. Step 5: Developing the sample application (2/2)
      7. Step 6: Defining the IMS environment
      8. Step 7: Running a Web application
      9. Problem determination for Remote Database Services
      10. Summary of the IMS RDS implementation
  24. Appendix A: Sample code: Non-IMS Connector for Java client code
    1. C sample source code (1/3)
    2. C sample source code (2/3)
    3. C sample source code (3/3)
    4. Java sample source code (1/3)
    5. Java sample source code (2/3)
    6. Java sample source code (3/3)
  25. Appendix B: IMS RDS application example
    1. ImsRdsSampleGlobal.java
    2. ImsJavaRdsSample.java
    3. GlobalInput.html
    4. LocalInput.html
    5. Output.jsp
  26. Appendix C: Additional material
    1. Locating the Web material
    2. Using the Web material
  27. Abbreviations and acronyms
  28. Related publications
    1. IBM Redbooks
    2. Other publications
    3. Online resources
    4. How to get IBM Redbooks
    5. Help from IBM
  29. Index (1/3)
  30. Index (2/3)
  31. Index (3/3)
  32. Back cover

Product information

  • Title: IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity
  • Author(s): Jouko Jantti, Jordi Guillaumes i Pons, Gen Sasaki, Egide Van Aerschot, Andres Wolf Andreoni
  • Release date: February 2006
  • Publisher(s): IBM Redbooks
  • ISBN: None