InterConnect 2015 Session 6638 The One-Day CICS Transaction Server Upgrade: Migration Considerations. After months of writing letters of justification you‘re finally OK to order CICS TS. The software has arrived and is ready to install. What next? Do you have to buy lunch for the z/OS Sys Progs to get them to install the latest release of z/OS? What do you need from the database administrators? Is this the time to “byte” the bullet and use CICSPlex Systems Manager? Are your CICS Exits and User Replaceable Modules still valid? What will it take to get them working with this release of CICS? What will you have to tell the Application Programmers? Is your shop relying on any function that has been removed from this release of CICS? Come to this technical session to get the answers to the above questions and more.
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
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
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
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
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.