getting started with cicsplex system manager

CICS Transaction Server – CICSPlex SM

© 2014 IBM CorporationThe Future Runs on System z 04/10/2023

Steve Fowlkes

[email protected]

CICSPlex® System Manager…getting started


2The Future Runs on System z 04/10/2023

Agenda

CICSPlex SM Workload Management can be used to provide a Single-System Image (SSI) and to dynamically manage the distribution of work across the CICSplex according to predetermined criteria.

– The role CICSPlex SM Plays in the Enterprise

– Setting up a Single-System Image



Plex1

Plex2

Managing your CICS environment

MVS1

CICSa

CICSc

CICSb

CICSd

MVS2

CICSe

CICSg

CICSf

CICSh

MVS3

CICSi

CICSk

CICSj

CICSl

MVS4

CICSm

CICSo

CICSn

CICSp

MVS5

CICSq

CICSs

CICSr

CICSt

MVS6

CICSu

CICSw

CICSv

CICSx



Web Services, etc.3270Network

CMASX (MP)

WUI

LPAR1 LPAR2

CMASX

WUI

TOR1 WSR1 TOR2 WSR2

AORn AORn

DB21 DB22

User Data

CF

CICSplex

WUIplex

AORn AORn



CICSPlex SM (CPSM) Architecture

Workstation

CPSM WUI

CICS Explorer

z/OS

CPSMWUI Server

CMAS CICS Region

CICS Region

CICS Region

CICS Region

z/OS

CMAS MP

CICS Region

CICS Region

CICS Region

CICS Region

CPSMWUI Server



Topology & Resources Basis for Single-System

Image (SSI)

CICS Systems automatically register at Initialization and Termination

Used to direct requests and/or changes to CICS Systems and their resources

Keeps track of all individual CICS Systems, groups of CICS Systems, and resources within the CICSplex’s

Used for routing transactions within the CICSPlex

System z / CICS TS

CPSM CMAS

Data Resp.

CICS1

CICS2

CICS3

CICSn

CSD

TRAN

PROG

FILE

Resources typically reside on CSD but can be on CMAS data repository via BAS



Five stages of CICSPlex SM implementation

Single-System Image (SSI)

– Allows effective manage all CICS systems

CICSPlex SM WorkLoad Management (WLM)

– Allows better management of applications

– Makes a high availability environment possible

CICSPlex SM Business Application Services (BAS)

– Allows ease of CICS resource management

CICS resource monitoring – Real-Time Analysis (RTA)

– Allows resources to be monitored

– Can “fix” CICS resources

High availability


Setting up CICSPlex SM – Single-System Image

You can simply create two new CICS regions

– then turn one into a CMAS

– the other into a Web User Interface (WUI)

See full instructions for details and additional steps:– CICS Transaction Server for z/OS Version 5 Release 1 Knowledge Center


http://www-01.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts.doc/topics/configuring_cpsm.html?lang=en



Setting up a CMAS (CICSPlex SM) address space Turn one of your regions into a CMAS

Create and initialize a CICSPlex SM data repository (EYUDREP)– See CICS.SDFHINST(EYUCMSDS) for sample JCL

Modify the CICS JCL to create a CMAS– See CICS.SDFHINST(EYUCMASP) for sample JCL– Change program name to EYU9XECS– Add CICS.SEYUAUTH to the STEPLIB– Add CICS.SEYULOAD to the DFHRPL– Add EYUDREP DD statement (from step 1)– Add EYUPARM DD statement

• See CICS.SDFHINST(EYUCMS0P) for sample EYUPARM parameters– Only need NAME of CMAS for now

Update the SIT (or SIT Overrides)– See CICS.SDFHINST(EYUCMSSP) for sample SIT override parameters– Note the following values

• CPSMCONN=CMAS• MAX=300• EDSALIMIT=100• SPOOL=YES• ICVR=20000



Create CICSPlex SM data repository (EYUDREP)

//DEFDREP EXEC PGM=IDCAMS

//SYSPRINT DD SYSOUT=*

//SYSIN DD *

DEFINE CLUSTER -

(NAME(CICS.CTS510.CMASLPR1.EYUDREP) -

RECORDS(500,3000) -

CISZ(8192) -

RECSZ(200,6550) -

KEYS(64,0) -

SHR(2) -

INDEXED -

SPEED -

REUSE)

/*



Initialize CICSPlex SM data repository (EYUDREP)

//DREPINIT EXEC PGM=EYU9XDUT,

// COND=(8,LT),

// PARM=('CMASNAME=CMASLPR1',

// 'DAYLIGHT=N',

// 'TIMEZONE=T',

// 'SYSID=LPR1',

// 'ZONEOFFSET=0')

//EYUXDPRM DD *

WUI=YES

WUIPLEX=WUIPLX1

WUINAME=WUILPR1

WUIAPPLID=WUIAPPL

WUISYSID=LPW1

/*

//STEPLIB DD DISP=SHR,DSN=CICS.V5R1.CPSM.SEYUAUTH

//EYUDREP DD DISP=OLD,DSN=CICS.CTS510.CMASLPR1.EYUDREP




Setting up a Web User Interface (WUI) ServerTurn one of your regions into a WUI

Create a Web User Interface server repository (EYUWREP)– See CICS.SDFHINST(EYUJWREP) for sample JCL

//DEFWREP EXEC PGM=IDCAMS


//SYSIN DD *

DEFINE CLUSTER ( -

NAME( CICS.CTS510.WUILPR1.EYUWREP ) -

STORCLAS( STANDARD ) -

RECORDS( 5000 5000 ) -

CONTROLINTERVALSIZE( 8192 ) -

SPANNED -

INDEXED -

SHAREOPTIONS( 2 )) -

DATA ( -

NAME( CICS.CTS510.WUILPR1.EYUWREP.DATA ) -

KEYS( 20 20 ) -

RECORDSIZE( 8192 32000 )) -

INDEX ( -

NAME( CICS.CTS510.WUILPR1.EYUWREP.INDEX )) -



Setting up a Web User Interface (WUI) ServerTurn one of your regions into a WUI

Modify the CICS JCL to create a WUI– See CICS.SDFHINST(EYUWUIP) for sample JCL– Add CICS.SEYUAUTH to the STEPLIB– Add CICS.SEYULOAD to the DFHRPL– Add EYUWREP DD statement (from step 1)– Add EYUPARM DD statement

• See CICS.SDFHINST(EYUWUI0P) for sample EYUPARM parameters– NAME(WUILPR1) – CICSPLEX(WUIPLX1)– CMASSYSID(LPR1)

– Add EYUWUI DD statement• See CICS.SDFHINST(EYUWUIIN) for sample EYUWUI parameters

– TCPIPHOSTNAME(LPAR1.COMPANY.COM) – TCPIPPORT(18000)– CMCIPORT(18001) – DEFAULTCMASCTXT(CMASLPR1) – DEFAULTCONTEXT(WUIPLX1) – DEFAULTSCOPE(WUILPR1)– AUTOIMPORTDSN(CICS.V5R1.CPSM.SEYUVIEW)– AUTOIMPORTMEM(EYUEA*)

Update the SIT (or SIT Overrides)– See CICS.SDFHINST(EYUWUISP) for sample WUI SIT parameters– Note the following values

• CPSMCONN=WUI• INITPARM=(EYU9VKEC='ENU',EYU9VWAN='ENU1')• TCPIP=YES



Setting up a Managed Application System (MAS)

Modify the CICS JCL for the existing CICS system that you want CICSPlex SM to manage

– Add CICS.SEYUAUTH to the STEPLIB

– Add CICS.SEYULOAD to the DFHRPL

– Add EYUPARM DD statement• See CICS.SDFHINST(EYULMS0P)

> for sample EYUPARM parameters for managed CICS system

– NAME(CICSAOR1)

– CICSPLEX(CICSPLX1)– CMASSYSID(LPR1)

Update SIT (or SIT Overrides)

– See CICS.SDFHINST(EYULMSSP)

– for sample CICS SIT overrides for managed CICS systems

– CPSMCONN=LMAS



Use CMCIPORT from EYUWUIIN



In the editor, change values as needed



Right-Click –> New to add CICS systems to CICSplex



User editor to change values as needed



Change values for additional regions


What about CICSPlex SM Security?

Ensure that the CPSMOBJ class is active and that generic profiles can be defined

– SETROPTS CLASSACT(CPSMOBJ)

– SETROPTS GENERIC(CPSMOBJ)

– SETROPTS GENCMD(CPSMOBJ)

Create a RACF profile to protect all of the views and action commands for all CICSPlex SM functions

– RDEF CPSMOBJ ** UACC(NONE) OWNER(admin_group) NOTIFY(admin_user)

Permit access to specific view groups as needed

– PERMIT ** CLASS(CPSMOBJ) ID(SYSPGRP) ACCESS(UPDATE)

– PERMIT TOPOLOGY.** CLASS(CPSMOBJ) ID(OPSGRP) ACCESS(UPDATE)

– PERMIT TOPOLOGY.** CLASS(CPSMOBJ) ID(HELPGRP) ACCESS(READ)

– PERMIT OPERATE.** CLASS(CPSMOBJ) ID(OPSGRP) ACCESS(UPDATE)

– PERMIT OPERATE.** CLASS(CPSMOBJ) ID(HELPGRP) ACCESS(READ)

– PERMIT OPERATE.** CLASS(CPSMOBJ) ID(APPLGRP) ACCESS(READ)

– PERMIT OPERATE.** CLASS(CPSMOBJ) ID(PERFGRP) ACCESS(READ)



developerWorks blog entry by Chris Hodgins

CICSplexed and Confused? Part 1: Understanding your CICSplex

“Related posts” section has links to Part 2 and Part 3


https://www.ibm.com/developerworks/community/blogs/ChrisHodgins/entry/cicsplexed_and_confused_part_1_understanding_your_cicsplex1?lang=en



ibm/developerworks/cicsdev

facebook.com/IBMCICS

twitter.com/IBM_CICS

youtube.com/cicsfluff

youtube.com/cicsexplorer

themasterterminal.com

twitter.com/IBM_System_z

CICS Explorer Forum ibm.com/developerworks/forums/forum.jspa?forumID=1475&start=0

CICS-L list Forumlistserv.uga.edu/archives/cics-l.html

Google us or check us out at:www.ibm

.com/cics

http://twitter.com/

http://www.facebook.com/IBMCICS?sk=wall

http://www.youtube.com/cicsfluff

http://www.youtube.com/cicsexplorer

https://www.ibm.com/developerworks/mydeveloperworks/blogs/cicsdev/?lang=en

http://twitter.com/

http://themasterterminal.com/

http://www.listserv.uga.edu/archives/cics-l.html

http://www.ibm.com/developerworks/forums/forum.jspa?forumID=1475&start=0



© IBM Corporation 2012. All Rights Reserved.

The workshops, sessions and materials have been prepared by IBM or the session speakers and reflect their own views. They are provided for informational purposes only, and are neither intended to, nor shall have the effect of being, legal or other guidance or advice to any participant. While efforts were made to verify the completeness and accuracy of the information contained in this presentation, it is provided AS IS 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, this presentation or any other materials. Nothing contained in this presentation is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software.

References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results. Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon many factors, including considerations such as the

amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve results similar to those stated here.

All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer.

The following are trademarks of the International Business Machines Corporation in the United States and/or other countries. For a complete list of IBM trademarks, see www.ibm.com/legal/copytrade.shtmlAIX, CICS, CICSPlex, DB2, DB2 Universal Database, i5/OS, IBM, the IBM logo, IMS, iSeries, Lotus, OMEGAMON, OS/390, Parallel Sysplex, pureXML, Rational, RCAF, Redbooks, Sametime, Smart SOA, System i, System i5, System z , Tivoli, WebSphere, and z/OS. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.Intel and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.UNIX is a registered trademark of The Open Group in the United States and other countries.Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

getting started with cicsplex system manager

Software