migration to cics ts for vse/esa

Migration to CICS TS for VSE/ESA

Copyright © 2007 illustro Systems International, LLC. All rights reserved.

IBM System z Expo September 1721, 2007 San Antonio, TX

2007 IBM System z Expo

E19

Migration to CICS TS for VSE/ESA, Is it time to do it?

John Lawson

Copyright © 2007 illustro Systems International, LLC

IBM 2007 System z Expo San Antonio, Tx.


Presented by: John Lawson

illustro Systems 1950 Stemmons Frwy. Suite 2016 Dallas, Texas 75207 Phone: 2148008900 http://www.illustro.com

IBM20073 Copyright © 2007 illustro Systems International, LLC

Trademarks

The following are trademarks of International Business Machines Corporation

IBM CICS VSE/ESA CICS/VSE z/VSE VTAM ESA/390 S/390

All other trademarks are trademarks of their respective companies.




Topics

n History n Planning n Implementation n Resource Definition n Security n Application Program Considerations


Topics…

n Customization n Statistics and Monitoring n Problem Determination n Additional information n Summary


n CICS/VSE Version 2 q Announced 9/05/1990 q Last release CICS/VSE 2.3 n Announced in 1994 n Last release to support older CICS functions n Still provided with z/VSE 4.1

n CICS TS for VSE/ESA Version 1 q Announced 9/29/1998 q Major new CICS product for VSE

History




n Not your typical CICS migration n Major differences q Rearchitected CICS q Discontinued functions n PCT, PPT and RDOeligible TCT macro definitions n Support for macro level programs n Support for RPG programs n Direct access to CICS control blocks n Internal security n BTAM

Planning


n CICS TS for VSE/ESA 1.1 q Based on CICS for MVS/ESA 4.1 + function from CICS TS for OS/390

q Report Controller integrated into product q Preinstalled in PRD1.BASE n Generation Feature into PRD2.GEN1 (Optional)

q Works with n Basic Security Manager or External Security Manager

n VSE/ESA Interactive Interface n VSE/ICCF

Planning…


n Optional Products q BTAM no longer orderable, must be copied from current system, not support by CICS TS

q DL/I VSE 1.11 supports CICS TS only q DL/I DOS/VS 1.10 supports CICS/VSE 2.3 only

q DB2 Server for VSE and VM 6.1 or higher required for CICS TS

Planning…




n Optional Products q COBOL for VSE/ESA, PL/I for VSE/ESA, C for VSE/ESA

q DOS/VS COBOL no longer available n Copy jobs in APARs PQ00970 and PQ00971

q DFSORT/VSE or equivalent sort product with E15 and E35 exits n Required to process statistics with DFHSTUP

Planning…


n Vendor Products q Review currently installed versions for CICS TS support n Vendor websites n Service and Support page on VSE/ESA website www1.ibm.com/servers/eserver/zseries/os/vse/

q May require release or maintenance upgrade

q May require replacement if no CICS TS support

Planning…


n Preparing to migrate q Read the CICS TS Migration Guide and Redbook

q Read them again!!

n Develop a migration plan q Install, test q Migrate discontinued functions on current CICS/VSE system

q Gain familiarity with new parameters and tuning options

Planning…




Implementation

n CICS TS Partitions q 50MB F2 for CICS TS with ICCF q Additional CICS TS partitions n Static or dynamic partition n Recommended minimum 50MB allocation n Virtual storage requirements larger the CICS/VSE

q Cannot run CICS TS with subsystem storage protection in F4

q FB (default) for VSE BSM Security Server


n Virtual storage requirements are larger q CICS TS 31bit partition GETVIS n Must be at least 12.5MB plus storage for VSAM buffers

q More data space usage n Basic Security Manager n CICS Data Management Facility (DMF) n CICS Shared Data Tables n Environment B SYSDEF DSIZE=20MB

q May require more real memory

Implementation…


Partition start

available 24bit GETVIS

24bit VSAM control blocks, etc.

CICS 24bit storage

CICS Nonnucleus modules and control blocks (.5MB)

CICS DSA(DSALIM – 2MB min.)

(UDSA, RDSA, SDSA, CDSA)

VSAM buffers & 31bit control blocks

CICS 31bit storage

CICS Nonnucleus modules and control blocks (2.3MB)

CICS Extended DSA (EDSALIM – 10MB min.)

(EUDSA, ERDSA, ESDSA, ECDSA)

available 31bit GETVIS

31bit GETVIS

CICS TS Partition

Partition end (2 GB max)

CICS Transaction Server Partition

24bit GETVIS

SIZE=DFHSIP

16 MB

CICS TS DFHSIP (4K)

Implementation…




Implementation…

n Virtual Storage Considerations q 24bit and 31bit dynamic storage areas required n EDSALIM limits 31bit DSAs q Recommend supplied value of 25MB or greater

n DSALIM limits 24bit DSAs q Use value based on CICS/VSE 2.3 startup message: “SUBPOOL SIZE BEFORE LOADING RESIDENT PROGRAMS”

n Other SIT parameters allocate individual DSAs q Recommend default 0 to let CICS do dynamic allocations


Implementation…

n Virtual Storage Considerations q Task storage allocated based on MXT value n Limits total number of user tasks n Storage preallocated in DSAs for MXT and 10 system tasks

n MXT=999 is not good (uses 3.6MB) n Specify MXT value based on CICS/VSE 2.3 shutdown statistics: “Peak number of tasks reached” “Number of times at max task”


Implementation…

n CICS system datasets q CSD file is required!!! n Definition moved from FCT to SIT

q Restart dataset (DFHRSD) n For emergency restart only n Other information moved to new VSAM KSDS catalog datasets

q DFHSTM and DFHSTN obsolete




Implementation…

n CICS system datasets… (new) q Global catalog (DFHGCD) n Journal status and restart control records n Installed RDO resources n Restart control record

q Local catalog (DFHLCD) n CICS TS domain status information n Formatted with DFHCCUTL utility


Implementation…

n CICS system datasets… (new) q Data Management Facility (DMF) datasets n Statistics and monitoring data collection n DFHDMFA, DFHDMFB

q Journal Archive Control Dataset (DFHJACD) n Required for automatic journal archiving n Not created during installation


Implementation…

n CICS System Datasets… q Defined for CICS/ICCF partition during install n VSAMDEFS.Z and VSAMINIT.Z

q Definitions for second CICS partition n Use skeleton jobstream in ICCF library 59 n SKPREPC2




Implementation… n Startup jobstream changes q CICS/VSE 2.3 EXEC DFHSIP,SIZE=nnnnK,PARM=‘xxx’,DSPACE=2M

q CICS TS // ID USER=DBDCCICS q CICS region userid for security

// EXEC DFHSIP statement SIZE=DFHSIP,PARM=‘xxx’,DSPACE=2M,OS390 q Program area only used for DFHSIP q CICS TS functions use OS/390 emulation mode q SKCICS and SKCICS2 skeletons in ICCF library 59


Implementation…

n Migrate macro tables to CSD and RDO q PCT, PPT, RDOeligible TCT entries q FCT (optional)

n Update SIT parameters q Many new/changed/obsolete entries

n Review other tables for new/changed parameters


Implementation…

n CICS system initialization parameter changes q 96 new parameters q 28 changed q 30 removed q Some defined in startup job only q Use skeletons in ICCF library 59 n DFHSITSP for CICSICCF n DFHSITC2 for additional CICS TS partitions




n CICS system definition file (CSD) is mandatory q Required for transactions, VTAM terminals, MRO/ISC connections and sessions, VSE console terminals

q Required for programs and mapsets n Or use new Program Autoinstall

Resource Definition


n New support for defining n VSAM files n LSRPOOLs n TRANCLASSes n VSE console terminals

q Can still use FCT macro table for VSAM files and LSRPOOLs n Must use macro table for DA files

Resource Definition…



n Use IBM supplied definitions for new entries and new/changed parameters

n Transactions, programs, mapsets, VTAM and VSE console terminals q RDO entries in supplied CSD file q DFHxxxxx and VSExxxxx groups q CEE group (LE/VSE), TCPIP group (TCPIP for VSE/ESA)




n Other resources still defined using tables q TCT for SAM terminals, remote terminals for transaction routing, logical device codes

q Journals (JCT), Transient Data Queues (DCT), Program Lists for startup and shutdown (PLTPI and PLTSD), MCT, SRT, TLT, TST, XLT, etc.

q ALT, NLT and SNT are no longer supported




n Macro tables q DCT, FCT, JCT, PLT, SIT, TST, XLT q Supplied skeletons in ICCF library 59 (DFHxxxxx) n Suffix SP for primary CICS TS partition q Startup PLT – PI, shutdown PLT SD

n Suffix C2 for second CICS TS partition q Startup PLT – P2, shutdown PLT – S2


n Migrate discontinued macro tables q Remove IBM supplied entries q Optionally add DFHxxx TYPE=GROUP to define RDO groups

q Assembly with CICS TS supplied macros q Migrate to CSD with DFHCSDUP batch utility

n Migrate supported macro tables q Update with new/changed parameters and entries q Reassemble with CICS TS





n Migrate CSD definitions q Restore CICS/VSE CSD q Method 1: Upgrade CICS/VSE CSD with DFHCSDUP utility n CICS and VSE supplied entries

q Method 2: Copy application groups from CICS/VSE CSD to CICS TS CSD (recommended)



Security n Internal security withdrawn q No SNT q CICS signon changed q Several parameters obsolete

n External Security Manager (ESM) used for all security checking

n All security based on 8 character userid n Utilities to convert DFHSNT and PCT definitions


Security...

n Obsolete parameters q TRANSEC on transaction definitions q RSL on resource definitions q OPERID, OPERPRTY, OPERRSL, OPERSEC in terminal and session definitions

q XSNAME (SECURITYNAME) in MRO/ISC definitions

q EXTSEC in SIT




CICS TS Security Choices

n No security q Built into application or not required q SIT SEC=NO

n Basic Security Manager (BSM) q User signon and transaction security q Enhanced in z/VSE 3.1.1 and later to support resource security

n External Security Manager q Vendor product or write your own q “Full function” depending on product


Basic Security Manager

n Basic ESM part of VSE/ESA 2.4 and later n Basic security support for CICS TS q Signon security q Transactionattach security q Operates independent of IPL SYS SEC setting q Requires SIT SEC=YES, XTRAN=YES

n Support for DTSECTAB system security q IPL SYS SEC=YES


Basic Security Manager...

n BSM prior to z/VSE 3.1.1 does not support q Resource security checking q Report Controller security q Command security q Surrogate user checking q MRO/ISC security




Basic Security Manager...

n Enhanced in z/VSE 3.1.1 and later q Support for CICS resource access security n Programs, files, journals n Started transactions n Temporary storage and transient data n Report Controller spool and printer access

q Support for application (APPL) and facility resource classes

q New BSM security dialogs, BSTADMIN utility and security repository VSAM file BSTCNTL


Basic Security Manager…

CICS TS VSE Security Server FB

VSE Control File

User Profiles

DTSECTAB

BSM (pre z/VSE 3.1.1)

DTSECTXN CICS

Transactions Files, Libraries Sublibraries Members

Signon and Transaction Requests

Requests for DTSECTAB resources

RACROUTE


Basic Security Manager … CICS TS VSE

Security Server FB

VSE Control File

User Profiles

BSM z/VSE 3.1.1

DTSECTXN

CICS Transactions

DTSECTAB

Files, Libraries Sublibraries Members

Signon, transaction and resource requests

Requests for DTSECTAB resources

RACROUTE

CICS Resources

BSM Control File





n CICS TS signon options q VSE/ESA signon panel (IEGM) q CICS TS CESN transaction q User written signon program n EXEC CICS SIGNON



n Review and update BSM security definitions q Transaction security definitions n Security class 1 defined for all CICS transactions (CEMT, CEDA, CECI, etc.)

n DITT(O) transaction defined with security class 61

q Default security n Security profile required for CICS default user

q SIT DFLTUSER=CICSUSER q CICSUSER profile defined with security classes 1, 6064

n Default user should have minimum level security q Security classes 1 and 61


Security Migration n Utilities to convert transaction security

q REXX procedures in ICCF library 59 q Creates definitions for old or new security method q DTSECTXS.PROC n Converts PCT source to BSM transaction security definitions

q DTSECTX2.PROC n Converts Security Migration Aid (SMA) file entries to BSM transaction security definitions

q DTSECTX3.PROC n Converts DEFINE TRANSACTION definitions from DFHCSDUP EXTRACT function to BSM transaction security definitions




Security Migration...

n Security Migration Aid (SMA) q Stage one of two stage security migration q Menu driven online program q Extracts security information from a running CICS/VSE system and the VSE IUI control file

q Creates VSAM KSDS file DFHXSMA n Records containing VTAM APPLID, resource type, resource name, RSL and TRANSEC values

n Used as input to ESM supplied stage two utilities


External Security Manager

n Vendor supplied products q Level of security support may vary q Check vendor documentation for details

n Computer Associates Top Secret n B.I. Moyle BIMAlert/CICS n MacKinney Systems CICS/Signon n Others???


Application Program Considerations n Command level only q DOS/VS COBOL programs compiled with CBL STATE and FLOW will abend CICS TS

n Macro level programs are not supported q Identify with DFHMSCAN utility q Convert to Command Level using the CICS Application Migration Aid (AMA)

n New translator option SPI to use System Programming Interface EXEC Commands




Application Program Considerations…

Compiler RunTime Library COBOL for VSE/ESA LE/VSE High Level Assembler/Assembler None or LE/VSE PL/I for VSE/ESA LE/VSE C for VSE/ESA LE/VSE DOS/VS COBOL LE/VSE 1

VS COBOL II LE/VSE 2

Supported: Programs Compiled By

1 Will probably run if linkedited with DOS/VSE COBOL or COBOL II runtime library, but not supported if it fails. Support for compiler ended 12/1999. 2 Will probably run if linkedited with COBOL II runtime library, but not supported if it fails. Support for compiler ended 4/1998.


Application Program Considerations...

Compiler RunTime Library DOS PL/I Any C/370 Any RPG II Any

Not Supported: Programs Compiled By


Application Program Considerations…

n EXEC CICS API commands q Security related parameters n ASSIGN OPERKEYS or OPSECURITY q Not supported

n ASSIGN USERNAME q Returns blanks using BSM q Depends on ESM

n Can use ASSIGN USERID and ASSIGN OPID

q ADDRESS CSA not supported




Customization

n Review all customization interfaces n No sysgen or SIT overlays n PLTPI separated into three stages n Define PLT programs with EXECKEY(CICS)

n Rework Global User Exits (GLUEs) n Review User Replaceable Modules (URMs)


n Global User Exits q 35 New and 8 removed exit points q Standardized linkage conventions for all exits

q New Exit Programming Interface (XPI) n Access to CICS services

q Must be 31Bit capable q Existing programs must be changed

Customization…


Customization...

n User Replaceable Modules (URMs) q Must be command level q Must be AMODE(31) q Use COMMAREA instead of internal control blocks

q VSE supplied URMs in ICCF lib 59 have been updated n DFHPEP, IESZNEP (NEP) n IESZATDX (autoinstall)




Statistics and Monitoring

n New Data Management Facility (DMF) used for collecting statistics and monitoring data q Used for BSM security logging in z/VSE 4.1

n Obsolete statistics/monitoring definitions q CSSM and CSSN transient data queues q CSTT statistics transaction q DFHSTM and DFHSTN statistic datasets q Journals for monitoring data


Statistics and Monitoring…

CICS TS partition(s) DMF Data Space

DFHMNSVC

DMF partition

DFHDFQMX

Data

Data

Data

DFHDFFM

ESDS

Collecting the Data


Statistics and Monitoring…

ESDS

DFHDFOU DFHSTUP

or DFH$MOLS

SAM

Offloading and Processing the Data




Statistics ‑ DFH0STAT

n Sample program DFH0STAT.C q COBOL for VSE/ESA source in PRD1.BASE q Uses EXEC CICS statistics commands (SPI) q Output to n VSE/POWER LST queue using Report Controller n CICS Temporary Storage queue

q Can be invoked from n Terminal n VSE console n PLTSD n As a STARTed transaction


n More trace and dump granularity q Dump Tables n Transaction q By transaction abend code

n System q By system dump code

n Created by q CEMT SET q EXEC CICS SET

q New trace entries and trace levels

Problem Determination


Problem Determination…

n New trace and dump utility programs q DFHTU410 formats auxiliary trace q DFHDU410 formats transaction dumps q DFHPD410 formats system dumps

n Several options to control dump and trace q New SIT parameters q New CEMT options q New CETR transaction





n Review SIT options affecting dump and trace q DUMP=YES|NO n Controls taking of system dumps

q SYDUMAX=999,TRDUMAX=999 n Maximum number of system and transaction dumps per dump code

q TRTRANSZ=512 n Size of transaction trace table in KB

q TRTABSZ=256 n Size of system trace table in KB



n Suppress system dumps for ASRA and ASRB abend q SIT ABDUMP and PCDUMP options obsolete q Specify in system dump table

CEMT SET SYDUMPCODE(AP0001) ADD NOSYSDUMP CEMT SET SYDUMPCODE(SR0001) ADD NOSYSDUMP

or from a PLT initialization program EXEC CICS SET SYDUMPCODE(AP0001) ADD NOSYSDUMP EXEC CICS SET SYDUMPCODE(SR0001) ADD NOSYSDUMP


Summary

n Migration to CICS TS takes more planning

n Some steps can be done on current CICS/VSE partition q Implement RDO q Install a security manager q Migrate discontinued functions

n Good planning and education will lead to a successful migration




Additional Information n CICS TS books q Release Guide (GC331646) q Migration Guide (GC331645) q http://www.software.ibm.com/ts/cics

n Redbooks q Migration to VSE/ESA 2.4 and CICS Transaction Server for VSE/ESA 1.1 (SG245595)

q Implementation of VSE/ESA 2.4 and CICS Transaction Server for VSE/ESA 1.1 (SG245624)

q http://www.redbooks.ibm.com


Additional Information…

n illustro Education Courses q CICS Transaction Server for VSE/ESA Migration (A3731)

q CICS Transaction Server for VSE/ESA Tuning and Problem Determination (A3732)

q CICS Transaction Server for VSE/ESA Under the Covers (A3733)

migration to cics ts for vse/esa

Documents