DOCSLIB.ORG

CICS TS for Z/OS: Java Applications in CICS Chapter 1

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
CICS TS for Z/OS: Java Applications in CICS Chapter 1 CICS Transaction Server for z/OS 5.4 Java Applications in CICS IBM Note Before using this information and the product it supports, read the information in “Notices” on page 277. This edition applies to the IBM CICS® Transaction Server for z/OS® Version 5 Release 4 (product number 5655-Y04) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 1974, 2020. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this PDF.....................................................................................................vii Chapter 1. CICS and Java...................................................................................... 1 Java support in CICS....................................................................................................................................1 The OSGi Service Platform..................................................................................................................... 3 JVM server runtime environment...........................................................................................................4 JVM profiles............................................................................................................................................ 6 Structure of a JVM.................................................................................................................................. 7 CICS task and thread management....................................................................................................... 9 Shared class cache...............................................................................................................................11 Java applications that comply with OSGi..................................................................................................12 Java applications in a Liberty JVM server................................................................................................. 14 Java web services...................................................................................................................................... 16 Spring Boot support in CICS......................................................................................................................19 Chapter 2. Developing Java applications .............................................................21 What you need to know about CICS..........................................................................................................21 CICS transactions ................................................................................................................................ 21 CICS tasks.............................................................................................................................................22 CICS application programs.................................................................................................................. 22 CICS services........................................................................................................................................22 Java runtime environment in CICS ..................................................................................................... 24 Developing applications using the IBM CICS SDK for Java ..................................................................... 24 Setting up the Target Platform............................................................................................................. 25 Creating a plug-in project.....................................................................................................................26 Updating the plug-in project manifest file...........................................................................................27 Creating a Java EE application.............................................................................................................28 Adding a project to a CICS bundle project...........................................................................................29 Updating the project build path........................................................................................................... 30 Developing applications using Maven or Gradle.......................................................................................31 Manually importing Java libraries............................................................................................................. 38 Considerations for a shared JVM...............................................................................................................39 Java development using JCICS................................................................................................................. 39 The Java class library for CICS (JCICS)............................................................................................... 40 Data encoding.......................................................................................................................................43 JCICS API services and examples....................................................................................................... 44 Using JCICS.......................................................................................................................................... 66 Java restrictions .................................................................................................................................. 67 Guidance for using OSGi............................................................................................................................ 67 Developing Java applications to run in a Liberty JVM server .................................................................. 69 Setting up the development environment........................................................................................... 69 Java EE and Liberty applications......................................................................................................... 71 Migrating Java EE applications to run in Liberty JVM server ..............................................................81 Linking to a Java EE application from a CICS program....................................................................... 81 Java Transaction API (JTA) ................................................................................................................. 88 Java Persistence API (JPA).................................................................................................................. 89 Enterprise JavaBeans (EJB).................................................................................................................91 Java Message Service (JMS)................................................................................................................ 99 Java Management Extensions API (JMX) ......................................................................................... 100 Java Authorization Contract for Containers (JACC).......................................................................... 101 iii Java Authentication Service Provider Interface for Containers (JASPIC)........................................102 Java EE Connector Architecture (JCA).............................................................................................. 103 Developing microservices with MicroProfile..................................................................................... 115 Spring Boot applications....................................................................................................................119 Liberty web server plug-in................................................................................................................. 125 Liberty features........................................................................................................................................125 Accessing data from Java applications ..................................................................................................138 Interacting with structured data from Java............................................................................................ 139 Developing Java applications to use the JZOS Toolkit API in an OSGi JVM server............................... 140 Accessing IBM MQ from Java programs ................................................................................................ 142 Using IBM MQ classes for Java in an OSGi JVM server ....................................................................142 Using IBM MQ classes for JMS in a Liberty JVM server ................................................................... 143 Using IBM MQ classes for JMS in an OSGi JVM server .................................................................... 146 Connectivity from Java applications in CICS ......................................................................................... 148 JCA local ECI support..............................................................................................................................148 Packaging existing applications to run in a JVM server..........................................................................149 Converting an existing Java project to a plug-in project...................................................................149
Load more

Recommended publications
  • Red Hat Fuse 7.5 Apache Karaf Transaction Guide
    Red Hat Fuse 7.5 Apache Karaf Transaction Guide Writing transactional applications for the Apache Karaf container Last Updated: 2020-02-21 Red Hat Fuse 7.5 Apache Karaf Transaction Guide Writing transactional applications for the Apache Karaf container Legal Notice Copyright © 2020 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
    [Show full text]
  • Eclipse (Software) 1 Eclipse (Software)
    Eclipse (software) 1 Eclipse (software) Eclipse Screenshot of Eclipse 3.6 Developer(s) Free and open source software community Stable release 3.6.2 Helios / 25 February 2011 Preview release 3.7M6 / 10 March 2011 Development status Active Written in Java Operating system Cross-platform: Linux, Mac OS X, Solaris, Windows Platform Java SE, Standard Widget Toolkit Available in Multilingual Type Software development License Eclipse Public License Website [1] Eclipse is a multi-language software development environment comprising an integrated development environment (IDE) and an extensible plug-in system. It is written mostly in Java and can be used to develop applications in Java and, by means of various plug-ins, other programming languages including Ada, C, C++, COBOL, Perl, PHP, Python, Ruby (including Ruby on Rails framework), Scala, Clojure, and Scheme. The IDE is often called Eclipse ADT for Ada, Eclipse CDT for C/C++, Eclipse JDT for Java, and Eclipse PDT for PHP. The initial codebase originated from VisualAge.[2] In its default form it is meant for Java developers, consisting of the Java Development Tools (JDT). Users can extend its abilities by installing plug-ins written for the Eclipse software framework, such as development toolkits for other programming languages, and can write and contribute their own plug-in modules. Released under the terms of the Eclipse Public License, Eclipse is free and open source software. It was one of the first IDEs to run under GNU Classpath and it runs without issues under IcedTea. Eclipse (software) 2 Architecture Eclipse employs plug-ins in order to provide all of its functionality on top of (and including) the runtime system, in contrast to some other applications where functionality is typically hard coded.
    [Show full text]
  • Netbeans RCP by John Kostaras Open Conference Crete 2012 Agenda
    NetBeans RCP By John Kostaras Open Conference Crete 2012 Agenda ∗ Introduction ∗ Module System ∗ Lookups ∗ Window System ∗ Explorer Views ∗ Nodes ∗ Action System ∗ Dialogs and Wizards ∗ Options & Settings ∗ FileSystem & DataSystem ∗ Visual Library ∗ Internationalisation ∗ Help System ∗ Hands on 15/9/2012 NetBeans RCP - John Kostaras - JavaCrete 2012 2 Prerequisites ∗ NetBeans 7.2 ( http://www.netbeans.org ) ∗ Todo app (http://netbeans.org/community/magazine/code/nb- completeapp.zip ) 15/9/2012 NetBeans RCP - John Kostaras - JavaCrete 2012 3 Introduction NetBeans RCP -John Kostaras -JavaCrete 2012 4 15/9/2012 What is NetBeans Rich Client Platform? ∗ Set of APIs and Libraries ∗ Framework and Module system ∗ Generic Desktop Application ∗ Platform modules + IDE Modules = NetBeans IDE ∗ Platform modules + your modules = Your Application ∗ Provides services that almost all Desktop Applications need ∗ Saves development time ∗ Allows you to concentrate on the actual business logic ∗ NetBeans RCP Application server for the desktop ∗ Improves development and maintainability through modularization 15/9/2012 NetBeans RCP - John Kostaras - JavaCrete 2012 5 Benefits ∗ Shorter development time ∗ Consistent User Interface ∗ Updateable (Update center / Webstart) ∗ Platform Independence (Swing + platform specific launchers) ∗ Modularity 15/9/2012 NetBeans RCP - John Kostaras - JavaCrete 2012 6 Hands-on NetBeans RCP - John Kostaras - JavaCrete 2012 7 15/9/2012 TodoRCP ∗ A todo list application: "A complete App using NetBeans 5" by Fernando Lozano http://netbeans.org/download/magazine/01/nb01_completeap
    [Show full text]
  • Introduction Background Scope
    Copyright Oracle Corporation and VMware Inc, 2010 Enterprise Modules Project (Gemini) Proposal The Enterprise Modules Project is a proposed open source project under the Eclipse Runtime Project. This project is in the Project Proposal Phase (as defined in the Eclipse Development Process). Introduction The intent of the "Enterprise Modules" project, nicknamed Gemini, is to provide a home for subprojects that integrate existing Java enterprise technologies into module-based platforms, and/or that implement enterprise specifications on module-based platforms. Gemini will be a parent ("container project" as defined by the Eclipse Development Process) for several subprojects ("operating projects" as defined by the Eclipse Development Process) that provide the specific implementations/integrations. Gemini will itself be a subproject of the Eclipse Runtime Project and will strive to leverage functionality of existing projects. We encourage and request additional participation and input from any and all interested parties in the Eclipse community. Background Enterprise applications are often complex, involving multiple layers and many actors. Even though every application has a different purpose and usage, there are a number of features and behavioral requirements in the underlying infrastructure that are common among many of those seemingly dissimilar applications. For a long time, not only did developers need to create the vertical business logic of the application, but they also had to create the platform plumbing on which the application could run. Enterprise Java standards made great strides in defining specifications describing how these layers could be implemented, exported and used. They have since become the assumed and ubiquitous underpinnings of the majority of enterprise Java systems.
    [Show full text]
  • An Empirical Evaluation of Osgi Dependencies Best Practices in the Eclipse IDE Lina Ochoa, Thomas Degueule, Jurgen Vinju
    An Empirical Evaluation of OSGi Dependencies Best Practices in the Eclipse IDE Lina Ochoa, Thomas Degueule, Jurgen Vinju To cite this version: Lina Ochoa, Thomas Degueule, Jurgen Vinju. An Empirical Evaluation of OSGi Dependencies Best Practices in the Eclipse IDE. 15th International Conference on Mining Software Repositories, May 2018, Gothenburg, Sweden. 10.1145/3196398.3196416. hal-01740131 HAL Id: hal-01740131 https://hal.archives-ouvertes.fr/hal-01740131 Submitted on 27 Mar 2018 HAL is a multi-disciplinary open access L’archive ouverte pluridisciplinaire HAL, est archive for the deposit and dissemination of sci- destinée au dépôt et à la diffusion de documents entific research documents, whether they are pub- scientifiques de niveau recherche, publiés ou non, lished or not. The documents may come from émanant des établissements d’enseignement et de teaching and research institutions in France or recherche français ou étrangers, des laboratoires abroad, or from public or private research centers. publics ou privés. An Empirical Evaluation of OSGi Dependencies Best Practices in the Eclipse IDE Lina Ochoa Thomas Degueule Jurgen Vinju Centrum Wiskunde & Informatica Centrum Wiskunde & Informatica Centrum Wiskunde & Informatica Amsterdam, Netherlands Amsterdam, Netherlands Amsterdam, Netherlands [email protected] [email protected] Eindhoven University of Technology Eindhoven, Netherlands [email protected] ABSTRACT that can be implemented and tested independently. This also fos- OSGi is a module system and service framework that aims to fill ters reuse by allowing software components to be reused from one Java’s lack of support for modular development. Using OSGi, devel- system to the other, or even to be substituted by one another pro- opers divide software into multiple bundles that declare constrained vided that they satisfy the appropriate interface expected by a client.
    [Show full text]
  • 154 Core Jetty
    #154 CONTENTS INCLUDE: n Jetty Architecture n Configuring Jetty n Basic Usage Jetty n Advanced Usage n Using with Web Frameworks A Lightweight, Open-Source Web Server and Servlet Container n Running Standalone By Jos Dirksen n Integration with Maven and more... Visit refcardz.com SelectChannelConnector Uses NIO buffers with a non-blocking threading ABOUT JETTY model. Threads are only allocated to connec- tions with requests. Use when there are many connections that have idle periods. Jetty, an open-source web server hosted by the Eclipse foundation, is a full-fledged HTTP server and Servlet container that can be easily SslSocketConnector SSL version of the SocketConnector configured to serve static and dynamic content. You can very easily SslSelectChannelConnector SSL version of the SelectChannelConnector embed Jetty into your own applications using Java or XML-based AJPConnector Use for connections from Apache modules: configuration or run Jetty directly from Maven. Additionally, you can use mod_proxy_ajp and mod_jk. Jetty in many different high-demand areas such as Yahoo Hadoop Cluster, HTTPSPDYServerConnector Supports the SPDY protocol and performs SPDY Google AppEngine, and Yahoo! Zimbra. to HTTP conversion. If SPDY is not negotiated, This RefCard refers primarily to Jetty 8; however, most of the configuration falls back to HTTPS. Get More Refcardz! Refcardz! Get More discussed will work on Jetty 7. Handler JETTY ARCHITECTURE The handler is the component that deals with requests received by a connector. There are three types of handlers in Jetty. It’s important to understand the architecture behind Jetty. The main • Coordinating handlers route requests to other handlers. architecture of Jetty consists out of the following four components.
    [Show full text]
  • Scaling JPA Applications with Toplink Grid
    <Insert Picture Here> @ TopLink Grid: Scaling JPA Applications with Coherence Shaun Smith, Principal Product Manager Oracle Server Technologies, TopLink Copyright © 2010 Oracle Java Persistence: The Problem Space Customer <customer id=“…”> <name>…</name> id: int JAXB/SDO … name: String </contact-info> creditRating: int </customer> Java XML JPA CUST ID NAME C_RATING JPA: Java Persistence API Relational JAXB: Java Architecture for XML Binding SDO: Service Data Objects EclipseLink Project • Provides JPA, JAXB, SDO, DBWS, and EIS persistence services • Open source Eclipse project • Project Lead by Oracle • Founded by Oracle with the contribution of full TopLink source code and tests • Based upon product with 12+ years of commercial usage EclipseLink JPA • JPA 1.0 compliant with advanced persistence • JPA 2.0 Reference Implementation (JSR 317) • Supports Java EE, Java SE, Web, Spring, and OSGi • Supports all leading RDMS with platform specific features • Best JPA for the Oracle Database—supporting advanced features • Extensible and pluggable • Key infrastructure: • Caching, Locking, Query Framework, Mapping, … • … plus many valuable advanced features Oracle TopLink 11gR1 • Oracle’s Enterprise Java Persistence Framework • Includes open source EclipseLink with Commercial Support • Certified on WebLogic and redistributed by Oracle as part of TopLink product • TopLink Grid: JPA integration with Coherence • Included in WebLogic Server • Tooling Support in JDeveloper and Eclipse Example JPA Client Code … Mechanics of a JPA Application Step 1 Step 2 Step 3 Application Logic Application Logic Application Logic Create/ Modify Entities JPA JPA JPA Read Insert/ Entities Update Entities JPA with Cache TX n TX n+1 Application Logic Application Logic Cache hits JPA avoid object build cost ReadTX Commit Entities Scaling Java Persistence Java Scaling Application Application JPA Application Application Application Application Application JPA Application Application Application .
    [Show full text]
  • Visualizing Modules and Dependencies of Osgi-Based Applications
    Visualizing Modules and Dependencies of OSGi-based Applications Doreen Seider, Tobias Marquardt, Marlene Bruggemann,¨ and Andreas Schreiber German Aerospace Center (DLR), Simulation and Software Technology Linder Hoehe, 51147 Cologne, Germany fdoreen.seider,tobias.marquardt,[email protected] Abstract—The architecture of software it not tangible; but II. OSGI-BASED APPLICATIONS in different situations it is preferable to have it tangible. For example, while reviewing it against the intended design, intro- OSGi (Open Services Gateway Initiative) [4] is a spec- ducing the software to others, or starting to develop on a new ification that defines a dynamic module system for Java. part. Basic aspects of a software architecture are the modules Multiple implementations exist such as Apache Felix [5], the software is constructed of and the dependencies between Eclipse Equinox [6], or Knopflerfish [7]. them. To comprehend these aspects is important especially for A module is a unit of functionality. In Java, different types software using a technology such as OSGi, which key concept is modularization. of modules exist: In this paper, we describe interactive visualization tools that • Class: unit of state and behavior we developed to comprehend OSGi-based applications with their • Package: set of classes modules and dependencies. We focus on concepts to treat large number of modules and dependencies: navigation, filtering, and OSGi adds two additional types of modules: selection. We applied our solution for OSGi-based applications • Bundle: set of packages with hundreds of modules containing multiple submodules each. • Service: class instances that are shared between bundles With the resulting visualizations, we can explore the modular- ization of the software architecture.
    [Show full text]
  • Best Practices for Programming Eclipse and Osgi
    Best Practices for Programming Eclipse and OSGi BJ Hargrave IBM Lotus Jeff McAffer IBM Rational Software © 2006 by IBM; made available under the EPL v1.0 | March 24, 2006 Introduction During the Eclipse 3.0 and OSGi R4 development cycles, OSGi and Eclipse began to influence each others work Eclipse 3.0 adopted the OSGi framework as the “footing” of the Eclipse platform OSGi R4 incorporated features to support important Eclipse use cases This led to the OSGi R4 Framework specification of which Eclipse Equinox is an implementation The Equinox code is currently being used by OSGi as the framework reference implementation for R4 2 Eclipse/OSGi Best Practices | © 2006 by IBM; made available under the EPL v1.0 Overview As a result of the incorporation of the OSGi framework into Eclipse, there are several additional capabilities now available to Eclipse plug-in writers that should be considered Today we will look at two areas Modularity – Techniques for sharing classes and resources between bundles (aka. plug-in) Collaboration – Techniques for inter bundle collaboration (which build upon class sharing) 3 Eclipse/OSGi Best Practices | © 2006 by IBM; made available under the EPL v1.0 Modularity “(Desirable) property of a system, such that individual components can be examined, modified and maintained independently of the remainder of the system. Objective is that changes in one part of a system should not lead to unexpected behavior in other parts.” www.maths.bath.ac.uk/~jap/MATH0015/glossary.html We need to be able to share classes and resource between bundles (modules) while supporting a proper level of modularity Eclipse and OSGi offers two main ways of sharing Require-Bundle Import-Package 4 Eclipse/OSGi Best Practices | © 2006 by IBM; made available under the EPL v1.0 Require-Bundle Mechanism for a bundle to gain access to all the packages exported by another bundle – “bulk import” Advantages Can be used for non-code dependencies: e.g.
    [Show full text]
  • Android/Osgi-Based Vehicular Network Management System Teng-Wen Chang Department of Electrical Engineering, National Taiwan University, Taipei, Taiwan
    Android/OSGi-based Vehicular Network Management System Teng-Wen Chang Department of Electrical Engineering, National Taiwan University, Taipei, Taiwan Abstract- With the enormous market potential of the telematics connection modules, but also offers resources management. industry and the rapid development of information technology, The open/standard telematics platforms in the telematics automotive telematics has attracted considerable attention for middleware layer mainly standardize API’s and mobile computing and intelligent transport systems (ITSs). This graphic/vocal HMI (human-machine interface) so that both study integrates the Open Gateway Service Initiative Vehicle service providers and car manufacturers can quickly deliver Expert Group (OSGi/VEG) into an Android platform to generate a vehicular Android/OSGi platform that has the solutions to potential markets and simplify development. If advantages of both original platforms. These features include service providers want to remotely deploy telematics services remote management, rich class sharing, proprietary vehicular to an on-board terminal, or if road-side centers need to applications, security policies, easy management of application diagnose/configure vehicular devices or manage modules of programming interface (APIs), and an open environment. This telematics application, they should use remote management study also integrates a cloud computing mechanism into the services that rely on open/standard telematics platforms. Android/OSGi platform, allowing service providers to upload their telematics bundles onto storage clouds using a provisioning server. A management agent in the Android/OSGi platform can simultaneously update its application service modules using remote storage clouds and use visual intelligence to continually change the distinguishing features of applications based on context awareness without user intervention.
    [Show full text]
  • Eclipse Glassfish Server Administration Guide, Release 5.1 Table of Contents
    Eclipse GlassFish Server Administration Guide, Release 5.1 Table of Contents Eclipse GlassFish Server . 1 Preface. 2 GlassFish Server Documentation Set. 2 Related Documentation. 4 Typographic Conventions. 5 Symbol Conventions . 5 Default Paths and File Names . 6 1 Overview of GlassFish Server Administration . 8 Default Settings and Locations . 8 Configuration Tasks . 9 Administration Tools . 17 Instructions for Administering GlassFish Server . 27 Part I . 28 Runtime Administration . 29 2 General Administration . 30 Using the asadmin Utility . 30 Administering System Properties. 39 Using Configuration Modularity. 42 Administering Resources . 44 Listing Various System Elements . 45 Using REST Interfaces to Administer GlassFish Server. 50 3 Administering Domains . 97 About Administering Domains . 97 Creating, Logging In To, and Deleting a Domain . 99 Starting and Stopping a Domain . 107 Configuring a DAS or a GlassFish Server Instance for Automatic Restart . 110 Backing Up and Restoring a Domain. 116 Re-Creating the Domain Administration Server (DAS) . 119 Additional Domain Tasks . 121 4 Administering the Virtual Machine for the Java Platform . 125 Administering JVM Options. 125 Administering the Profiler. 129 5 Administering Thread Pools . 132 About Thread Pools . 132 Configuring Thread Pools . 132 6 Administering Web Applications . 136 Invoking a Servlet by Alternate Means. 136 Changing Log Output for a Servlet. 137 Defining Global Features for Web Applications . 138 Redirecting a URL . 139 Administering mod_jk . 139 Administering mod_proxy_ajp. 146 7 Administering the Logging Service. 151 About Logging. 151 Configuring the Logging Service . 158 Viewing Log Records . 174 Listing Loggers . 176 8 Administering the Monitoring Service. 177 About Monitoring. 177 Configuring Monitoring . 186 Viewing Common Monitoring Data . 189 Viewing Comprehensive Monitoring Data.
    [Show full text]
  • Oracle Glassfish Server 3.1 Application Development Guide • November 2010 Preface
    For Review Purposes Only Oracle® GlassFish Server 3.1 Application Development Guide Part No: 821–2418 November 2010 Copyright © 2010, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are “commercial computer software” or “commercial technical data” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms setforth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
    [Show full text]