Session 6638 - The One-Day CICS Transaction Server Upgrade: Migration Considerations
- 1. © 2015 IBM Corporation Upgrading to CICS TS V5.2 Session 6638 Steve Zemblowski zem@us.ibm.com
- 2. Session Agenda • Software prerequisites • General external changes • Resource definition • Application and systems programming interfaces • Global user exits • Monitoring and statistics • Upgrade Process • Stabilization of support and discontinued functions • Documentation • Summary 3
- 3. 5 CICS Developer Trial 5 • V5.2 Available in 2014 • No charge trial, fixed expiry date • Does not start SVC period • For non-production environments • Available through IBM ShopzSeries • PID 5655-Y30 http://www-03.ibm.com/software/products/en/cics-ts-devtrial Based on CICS TS V5.2 - (with restrictions) • Performance • Capacity • License
- 4. CICS Transaction Server V5.2 Elements • CICS Transaction Server V5.2 • CICS 0690 • Service Flow Runtime • CICSPlex SM V5.2 • REXX • Development System • Runtime Facility • REXX Common for z/OS • Available via download • CICS Explorer V5.2 • CICS Information Center V5.2 7
- 5. Software prerequisites • CICS TS V5.2 requires z/OS V1.13, or later • The product will not initialize with a lower level of operating system installed • IBM 64-bit SDK for z/OS, Java Technology Edition V7 SR1 or later or V7.1 • Required if using Java application programs, the CICS Web Services Assistant, the CICS XML Assistant or validation of web services/XML transforms • The IBM XML Toolkit V1.10 for z/OS is not required for installation • Required at runtime if WS-Security is used • If not present at runtime DFHPI0119 will be issued • IBM XML Toolkit and Java SDK NOT shipped with CICS 9
- 7. Software prerequisites… • An example of a compatibility report 12
- 8. Compiler Best Practices • Upgrade compilers when you upgrade System z hardware or Middleware • Minimize quality assurance effort • Maximize performance • Leverage compiler support for new middleware features • Improve debugging and programmability • Recompile “hot spots” to improve performance • Leverage new compiler features to modernize critical applications • “Rip and Replace is expensive and risky • Modernization promotes reuse and delivery of new solution at lower cost, lower risk and shorter delivery time • Use Rational development tools to improve programmer productivity • Rational Developer for z, Rational Developer for z UT, Rational Team Concert 13
- 9. Business Partner Software • The information contained on the Business Partner Offerings pages and any associated documentation was supplied by various third parties, and was not authored by IBM; it is provided by IBM for informational purposes only. To the fullest extent permitted under applicable law, the information contained on the Business Partner Offerings pages and any associated documentation is made available by IBM and (where relevant) by the named IBM Business Partner on "as is" basis, without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, the information on the Business Partner Offerings pages or in any other related documentation. Nothing contained on the Business Partner Offerings pages or in such documentation is intended to, or shall have the effect of, creating any warranty or representation from IBM (or any of IBM's Business Partners, suppliers or licensors), or altering the terms and conditions of the applicable license agreement governing the use of any IBM software. The IBM Business Partner statements on the Business Partner Offerings pages or in such documentation do not necessarily represent the positions, strategies or opinions of IBM; those statements are provided only to illustrate how various IBM Business Partners use or support various IBM software products. No guarantee of comparable results is offered, either by IBM or by any of its Business Partners, suppliers or licensors. • Current business partner support will be maintained at: • Business Partner Software 15
- 10. z/OS Storage • 64-bit storage • Above the 2 gigabyte bar • 31-bit storage • Above the line 16 megabyte line • Below the 2 gigabyte bar • 24-bit storage • Below the line 16 megabyte line 2GB 16MB 64-bit storage 31-bit storage 24-bit storage 0 16EB REGION 4GB MEMLIMIT
- 11. CICS TS V5.2 Usage of 24 and 31 Bit Storage 19 2GB (Extended) High Private Area REGION / JES / IEFUSI CICS kernel storage EDSALIM EUDSA ECDSA ESDSA ETDSA ERDSA DSALIM CDSA SDSA UDSA RDSA System region Commonstorage Non-CICS user application storage LSR pools
- 12. CICS TS V5.2 Usage of 64 Bit Storage 16EB MEMLIMIT / IEFUSI JVM server (x n) Msg tables GCDSA TSMAINLIMIT Temp storage TRTABSZ Internal trace table Sharedmemoryaddressing Storage<2GB TRTRANSZ Tran. dump trace table MN, LD, TS, CQ control blocks 64 bit application data cache GUDSA 64 bit application data cache GSDSA 64 bit application data cache Non CICS user application storageSM control blocks
- 13. External Changes… • MEMLIMIT • CICS TS V5.2 requires a minimum of 6GB • DFHSM0602 message is issued and CICS terminates – if MEMLIMIT is less than 6GB • Above bar storage usage – See the CICS TS V52 Performance Guide, chapter 7 • Virtual and real storage: performance and tuning 23
- 14. External Changes… • Installation procedure has changed! • You must install the activation module – Installs in • CICSTS52.hlq.SDFHLIC for CICS TS 52 • CICSTS52.hlq.SDFHDEV for Developer Trial • CICSTS52.hlq.SDFHVUE for Value Unit Edition • STEPLIB concatenation • Activation dataset must be in STEPLIB concatenation • Release levels • INQUIRE SYSTEM RELEASE returns 0690 • Utility programs suffixed with 690 – e.g. DFHPD690 • Do not place DFHRPL libraries or Dynamic library datasets in the extended address space (EAS) of an extended address volume (EAV) 25
- 15. External Changes… • New System Initialization parameters • NISTSP800131A={NOCHECK|CHECK} – Specifies whether the CICS region is to check for conformance to the NIST SP800-131A standard. • USSCONFIG={/var/cicsts/dfhconfig | directory} – Directory in which z/OS UNIX configuration files such as the SSL cipher suite specification file are stored • MAXOPENTCBS – Specifies the maximum number of open task control blocks • MAXXPTCBS – Specifies the maximum number of open X8 and X9 TCBs that can exist concurrently in the CICS region Take the defaults for MAXOPENTCBS and MAXXPTCBS. Make sure to remove these values from your SIT before upgrading to CICS TS 52 27
- 16. External Changes… • Changed System Initialization parameters • ENCRYPTION={STRONG|ALL|TLS12} – Specifies encryption levels – WEAK, MEDIUM, NORMAL, and TLS12FIPS are no longer supported • JVMPROFILEDIR={/usr/lpp/cicsts/cicsts52/JVMProfiles|direct ory} – JVMSERVERS defined in bundles do not use profiles from this directory • MXT={250|number} – Default changed to 250 from 500 29
- 17. External Changes… • Obsolete Resource Definitions • DNSGROUP – Group name for connection optimization • GRPCRITICAL – Specifies critical member of a DNSGROUP • Changed Resource Definitions or Attributes • DB2CONN resource definition: changed TCBLIMIT attribute – CICS will detect a mismatch between the threads definied and the TCB limit and issue a DFHDB2110 message • TSMODEL resource definition: changed EXPIRYINTMIN attribute – You may specify TS expiration times in minutes – Expiration processing is now supported for shared TS queues 31
- 18. External Changes… • New Resource Definition Groups • DFHFCRL – Manipulates files installed via the bundle process • Changed Resource Definition Groups • DFHPGAIP – Autoinstall programs are now defined with CONCURRENCY(THREADSAFE) • Macro Control Tables • Reassemble all tables against the CICS TS V5.2 libraries 33
- 19. External Changes… • Obsolete SPI commands • INQUIRE TCPIPSERVICE DNSSTATUS – DNSSTATUS was used to specify the Domain Name System (DNS) and Workload Manager (WLM) registration status of a service • SET TCPIPSERVICE DNSSTATUS and DNSGROUP – DNSGROUP was used to specify the group name with which CICS registered to Workload Manager for connection optimization 35
- 20. External Changes… • Changed SPI options • Inquiring on private resources for applications – LIBRARY and PROGRAM – INQUIRE from a public program returns information about the public resource • If the resource is not available as a public resource, a “not found” response is returned – INQUIRE when running under an application returns information about the private resource • If the application does not have a private resource, information is returned about a public resource • If the resource is not available as a private or public resource, a “not found” response is returned 37
- 21. External Changes… • Changed SPI options • CREATE TSMODEL – A new option EXPIRYINTMIN is added • EXTRACT STATISTICS – APPLICATION(data-value) – APPLMAJORVER(data-value) – APPLMINORVER(data-value) – APPLMICROVER(data-value) – PLATFORM(data-value) • INQUIRE ASSOCIATION – New attributes ACAPPLNAME, ACMAJORVER, ACMICROVER, ACMINORVER, ACOPERNAME, and ACPLATNAME return the current application context • INQUIRE BUNDLE and INQUIRE BUNDLEPART – AVAILSTATUS • INQUIRE JVMSERVER – PROFILEDIR option now displays the JVM profile directory for JVM servers that are packaged in CICS bundles • INQUIRE LIBRARY – New options are added to specify the application context for browsing private resources • INQUIRE PIPELINE – Now includes a MSGFORMAT parameter for determining the message format • INQUIRE PROGRAM – A new option RESIDENCY is added to the INQUIRE PROGRAM command 39
- 22. External Changes… • Changed SPI options • INQUIRE SYSTEM – MESSAGECASE, MVSSMFID and MVSSYSNAME are added to the command • INQUIRE WEBSERVICE – New states, DISABLING and DISABLED, for web services that are packaged in CICS bundles • SET BUNDLE – New option AVAILSTATUS gives/removes access to application entry points 41
- 23. External Changes… • Changed CEMT Commands • Similar to SPI changes 43
- 24. External Changes… • Changed CEMT Commands • INQUIRE JVMSERVER – A new option PROFILEDIR has been added • INQUIRE PROGRAM – New options APPLICATION, APPLMAJORVER, APPLMINORVER , APPLMICROVER, ENTRYPOINT and OPERATION are added • INQUIRE URIMAP – The USAGE option has a new value JVMSERVER • SET PROGRAM – A new option OPERATION has been added • SET STATISTICS – The default value for interval has decreased form 3hrs to 1hr • SET SYSTEM – The max value for MAXTASKS has increased to 2000 and the minimum to 10 45
- 25. External Changes… • New CICS Supplied Category 1 Transactions • CFCR – This transaction is used to disable files that are defined in CICS bundles • CJLR – This transaction is used to provide Liberty XA recovery 47
- 26. External Changes… • Global User Exits • It is HIGHLY recommended that ALL global user exits be analyzed to ensure that they are THREADSAFE and that their PROGRAM definitions changed to specify CONCURRENCY(THREADSAFE) • For XPI check information in CICS Infocenter 49
- 27. External Changes… • Global User Exits • XPI Changes – INQUIRE_APP_CONTEXT – Returns the current application context for the most recent application that has been set onto the task – INQUIRE_PROGRAM and START_BROWSE_PROGRAM – New options to inquire on private programs 51
- 28. External Changes… • Global User Exits • Resource management installation and discard exit: XRSINDI – UEPAPCTXT – For private resources for applications that are deployed on platforms, this parameter contains the address of a variable-length list, which corresponds to the list in UEPIDNAM, containing the application context information for the resource. The information is listed in the following order: – 1.The private resource name, padded with spaces to 8 characters – 2.The platform name, padded with spaces to 64 characters – 3.The application name, padded with spaces to 64 characters – 4.The major version number for the application, which is a fullword binary value – 5.The minor version number for the application, which is a fullword binary value – 6.The micro version number for the application, which is a fullword binary value – UEPAPPTK – Address of a variable-length list, containing an 8-character token representing the application instance to which this resource belongs. For public resources, this address is zero 53
- 29. External Changes… • User Replaceable Modules… • Changed User Replaceable Modules – DFHDSRP, distributed routing program – New DFHDYPDS fields for Application and Platform support – DFHPGADX, program autoinstall program – Supplied definitions now specify CONCURRENCY(THREADSAFE): – DFHPGADX, Assembler program – DFHPGAHX, C program – DFHPGALX, PL/I program – DFHPGAOX, COBOL program – EYU9WRAM / EYU9XLOP – New fields for Application and Platform support 55
- 30. External Changes… • Monitoring • Record size increases to 3260 bytes • MCT default changed from RMI=NO to RMI=YES 57
- 31. External Changes… • Statistics • Monitor Domain Statistics – Number of user transactions ended in interval – Number of system transactions ended in interval – Time last transaction attached – Time last transaction ended – MAXTASK at last transaction attached – Current user tasks at last transaction attached – Average user response time – Peak user response time – Time of peak user response timeLoader Global Statistics – New statistics on RO TCB program load requests and load time • Dispatcher Statistics – New fields to understand the TCB pool performance • Private Resource Statistics – Programs – Library 59
- 32. External Changes… • Application Programming Interface changes • ASSIGN – LINKLEVEL – ERRORMSG – Application Context • DELAY – Milliseconds option • FORMATTIME – STRINGZONE • LINK – May operate differently when using application entry points • INVOKE APPLICATION – New command for specific application invocation • VERIFY TOKEN – New command to get the USERID associated with a Kerberos token 61
- 33. Upgrade Process • Operating System Setup • CICS uses z/OS conversion services – Conversion facility must be enabled – Documented in “z/OS Support for Unicode Using Conversion Services” • SDFHLINK modules are downward compatible – e.g. SVC, DFHIRP – New DFHCSVCU utility to install CICS SVC without z/OS IPL – Considerations for DFHIRP • SEYULINK modules are not downward compatible • MEMLIMIT needs to be set equal to or greater than 6GB 63
- 34. Upgrade Process… • Installation Process • Default installation process – Common IBM install procedures – SMP/E RECEIVE, APPLY, ACCEPT commands – Described in the CICS Program Directory • DFHISTAR process – CICS generated installation job stream – Described in the CICS Installation Guide • Note addition of License Library – Must be installed before running IVPs 65
- 35. Upgrade Process… • CICS Local and Global Catalog • Define new Local and Global catalogs • Initialize the catalogs using CICS TS V5.2 utilities • Perform a START=INITIAL • CICS will fail startup if back level GCD or LCD is used – DFHRM0100 applid GLOBAL CATALOG DATA SET IS NOT INITIALIZED FOR THIS RELEASE OF CICS – DFHCC0107 applid LOCAL CATALOG DATA SET IS NOT INITIALIZED FOR THIS RELEASE OF CICS 67
- 36. Upgrade Process… • CICS System Definition (CSD) • Define New CSD • REPRO existing CSD to new dataset • Run DFHCSDUP UPGRADE – Use DFHCSDUP SCAN command to check for user changes • Sharing the CSD – CICS TS V5.2 CSD can be shared with prior releases – DFHCOMPG (51) – DFHCOMPF (42) – DFHCOMPE (41) – DFHCOMPD (32) – DFHCOMPC (31) 69
- 37. Upgrade Process… • CICSPlex Systems Manager • CICSPlex upgrade similar to previous releases – Maintenance point CMAS must be upgraded first • CMAS and MAS agent code must all be at V5.2 level • WUI Server and its connected CMAS must be at V5.2 level 71
- 38. Stabilization of Support • CICSPlex SM Web User Interface (WUI) • The CICSPlex SM Web User Interface (WUI) for CICS TS is stabilized. Minor additions to existing views will continue. The CICSPlex SM WUI will not be withdrawn during the lifetime of CICS TS V5. • The CICSPlex SM address space (CMAS) and WUI server components continue to provide strategic support for the CICS Explorer V5.1 and form the basis of the modern CICS user experience. CICSPlex upgrade is similar to previous releases • CICS DISTRIBUTED DATA MANAGEMENT (DDM): • From the release of CICS TS V2.1, in March 2001, CICS Distributed Data Management (DDM) provides Parallel Sysplex support for VSAM data sharing, Sysplex-wide logging and journal management, and CICS temporary storage data sharing for CICS TS. CICS DDM is no longer available from IBM and support was discontinued, as of December 31, 2003. CICS DDM is no longer available in CICS TS from Version 5.2 onwards. • CICS TS APPLICATIONHANDLER JAVA INTERFACE • The CICS TS ApplicationHandler Java interface, which can be used to write SOAP web services provider pipeline application handlers in an Axis2 JVM server, is deprecated. Clients who want to write SOAP web services for CICS TS in Java, or to customize pipeline processing in Java, are encouraged to use Java API for XML Web Services (JAX-WS) facilities in the Liberty JVM server web container, built on WebSphere Application Server 1 Liberty profile technology. 73
- 40. CICS Interdependency Analyzer / Deployment Assistant • Interdependency Analyzer Upgrade Analysis • Can help identify changes related to CICS upgrades • Query results can help target testing • Deployment Assistant • Supplied Cheat Sheet – Steps to Upgrade 76
- 41. What’s next… More of my sessions #2809 Five compelling reasons for creating a CICS Cloud #2844 There’s a new Sheriff in Town – CICS Policy Based Management #6638 Upgrading to CICS 52 More Cloud sessions #4156 Twist and Cloud - How customers make CICS dance #3034 Build a WebSphere Linux Cloud on System z: from roll your own to pre-integrated #3239 Using cloud techniques and technologies to make your mainframe more efficient Collect a z Passport sticker here, and at… @IBM_CICS slideshare.net/IBM_CICSfacebook.com/IBMCICS ibm.com/cics WIN!
- 42. Get a lightning start: Key InterConnect 2015 sessions #2829 Mon 2:00-3:00 Liberté, Égalité, Fraternité—Viva the CICS and WebSphere Mini Revolution #1670 Tue 3:30-4:30 IBM WebSphere Liberty z/OS Connect: A Technical Introduction #4032 Wed 9:30-10:30 Meet the Winners of IBM’s Mainframe Mobile App Throwdown 2014 #6482 Thu 11:00-11:50 What is the Mainframe Mobile App Throwdown and How Do I Register? Register now at ibm.biz/mmathrowdown and submit your app by April 12th Mobilize your mainframe in our fun app-building contest for z Systems clients & business partners! The Mainframe Mobile App Throwdown is back for 2015!
- 43. Need expert help? 79 CICS Development Services, for worldwide services assistance Bringing CICS development expertise directly to your doorstep Email us CICSDTS@UK.IBM.COM Get a deep dive into your systems with a CICS health check Want to know more about CICS and Java? We offer tailored Java education Move forward with mobile with our customized mobile workshop Soar into the cloud with our tailored cloud workshop Need to optimize your systems? Then ask about a performance optimization engagement Get the low down on performance with a CICS performance workshops Need to modernise your workload in CICS? Ask about a integration and connectivity engagement Need some help upgrading to the latest release? Then ask about our upgrade workshop Need to reduce cost by optimizing your systems? Then a performance optimization engagement may be for you Need something different? Then we can build a customized workshop, just for you! Availability a concern? Then try our High Availability workshop Visit ibm.com/cics then click ‘Services’
- 44. Summary • Installation • Similar to previous releases • New License Modules • Standard IBM procedure or DFHISTAR • Upgrading • Application Programmers – Review Changes based on Applications and Platforms • Systems Programmers – “Normal” release process – Review all GLUES, TRUES, URMs and Resource definitions 80
- 45. Notices and Disclaimers Copyright © 2015 by International Business Machines Corporation (IBM). No part of this document may be reproduced or transmitted in any form without written permission from IBM. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM. Information in these presentations (including information relating to products that have not yet been announced by IBM) has been reviewed for accuracy as of the date of initial publication and could include unintentional technical or typographical errors. IBM shall have no responsibility to update this information. THIS DOCUMENT IS DISTRIBUTED "AS IS" WITHOUT ANY WARRANTY, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL IBM BE LIABLE FOR ANY DAMAGE ARISING FROM THE USE OF THIS INFORMATION, INCLUDING BUT NOT LIMITED TO, LOSS OF DATA, BUSINESS INTERRUPTION, LOSS OF PROFIT OR LOSS OF OPPORTUNITY. IBM products and services are warranted according to the terms and conditions of the agreements under which they are provided. Any statements regarding IBM's future direction, intent or product plans are subject to change or withdrawal without notice. Performance data contained herein was generally obtained in a controlled, isolated environments. Customer examples are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual performance, cost, savings or other results in other operating environments may vary. References in this document to IBM products, programs, or services does not imply that IBM intends to make such products, programs or services available in all countries in which IBM operates or does business. Workshops, sessions and associated materials may have been prepared by independent session speakers, and do not necessarily reflect the views of IBM. All materials and discussions are provided for informational purposes only, and are neither intended to, nor shall constitute legal or other guidance or advice to any individual participant or their specific situation. It is the customer’s responsibility to insure its own compliance with legal requirements and to obtain advice of competent legal counsel as to the identification and interpretation of any relevant laws and regulatory requirements that may affect the customer’s business and any actions the customer may need to take to comply with such laws. IBM does not provide legal advice or represent or warrant that its services or products will ensure that the customer is in compliance with any law.
- 46. Notices and Disclaimers (con’t) Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products in connection with this publication and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. IBM does not warrant the quality of any third-party products, or the ability of any such third-party products to interoperate with IBM’s products. IBM EXPRESSLY DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. The provision of the information contained herein is not intended to, and does not, grant any right or license under any IBM patents, copyrights, trademarks or other intellectual property right. • IBM, the IBM logo, ibm.com, Bluemix, Blueworks Live, CICS, Clearcase, DOORS®, Enterprise Document Management System™, Global Business Services ®, Global Technology Services ®, Information on Demand, ILOG, Maximo®, MQIntegrator®, MQSeries®, Netcool®, OMEGAMON, OpenPower, PureAnalytics™, PureApplication®, pureCluster™, PureCoverage®, PureData®, PureExperience®, PureFlex®, pureQuery®, pureScale®, PureSystems®, QRadar®, Rational®, Rhapsody®, SoDA, SPSS, StoredIQ, Tivoli®, Trusteer®, urban{code}®, Watson, WebSphere®, Worklight®, X-Force® and System z® Z/OS, are trademarks of International Business Machines Corporation, registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at: www.ibm.com/legal/copytrade.shtml.
- 47. Thank You Your Feedback is Important! Session 6638 Access the InterConnect 2015 Conference CONNECT Attendee Portal to complete your session surveys from your smartphone, laptop or conference kiosk.