2. You editDFHISTARinthehlq.TDFHINSTlibrary,tospecifyCICSinstallation parametersspecifictoyour CICSenvironment.
3. When yourunDFHISTAR,thetailoredcopiesof theskeletonjobs arecopied fromthehlq.TDFHINSTlibrarytothehlq.XDFHINSTlibrary.
hlq.XDFHINST
isused tostorethetailored,executable,copiesoftheskeletonjobsthat aretoberun.
4. ToinstallCICS,yourunthetailoredcopiesof theCICS-supplied installationjobs to transfertheCICSsoftwarefromthedistribution tapetothehlq.ADFHINST andhlq.SDFHINSTlibraries.
hlq.ADFHINST
istheSMP/E-supporteddistributioninstallationlibrary.
hlq.SDFHINST
istheSMP/E-supportedtargetinstallationlibrary.Afteryou have installedtheCICSsoftwareintothis andotherSMP/E-supported libraries (namedSDFHxxxxandADFHxxxx),theskeletonjobs thatyou shoulduseonanylaterrunsof DFHISTARarestoredintheSDFHINST library.
Note: TheactualnamesoftheTDFHINSTandXDFHINSTlibraries,andtheprefix forthoseandotherCICSlibraries,aredefinedinDFHISTAR,whichyouedit asdescribedinthis chapter.
What you should do
Totailor theskeletonjobs youmustrunDFHISTAR.Forinformationonhowto do this, andtheparametersinvolved,seeCICSTransactionServerfor z/OSProgram Directory.
Running DFHISTAR
When youhaveeditedDFHISTARwiththevaluesfor installationparametersfor your CICSenvironment,submitDFHISTAR.
When yourunDFHISTAR,it tailorstheskeletonjobsselectedintheDFHISTAR input (bytheSCOPE orSELECTparameter)to yourenvironmentandadds themto thelibrarythatyouspecifiedontheLIB parameter(bydefault,hlq.XDFHINST).If necessary, DFHISTARcreatesthelibrarythatisspecifiedontheLIB parameter.
148 CICSTSforz/OS: InstallationGuide
ATableinsection6.4oftheCICSTransactionServerforz/OS ProgramDirectory liststhoseskeletonjobs installedinthehlq.SDFHINSTlibrarythatyoucantailorby runningDFHISTAR.
Note: Youmust specifythefullname oftheinstallationlibraryfromwhichthe skeletonjobsareobtained,ontheTEMPLIBparameter andSYSPROCDD statementofDFHISTAR(bydefault,hlq.TDFHINST).Forthepost-installation tasksthataredescribedinthisbook,youshouldspecifyTEMPLIB
SDFHINST.
DFHISTARproducesajoblogand,ifnecessary, anerrorcode:
v Theoutputjoblogliststhevaluesthatwereactuallyusedfor theparametersof DFHISTAR.
v IfanyerroroccurswhenrunningDFHISTAR,anerrorcodeof 4or12is returned.Forerrorcode4, theskeletonjobs aretailoredandaddedtothe hlq.XDFHINSTlibrary.For errorcode 12,theskeletonjobs arenottailoredor copied.Toresolvethecauseoftheerror,examinetheoutputjoblogand,if necessaryeditandsubmitDFHISTARagain.
150 CICSTSforz/OS: InstallationGuide
Chapter 27. Creating the CICS data sets
Afteryouhave installedCICS,andapplied anynecessaryservice,youcan runthe DFHCOMDS,DFHDEFDS,andDFHCMACIjobstocreatetheCICSdatasets.
CICSsupports accessto thefollowing typesof datasets:
v Key-sequenceddataset(KSDS).Withreleasesof DFSMS/MVS1.4andlater, a datasetcanbegreaterthan4GBinsizeif itisdefinedasextendedformat and extendedaddressability inthestorageclass.CICSsupports,inbothRLand non-RLSmode,KSDSdatasets thataredefinedwiththeseextendedattributes.
v Entry-sequenceddataset(ESDS).Withreleasesof DFSMS/MVS1.5andlater,a datasetcanbegreaterthan4GBinsizeif itisdefinedasextendedformat and extendedaddressability inthestorageclass.However, CICSdoesnotsupport ESDSdatasetsthataredefinedwiththeseextendedattributes.Attemptsto open datasetsdefinedwiththeextendedattributefail witherrormessage
DFHFC0966,codes8504,0008,0068.
v Relativerecorddataset(RRDS).Withreleasesof DFSMS/MVS1.5andlater,a datasetcanbegreaterthan4GBinsizeif itisdefinedasextendedformat and extendedaddressability inthestorageclass.However, CICSdoesnotsupport RRDSor VRRDSdatasetsthataredefinedwiththeseextendedattributes.
Attemptstoopen datasetsdefinedwiththeextendedattributefailwitherror messageDFHFC0966,codes8504,0008,0068.
Datasets
Thedatasets createdbythejobs describedinthischapterarerequiredbythe IVPsdescribedinChapter34,“Runningtheinstallationverification
procedures,”onpage189.
VSAMDatasetsandz/OS1.3
If youareusingz/OS1.3or above,readInformationAPARII13288.
It reportsthatthelevelofDFSMS suppliedwithz/OS1.3haschangedthe waythatindexcontrolintervalsize(CISIZE) iscalculated forthoseVSAMdata sets thathaveindexcomponents.Asa result,large defaultCIsizes canbe expected,andthiscan causeopenerrorsduringCICSstart-up.
This appliesto bothCICSdatasets andyourownapplicationdatasets.
Job Function
DFHCOMDS Deletesandrecreatesdatasets commontoall CICSregions.
DFHDEFDS Deletesandrecreatescopiesof datasetsthatare usedonly byoneCICSregion.Yourunaseparate copyofthisjobto createthedatasets foreach CICSregion.
DFHCMACI DeletesandrecreatestheCICSmessagesdata set,dsindex.DFHCMACD,andloadsit withthedata
|
fromtheCICS-suppliedfile,DFHCMACD,inthe hlq.SDFHMSGStargetlibrary.
DFH0JCUS Deletesandrecreatesthesampleapplications detailsdataset,dsindex.SAMPLE.DFHCTCUS(and itsassociatedalternate indexandpath), andloads itwiththedatafromtheCICS-suppliedfile,
DFH0DCUS,inthehlq.ADFHAPD2library.
DFH0JHLP Deletesandrecreatesthesampleapplicationshelp dataset,dsindex.SAMPLE.DFHCTHLP,andloadsit withthedatafromtheCICS-supplied file,
DFH0DHLP,inthehlq.ADFHAPD1library.
When youranDFHISTAR,thesejobswere tailoredtoyourenvironment andstored inthelibrarythatyouspecifiedontheLIB parameterofDFHISTAR(bydefault, hlq.XDFHINST). IfyouhavenotyetrunDFHISTAR,youshoulddosobefore runninganyof theCICSpost-installationjobs.
You cangenerateseveralcopiesof thesejobs byrerunningDFHISTAR,selecting thejobs thatyouwantto copy.Togeneratenewcopies ofthesejobs,edit
DFHISTARto specifynew valuesfortheDSINFOandSELECTparameters.Only thosejobsthatyou namebytheSELECTparameter areregenerated.