Migration to CICS TS for VSE/ESA
Transcript of Migration to CICS TS for VSE/ESA
Page 1
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.
Migration to CICS TS for VSE/ESA
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.
Page 2
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM20074 Copyright © 2007 illustro Systems International, LLC
Topics
n History n Planning n Implementation n Resource Definition n Security n Application Program Considerations
IBM20075 Copyright © 2007 illustro Systems International, LLC
Topics…
n Customization n Statistics and Monitoring n Problem Determination n Additional information n Summary
IBM20076 Copyright © 2007 illustro Systems International, LLC
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
Page 3
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM20077 Copyright © 2007 illustro Systems International, LLC
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
IBM20078 Copyright © 2007 illustro Systems International, LLC
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…
IBM20079 Copyright © 2007 illustro Systems International, LLC
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…
Page 4
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200710 Copyright © 2007 illustro Systems International, LLC
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…
IBM200711 Copyright © 2007 illustro Systems International, LLC
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…
IBM200712 Copyright © 2007 illustro Systems International, LLC
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…
Page 5
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200713 Copyright © 2007 illustro Systems International, LLC
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
IBM200714 Copyright © 2007 illustro Systems International, LLC
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…
IBM200715 Copyright © 2007 illustro Systems International, LLC
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…
Page 6
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200716 Copyright © 2007 illustro Systems International, LLC
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
IBM200717 Copyright © 2007 illustro Systems International, LLC
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”
IBM200718 Copyright © 2007 illustro Systems International, LLC
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
Page 7
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200719 Copyright © 2007 illustro Systems International, LLC
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
IBM200720 Copyright © 2007 illustro Systems International, LLC
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
IBM200721 Copyright © 2007 illustro Systems International, LLC
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
Page 8
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200722 Copyright © 2007 illustro Systems International, LLC
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
IBM200723 Copyright © 2007 illustro Systems International, LLC
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
IBM200724 Copyright © 2007 illustro Systems International, LLC
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
Page 9
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200725 Copyright © 2007 illustro Systems International, LLC
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
IBM200726 Copyright © 2007 illustro Systems International, LLC
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…
IBM200727 Copyright © 2007 illustro Systems International, LLC
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)
Page 10
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200728 Copyright © 2007 illustro Systems International, LLC
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
Resource Definition…
IBM200729 Copyright © 2007 illustro Systems International, LLC
Resource Definition…
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
IBM200730 Copyright © 2007 illustro Systems International, LLC
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
Resource Definition…
Page 11
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200731 Copyright © 2007 illustro Systems International, LLC
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)
Resource Definition…
IBM200732 Copyright © 2007 illustro Systems International, LLC
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
IBM200733 Copyright © 2007 illustro Systems International, LLC
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
Page 12
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200734 Copyright © 2007 illustro Systems International, LLC
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
IBM200735 Copyright © 2007 illustro Systems International, LLC
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
IBM200736 Copyright © 2007 illustro Systems International, LLC
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
Page 13
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200737 Copyright © 2007 illustro Systems International, LLC
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
IBM200738 Copyright © 2007 illustro Systems International, LLC
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
IBM200739 Copyright © 2007 illustro Systems International, LLC
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
Page 14
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200740 Copyright © 2007 illustro Systems International, LLC
Basic Security Manager…
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
IBM200741 Copyright © 2007 illustro Systems International, LLC
Basic Security Manager…
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
IBM200742 Copyright © 2007 illustro Systems International, LLC
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
Page 15
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200743 Copyright © 2007 illustro Systems International, LLC
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
IBM200744 Copyright © 2007 illustro Systems International, LLC
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???
IBM200745 Copyright © 2007 illustro Systems International, LLC
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
Page 16
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200746 Copyright © 2007 illustro Systems International, LLC
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.
IBM200747 Copyright © 2007 illustro Systems International, LLC
Application Program Considerations...
Compiler RunTime Library DOS PL/I Any C/370 Any RPG II Any
Not Supported: Programs Compiled By
IBM200748 Copyright © 2007 illustro Systems International, LLC
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
Page 17
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200749 Copyright © 2007 illustro Systems International, LLC
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)
IBM200750 Copyright © 2007 illustro Systems International, LLC
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…
IBM200751 Copyright © 2007 illustro Systems International, LLC
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)
Page 18
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200752 Copyright © 2007 illustro Systems International, LLC
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
IBM200753 Copyright © 2007 illustro Systems International, LLC
Statistics and Monitoring…
CICS TS partition(s) DMF Data Space
DFHMNSVC
DMF partition
DFHDFQMX
Data
Data
Data
DFHDFFM
ESDS
Collecting the Data
IBM200754 Copyright © 2007 illustro Systems International, LLC
Statistics and Monitoring…
ESDS
DFHDFOU DFHSTUP
or DFH$MOLS
SAM
Offloading and Processing the Data
Page 19
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200755 Copyright © 2007 illustro Systems International, LLC
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
IBM200756 Copyright © 2007 illustro Systems International, LLC
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
IBM200757 Copyright © 2007 illustro Systems International, LLC
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
Page 20
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200758 Copyright © 2007 illustro Systems International, LLC
Problem Determination…
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
IBM200759 Copyright © 2007 illustro Systems International, LLC
Problem Determination…
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
IBM200760 Copyright © 2007 illustro Systems International, LLC
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
Page 21
Migration to CICS TS for VSE/ESA
Copyright © 2007 illustro Systems International, LLC. All rights reserved.
IBM200761 Copyright © 2007 illustro Systems International, LLC
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
IBM200762 Copyright © 2007 illustro Systems International, LLC
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)