© 2015 IBM Corporation

Upgrading to CICS TS V5.2

Session 6638

Steve Zemblowskizem@us.ibm.com

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

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

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

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

Software prerequisites…

• http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html

11

Software prerequisites…

• An example of a compatibility report

12

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

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

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-bitstorage

31-bitstorage

24-bitstorage

0

16EB

REGION

4GB

MEMLIMIT

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

Com

mon s

tora

geNon-CICS

userapplication

storage

LSR pools

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

Share

d m

em

ory

addre

ssin

g

Sto

rage <

2G

B

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 storage

SM control blocks

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

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

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

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

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

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

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

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

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

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

External Changes…

• Changed CEMT Commands

• Similar to SPI changes

43

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

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

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

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

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

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

External Changes…

• Monitoring

• Record size increases to 3260 bytes

• MCT default changed from RMI=NO to RMI=YES

57

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

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

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

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

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

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

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

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

IBM Knowledge Center

75

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

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!

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/mmathrowdownand 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 Throwdownis back for 2015!

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 ourtailored 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/cicsthen click ‘Services’

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

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.

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.

Thank YouYour 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.