ca datacom®/ad report utilization, and information gather for support

World®’16

CADatacom®/ADReportUtilizationandInformationGatheringforSupportDaleRussell,DirectorSoftwareEngineeringandProductOwnerCATechnologies

MFX97S

MAINFRAMEANDWORKLOADAUTOMATION

2 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD

©2016CA.Allrightsreserved.Alltrademarksreferencedhereinbelongtotheirrespectivecompanies.

Thecontentprovidedinthis CAWorld2016presentationisintendedforinformationalpurposesonlyanddoesnotformanytypeofwarranty. The informationprovidedbyaCApartnerand/orCAcustomerhasnotbeenreviewedforaccuracybyCA.

ForInformationalPurposesOnlyTermsofthisPresentation


Abstract

CometothissessiontolearnwhatinformationshouldbegatheredbyaCADatacom®/ADwhencallingCAsupport.

ThesessioncoversthebasicsoftheCADatacom®/ADrepositoryandhowtousethebuilt-inutilitiestogeneratekeysystemreports.

CADatacom®/ADisaspecialpackagingofCADatacom®productsthatprovidesahighperformancedatarepositoryforCAmainframeproductssuchasCAWorkloadAutomationRestartOptionforz/OSSchedulersandCAWorkloadAutomationCA7®Edition.

DaleRussell

CATechnologiesDirectorSoftwareEngineeringandProductOwner


Agenda

WHATARETHEMAINCOMPONENTSOFANDADREPOSITORY?

WHATISDBUTLTY?

WHATREPORTSSHOULDIGENERATE?

WHATOTHERREPORTINGCAPABILITIESAREAVAILABLEINAD?

GATHERINGDOCUMENTATIONBEFORECALLINGSUPPORT

1

2

3

4

5

SUMMARY6


TheMainComponentsoftheADRepository

§ Multiple-UserFacility(MUF)– Singleaddressspaceusedtomanagealluserdatarequests– Doesmostofthesystemrequests– Executes“online”portionofcertainutilities

§ Server(optional)– Oneormoreaddressspacesusedtomanagedatarequestscomingin

fromdistributedenvironments– SupportsODBC/JDBC– UtilizesTCP/IPorCACCIforcommunications

KeyComponents– AddressSpaces


TheMainComponentsoftheADRepository(Cont’d)

§ CICS– OneormoreCICSaddressspacesusedtoexecuteCICStransactions

thatmakedatarequeststotheMUF

§ Batch– Oneormorebatchaddressspacesusedtoexecute

§ VariousutilitiesusedtomanagetheADenvironment§ UserprogramsaccessingthedatamanagedbytheMUF

KeyComponents– AddressSpace(s)



§ CXX(Catalog)providesadirectoryofalldataintherepository– SimilartotheVSAMmastercatalogortheDB2catalogtables

§ LXX(Logfile)isthatactivetransactionlog– Storesdatarowchangesforusertablesusedfordatarecovery– StoressystemstateinformationusedtorestartafailedMUF

§ RXX(RecoveryFile)isthepermanenttransactionlog– Storestransactionlogrecordsthathavebeencommittedandspilled

(moved)fromtheLXX

KeyComponents– ControlDatasets



§ FXX(ForceArea)usedtospeedrestartprocessing– Trackslongrunning“uncommitted”transactions– OnlyusedduringawarmrestartafteraMUFabend

§ PXX(PrintandDiagnosticsArea)usedfordiagnostics– Containsinformationthatcouldbeutilizedfortuningordiagnosing

issuesintheMUF§ Performancemetrics§ DumpsofkeyMUFmemoryduringfailedrequests§ DumpsofMUFmemoryduringaMUF

KeyComponents– ControlDatasets



§ Datadictionary(DD0002)providesmetadatamanagement– AlldatabaseandtablesmustbedefinedtoDDbeforetheycanbeused– UsedtopopulateinformationintotheCXXviathecatalogfunction– UsedbySQLandotherrequeststhatutilizemetadata

§ DataDefinitionDirectory(DDD0015)providesextendedmetadatamanagementforSQLaccess– HoldsSQLmetadataextractedfromtheDDduringtheCXXcatalog– HoldsSQLmetadatacreatedduringprogramcompiles(PLANs)and

selectedDDLoperationssuchasdefiningintegrities(CONSTRAINTs)

KeyComponents– ControlDatabases



§ SQLDefault(SQL0016)storestablescreatedbySQLDDL– UsedwhenSQLDDLcommandscreatetableswithoutspecifyingana

dataareatoholdthetable

§ SQLTTM(TTM0017)usedtobuildinterimtemporarytables– UsedwhenSQLDMLcommandsgenerateasubsetofdatathatmust

beheldforashortperiodoftimewhilethequeryisprocessed




§ CBS(CBS0006)workareautilizedtoprocessSELcommands– SELxxcommandscanrequestdatabasedoncontentandnotkeyvalue– PrimarydataextractioncommandsforSQLrequests

§ CBSHistorical(Heur1006)storesinformationonpreviouslyexecutedSELcommands– Providesrun-timeoptimizationofrepeatedSELxxcommands

§ DynamicSystemTables(DST1000)– virtualdatabase– Provideskeymetricsfortuninganddiagnostics




§ Additionaldatabases-– NotessentialtotheexecutionofADrepository– DefinedsothatthecanbeactivatedifneededbytheADuser

§ HR0001/OE0010– sampledatabasesusedduringIVP§ DQ0003– housesCADataqueryproducttables§ PRM0004/ACCT0005– optionalaccountinganddiagnosticcapabilities§ DST1000– virtualdatabaseusedtosupporttuninganddiagnostics§ AutostatusSTA1018– optionaldatabasefordiagnosticcapabilities§ AutocollectSNP1019/DEL1020– optionaldatabasesfortuning



TheMainComponentsoftheADRepository(Cont’d)KeyComponents– Schematic

zOSLPAR

MUFAddressspace• Start-upparameters• Executingcode• Sharedmemory(buffers)• 31bitdataspacesattachedasneeded

ServerAddressSpace(s)• Start-upparameters• Executingcode• Sharedmemory• TCP/IPorCCIconnectivity

BatchAddressSpace(s)

• Databaseutilities• Userprograms

CICSAddressSpace(s)• Databasetransactions• Usertransactions

DatabasesubsystemandPCCallsinstalledduringCAS9(CACommonServices)initiation

CXX

LXX

FXX

PXX

RXX

DD0002

DDD0015

SQL0016

TTM0017

CBS0006

HEUR1006

DST1000

STA1018

SNP1019

DEL1020

PRM0004

ACCT0005

HR0001

OE0010

DQ0003


TheMainDatabaseUtility- DBUTLTY

§ INIT– initializedatasetsanddatabasesforusebyAD

§ LOAD– loaddatatocontroldatasetsanddatabases

§ BACKUP– createbackupsofalldatasetsanddatabases

§ REPORT- providesreportsfromcontroldatasets

§ RECOVER– rebuilddatabasefrombackupplusrecoveryfiles

§ Other– variousfunctionalitythatisusedtomanagetheADenvironment

KeyFunctions


DBUTLTYReports

§ CXXreport– Dumpsthecatalogedinformationforoneormoredatabases

§ Physicalmetadatasuchasrowlength,keydefinitions,etc.§ Contentinformationsuchasdatasetnames,size,blocksin-use,rows,etc.§ Statusinformationsuchastableloaded,SQLconstraintin-place,etc.

– Usedtodeterminethestatusandcontentsofdatabasesintheenvironment

– Variousreportstypesavailable

KeyReports


CXXReportFullReport- REPORTAREA=CXX,DBID=400

Databaseinfo

Indexinfo


CXXReport(Cont’d)FullReport– OnepagePerLogicalTable(AreaInfoRepeatedOnceforEachTableinArea)

Table Area

Keys

Elements


CXXReportTypeA- REPORTAREA=CXX,DBID=400,TYPE=A

Spaceinfo


DBUTLTYReports

§ PXXreport– DumpsthecaptureddiagnosticsfromtheMUF

§ DUMPS=FULLprintsalldumpsinthePXX(useafterMUFabend)§ DUMPS=REQUESTprintsonlyrequestfailures

– RunonlyifrequestedbyCAsupport

§ DUMPS=TRACEprintsonlyoutputfromtracesthathavebeenenabled– RunonlyifrequestedbyCAsupportraceoutputfromenabledtraces

– Printsprocessingstatistics/metricsfromspecificpointsintime§ JOBSTAT=DETAIL/DETAILX/SUMMARY– metricsaftereachjobcompletes§ SYSSTAT=DETAIL/DETAILX/SUMMARY– metricsaftereachcloseandcurrent

KeyReports


PXXReport- DUMPSPXXReport- REPORTAREA=PXX,DUMPS=FULL

AfterMUFabends.

ProvidetoCAsupport

forprocessing.


PXXReport- StatisticsPXXReport- REPORTAREA=PXX,SYSSTAT=SUMMARY

AtanypointtogetcurrentMUF

processinginformation.


ReplacingthePXXReportsWithStandardJESOutput

§ UsingSYSOUTforsavingdiagnosticandtuninginformation– SYSOUTparameterintheMUFStartupOptions(AXDATIN1)

§ AllowsyoutospecifynewoutputprocessingfordiagnosticsandtracinginformationthatwouldotherwiseberoutedtotheStatisticsandDiagnosticsArea(PXX)

§ CLASS– TheJESclasswhichisallocatedSYSOUTdatasetwhenclosed/deallocated

§ xM– ThenumberoflinesofoutputbeforethisDDisclosedandreopened

UsingSYSOUTforPXXData


ReplacingthePXXReportsWithStandardJESOutput(Cont’d)UsingSYSOUTforPXXdata

SYSOUTdatasetscontaincurrent

information.

• CanbeviewedlikeanySYSOUTdataset• Assignedclassdeterminesiftheywillremainafterjobends• Providesimprovedaccesstogenerateddumps,traces,etc.whileMUFisup


DBUTLTYReports

§ AUTOINFOReport– Buildsaformattedreportofallperformancemetrics– StandardtoolforDatacomtuning– OptionallyabilitytogeneratemetricstoaQSAMfileforparsinginto

EXCEL

KeyReports


DBUTLTYReportsAUTOINFODDNAME=DSVOUT

OndemandwhileMUFisUP.

Provides18differenttablesofperformanceinformation.


Whatotherreportcapabilitiesareavailable?

§ MUFEOJReports– SYSPRINTwillhaveasubsetoftheperformancemetricsdiscussedsofar

§ DynamicSystemTables– setofdatabasetablesthatallowstheusertobuildhisonlyperformancemetricqueries

§ DBSQLPR– batchfacilitythatallowstheusertoexecutead-hocSQLqueries– WorksreallywellwhenusedinconjunctionwithDynamicSystem

Tables


DynamicSystemTables

§ CXXinformation– themajorityoftheinformationintheCXX

§ MUFinformation– themajorityofperformancemetrics,start-upoptionsandmuchmore

§ SQLusageinformation– informationontheSQLDDLdefinitionssuchasconstraintsandviews,currentexecutingSQLqueries,SQLtaskinformation

SeetheSystemsTableReferenceGuideforaFullListofAvailableData


Ad-hocDSTReportsUsingBatchDBSQLPR

DBSQLPRallowsuserstodoad-hocSQLqueriesagainsttables.

WorksgreattopullinformationfromDynamicSystemtables.

InformationcanevenbeenoutputinastandardCSVformatforloadingto

spreadsheet.

WhattableshavebeencreatedusingtheSQL

defaultdatabase0016?


GatheringDocumentationBeforeCallingSupport

§ IfMUFcrashed– MUFaddressspacedump(SVCDUMPifpossible)– MUFbatchjoborstartedtaskoutput– MUFJESLOG– DBUTLTYPXXDUMPS=FULLreport

§ IfMUFdidnotcrash,butperformanceisbad– IssueconsolecommandCOMMSTATUStoMUFseveraltimes– MUFbatchjoborstartedtaskoutput– MUFJESLOG– DBUTLTYAUTOINFOreport


Summary

§ GettingfamiliarwithDBUTLTYreportswillincreaseyourabilitytounderstandtheADenvironment

§ SettingupstandardDBSQLPRjobstoqueryDynamicSystemTableswillhelptoquicklylookforinformation

§ Havingachecklistofwhattogatherintheeventofaproblemwillreducethetimeittakestoresolveanissue


RecommendedSessionsSESSION# TITLE DATE/TIME

MFX92S StrategyandVisionforCADatacomandCAIdeal™ 11/16/2016at12:45pm

MFX93S What’snewinCADatacom 11/16/2016at1:45pm

MFX94S ReducingTCOwithDatacomCompression(Presspack) 11/16/2016at3:00pm

MFX95SA ModernizingtheCADatacomdata – SQLAccessPartI 11/16/2016at3:45pm

MFX95SB ModernizingtheCADatacomdata – SQLAccessPartII 11/16/2016at4:30pm

MFX96S CADatacom/ADInstallation/UpgradeandMaintenance 11/17/2016at12:45pm

MFX97S CADatacom/ADReportUtilization,andinformationgatherforSupport 11/17/2016at1:45pm

MFX98SUsingCASYSVIEW®tomonitorandmeasureyourCADatacomenvironment– ADandDB

11/17/2016at3:00pm

MFX99S BirdsofaFeather/StumptheTechie! 11/17/2016at3:45pm


Questions?


Stayconnectedatcommunities.ca.com

Thankyou.

ca datacom®/ad report utilization, and information gather for support

Technology