CICS Transaction Server for z/os. Installation GC

(1)

CICS Transaction Server for z/OS

Installation Guide

Version 2 Release 3

(2)

(3)

CICS Transaction Server for z/OS

Installation Guide

Version 2 Release 3

(4)

Note!

Beforeusingthisinformationandtheproductitsupports,besuretoreadthegeneralinformationunder“Notices”onpage 453.

Ninthedition(April2008)

ThiseditionappliestoVersion 2 Release 3ofCICSTransactionServerforz/OS,programnumber5697-E93,and toallsubsequentversions,releases,andmodificationsuntilotherwiseindicatedinneweditions.Thiseditionreplaces GC34-6224-06.Makesureyouareusingthecorrecteditionfortheleveloftheproduct.

OrderpublicationsthroughyourIBMrepresentativeortheIBMbranchofficeservingyourlocality.Publicationsare notstockedattheaddressgivenbelow.

Atthebackofthispublicationisapageentitled“SendingyourcommentstoIBM”.Ifyouwishtosendcommentsby mail,pleaseaddressthemto:

User Technologies Department Mail Point 095

IBM United Kingdom Laboratories Hursley Park

WINCHESTER Hampshire SO21 2JN United Kingdom

WhenyousendinformationtoIBM,yougrantIBManonexclusiverighttouseordistributetheinformationinany wayitbelievesappropriatewithoutincurringanyobligationtoyou.

©CopyrightInternationalBusinessMachinesCorporation1989,2008.Allrightsreserved.

USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContract withIBMCorp.

(5)

Part 1. Planning for Installation

. . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter1. Introduction. . . 3

Overview ofCICSTS. . . 3

Packaging . . . 3

CICSTSelementsandfeatures . . . 4

Exclusive andnon-exclusiveelementsandfeatures. . . 4

Whatyoureceive withCICSTS . . . 4

Documentation . . . 5

Summaryof elementsinCICSTS . . . 6

TheCICSClientsandTheCICSTransactionGateway. . . 7

InstallingCICSTS . . . 7

Chapter2. InstallingCICSTS . . . 9

Requirements forCICSTS. . . 9

Hardwarerequirements forinstallingCICSTS. . . 9

Softwarerequirements forinstallingCICSTS. . . 10

DASDstoragerequirementsfor CICSTS . . . 11

InstallingCBPDO . . . 11

Runningtheinstalljobs. . . 12

InstallingServerPac . . . 13

Whatyouneed toinstalltheServerPac. . . 14

Summaryof theServerPacinstallationsteps. . . 14

Thenextstep . . . 15

Chapter3. Post-installationrequirements . . . 17

Implementingchangesinyour z/OSenvironmentfor CICS. . . 17

APF-authorizing CICSSDFHAUTH library. . . 18

AuthorizingCICSregionuseridstoRACF . . . 18

AddingSDFHLINKtotheMVS LNKLST . . . 19

DefiningCICSasanMVS subsystem . . . 19

DefiningandinstallingtheCICSType3SVC. . . 19

Reviewingthehigh-performanceoption. . . 20

(6)

Defininglogstreams. . . 20

MVSASRexit . . . 21

Planning forCICSPlexSM . . . 22

Planning forCICSPlexSMmigration. . . 22

ParallelSysplex considerations. . . 22

Chapter4. Installingthe CICSInformationCenter . . . 23

Requirements . . . 23

Installing theinformationcenteronaworkstation . . . 23

Installing theinformationcenteronaserver . . . 24

Performing asilentinstallationoftheinformationcenter. . . 25

Part 2. Setting up the MVS environment for CICS

. . . . . . . . . . . . . . . 27

Chapter5.Authorizingthe hlq.SDFHAUTHlibrary. . . 29

Chapter6.AuthorizingCICSregionstoaccessMVSresources . . . 31

Protecting CICSloadmoduledatasets . . . 31

Authorizingaccesstodatasetservicesmodules . . . 31

Authorizingaccesstoa CICSregion’s VTAMACB. . . 32

Authorizingtheregionuseridto accesscategory 1transactions . . . 33

AuthorizingaccesstoanSMSVSAMserver . . . 33

AuthorizingaccesstoMVS logstreams. . . 34

Authorizationsfor usersof IXCMIAPU . . . 34

Authorizationsfor CICSregions. . . 34

AuthorizingCICSregionuseridstoz/OS UNIXSystemServices . . . 36

ActivatingRACFresourceclasses. . . 36

Chapter7. Definingthe defaultCICSuseridtoRACF . . . 39

Chapter8. InstallingCICS-requiredmodulesin theMVS linklist . . . 41

CICS-supplied modulesrequiredintheMVSlinklist . . . 41

CICSshareddatatablesmodulesfor theMVSlinklist . . . 42

Modulesofother MVSproductsintheMVSlinklist. . . 42

Chapter9. DefiningCICSasanMVS subsystem . . . 45

TheIEASYSxxMVS initializationmember . . . 45

TheIEFSSNaaMVSsubsysteminitializationmember . . . 46

Theconsolemessage-handlingfacility . . . 46

TheDFHSSIyymessage-formattinginitialization member . . . 47

Default message-formattinginitializationparameters . . . 48

Activatingmessageformatting . . . 49

Modulesneededtousetheconsolemessage-handlingfacilities. . . 50

Coexistence considerations . . . 50

EXCIPipeAllocation. . . 51

TheDFHSSIyyinitializationmember . . . 51

TheEXCIpipeallocation limit . . . 52

Default EXCIpipeallocationlimitinitializationparameter . . . 52

Chapter10.InstallingtheCICSType3SVC . . . 53

DefiningtheCICSSVCsto yourMVS . . . 53

Using morethanoneversionof theCICSType3 SVC . . . 54

MRObetweendifferentCICSreleaseswithachangedSVCnumber . . . 55

Chapter11.Selectingthehigh-performanceoption . . . 57

DefiningDFHHPSVC toMVS . . . 57 iv CICSTSforz/OS: InstallationGuide

#

(7)

Loading moduleDFHHPSVC. . . 57

Removing existingDFHHPSVC modulesfromtheMVSnucleus. . . 58

Chapter12.DefiningCICSregionsasapplications toVTAM. . . 59

DefiningspecificCICSAPPLstatementstoVTAM . . . 59

VTAMAPPLparametersfor CICSregions. . . 59

VTAM versionandreleaselevelindicator . . . 61

MessageDFHZC3473onopeningtheVTAMACB. . . 61

Cross-domain considerations. . . 61

VTAM LUaliasfacility . . . 62

Chapter13.InstallingCICSmodulesinthe MVSlinkpackarea . . . 67

Preparingto installCICSmodulesintheMVSlink packarea. . . 67

Benefitsof usingtheMVS linkpackarea . . . 67

WhatismeantbytheMVS linkpackarea? . . . 68

Whichmodulesmust beintheMVSlink packarea . . . 68

Whichmodulescan beintheMVSlink packarea? . . . 69

Serviceconsiderations . . . 70

Howto usemodulesintheMVSlink packarea. . . 71

Space requirementsfor CICSmodulesintheMVS linkpackarea . . . 71

DefiningtheCICSLPAlibrarytoyourMVS . . . 71

InstallingCICSmodulesintheLPA . . . 72

Selectingmodulesfor theMVSlink packarea . . . 72

TheCICS-supplied SMP/EUSERMOD,DFHUMOD . . . 73

Changinga CICS-suppliedUSERMOD . . . 73

PreparingtheUSERMOD. . . 73

ReceivingandapplyingtheUSERMOD. . . 73

ControllingtheuseofmodulesfromtheMVSlinkpackarea . . . 74

ModulesintheMVS linkpackareafromhlq.SDFHAUTH . . . 74

ModulesintheMVS linkpackareafromhlq.SDFHLOAD . . . 74

SampleDFHCSDUPjobtospecifyUSELPACOPY(YES) . . . 78

Chapter14.DefiningCICSIPCSexitcontroldatatoMVS. . . 81

TheDFHIPCSPCICSexit controldata . . . 81

Chapter15.MVSProgrampropertiestableentries . . . 83

RACFpasswordchecking. . . 83

Non-swappableCICSregions . . . 83

MVS protectionkeyforCICS. . . 84

Chapter16.MVSperformancedefinitions . . . 85

ImplementingMVS workloadmanagement. . . 85

MatchingCICSperformanceparameterstoservicepolicies . . . 86

Chapter17.Spoolperformanceconsiderations. . . 87

Chapter18.MVSautomaticrestartmanagementdefinitions. . . 89

ImplementingMVS automaticrestartmanagement. . . 89

Chapter19.MVScross-system MROdefinitions . . . 91

Sysplex overview . . . 91

MVS XCFconsiderationsfor MRO. . . 91

Chapter20.PR/SMpolicy forhandling MVSfailures . . . 93

XCFPR/SM policy . . . 93

(8)

Chapter21.MVSASREXIT-SYMRECAuthorization Exit . . . 95

Chapter22.DefinitionsrequiredforVSAMRLSsupport . . . 97

Definingthemastercouplingfacilitylockstructure . . . 97

Definingcouplingfacilitycachestructuresandcachesets . . . 97

Definingcachesets . . . 98

DefiningSMS storageclassesforRLSaccess . . . 98

AlteringdatasetattributesforRLSaccess. . . 98

Definingsharingcontroldatasets . . . 99

AuthorizingCICSuseridsfor VSAMRLSsupport. . . 100

Addingnewparametersto SYS1.PARMLIB(IGDSMSxx) . . . 100

Establishingnew proceduresfor VSAMRLSsupport . . . 100

Activatingthecouplingfacilitystructures . . . 101

Chapter23.Consolemessages. . . 103

Chapter24.DefiningtheloggerenvironmentforCICSjournaling . . . . 105

Requirements planningandchecklist . . . 105

Settinguptheenvironment forCICSlogmanager . . . 110

CouplingfacilityorDASD-only? . . . 112

Coupling facilitylogstreams . . . 113

Definingcouplingfacilitystructures . . . 114

Planning considerationsfor thenumberof logstructures . . . 117

Logstructure namingconventions . . . 118

Definingcouplingfacilitylogstreams . . . 118

Sizingconsiderations forcouplingfacilitylogstreams . . . 120

CouplingfacilityrequirementsinanRLSenvironment . . . 127

Stagingdatasets forcouplingfacilitylogstreams. . . 128

DASD-onlylogstreams . . . 129

DefiningDASD-onlylogstreams . . . 130

Sizingconsiderations forDASD-onlylogstreams. . . 131

Converting aDASD-onlylogstreamtousea couplingfacility . . . 134

AnalyzingSMFType88records . . . 135

Managingsecondarystorage . . . 136

Managinglogdatasets . . . 136

Logtailmanagement . . . 137

Chapter25.ApplyingservicetoCICSTransactionServerforOS/390 139 Load librarysecondaryextents . . . 139

TheCICSTS-suppliedSMP/Eprocedure. . . 140

APARfixes. . . 140

PTFs . . . 141

CICSservice considerations . . . 141

CICSPlex SMserviceconsiderations . . . 142

ServicingtheCICSmessagesdataset . . . 142

Part 3. Getting ready to run CICS

. . . . . . . . . . . . . . . . . . . . . . 145

Chapter26.TailoringtheCICS-supplied skeletonjobs . . . 147

TheCICSinstallationlibraries . . . 147

Whatyoushould do . . . 148

RunningDFHISTAR . . . 148

Chapter27.CreatingtheCICSdatasets . . . 151

Namingconventions . . . 152

Creatingdatasets commontoallCICSregions,DFHCOMDS job. . . 153 vi CICSTSforz/OS: InstallationGuide

(9)

Creatingseveralcopiesof theDFHCSDandSYSINdatasets . . . 153

Creatingdatasets uniqueto eachCICSregion,DFHDEFDSjob . . . 154

CreatingtheCICSmessages dataset,DFHCMACIjob . . . 155

DefiningtheDFHCMACDfileandassociatedCICSresources . . . 155

Definingthesampleapplicationsdatasets . . . 156

TheCUAtextlevelapplication. . . 156

TheFILEAsampleapplicationprograms . . . 157

TheCICSApplicationProgrammingPrimersampleapplication. . . 157

Chapter28.DefiningDL/Isupport. . . 159

PDIRs. . . 159

AddingremoteDL/Isupport. . . 159

Defininga PSBdirectory. . . 160

Coding CICSsysteminitializationparametersforremoteDL/Isupport . . . 160

Global userexitsforDL/I. . . 161

Chapter29.AddingCICSsupportforprogramming languages . . . 163

InstallingLanguageEnvironmentsupport. . . 163

InstallingCICSsupportfor LanguageEnvironment . . . 164

LanguageEnvironmentsupportforCOBOL. . . 165

LanguageEnvironmentsupportforCandC++. . . 165

LanguageEnvironmentsupportforPL/I . . . 166

LanguageEnvironmentsupportforCICSJVMprograms . . . 166

Chapter30.InstallingJavasupport . . . 167

InstallingsuppliedJavacomponents . . . 167

JAR files. . . 167

ET/390 (HPJ)andJCICSsupport . . . 168

Sampleprograms . . . 168

InstallingtheJavaVirtualMachine . . . 168

JVMprofiles . . . 168

JVMpropertiesfiles. . . 170

Java2securitypolicyfor EJBs . . . 171

Installingthehlq.SDFJAUTH library. . . 171

Installingthehlq.SDFJLPAlibrary . . . 171

Amending parametersinSYS1.PARMLIB(BPXPRMxx). . . 172

Chapter31.InstallingMROandISCsupport . . . 173

InstallingMROsupport . . . 173

DefiningCICSasanMVS subsystem . . . 174

InstallingthemodulesDFHIRPandDFHCSVCintheLPA . . . 174

Installingrequiredhardware andsoftwarefor XCF/MRO . . . 174

DefiningMVS imagesassystemsinanXCFsysplex . . . 174

Enabling MROforCICSstartup . . . 175

AddingISCsupport. . . 175

RunningaCICSregionwithISC. . . 175

Chapter32.EnablingTCP/IPina CICSregion. . . 177

UsingTCP/IPinaCICSregion . . . 177

Chapter33.EnablingREXXforCICS . . . 179

Step1--Modify yourRDOdefinitionsto addrequiredentries. . . 179

Step2--CreatetheRFSfilepools. . . 179

Step3--BINDtheCICSQLprogramtoyourDB2 plan . . . 180

Step4--AddDDstatementstoyourCICSstartupjob . . . 180

Step5--Modify memberCICSTART. . . 180

||

(10)

Step6--FormattheRFSfilepools. . . 180

Step7--Verifyingtheinstallation . . . 181

Step8--Accessing thesuppliedsoftcopydocumentation . . . 181

Customizationinformationfor REXX . . . 181

ChangingsuppliedCICStransactioncodes . . . 182

RFSfilepool definitions . . . 183

TDqueuesneededfor IMPORTandEXPORTcommands . . . 183

SQLdefinitionsused forauthorizingtransactionstouseDB2 . . . 183

Specialexecdatasets usedbytheREXXDevelopment System . . . 184

SpecialUSERidsandtheirusage . . . 184

Other considerations . . . 185

Online HELPfacility . . . 185

Part 4. CICS verification . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Chapter34.Runningtheinstallationverificationprocedures . . . 189

Preparation forrunningtheIVPs . . . 189

CreatetheCICSdatasetsfor theIVPjobs . . . 189

Install theCICSSVCfortheIVPjobs . . . 189

Define andactivatetheCICSapplids . . . 190

Authorize theIVPuserid . . . 190

Reviewsecurityrequirementsfor theIVPjobs. . . 191

Define logstreams . . . 192

Specifysystem initializationparametersfortheIVPjobs . . . 193

ResourcesfortheCICSmessagesfacility,CMAC . . . 194

TheCICSstartupprocedure,DFHSTART . . . 194

DDstatementsfor CICSdata sets . . . 195

Verify batchjob, DFHIVPBT. . . 196

SamplejoblogfortheDFHIVPBTjob . . . 197

OutputfromtheDFHIVPBTjob . . . 200

Verify interactivejob,DFHIVPOL. . . 204

Defininga terminalfortheonlineIVP . . . 204

DefiningtheCICSAPPLIDto VTAM . . . 206

DefininganMVSconsole . . . 207

DefiningaTSOuserasaconsoledevice. . . 207

RunningtheDFHIVPOLjob. . . 208

Logging onat aVTAM terminal . . . 211

Using CICS-suppliedtransactionsthroughaterminal . . . 212

Using theCEDAtransaction . . . 214

Invokingandexecutingsampleprograms. . . 215

Using transactionsfroma consoledevice. . . 215

Terminating CICS . . . 217

Verifying shareddatatablessupport . . . 217

Example verificationof shareddatatables . . . 218

Verifying theCICS-DBCTLinterface. . . 224

TheIMSinstallationrequirements fortheDFHIVPDBjob. . . 224

TheDFHIVPDBjobsteps . . . 224

Testing theCICS-DB2environment . . . 228

Run DB2jobsDSNTEJ5C andDSNTEJ5P . . . 228

StartingaDB2organizationorprojectapplication. . . 228

RunningtheEJB″HelloWorld″ sample . . . 230

Part 5. CICSPlex SM installation and setup

. . . . . . . . . . . . . . . . . 231

Chapter35.CICSPlex SMsetupchecklistandworksheets. . . 233 viii CICSTSforz/OS: InstallationGuide

(11)

Installationchecklists . . . 234

MVS installationandsetupchecklist . . . 234

Remote MASfor Windowsinstallationandsetupchecklist . . . 237

Systemworksheet . . . 238

CASworksheet . . . 239

CMAS worksheet . . . 240

LocalMAS worksheet. . . 242

Remote MASfor Windowsworksheet . . . 243

Chapter36.SettinguptheMVS environment . . . 245

Noting IEASYSxxvalues. . . 245

UpdatingIEASYSxx(CAS) . . . 246

UpdatingIEASYSxx(CMAS) . . . 246

Authorizinglibraries. . . 247

UpdatingtheMVS linklist. . . 248

Preparingto usetheCICSPlex SMAPI . . . 248

InstallingtheREXXfunctionpackage . . . 249

Using CICSPlex SMmodulesintheMVS linkpackarea. . . 250

Space requirements . . . 250

InstallingCICSPlex SMmodulesintotheLPA. . . 251

Applying maintenanceto LPAmodules. . . 252

Chapter37.VTAMrequirements . . . 253

DefiningVTAM requirements(CAS). . . 253

Step1: (Optional)Creatingamode table. . . 253

Step2: CreatingaVTAM applicationdefinition(CAS) . . . 255

Step3: Definingcross-domainresources(CAS) . . . 256

Step4: Updatingtheconfigurationlist(CAS) . . . 256

Step5:Activatingthemajor nodes(CAS). . . 257

DefiningVTAM requirements(CMAS) . . . 257

Step1: CreatingaVTAM applicationdefinition(CMAS) . . . 258

Step2: Definingcross-domainresources(CMAS) . . . 259

Step3: Updatingtheconfigurationlist(CMAS). . . 260

Step4:Activatingthemajor nodes(CMAS). . . 260

ReviewingVTAM cross-domainresourcemanagementdefinitions (remote MAS) . . . 261

Step1: ReviewingremoteMAS cross-domaindefinitions . . . 261

Step3: Updatingtheconfigurationlist(remoteMAS) . . . 261

Step4:Activatingthemajor nodes(remoteMAS). . . 262

Chapter38.Generatingpost-installationmembers . . . 263

Chapter39.CreatingandmanagingCICSPlexSM datasets . . . 265

CAS-relateddatasets. . . 265

CreatingtheCICSPlex SMdatarepository . . . 265

PopulatingtheCICSPlex SM datarepository . . . 268

Converting theCICSPlex SMdatarepository . . . 268

ExpandingtheCICSPlex SM datarepository . . . 270

Taking backupsof theCICSPlex SMdatarepository . . . 270

Defininga forwardrecovery logforthedatarepository. . . 270

Chapter40.UpgradingtheCSDandmacrodefinitions . . . 273

CreatingCICSresourcedefinitiontablesforCMASs. . . 273

UpdatingtheCSDfilesusingDFHCSDUP(CMAS) . . . 273

Journalmodelconsiderations ina CICSTSfor OS/390CMAS . . . 274

ConsiderationswhenupgradingtheCSDrelease(CMAS) . . . 274

||

(12)

ConsiderationswhensharingtheCSD(CMAS) . . . 275

UpdatingCICSresourcedefinitiontablesfor MASs . . . 276

UpdatingCSDfilesusingDFHCSDUP(MVS MAS) . . . 276

ConsiderationswhenupgradingtheCSDrelease(MVSMAS) . . . 277

ConsiderationswhensharingtheCSD(MVS MAS) . . . 278

Chapter41.PreparinguseraccesstoCICSPlex SM . . . 279

Chapter42.Settingupacoordinatingaddressspace (CAS) . . . 281

Preparingto startaCAS. . . 281

STARTcommandforaCAS . . . 282

Identifying andconnectingtoa CAS . . . 284

SettingtheCASsystemcommunicationinformation. . . 284

Preparingto stopaCAS. . . 284

Stoppinga CAS . . . 284

Chapter43.SettingupaCICSPlex SM addressspace(CMAS) . . . 287

Before youbegin. . . 287

CICSPlex SMauxiliarystorageusage. . . 287

Preparingto transmitgenericalertstoNetView . . . 288

Preparingto startaCMAS . . . 289

EditingCICSPlex SM systemparameters . . . 291

CMAS-relatedCICSSITparameters . . . 292

Controllingtasksina CMAS . . . 295

ControllingCICSstorageina CMAS . . . 295

STARTcommandforaCMAS. . . 296

SettingtheVTAMAPPLID foraCMAS . . . 297

ShuttingdownaCMAS . . . 297

Using theSHUtdowncommand . . . 297

Using theCOSD transaction . . . 298

Restarting aCMAS. . . 298

Chapter44.SettingupaCICSmanagedapplicationsystem(MAS). . . . 299

Before youbegin. . . 299

Using CICSglobaluserexitsanduser-replaceable modules. . . 299

ControllingtheuseofmodulesfromtheLPA . . . 300

Preparingto startanMVSMAS . . . 300

ActivatingDB2connectionsduringCICSstartup . . . 301

MQSeriesconnections . . . 302

MVS MAS-relatedCICSSITparameters . . . 302

PreparingtheMASfor historyrecording . . . 304

Stopping andrestarting managementof aCICSsystem . . . 305

Stoppingmanagement ofa CICSsystem. . . 305

Restarting managementofa CICSsystem . . . 305

Terminating aMAS. . . 306

Controllingthenumberof long-runningtasksinaMAS. . . 306

Chapter45.SettingupaCICSPlex SM remoteMAS agentforWindows 307 Overview ofthesetupprocess. . . 307

Prerequisitesoftware . . . 308

Setup requirements. . . 308

MicrosoftWindowsInstallerService. . . 309

DownloadingtheremoteMAS agentsetupfile. . . 309

Installing theremoteMASagent components . . . 310

Attendedinstallation . . . 310

Unattended installation . . . 310 x CICSTSforz/OS: InstallationGuide

||

#

(13)

Changesmade duringinstallation . . . 311

Directorystructure . . . 311

Changesto environmentvariables . . . 311

Changesto thesystemregistry . . . 311

Reviewingyour SNAconfiguration . . . 311

Defininga communicationsdefinitionforCICSPlex SM . . . 312

ReviewingtheCICS for Windowsregiondefinitionparameters . . . 312

Customizing theuser-replaceableprograms. . . 313

Updatingexistinguser-replaceableprograms . . . 313

Using thesamplessuppliedwithCICSPlex SM . . . 314

EditingtheCICSPlex SM EYUPARMS.DATfile . . . 315

InstallingtheCICSPlex SM resourcedefinitions . . . 315

DeletingtheCICSPlex SM resourcedefinitions . . . 316

DefiningtheremoteMASto CICSPlex SM . . . 316

Restarting yourCICS for Windowssystem. . . 317

Securityconsiderations . . . 317

Stoppingandrestarting managementof aCICS for Windowssystem . . . . 317

Stoppingmanagement ofa CICS for Windowssystem . . . 317

Restarting managementofa CICS for Windowssystem. . . 317

Terminating aCICS for Windowsregion. . . 317

Uninstalling theCICSPlex SMremoteMASagent forWindows . . . 318

Modifyingandrepairing aninstallation. . . 318

Chapter46.ConfiguringtheStarterSet . . . 319

TheStarterSet sampleslibraries. . . 319

JCLinCICSTS23.CPSM.SEYUJCLforcreating theStarterSet . . . 319

JCLinCICSTS23.CPSM.SEYUJCLforrunningtheStarterSet. . . 320

DefinitionsinCICSTS23.CPSM.SEYUDEFfortheStarterSetenvironment 320 TheStarterSet namingconvention . . . 321

CreatingtheStarterSetenvironment . . . 322

SelectingtheStarterSetconfiguration. . . 323

DefiningtheStarterSetenvironment . . . 323

StartingtheStarterSetcomponents . . . 325

DeletingtheStarterSet . . . 326

Using theStarterSet asamodel. . . 327

Chapter47.ApplyingservicetoCICSPlex SM. . . 329

CICSTSforOS/390-supplied SMP/Eprocedure . . . 329

Applying PTFstoCICSPlexesrunningCICSTransactionServerforz/OS, Version2 Release3 andlater . . . 329

Applying serviceto theremoteMASagent forWindows . . . 330

Chapter48.Usingthe EYUINSTEXECtotailorskeletonjobs. . . 331

SampleJCLeditingconsiderations . . . 331

EYUINSTEXECparameters . . . 333

SampleJCLexecutionconsiderations . . . 340

Chapter49.CICSPlex SMsystemparameters. . . 341

Chapter50.CMASjournaling . . . 357

Chapter51.PreparingtousetheIPCStools . . . 361

UpdatingBLSCECT . . . 361

Updatinglibraryallocations . . . 362

SDUMPoptions . . . 362

|

||

(14)

Part 6. CICSPlex SM verification . . . . . . . . . . . . . . . . . . . . . . . 365

Chapter52.CICSPlex SMinstallationverificationprocedures . . . 367

If theIVPsdonotworkasdescribed . . . 367

Thestagesof IVP1andIVP2 . . . 367

TheIVPsampleslibraries . . . 368

Chapter53.Installationverificationprocedure1(IVP1) . . . 371

SettinguptheCICSPlex SMenvironmentonsystemA . . . 371

StartingupandverifyingCICSPlex SM componentsonsystemA . . . 373

1: StarttheCASEYUCAS1A . . . 373

2: StarttheCMASEYUCMS1A . . . 374

3: DefineaCICSplex toCICSPlex SM . . . 374

4: RunthebatchedrepositoryupdatefacilityonsystemA . . . 377

5: StarttheMAS EYUMAS1A . . . 378

Testing CICSPlex SMfunctions . . . 379

Test theoperationsfunctionsonsystemA . . . 379

SettinguptheCICSPlex SMenvironmentonsystemB . . . 384

StartingupandverifyingCICSPlex SM componentsonsystemB . . . 385

1: CreateCASdefinitions . . . 386

2: StarttheCASEYUCAS1B . . . 390

3: CheckingCAS-to-CASconnections. . . 391

4: StarttheCMASEYUCMS1B . . . 392

5: RunthebatchedrepositoryupdatefacilityonsystemB . . . 393

6: EnableEYUCMS1B tomanageEYUPLX01. . . 393

7: StarttheMAS EYUMAS1B . . . 396

Testing CICSPlex SMfunctions . . . 397

Test theoperationsfunctionsonsystemB . . . 397

Customizing theinstallationverificationprocedures . . . 399

StarttheremoteMAS forWindows . . . 402

Verify thattheremoteMAS forWindowsisactiveinCICSPlex SM . . . 404

StoptheremoteMASforWindows . . . 404

Restart theremoteMASfor Windows . . . 405

Part 7. Appendixes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

Appendix. CICSmoduleseligiblefortheMVSlinkpackarea . . . 409

CICSmodulesrequiredintheMVSlink packarea . . . 409

CICSmoduleseligiblefor theMVSlinkpackarea . . . 409

Informationabout moduleseligiblefortheMVS linkpackarea . . . 409

Priority . . . 410

Size . . . 410

Option/Note . . . 410

Glossary ofSMP/Etermsusedinthisbook. . . 427

Bibliography . . . 429

TheCICSTransactionServerfor z/OSlibrary . . . 429

Theentitlementset. . . 429

PDF-only books . . . 429

Other CICSbooks . . . 431 xii CICSTSforz/OS: InstallationGuide

(15)

Booksfromrelatedlibraries. . . 431

Systems NetworkArchitecture(SNA) . . . 431

Advancedcommunicationsfunctionfor VTAM(ACF/VTAM) . . . 431

NetView Version3.1 . . . 432

NetView MultiSystemManagerVersion2.2 . . . 432

DATABASE2(DB2) . . . 432

eNetwork CommunicationsServerfor OS/2Warp,Version5 . . . 432

CICSfor OS/2Versions3and3.1 . . . 432

OS/2Version2 . . . 433

OS/2Warp. . . 433

Virtual StorageAccessMethod(VSAM) . . . 433

ResourceAccessControlFacility(RACF). . . 433

SystemModificationProgramExtended (SMP/E). . . 433

Sysplex planning. . . 433

DFSMS/MVS . . . 433

MVS . . . 433

IMS/ESAVersion6library . . . 434

Determiningif apublicationiscurrent . . . 435

Accessibility . . . 437

Index. . . 439

Notices . . . 453

Trademarks. . . 454

Sendingyour commentstoIBM . . . 455

(16)

xiv CICSTSforz/OS: InstallationGuide

(17)

Preface

What this book is about

This bookdescribesCICS^®TransactionServerfor z/OS^®, Version2 Release3 (CICSTS).Ittakesyouthroughthenecessaryplanningandhelpsyouinstall CICS TransactionServerfor z/OS,Version2Release3. Itcontainsguidanceabout tailoring CICSforuseinyoursystemsenvironment.It:

v Describesthecontentof CICSTSandthetwodeliverymethods—ServerPacand CBPDO

v Explainsthemethodof installingCICSTS(witheitherServerPacorCBPDO), andprovidesreferencesto therequiredsources ofinformation.In thisbook,

“installing”meansloadingthecodeinto thelibraries inpreparationforthe migrationandcustomizingtasks.

v

Liststhehardware andsoftwareyoumust haveto runtheCICSTSproduct elementsandexploitthefunctionprovidedbyCICSTS.

v Coversinstallation,andverificationofthatinstallation,forbothCICSand CICSPlex^®SM.

v Tellsyouaboutinstalling theworkstation-based componentsof CICSTS.

Thebook assumesthatyou areupgradingtoCICSTSlevelsofalltheproduct elementsintheServer.

Planning themigrationtoCICSTSrequiresthatyouunderstandthefunction provided bytheCICSTSproductset.Youcanlearnabout thefunctioninthe various productlibrariesoftheindividual elementsthatcomprisetheproductset.

Always checktheproductlibraries(forexample,intheCICSTransactionServerfor z/OS MigrationfromCICSTSVersion2.2)forchangesthatmightaffect CICSTS elements.

Who is this book for?

This bookisintendedfor experiencedCICSsystemprogrammerswho areplanning to migratetoCICSTS.

This bookisalsofor systemprogrammerswho areresponsibleforinstallingand tailoring CICSandCICSPlex SM.

By “experienced”,wemeanthatasystem programmer’sexperienceincludes installing andmanagingCICSandsomeoralloftheotherelementsintheCICSTS productset.

What you need to know to understand this book

Tofullyunderstandtheinstallationinformationinthisbook,youshouldhave experience oftheIBM^® MVS^™operatingsystem,andtheSystemModification Program/Extended(SMP/E)licensedprogramneededto maintainCICSand

CICSPlex SM.Tousetheinstallationverificationprocedures,youshouldbefamiliar withtheJCLandcatalogedproceduresforMVS.Italsohelpsif youarefamiliar withCICSandCICSPlex SMconcepts.

(18)

How to use this book

for planning

Readthroughthesectionsofthisbook thattellyouabout:

v Theproductsandhardwareyouneed tosupportthefunctionthatcomeswith CICSTS.

v

Thepointerstomigrationandinstallationinformationthatisintheproduct librariesthatyoureceive withCICSTS.

Onceyouhave identifiedtheactions youneedto taketocompleteyourmigration, writeaplan describingthestepsyourinstallationwilltake.Include yourestimateof how muchtime eachsteprequiresandwho willdoit.

for installation

CICSandCICSPlex SM areavailableonly aselementsof theCICSTransaction Server, througheithertheServerPacorCBPDOmethodof delivery.For information about thesetwo methodsof deliveryof theCICSTransactionServer,see

Chapter2,“InstallingCICSTS,”onpage9.

ToinstalltheCICSTransactionServerusingtheCBPDOmethod,youshoulduse theCICSTransactionServerfor z/OSProgramDirectory,togetherwiththe instructionscontainedintheMemotoUsers Extension,to loadthesoftwarefrom thetapeDASD.For theServerPacmethod,youfollow thesuppliedsetofISPF dialogs andtheaccompanyingdocumentation.

Afteryouhave loadedtheCICSTransactionServerelementsto DASD,youshould then usethisbookto tailorCICStoyour environment;thatisto:

v IntegrateCICSwithMVS andACF/VTAM v Applyservice toCICS(ifrequired) v CreatetheCICSdatasets

v

InstallDB2^®support(if required) v

InstallMROandISCsupport(ifrequired) v

Runtheinstallationverificationprocedures(if required).

Notes:

1. “CICSmoduleseligiblefor theMVS linkpackarea,”onpage409givesdetails of theCICSmodulesthatareneededin,andeligiblefor,theMVS linkpack area.

2. If youinstalledCICSfromCBPDO, youdonotneed toruntheDFHISTARjob againtospecifythepost-installationparameters.However,ifyou wishto create several copiesofthepost-installationjobs (forexampletocreateseveralcopies of theDFHDEFDSjobto defineCICSdatasets uniquetoseveralCICS

regions), youcaneditandruntheDFHISTARjobasmanytimesasrequired.

Some oftheinformationinthis bookisalsoof interestifyouhave installedCICS TransactionServerusingtheServerPacmethodof delivery.

In particular,youshouldeditandruntheDFHISTARjob,specifyingthekeyword POST, todefineparametersneededtotailoryourCICSenvironment.

Notes on terminology

CICSisusedthroughoutthisbook tomean theCICSelementof theIBMCICS TransactionServerfor z/OS,Version2Release3.

xvi CICSTSforz/OS: InstallationGuide

(19)

CICSPlexSMrefers toCICSPlexSystemManager,anelementof CICS Transactionserver.

CICSTSVersion2 regionisused torefertoa CICSregionrunningunderCICS TS Version2, incontrast,forexample,to aCICS/ESA^® 4.1region.

MVS isusedthroughoutthisbookto meantheoperatingsystem MVS,or theBase Control Program(BCP)elementofz/OS.

RACF^®isusedthroughoutthisbook tomeantheMVS ResourceAccessControl Facility(RACF)oranyotherexternalsecuritymanagerthatprovidesequivalent function.

ThetermCICSTS2.3regionisused torefertoa CICSregionrunningunderCICS TS Version 2 Release 3,incontrast,for example,to aCICS/ESA 4.1region.

$ In theprogrammingexamplesinthisbook,thedollarsymbol ($,)isusedasa national currencysymbol andisassumedtobeassignedtheEBCDICcode point X’5B’. Insomecountriesa differentcurrency symbol,for examplethepoundsymbol (£), ortheyensymbol(¥), isassignedthesameEBCDICcode point.In these countries,theappropriatecurrencysymbol shouldbeused insteadofthedollar symbol.

hlq Throughoutthis book,thetermhlqisusedtodenotethehigh-levelqualifierof theCICSTSdatasets;forexample,CICSTS23.CICSfor CICSdatasets and CICSTS23.CPSMfor CICSPlexSMdatasets.TheCICSTS23partofthehigh-level qualifier isdefinedbytheLINDEXparameterintheDFHISTARinstallationjob.

IMS™librarynames

TheIMSlibrariesreferred tointhischapterareidentifiedbyIMS.libnam(for example,IMS.RESLIB).If youareusingyourown namingconventions, changetheIMSprefixto matchthosenamingconventions.

CICS system connectivity

This informationonCICSsystemconnectivity toCICSPlex SM supersedesthe informationintheCICSPlex SMbooks. Changesaremarkedwitha#inthe margin.

This releaseofCICSPlex SM canbeusedtocontrolCICSsystemsthataredirectly connectedto it.

For thisreleaseof CICSPlex SM,theconnectableCICSsystemsare:

v CICSTransactionServerforz/OS 2.3 v CICSTransactionServerforz/OS 2.2 v CICSTransactionServerforOS/390^®1.3

v CICSforWindows^®componentofIBMTXSeries^®4.3.0 (withPTF 4) v CICSforWindowscomponentofIBMTXSeries5.0

You canusethisreleaseof CICSPlex SMto controlsystemsrunningsupported releasesofCICSthatareconnectedto,andmanaged by,yourpreviousreleaseof CICSPlex SM.However, ifyouhave anydirectly-connectablereleaselevelsof CICS,aslistedabove,thatareconnectedtoapreviousreleaseofCICSPlex SM, you arestrongly recommendedto migratethemtothecurrentreleaseof

(20)

CICSPlex SM,to takefulladvantageoftheenhancedmanagementservices.See theCICSTransactionServerfor z/OSMigrationfromCICSTSVersion2.2for informationonhow todothis.

Table1 showswhichsupportedCICSsystemscan bedirectly connectedtowhich releasesofCICSPlex SM.

Table1.Directly-connectableCICSsystemsbyCICSPlex SMrelease CICSsystem CICSPlex SMcomponent

ofCICSTS2.3

CICSPlex SMcomponent ofCICSTS2.2

CICSPlex SMcomponent ofCICSTS1.3

CICSTS2.3 Yes No No

CICSTS2.2 Yes Yes No

CICSTS1.3 Yes Yes Yes

TXSeries4.3.0.4 Yes Yes No

TXSeries5.0 Yes Yes No

xviii CICSTSforz/OS: InstallationGuide

(21)

Summary of changes

This bookisbasedontheInstallationGuideforCICSTransactionServerfor z/OS, Version2 Release2,GC34-5985-00.Changesfromthateditionaremarkedby vertical barsintheleftmargin.

This partlistsbrieflythechangesthathave beenmade forthefollowingrecent releases:

Changes for CICS Transaction Server for z/OS, Version 2 Release 3

Themoresignificantchangesfor thiseditionare:

v Technicalchanges:

– InCICSPlex SM,supportfortheCICSOS/2^®remoteMASisremoved,and thecorrespondingtopicinthesection aboutCICSPlexSMverificationis deleted.

– Neworrevisedtopicsinclude:

- “InstallingtheJavaVirtualMachine”onpage168 - “Installingthehlq.SDFJAUTHlibrary”onpage171

- “PopulatingtheCICSPlex SMdatarepository”onpage268 - “CMAS-relatedCICSSITparameters”onpage292

- “PreparingtheMASfor historyrecording”onpage304 v Stucturalchanges:

– Chapter4, “InstallingtheCICSInformationCenter,”onpage23hasbeen movedfromthebackofthebook.ItisnowinPart1, “Planningfor Installation,”onpage1.

Changes for CICS Transaction Server for z/OS Version 2 Release 2

v Technicalchanges:

– Insupportofthenew CICSPlex SMremoteMASagent forWindows,two chaptershavebeen added:

- Chapter45,“Settingupa CICSPlex SMremoteMASagent forWindows,”

onpage307

- Chapter55,“Installationverificationprocedure 6(IVP6),”onpage401 – Chapter49,“CICSPlex SMsystem parameters,”onpage 341hasbeen

updatedwithseveral newsecurity-relatedparameters.

v

Chapter43,“Settingupa CICSPlex SMaddressspace(CMAS),” onpage 287 hasbeenexpandedwiththeaddition ofthenewsections“Controllingtasksina CMAS”onpage295and“ControllingCICSstorageinaCMAS”onpage295.

v Stucturalchanges:

– AnewchapterChapter33,“Enabling REXXfor CICS,”onpage 179contains informationaboutREXXthatpreviouslyappearedintheCICSTransaction Serverforz/OSProgram Directory.

– TheformerAppendixA, dealingwith“Diskspaceneededfor CICS”,hasbeen removed.ThisinformationisavailablefromtheCICSTransactionServerfor z/OSProgramDirectory.As aconsequence,theformerAppendixBisnow AppendixA.

(22)

Changes for CICS Transaction Server for z/OS, Version 2 Release 1

v Thisbook hasanewPARTPart1, “PlanningforInstallation,”onpage1,which replacesthePlanningfor Installationmanual ofearlierreleases.

v InformationhasbeenaddedtoChapter6,“AuthorizingCICSregionstoaccess MVSresources,”onpage31describing“AuthorizationsforusersofIXCMIAPU”

onpage34.

v

InChapter24,“Definingtheloggerenvironmentfor CICSjournaling,”onpage 105,suggestedvaluesfor HIGHOFFLOADandLOWOFFLOADhavebeen revised,andnew sections“Requirementsplanningandchecklist” onpage105 and“AnalyzingSMFType88records”onpage135havebeen added.

v Chapter28,“DefiningDL/Isupport,”onpage159issignificantlychanged.

v Chapter29,“AddingCICSsupportfor programminglanguages,”onpage163is new.

v Chapter30,“InstallingJavasupport,”onpage 167,replacestheprevious“Java^™ support”chapter.

v Chapter32,“EnablingTCP/IPinaCICSregion,”onpage177isnew.

v

CICPlexSMfor thisreleaseofCICSTransactionServerdoesnotsupportCICS systemsrunningunderVSE/ESA^™.Thechapters:“SettingupaCICS/VSE^® remotemanaged applicationsystem (MAS)”and“Installationverification procedure3 (IVP3)”,(of thepreviousrelease)areremoved.

For mostitemsineachof thelistsabove,thereisareferenceto thepartof the book wherethereismoredetail.

Changes for CICS Transaction Server for OS/390 Version 1 Release 3

v Post-installation,additionto chapteronauthorizingCICSregions v VTAM^® definitionsrequiredforCICS:PERSIST=MULTI

v

DefininganMVS console v Javasupport

CICSPlex SM installation and setup

Tosupporttheinclusionof CICSPlex SMasanelementofCICSTransaction Server forOS/390,Version1Release3,andtheconsequent revisedinstallation processes, anew part,Part5, “CICSPlex SMinstallationandsetup,”onpage231 has beenaddedto explainhow toinstalltheCICSPlex SM element.This

informationwaspreviouslyavailableintheCICSPlex SM Setupbookatthe previousrelease.It containsthefollowingchapters

v Chapter35,“CICSPlex SM setupchecklist andworksheets,”onpage233.

v

Chapter42,“Settingupa coordinatingaddressspace(CAS),”onpage281.

v Chapter43,“Settingupa CICSPlex SMaddressspace(CMAS),” onpage 287.

v

Chapter44,“Settingupa CICSmanaged applicationsystem (MAS),”onpage 299.

v Chapter46,“ConfiguringtheStarterSet,”onpage319.

v Chapter47,“Applyingservice toCICSPlex SM,”onpage329.

v Chapter52,“CICSPlex SM installationverificationprocedures,”onpage367.

v Chapter54,“Installationverificationprocedure2 (IVP2),”onpage383.

v Chapter48,“UsingtheEYUINSTEXECto tailorskeletonjobs,”onpage 331.

xx CICSTSforz/OS: InstallationGuide

(23)

v Chapter49,“CICSPlex SM systemparameters,”onpage 341.

v Chapter50,“CMASjournaling,”onpage357.

v Chapter51,“PreparingtousetheIPCStools,”onpage361.

Changes for CICS Transaction Server for OS/390 Version 1 Release 2

Themajor changesto CICSthataffect CICSTransactionServerforOS/390, Version1 Release2are:

v

Chapter24,“Definingtheloggerenvironment forCICSjournaling,”onpage 105 hasbeenrewritten,toinclude informationaboutDASD-onlylogstreams.

v ThechapterdiscussingtheinstallationofDB2supporthasbeen removed.

InformationaboutCICSDB2isavailableintheCICSDB2Guide.

v Anewsection Chapter6, “AuthorizingCICSregionsto accessMVS resources,”

onpage 31to explainhow toauthorizeCICSregionuseridsto z/OSUNIX^® SystemServices.

Changes for CICS Transaction Server for OS/390 Version 1 Release 1

Themajor changesto CICSTransactionServerforOS/390Release1thataffect this bookare:

v

Supportfor theMVSlogger v Theremovalofjournalcontrol v Supportfor VSAMRLS.

Other changesmade tothis bookinclude:

v Theremovalofinformationrelatingto XRF,includinginformationfor the DFHALTDSandDFHIVPALjobs

v Theremovalofinformationrelatingto theCICSplexIVPs.

(24)

xxii CICSTSforz/OS: InstallationGuide

(25)

Part 1. Planning for Installation

This partdiscussesplanningconsiderationspriorto Installation.It containsthe following chapters

v

Chapter1, “Introduction,”onpage3 v Chapter2, “InstallingCICSTS,”onpage9

v Chapter3, “Post-installationrequirements,” onpage 17

v Chapter4, “InstallingtheCICSInformationCenter,”onpage23

(26)

2 CICSTSforz/OS: InstallationGuide

(27)

Chapter 1. Introduction

Generally, largeonlineCICSapplicationsrunonanMVS operatingsystemtogether withacollection ofothersupportingsoftwareproducts,someprovidedbyIBMand othersbyindependentsoftwarevendors(ISVs).Functionaladditionsinclude distributedCICSsoftwareonalternativeplatforms,enablingyoutodistribute transaction processing,withCICSontheMVShost actingasa largedatabase server.IBMrecognizesthatcustomerstraditionallyruntheseproductsat various releaselevels—apiecemealormix-and-matchapproach.

CICSTS,togetherwithotherz/OSSoftwareServers,isdesignedto makeit easier to installandoperatethemixofsoftwareyouneedto runyourbusiness.

Overview of CICS TS

WithCICSTransactionServerfor z/OS(CICSTS),IBMcontinuestointegrateCICS withasetof othersupportingsoftware,offeringyouasingle productinplaceof several products.Youorderanentiresetof software,integratedintoonelicensed product,instead ofhavingto ordernewlevelsof someproducts butnotothers.

CICSTSisamemberofthez/OSfamily ofMVS-basedsoftwareservers,andis separatelyorderable asa singlepartnumber.

WithinCICSTS, thelevelsofallproducts reflecttheleveloftheCICSTSproduct itself.Eventheword “product”hasnewmeaning;forthisreasontheproductsthat makeupthebase ofCICSTSarecalledelements. CICSTSmarksasignificant change fromtheformerpiecemeal approachtothewayyouorderandinstallCICS anditsrelatedsoftware.

Getting alltheelementsinCICSTSinstalledandrunningisthesubjectofthis book.BecausetheelementsandfeaturesofCICSTSareintegratedintoasingle packagewithcompatibleservicelevels, itisexpectedthatyouwillmigrateall elementsandfeaturesof CICSTSat thesametime.

Packaging

Thepackagingof CICSTSinto anumberofelementsissimilartothepackagingof z/OS. Foritsoperating systemenvironment,CICSTSrequiresz/OS, Version1 Release4.Asyou prepareto installCICSTS, keepinmindthatyougainthe benefits ofa comprehensivelytestedenvironmentwhenyouinstallCICSTS.

In summary,theconcept ofCICSTSisto integratearange oftransactionserver functionsintoa singleproductthatdeliversthefunctionpreviously providedbya numberof individualIBMsoftwareproducts.CICSTSconsistsof severalbase elements.TheintentisthatIBMships,andyourun,allelementsat thesingle releaselevelthatIBMhassubjectedtocomprehensive systemtesting.

MigratingfromonereleaseofCICSTStothenextisrelativelysimple, andthe transitionfromyourcurrentsystemstoCICSTSshouldalsobestraightforward.

(28)

CICS TS elements and features

CICSTSconsistsof baseelementsthatdeliveressentialtransactionserver functions. WhenyouorderCICSTS,youreceive allthebase elements,described inTable2onpage6.

Two methodsof installingCICSTS comefreewithyour license:

1. AsystemreplacemethodcalledServerPac

2. TheCustom-BuiltProductDeliveryOption (CBPDO).

Exclusive and non-exclusive elements and features

Some elementsandfeaturescontainnew functionthatisavailableonly withinCICS TS.This booklabelssuchanelement orfeatureexclusive:new functionis

exclusivetoCICSTS.If anelementor featureisexclusive,youreceivenew function onlythroughCICSTS.Thatis,whilepriorlevels continueto beavailable, future functionalenhancementsoccuronly withinCICSTS.

Other elements,however,existboth withinCICSTSandalso asseparately orderable products.Thesearenon-exclusive.

IBM’s directionisto makefunctionalenhancementsonly withinCICSTS.

What you receive with CICS TS

Because theelementsof CICSTSareintegratedintoa singlepackage,youare expectedto installtheentireproduct.

You caninstallCICSTSusingoneof severalIBMpackages.Twoofthese packages areavailableat noadditionalchargewhenyoulicenseCICSTS:(1) ServerPac,thesystem replacedeliverable,or (2)CBPDO.

There isnostand-aloneproducttapefor CICSTS,andthereisnoCustomBuilt InstallationProcessOffering(CBIPO).

Because oftheoveralleaseof installing,IBM recommendsthatyouchoose ServerPac,if possible.

v IfyouordertheServerPac offering,youreceive:

– Aseriesoftapes,eachinIEBCOPYdump-by-dataset format(notaphysical volumedump)containing acompletegeneratedCICSTS system.This consistsofdistribution andtargetlibraries,consolidatedsoftwareinventory (CSI)andotherSMP/Elibraries alreadygenerated.CICSTSelementsand theirserviceareintegratedintodistribution andtargetlibraries.

IBMhasIPLedthesystem andexecutedallinstallationverificationprograms (IVPs)priorto shipment.

– ACustomPacdialog,accessedthroughISPF,thatproducesjobs thatunload thetape toDASD.Throughthedialog,youcanname thedatasetsandplace theminthecatalogsyouspecify.Thefollowing accompanyingdocumentation tellsyouhow tousethedialog:

- ServerPac:InstallingYourOrder(customizedforeach customerorder) - ServerPac:UsingtheInstallationDialog,SA22-7815

– Allunintegrated service,availableonaservicetape.

– Samplejobs toassist withtheinstallationofCICSTSproductandservice.

Throughthedialog,you can:

(29)

– Namethedatasets andplacethemonthevolumesandinthecatalogsyou choose

– Saveconfigurationdata forthenextinstall,easing yourmoveto thenext releaseofCICSTS

– Runtailoredpost-installationverificationjobs.

v IfyouorderCBPDO,youreceiveonelogically stackedSMP/ERELFILEtape thatcontainsallthebase elements.Dependingonyourcustomerprofile,you receiveuninstalledservice.Youalso receive:

– Samplejobs tohelp youinstallCICSTSandservice.

– Custom-BuiltOfferingsPlan/Install,SC23-0352;theCBPDOMemotoUsers Extension;CICSTSProgramDirectory,GC33-1200,andprogrammaterials thatdescribeyourCBPDOorder.

Figure1illustratesthecontentdifferencesbetweentheServerPacmethodandthe CBPDO methodofinstallingCICSTS.

Documentation

Regardlessof whetheryouuseServerPacorCBPDO, youreceive:

Integration- tested code and PTFs

Integration- tested code in RELFILE

format

Integration- tested PTFs

Hipers Hipers

PE fixes PE fixes

Uninstalled PTFs based on your customer

profile PTFs required

for new products Other IBM

products you might have ordered

. . . PTFs not integrated and available for preventive maintenance

All service in both deliverables is current to within a week of order.

ServerPac CBPDO

IBM recommends

you install this code.

Integrated into libraries

Figure1.ContentsoftheServerPacandtheCBPDODelivery

(30)

v TheCICSTSProgram Directoryandother installationinformationfor the elements,inhardcopyandsoftcopy.

v Essentialhardcopybooksto helpyouwithinstallation.

v Allthepublicationsfor CICSTransactionServerforz/OS insoftcopyaspartof theCICSInformationCenter.This issuppliedonaCD-ROM.Installation

instructionsfortheCICSInformationCentercanbefoundinChapter4,“Installing theCICSInformationCenter,”onpage23.

For detailsof allthepublicationsavailable, see“Bibliography”onpage429.

Summary of elements in CICS TS

This sectionlistsalltheelementsandfeaturesinCICSTransactionServerfor z/OS.

Most oftheelementsareproducts thathavebeenavailable forsometime;youmay already berunningsomeofthem.

Table2 listsallelementsthatareintheCICSTSbase.Thetabletellsyou:

Name

Theshortname oftheelementused inthis book.

Excl.

Whethertheelementisexclusive.In theExcl.column,Yesindicatesan exclusiveelement,andNoindicatesa non-exclusiveelementthatisalso availableasa stand-aloneproduct.

Function Level

ThelatestCICSTS releaseinwhichtheelementchanged (thatis,wasadded to CICSTSor hadnewfunction added).For non-exclusiveelements,this column alsogivesthereleaselevelofthestand-aloneproduct.

Note: Toensurecompatibility withpreviousreleases,theCICSbase element maintainsitsownlevel(identification)number.Eachtime newfunction is addedtoCICSandshippedwiththeCICSTransactionServerproduct, theCICSlevelnumberisincremented.TheCICSlevelnumbernolonger impliesaspecificversionandreleasenumber,becauseCICSisno longeraseparateproduct.

TheCICSlevelnumberinCICSTSis0630.Thisnumberisreturnedin theRELEASEparameteroftheINQUIRE SYSTEMcommand.The0630 numberalsoappearsinotherformssuchas6.3.0inofflineutilitiessuch asstatisticsanddumpformatters toidentify thelevelof utilitybeing used,andasthesuffixinmodulenamessuchasDFHPD630.

Comments

Somegeneralinformationabout theelement.

Table2.ListofbaseelementsshippedinCICSTS

Nameofelement Excl. Functionlevel Comments

CICS Yes CICSTSV2R3 CICSincludes:

v ONCRPCsupport v Transactionaffinitiesutility v CICSWebinterface

v CICSDB2attachmentfacility v CICS/DDM

(31)

Table2.ListofbaseelementsshippedinCICSTS (continued)

Nameofelement Excl. Functionlevel Comments

CICSPlexSM Yes CICSTSV2R3 Updatedtosupportnewlevelsoffunctionin CICS.CICSPlexSMbecomesanexclusive elementinCICSTSRelease3.

IBMCICSPlexSystemManagerforMVS/ESA^™ Version1Release3continuestobeavailablefor customersthatarenotyetreadytomigrateto CICSTS(forexample,customerwithCICS/ESA Version4Release1orearlier).

ApplicationMigration Aid

No CICSTSV1R1 Firstavailablein1990,thiselementisstill availablestand-aloneasIBMCustomer InformationControlSystem(CICS)program offering,CICSApplicationMigrationAid,program number5695-061.

REXXforCICS No CICSTSV1R2(REXXfor CICS/ESAV1R1)

SeparatelyavailableasREXXforCICS,program number5655-B54.

The CICS Clients and The CICS Transaction Gateway

CICSTransactionServerforz/OSdoes notincludetheCICSUniversal Clientsor theCICSTransactionGateway.TousetheCICSUniversalClientV5 ortheCICS TransactionGatewayV5, licensesfortheseproductsarerequired.

Installing CICS TS

Chapter2,“InstallingCICSTS,”onpage9tellsyouaboutinstalling theCBPDO deliveryversionof CICSTS.

#

(32)

(33)

Chapter 2. Installing CICS TS

IBMoffersthefollowingmethods forinstallingCICSTS:

v ServerPac v CBPDO

v IBMcustomizedpackages.

Thefirsttwo oftheseareentitledofferings, andarethesubject ofthisbook,but IBMcustomizedpackagesarefee-basedandarenotdiscussedexceptforthe following summaryinformation.Depending onthecountryinwhichyouorder,you can purchaseoneofthefollowingcustomizedpackages:

v ASystemPac^®,whichtailorsCICSTStoyourenvironment,suchasDASDlayout andnamingconventions,basedoninformationprovided toIBM.

v SoftwareXcelInstallationExpress(SIE),whichtailorsCICSTS toyour specificationandprovidesservicesthatperformtheactualinstallforyou.

v Otherfee-basedservicesandcustomizedofferings.

BoththeServerPacandCBPDOmethodsof deliveringCICSTScomewithasetof documentation thatyouusewhenyouinstalltheproduct.Tohelp youplanahead, this chaptergivesyouapreviewof someofthisinformation,suchasthe

informationcontainedintheProgramDirectory,whichisshipped regardlessof the deliverymethodyouchoose.

Note: TheProgramDirectoryisavailableinhardcopyonlywiththeproduct—it cannotbeorderseparately.AsoftcopyversionisavailableontheCICSTS CD-ROMproductkit,andalso ontheTransactionProcessingandData CollectionKit,SK2T-0730.TheProgramDirectoryisalsoavailableonthe CBPDOandServerPactapes.

This chapteralsohelpsyouwithother planningstepsyoumusttake:

v Ensuringyouhavetherequiredhardwareandsoftwaretoinstall andrunCICS TS;see“Requirementsfor CICSTS.”

v EnsuringyouhaveenoughDASDstoragespaceforCICSTS;see“DASD storagerequirementsfor CICSTS”onpage11.

v OutliningtheinstallstepsforCBPDO; see“InstallingCBPDO”onpage 11

Requirements for CICS TS

Amajorpartofyourplanningeffortinvolveslookingat thesoftwareandhardware requiredfor thesystemthatyouareinstalling.

Hardware requirements for installing CICS TS

WhetheryouchoosetheCBPDOmethodor theServerPacmethod,thehardware requirementisthesame.

Hardwarerequirements aremorefullydescribedintheCICSTransactionServerfor z/OS ReleaseGuide

You needahardware configurationthatrunstherequiredlevelsof MVS,provided theconfigurationhasaterminal anda tapedevicecapable ofreadingoneofthe following typesof tapeonwhichCICSTSissupplied:

v

6250bpi9-trackreels