World®’16
IntroductiontoCADatacomKeyConceptsandFacilities- PartIIDaleRussellDirectorSoftwareEngineeringandProductOwnerCATechnologies
MAINFRAMEANDWORKLOADAUTOMATION
MFX68EB
2 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Abstract
Thisisamulti-partsessiontargetedtowardsthenewCADatacomDBAorsystemsprogrammer.ThesessioncoversthekeyconceptsandfacilitiesforimplementingandmanagingtheCADatacomenvironment.DirectorSoftware
EngineeringandProductOwner
CATechnologies
DaleRussell
3 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module5:DBUTLTY
4 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
DEFINETHEPURPOSEOFDBUTLTY
PERFORMIMPORTANTDBUTLTY TASKS
GENERATEDBUTLTY REPORTS
1
2
3
5 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBUTLTY
§ Whatwe’lltalkabout– WhatDBUTLTYis– Reviewofmajorfunctions– MasterList(DBMSTLST)
6 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBUTLTY
§ Batchprogram
§ Performsallutilityfunctionsfordatabasesandsystemareas
§ Keyworddriven,notpositional
§ Statementscanbeexecutedindividuallyoringroups
§ CADatacom/DBmessagesandreturncodesareissuedforanyfailure/error
Whatisit?
7 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBUTLTY
§ StandardconditioncodesaregeneratedforeachDBUTLTYstep
§ Statementsareechoedalongwithresults
§ STATUScommandavailablethroughconsole– monitorsprogressoflong-runningfunctions
Whatisit?
8 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MajorFunctions
§ Systemareamaintenance
§ CXXDatabasedefinitionmaintenance
§ Multi-UserControl
§ Datahandling
9 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MajorFunctions
§ Reporting
§ Recovery
§ Accounting
§ Errorhandling
§ Resourcemeasurementandmonitoring
Continued
10 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
SystemAreaMaintenance
§ INIT– AREA=CXX,CXXNAME=name,DATACOM=DB/AD– AREA=LXX,BLKSIZE=32760,VARIABLE=YES/NO,TSN=nnnnnnnnn– AREA=FXX,BLKSIZE=32760,TASKS=1-9999
§ RESET– AREA=CXX,DBID=nnnn,REPLY=NO/YES– AREA=LXX (onlytobeusedonveryrareorspecialoccasions!!!!!)
11 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
SystemAreaMaintenance
§ BACKUP– AREA=CXX,DDNAME=outdd– AREA=CXX,DDNAME=outdd,DBID=nnnn
§ LOAD– AREA=CXX,DDNAME=indd– AREA=CXX,DDNAME=indd,DBID=nnnn,NEWDBID=nnnn– AREA=CXX,DDNAME=indd,DBID=nnnn
Continued
12 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CXXDatabaseDefinitionMaintenance
§ CXXMAINT– OPTION=ALTER,CBSUSE=YES/NO,DBID=nnnn,KEYNAME=keynm,
TABLE=ttt– OPTION=ALTER,DSN=new.dataset.name,DBID=nnnn,AREA=aaa– OPTION=ALTER,DSOP=0-5,DBID=nnnn,AREA=aaa
§ ThefollowingwereperformedbytheVersion14.0upgrade– OPTION=ALTER,OPTION2=Y_DATAFS– OPTION=ALTER,OPTION2=Y_DATAHU– OPTION=ALTER,OPTION2=Y_AREAEV– OPTION=ALTER,CXXENQ=SYSPLEX
13 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CXXDatabaseDefinitionMaintenance
§ CXXMAINTDDPROD,DDNAME=ddcfbld.output.dataset,NEWDBID=nnnn
Note:UsemayberestrictedtoDATA-DICTandDDD-DATABASEinfutureversions,soitisstronglyrecommendedthatitsuseforanyotherdatabasebediscontinued.TheDDUPDATECATALOG,DDOLCATALOGorDDCFBLD-CXXCATALOGshouldbeusedinstead.
Continued
14 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CXXDatabaseDefinitionMaintenance
§ CXXMAINTOPTION=DELETE,DBID=nnnn,TABLE=ttt
§ CXXMAINTOPTION=PURGE,DBID=nnnn
§ LINKDBID=nnnn
§ REMOVEAREA=IXX,DBID=nnnn,KEYID=nnn
Continued
15 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Multi-UserControl
§ ACCESS– STATUS=OFF/READ/UTLTY/MAINT/NOMAINT/WRITE,– USERS=FAIL/WAIT/IGNORE,DBID=nnnn,AREA=aaa
§ COMM– OPTION=CLOSE,DBID=nnnn,AREA=aaa,IGN68=YES/NO– OPTION=REQABORT,REQSEQNO=nnnnnnn,IGN68=YES/NO
16 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Multi-UserControl
§ COMM– OPTION=ALTER,RCERROR=eeeii,BUFFERS=YES/NO,MASTERL=YES/NO– OPTION=ALTER,DUMPS=type,JOBNAME=jobname,TERMID=terminal
§ typeEXAMPLES:ARRAY/GLOBALA/PLAN/LUW/TASK/URT– OPTION=ALTER,TRACE=class,JOBNAME=jobname,TERMID=terminal
§ classEXAMPLES:TRACEERR/TRACERAT/TRACEPLAN– SeeDBUTLTYReferenceGuideforcompletelist
Continued
17 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Multi-UserControl
§ COMMOPTION=– EOJ,EOJOFF,EOJKEEP,EOJFREE– CLRPXX– NEWRXX– SNAP,SNAPCSA,SNAPSVC– STATS– STATUS– SYSTEMDBID_DELETE
Continued
18 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Multi-UserControl
§ COMMOPTION=CONSOLE,OPTION2=‘console/console-likecommand’– ‘COVERED_ADD237,A01,1G,F,75’– ‘COVERED_DELETE237,A01’– ‘DYNAMIC_EXTEND1440,XYZ,300,CYL’– ‘NEWCOPYmodule-name’– ‘QUIESCEOFF/TXN/REQ’– ‘VIRTUAL_ADD101,A25,200M’
§ FLEXPOOL– OPTION=ADD/DELETE,AREA=DATA/DATA2/DXX/IXX,NUMBER=nnnn
Continued
19 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ Initializingindexanddataareas
§ Loadingdataareas
§ Extractinginformationfromdataareas
§ Reorganizinglargedataareas
§ Maintainingindexand/ordataareas
20 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ INIT– AREA=IXX,DBID=nnnn,VERIFY=NO/YES,MULTUSE=NO/YES,BLKSIZE=nnn
nn,OLDEP=YES/NO– AREA=aaa,DBID=nnnn,MULTUSE=NO/YES,VERIFY=NO/YES– IXXAREA=***,DBID=nnnn,VERIFY=NO/YES,MULTUSE=NO/YES,– BLKSIZE=nnnnn,OLDEP=YES/NO– IXXAREA=Inn,DBID=nnnn,VERIFY=NO/YES,MULTUSE=NO/YES,– BLKSIZE=nnnnn,OLDEP=YES/NO– NOTE:IfaDDstatementispresentintheJCL,thedatasetnameonthe
DDstatementwillreplacethedatasetnameintheCXX
Continued
21 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
BlocksformattedtoCADatacom/DBrequirementsFirstblockupdateswithcontrolinformation
INITdiagram
22 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ LOAD(databaselevel)– DBID=nnnn,DDNAME=indd,FORMAT=backup/none,– SORT=nnnnnnn,OPTIMIZE=NO/YES,KBYTES=nnn,– INDEX=YES/NO,CLUSTER=SPARSE/DENSE,– LOADID=NO/YES,LOADDUPS=NO/YES,REMAP=fffttt,– OPTION1=NOF/’(I)’/’(U)’,RESETRCE=YES/NO,– SLACK=nnnn,SORTWK=0-99,STATS=YES/NO– NOTE:‘INITAREA=IXX’REQUIREDAHEADOFFULLDATABASELOADS
Continued
23 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ LOAD(arealevel)– DBID=nnnn,AREA=aaa,TABLE=ttt,DDNAME=indd,– FORMAT=backup/extract/var/none,SORT=nnnnnnn,– OPTIMIZE=NO/YES,KBYTES=nnn,INDEX=YES/NO,– URI=YES/NO,CLUSTER=SPARSE/DENSE,– LOADID=NO/YES,LOADDUPS=NO/YES,REMAP=fffttt,– OPTION1=NOF/’(I)’/’(U)’,RESETRCE=YES/NO,– SLACK=nnnn,SORTWK=0-99,STATS=YES/NO,– MISMATCH=IGNORE
Continued
24 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ MASSADD– DBID=nnnn,DDNAME=indd,TABLE=aaa,MULTUSE=NO/YES,
STARTAFT=nnnnnnn
§ REPLACE– DBID=nnnn,TABLE=ttt,DDNAME=indd,MULTUSE=NO/YES,
SORT=nnnnnnn,LOADPTN=SKIP/FAIL,SLACK=nnnn
Continued
25 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandlingLOADdiagram
26 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ RETIX(databaselevel)– DBID=nnnn,SORT=nnnnnnn,OPTIMIZE=NO/YES,
OPTION1=NOF/’(I)’/’(U)’,VERIFY=NO/YES,SORTWK=nn
§ RETIX(arealevel)– DBID=nnnn,AREA=aaa,SORT=nnnnnnn,OPTIMIZE=NO/YES,
OPTION1=NOF/’(I)’/’(U)’,VERIFY=NO/YES,SORTWK=nn,MULTUSE=NO/YES,MINIMAL=NO/YES
Continued
27 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandlingRETIXdiagram
28 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ EXTEND– DBID=nnnn,AREA=aaa,MULTUSE=NO/YES– DBID=nnnn,AREA=IXX,MULTUSE=NO/YES– DBID=nnnn,IXXAREA=aaa,MULTUSE=NO/YES
Continued
29 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ BACKUP– DBID=nnnn,SEQ=native/physical,DDNAME=outdd,RECID=NO/YES,
CMPRS=NO/YES,EXCLUDE=ttt,INCLUDE=ttt
– DBID=nnnn,AREA=aaa,SEQ=NATIVE,DDNAME=outdd,RECID=NO/YES,CMPRS=YES/NO,MULTUSE=NO/YES,FIRSTKEY=key-value,LASTKEY=key-value,EXCLUDE=ttt,INCLUDE=ttt
– DBID=nnnn,AREA=aaa,SEQ=PHYSICAL,DDNAME=outdd,RECID=NO/YES,CMPRS=YES/NO,MULTUSE=NO/YES,FIRSTKEY=key-value,LASTKEY=key-value,UPDATE=NO/YES,EXCLUDE=ttt,INCLUDE=ttt
Continued
30 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ EXTRACT– DBID=nnnn,AREA=aaa,TABLE=ttt,SEQ=NATIVE,DDNAME=outdd,
MULTUSE=NO/YES,SLACK=nnn,SEQBUFS=0-256,BLKSIZE=nnnnn– DBID=nnnn,AREA=aaa,TABLE=ttt,SEQ=PHYSICAL,DDNAME=outdd,
UPDATE=NO/YES,SLACK=nnn,SEQBUFS=0-256,BLKSIZE=nnnnn
§ LOAD– OPTION=MOVER,DBID=nnn,AREA=aaa
§ UNLOCK– OPTION=MOVER,DBID=nnn,AREA=aaa
Continued
31 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ EXTBKUP– FILEOUTDDNAME=outdd,TABLE=ttt– EXTBKUPDDNAME=indd– NOTE:BothfunctionsmustbepresentinthesameDBUTLTYexecution
Continued
32 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ Examples– BACKUPDBID=001,DDNAME=DB001BK,SEQ=NATIVE– BACKUPDBID=001,DDNAME=DB001BK,SEQ=PHYSICAL,RECID=YES– BACKUPDBID=001,DDNAME=DB001BK,SEQ=PHY,EXCLUDE=PMF– BACKUPDBID=001,DDNAME=DB001BK,SEQ=PHY,INCLUDE=PAY,
MULTUSE=YES,CMPRS=NO
Continued
33 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ Examples(contd)– EXTRACTDBID=2009,DDNAME=EXTOUT,SEQ=NATIVE,AREA=AR2,
TABLE=MNT– EXTRACTDBID=001,DDNAME=PMFOUT,SEQ=PHY,AREA=PMF,
TABLE=PMF,MULTUSE=YES– FILEOUTDDNAME=PMFOUT,TABLE=PMF– EXTBKUPDDNAME=DB001BK
Continued
34 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandlingBACKUPdiagram
35 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ DEFRAG– DBID=nnnn– DBID=nnnn,KEYID=kkk,PERCENT=nn,FIRSTKEY=key-value,
LASTKEY=key-value
§ VERINDEX– DBID=nnnn,OPTION=DATAINDEX/INDEXDATA,TABLE=ttt,
KEYNAME=ALL/keynm
§ OLREORG– DBID=nnnn,TABLE=ttt,REFGROUP=0-100,NUMBER=nnnnn,– FIRSTKEY=key-value,LASTKEY=key-value
Continued
36 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DataHandling
§ REORG– OPTION2=BACKUPONLY,AREA=aaa,DBID=nnnn,INNUM=n,
DDNAME=outdd,MULTUSE=NO/YES,CYCLE=n,SEQBUFS=0-256– OPTION2=LOADONLY,AREA=aaa,DBID=nnnn,INNUM=n,
DDNAME=outdd,MULTUSE=NO/YES,FORMAT=BACKUP/EXTRACT,TABLE=ttt,KBYTES=nnn,CYCLE=n,SEQBUFS=0256,SLACK=nnn,RESETRCE=NO/YES
– OPTION2=BACKUPLOAD,AREA=aaa,DBID=nnnn,INNUM=n,DDNAME=outdd,MULTUSE=NO/YES,FORMAT=BACKUP/EXTRACT,TABLE=ttt,KBYTES=nnn,CYCLE=n,SEQBUFS=0-256,SLACK=nnn,RESETRCE=NO/YES
Continued
37 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting
– AREA=CXX,TYPE=(A,B,I)– AREA=IXX,TYPE=(A,B,D,E,orG)(MUFmustbeup)– AREA=LXX– AREA=RXX– AREA=PXX– DEVICE=3390– MEMORY=(MVS,CForDS)– TYPE=H(historyreport,MUFmustbeup)– TYPE=DATANE(MUFmustbeup)– TYPE=U(debuggingreport)
38 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting
§ Reporttypes– TYPE=A(spaceutilization)– TYPE=B(key,element,fieldinformationsuppressed)– TYPE=I(catalogimpact,MUFmustbeup)
§ Reportscopereducedbyusing‘DBID=‘keyword– AREA=CXX,DBID=001– AREA=CXX,DBID=101,DBID=109,DBID=123,DBID=75– AREA=CXX,DBID=2-15
REPORTAREA=CXX
39 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
DATA AREA SPACE UTILIZATION REPORT
AREA DATA TOTAL TOTAL TOTAL USED PERCENT PARTIALLY AREA REUSE
NAME BASE TRACKS RECORDS BLOCKS BLOCKS FULL MAX EMPTY BLKS OPTION
CXX 100 N/A 1,200 631 52 52 N/A N/A
IXX 1 11 N/A 132 15 11 11 N/A N/A
DEM 1 5 17 165 12 7 7 10 CLUSTERING
PAY 1 15 200 495 13 2 2 0 NO RECLAMATION
PMF 1 20 200 660 17 2 2 0 NO RECLAMATION
IXX 2 300 N/A 3,600 942 26 26 N/A N/A
DD1 2 2,700 19,209 2,400 1,114 3 3 0 RANDOM
TYPE=AReport
40 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
DATABASEINFORMATION
DBCRBASREQUIREMENTSFORTHISBASE- 1,840
DBCRKELREQUIREMENTSFORTHISBASE- 1,624
NUMBEROFAREASINTHISBASE- 3
NUMBEROFTABLESINTHISBASE- 6
NUMBEROFKEYSINTHISBASE- 11
NUMBEROFELEMENTSINTHISBASE- 21
LASTOPENED- DATE--7/11/2012,TIME-09.25.26
LASTRESTARTED- DATE--7/09/2012,TIME-13.55.06
LASTMAINTAINED- DATE--4/09/2012,TIME-14.03.56
TYPE=BReport– Page1
41 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
REPLICATEDBASE- NO BASEFORMAT- 2
PARTITIONEDBASE- NO
UPDATEUSERS- 0
READONLYUSERS- 0
OCCURRENCE- HUMAN-RESOURCEP001
SQLSECURITY- NO
TYPE=BReport– Page1continued
42 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
INDEXINFORMATION- IXX
DEVICETYPE - 3390 DYNAMICEXTEND- NO
BLOCKLENGTH - 4,096 DYN.EXT.TRACKS- 0
LEVELS- 1 OLDEP- YESBLOCKS/TRACK - 12 CXXMAINTLINK- YES
BLOCKSINUSE - 15
BLOCKSUNUSED- 117
TOTALBLOCKS - 132
TOTALTRACKS - 11PERCENTFULL - 11
DATASETNAME- DCMLV2.DB12.IXX001 INDEXDTF/DDNAME- IXX001
VOLUMES- DCMSP1
TYPE=BReport– Page2
43 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
TABLENAME- PNC AREANAME- DEM
OCCURRENCE- DEMO-DEM-PNCP001 OCCURRENCE- DEMO-DEMP001
TABLEID- 6 AREASQLNAME- DEMO_DEM
RECORDLENGTH- 14/26 BLOCKLENGTH- 1,024 SLACK- 0RECORDSINTABLE- 5 OVERFLOWSINAREA- 0
LENGTHOFKEY/ELEMENTS- 176 BLOCKSINUSE- 12
NUMBEROFKEYS- 1BLOCKSUNUSED- 153
NUMBEROFELEMENTS- 3 TOTALBLOCKS- 165 CXXMAINTLINK- YES
CHANGEMASTERKEY- NO TOTALTRACKS- 5 DYNAMICEXTEND- YESDUPLICATEMASTERKEY- NO PERCENTFULL- 7 DYN.EXT.TRACKS - 0
TYPE=BReport– Page3
44 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
RECOVER- YES DEVICETYPE- 3390
LOGGING- YES BLOCKS/TRACK- 33
PIPELINE- YES DSOPMODE- BASIC
DBCOMPRESSION- NO TABLELOADED- YES,DATE--7/09/2012,TIME-14.01.53USERCOMPRESSION- NO INDEXLOADED- YES
CLUSTERKEYID- 0 DATADICTIONARYBASE- 2
CLUSTERKEYLENGTH- 3 DATABASEIDCHANGE- NO
DEFINITIONPOSTEDVIA- LOADFROMBACKUP
AUTHID- SYSUSR SQL-INTENT- YTABLESQLNAME- DEMO_DEM_PNC UNIQUEROWIDENTIFIERS(URI)- 17
TYPE=BReport– Page3continued
45 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– CXX(contd)
IMPACTREPORT
BASE AREA TABLE ID DISPOSITION
1 DEM PNC 006 LOADED
PNM005 LOADEDPOH 003 LOADED
POL 004 LOADED
PAY PAY 001 LOADED
PMF PMF 002 LOADED
TYPE=IReport
46 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– IXX
REPORTAREA=IXX,DBID=n,TYPE=A(tablenamesequence)AREA=IXX,DBID=n,TYPE=B(keyid sequence)AREA=IXX,DBID=n,TYPE=D,KEYID=nnn (dumpofDXX)AREA=IXX,DBID=n,TYPE=E,KEYID=nnn (dumpofIXX)AREA=IXX,DBID=n,TYPE=G(uniquekeyvaluecount)AREA=IXXAREA,………(multi-datasetindexreports)
Reminder:MUFmustbeup
Types
47 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– IXX
INDEX POPULATIONREPORT- BYTABLETABLE KEYID KEYNAME RECORDS COMMENTSPAY 001 EMPNO 200
PMF 001 EMPNO 200002 STZIP 200
PNC 016 PNDAT 5PNM 015 PN 3POH 011 POLI 5
012 VENDR 5013 POHTV 5014 LATE 2
REPORTAREA=IXX,TYPE=AReport
48 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– IXX
00000001000000C3C161C4C1E3C1C3D6D461C4C261C9E7E7F0F0F0F0F140404040404040404040*CA/DATACOM/DB/IXX00001*00002000-SAME-00004000000000A00E0C01100000010000000000000000000000000000000000000000*...............................................*00006000000000000000840000000F0000000000000000000000000000000000000000*.......d......................................*000080000000000000000000000000000000000000000000000000C4C2F1F1C3E7E740*...............................DB11CXX *
00000002000000FF01000000000000000000000F6F0000000D002C003E004D005C000D00000000*.............?.........(.*..................*0000200000000000000000000000000006000000030001F0F0F1F50200000000040002*....................0015...................*0000400000000500020101000000060B000200000007000C0101000000080D00020000*...............................................*0000600009000E01010000000A0F01010000000B1000020000000C038F00020000000D*...............................................*
REPORTAREA=IXX,KEYID=nnn,TYPE=DandEReport
49 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– IXX
INDEXPOPULATIONREPORT- BYTABLETOTALUNIQUE
TABLEKEYIDKEYNAME RECORDS RECORDS DATE/TIMEPAY001EMPNO200 10/07/2014,14.40.28
200PMF001EMPNO200 10/07/2014,14.40.29
200002STZIP 200 10/07/2014,14.40.29
68
REPORTAREA=IXX,TYPE=GReport
50 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– LXX
LOGFILE(LXX)OUTPUT
LOGFILEOPEN- YESLOGFILESPILLING- NOLOGFILESPILLPENDING- NOMASTERLISTRCVOPTION- NEVERLOGFILEHIGHESTTRANSACTIONSEQUENCENUMBER- 00001BE3CYCLESTARTDATE- /00/0000CYCLESTARTTIME- .00.00
REPORTAREA=LXXReport
51 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– LXX
FIRSTBLOCKUSEDTHISCYCLE- 00021A00CURRENTLOGBLOCK- 00007B01PHYSICALBLOCKSUSEDTHISCYCLE- 184RESTARTFORWARDSCANBLOCK- 00007B00LOGPENDINGPARAMETER- 100LOGFILEBLOCKSIZE- 27,998PHYSICALBLOCKSIZE- 27,998PHYSICALBLOCKSPERLOGICALBLOCK- 1LOGVARIABLE- NO
REPORTAREA=LXXReportcontinued
52 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– RXX
AREA=RXX,LOGPRINT=SUMMARY/DETAIL/DETAILXAREA=RXX,TSNPRINT=SUMMARY/DETAIL/DETAILX
Filterkeywords:BLOCK= DBID=nnnn JOBNAME=OPTION2= RANGEDT= RANGETSN=RECORDS= RUNUNIT= STARTAFT=TABLE= TSNPRINT= URINUM=
REPORTAREA=RXXReport
53 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– RXX
REQUESTSUMMARYREPORTCOMMANDTABLEDBIDAREAOCCURRENCESPERCENTCLOSE 44 0.0LOGDW 21 0.0MOVEROEVT161EVT7,030 32.1ADDIT C01781A01175 0.3DELET C01781A0172 0.1UPDAT C01781A01100 0.2ADDIT C02781A018,625 16.8DELET C02781A015,351 10.4MOVERU C02781A013 0.0UPDAT C02781A0127 0.0
REPORTAREA=RXX,LOGPRINT=SUMMARY
54 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– RXXcontinued
LOGPRINTDETAILREPORTCMDTBLDBIDURIBLOCKL#TSNJOBNAMER-UNITMPUSERIDAREAMONITORINFOINPUTRECORDFPRLXX
DATETIMECLOCKSEC.USERMOVETOLRIDPREVLRSNLBSNTASKSTATUSRECLDATA
DELETC02781000050ED0000280C0000001BD3DBAJDEL31,365CATBPPRA01109/24/201208.59.08CA38271D7674D525JOHAL0100000000000002010002575A00000923000002581B01386C7C
DELETC02781000050EE0000280C0000001BD3DBAJDEL31,365CATBPPRA01209/24/201208.59.08CA38271D7677B925JOHAL0100000000000002020000020100000924000002581B01386C7C
DELETC02781000050EF0000280C0000001BD3DBAJDEL31,365CATBPPRA01309/24/201208.59.08CA38271D76799025JOHAL0100000000000002030000020200000925000002581B01386C7C
REPORTAREA=RXX,LOGPRINT=DETAIL
55 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– RXXcontinued
LOGPRINT DETAILX REPORT
CMD TBL DBID URI BLOCK L# TSN JOB NAME R-UNIT MP USER ID AREA MONITOR INFO INPUT RECORD FPR LXX
DATE TIME CLOCK SEC.USER MOVE TO LRID PREV LRSN LBSN TASK STATUS RECL DATA
DELET C02 781 000050ED 0000280C 00 00001BD3 DBAJDEL 31,365 CATBPPR A01 1
09/24/2012 08.59.08 CA38271D7674D525 JOHAL01 00000000 00000201 0002575A 00000923 00000258 1 B 016C7C
492000 00000138 CA38271D 7674D525 00000000 000000C4 00010001 010C0002 57000000 *.........N........D............*
492020 02570000 00000000 05700000 02011800 00000924 12085908 00050E65 00000000 *...............................*
492040 C4C5D3C5 E3C3F0F2 C1F0F100 00000054 030D0066 000050ED 00000000 00000000 *DELETC02A01....................*
492060 00D1D6C8 C1D3F0F1 4003C3C1 E3C2D7D7 D9400000 00000000 00000000 00000000 *.JOHAL01 .CATBPPR .............*
492080 00000000 C4C2C1D1 C4C5D340 0002575A 40404000 00000000 0000D3D6 C3C1D340 *....DBAJDEL ...! ......LOCAL *
4920A0 40400400 20730000 00001BD3 00001BD3 00000923 00023D00 0000280C 00000257 * .........L...L...............* 4920C0 00000258 00000000 00000000 00000000 00600066 00001BD2 000050ED C3F0F240 *................-.....K....C02 *
REPORTAREA=RXX,LOGPRINT=DETAIL
56 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– PXX– StronglyrecommendMUFstartupoptionSYSOUT– IfSYSOUTused,onlydatainPXXisMUFEOJreport– IfMUFstartupoptionPXXSTATEOJPRTused,EOJreportisalsowritten
toaSYSOUTdataset– PXXSUMMARYdataalsoinDSTtableswhileMUFup– DBUTLTYAUTOINFOSYPRINTalsocontainsthisinformation
REPORTAREA=PXXJOBSTAT=SUMMARY/DETAIL/DETAILXSYSSTAT=SUMMARY/DETAIL/DETAILXDUMPS=FULL/REQUEST/TRACE,RTNCODE=nnn
57 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– Memory
MEMORY=MVSReportOPERATINGSYSTEMz/OSV1.13PROCESSOR2817SYSTEMCA31CADATACOM/DBSUBSYSTEMISPRESENT
COMMONMEMORYUSAGE(NOTSVCORMUFSPECIFIC)ADDRESSSIZETEXT00C5CD6436SSCT'DB'ANDSMALLANCHOR3A5FB000384DBNSDBNBLARGEANCHOR3A2600002082DBESPPR12CROSSMEMORY00C39000632DBSSVPR12SUBSYSTEM
MUFNAMESTATUSRELJOBNAMEJOBIDCXXNAMESVCCOMMON31ENBL-MDHMSCOMMENTSAAACMU11DISABLEDUNKN.2310COMMON24=192BOL41MUFENABLED12MSMMUFJOB36409CAMSM239101761031104757DS=00044MUFBOL50MUFDISABLED12MSMMUFJOB47671CAMSM23910176DS=00028MUF
REPORTMEMORY=MVS/DS/CF
58 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– DataNativeEfficienty (DATANE)
DBID=nnnn,TABLE=ttt,RECORDS=nnnnn
ReportPart1:
Base:161****************************************************************************Directory:DB11CXX
TBLAREAKEYCMPUSERCOMPRESSIONRECLNRECORDSBLKSIZETRACKSTOTBLKSINUSEBLKSPARTBLKS
EVTEVT EVTKN 513103,5287,4762,50017,50012,5155,706
SCANMAXROWS/BLOCK14#ROWSREAD 98,593
REPORTTYPE=DATANE
59 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– DATANEcontinued
ReportPart2:*------- BLOCK -------* PBC 1429 MRB *-MAX ROW/BLK EFFICIENCY RATES WITH BUFFERS -*
GROUP ROWS BLOCKS MAX MIN AVG BLOCK EFF 2 4 8 12 16 20 24 28 32 48 64 96 128 256
READ W/DATA ROWS ROWS ROWS CHANGES % % % % % % % % % % % % % % %
1 20,000 4,288 14 1 5 13,365 11 13 14 15 16 17 19 21
2 20,000 4,216 14 1 5 16,714 9 17 18 19 20 21 22 23 24
3 20,000 4,110 14 1 5 14,265 10 17 18 19 20 21 22 23 24 25 26
4 20,000 2,783 14 1 7 7,217 20 33 34 36 37 38 39 42 44 45 46 47
5 20,000 2,578 14 1 8 6,067 24 37 38 41 42 43 46 48 49 51
6 3,528 411 14 1 9 789 32 54 57 60 61 62
____________________________________________________________________________________________
FULL TABLE
MRB 103,528 10,821 14 1 10 58,417 13 20 21 22 23 24 26 27 28 29 30
AMRB 103,528 10,821 14 1 10 58,417 19 30 31 33 34 35 38 39 41 42 44
REPORTTYPE=DATANE,DBID=nnnn,TABLE=ttt,RECORDS=nnnnn
60 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– DATANEcontinued
ReportPart3:*------- BLOCK -------* PBC 1429 MRB *-MAX ROW/BLK EFFICIENCY RATES WITH BUFFERS -*
GROUP ROWS BLOCKS MAX MIN AVG BLOCK EFF 2 4 8 12 16 20 24 28 32 48 64 96 128 256
READ W/DATA ROWS ROWS ROWS CHANGES % % % % % % % % % % % % % % %
1 20,000 1,429 14 8 14 1,429 100
2 20,000 1,430 14 2 14 1,429 100
3 20,000 1,429 14 10 14 1,428 100
4 20,000 1,430 14 4 14 1,429 100
5 20,000 1,429 14 10 14 1,428 100
6 3,528 253 14 2 14 252 100
____________________________________________________________________________________________
FULL TABLE
MRB 103,528 7,395 14 12 14 7,395 100
AMRB 103,528 7,395 14 12 14 7,395 100
REPORTTYPE=DATANE,DBID=nnnn,TABLE=ttt,RECORDS=nnnnn
61 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Reporting– DatasetIdentity
DATA SET IDENTITY INFORMATION DEVICE INIT DATE TIME CXX NAME
DIRECTORY CXX R12 LEVEL 01 DB 3390 20120921 103605 DB11CXX
000000 C3C160C4 C1E3C1C3 D6D461C4 C261C3E7 E7404040 40404040 40404040 40404040 *CA-DATACOM/DB/CXX *
000020 C4C2F1F1 C3E7E740 0005121C 110C0000 0002000F 00000000 00000000 0010C4C2 *DB11CXX ......................DB*
000040 0E0C1000 00000000 00000000 00000000 C4C2C1D1 C3E7E7D3 00000000 20120921 *................DBAJCXXL........*
000060 10360540 40404040 00000000 00000000 00000000 00000000 00000000 00000000 *... ........................*
000080 00000000 00000000 00000000 00000000 C4C2C1D1 F0F0F1D9 00000000 12103110 *................DBAJ001R........*
0000A0 41122040 40404040 00000000 00000000 0004B000 00027800 00000000 00000000 *... ........................*
0000C0 00000000 01000000 00000000 00000000 F8D48F77 EB5B1BD6 138F94A1 FC2F4143 *................8M...$.O..m.....*
0000E0 0AE10E9B F6CE4FD8 421B101C 00000000 00000000 00000000 00000000 00000000 *....6..Q........................*
000100 00-SAME-
000EE0 00000000 00000000 00000000 00000000 00000000 00000000 00000302 00017F02 *..............................".*
000F00 00027502 00027602 0001EB02 00027702 00000000 00000000 00000000 00000000 *................................*
000F20 00-SAME-
REPORTTYPE=U,DDNAME=indd
62 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Recovery
§ SPILL– MUFstartupoptionLOGRCVNOonly– JCLmustcontainanRXXDDstatement
§ SPILLOPT– SPILL=MIN/MAX,HISTORY=NO/YES-FAIL/YES-RC0/YES-RC4
§ RXXFIX– CYCLE=cccccccccc,DBID=nnnn,HISTORY=NO/YES-FAIL/YES-RC0/YES-RC4
63 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Recovery
§ RECBASE– DBID=nnnn,TABLE=ttt
§ RECJOB– JOBNAME=job-name,NODE=n,ORIGRUNU=rununit,DATE=mmddyy,
STIME=hhmmss,ETIME=hhmmss
§ RECOVERY– ForwardorBackward– OneormoreRECBASEandorRECJOBfunctionmustprecede
RECOVERYfunction
Continued
64 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Recovery
§ RECOVERYOPTION=FORWARD,MISMATCH=FAIL/IGNORE,INDEX=YES/NO,NUMBER=0-9999,UPDATE=YES/NO,MULTUSE=NO/YES,DBID=nnnn,AREA=aaa,REPORT=ALL/ERRORS,RECID=NO/YES,FORCE=NO/YES,RANGEDT=ccyymmddhhmmssccyymmddhhmmss
Continued
65 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Recovery
§ RECOVERYOPTION=BACKWARD,MISMATCH=FAIL/IGNORE,INDEX=YES/NO,NUMBER=0-9999,SORT=nnnnnnn,OPTION1=NOF/’(I)’/’(U)’,SORTWK=0-99,TASKID=nnnnn,REPORT=ALL/ERRORS,TERMID=tttt,UNIT=sysda,TSN=nnnnnnn,FORCE=NO/YES,RANGEDT=ccyymmddhhmmssccyymmddhhmmss
Continued
66 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Accounting
§ ACCTOPTION=EDIT– DATABASE=dd-entity-occ-name,DDOVER=version,STATUS=status– TABLE=dd-entity-occ-name,DDOVER=version,STATUS=status
§ ACCTOPTION=CATALOG– DATABASE=dd-entity-occ-name,DBID=4
67 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Accounting
§ ACCTOPTION=OPEN– TABLE=ALL/Ann
§ ACCTOPTION=CLOSE– TABLE=ALL/Ann
§ ACCTOPTION=SPILL– TABLE=ALL/Ann
Continued
68 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ErrorHandling
§ SETOPTION1=– ON-ERROR-CONTINUE– ON-ERROR-STOP– ON-ERROR-ABEND– ON-ERROR-RCn– ON-ERROR-REMOVE– SNAPALL– SNAPERR
§ Maybeenteredinanyorder§ EachsubsequentSETsupersedes/replacesprevious
69 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ResourceMeasurementandMonitoring
§ AUTOCOLLECTOPTION=SNAPSHOT– MUFNAME=muf-name,DBID=1019/nnnn
§ AUTOCOLLECTOPTION=DELTACRE– OPTION=DELTACRE,DBID=1020/nnnn
§ AUTOSTATUSMUFNAME=muf-name– DBID=1018/nnnn,REPEATS=3/0-64800,OUTTAG=cccccccccccccccc,SNAPEXCL=DURATION0/HEADER/NOTACTIVE/REPCONNECT/WARNMSG
70 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ResourceMeasurementandMonitoring
§ AUTOINFODDNAME=outdd,DELIMIT=;– CreatesbothaSYSOUTreportandadataset– ContainsMUFconfigurationinformation– ContainsMUFresourceusagesnapshot– RunafterMUFhasbeenupforanextendedperiod– HelpsCASupportunderstandinganenvironment’sconfiguration
andusage
Continued
71 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MiscellaneousFunctions
§ DBTEST§ EDIT§ SECURITYOPTION=RESET,USER=xxx
72 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBMSTLST
§ Assembledandlinkedduringinstallation§ Tailoredasneeded§ Limitednumberofparameters
73 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBMSTLSTParameters
§ CXXNO§ IXXNO
DXXNO§ DATANO§ DATALN§ SMFRTY(z/OS)
74 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ ExplainthepurposeofDBUTLTY§ PerformimportantDBUTLTYtasks§ GenerateDBUTILTYreports
75 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module6:RoutineOperations
76 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
NAMETHEMAJORROUTINEOPERATIONALTASKS
IDENTIFYAREASTOBACKUP
1
2
77 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RoutineOperationsConsiderations
§ InitiatingtheMulti-UserFacility(MUF)
§ DisplayingtheMUFstatus
§ StoppingtheMUF
§ Backups
§ Restores/Reorganizations
78 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
InitiatingtheMulti-UserFacility
§ JoborStartedTask
§ MUFStartupjobtypicallyhastwosteps– DBMUFPR– DBUTLTYREPORTAREA=PXX
§ DBUTLTYstepnotneededifMUFStartupOptionsSYSOUTandPXXSTATSEOJPRT arepresent
79 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DisplayingMUFStatus
§ MUFconsolecommands
§ DBUTLTYCOMMcommands
§ DynamicSystemTables
§ CASYSVIEWPerformanceManagement(z/OS)
80 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MUFConsoleCommands
§ Issuez/OS‘/f’(MODIFY)command§ STATUS
– DisplaysstatusofMUF,taskthreads,activejobsDB01311I- STATUSDB01327I- MULTI-USERAVAILABLE,TASKS- ATTACHED----12,AVAILABLE----2411/01/1211:31:02DB01328I- TIMEI/OJOBNAMER-UNITTASKCMD-DBID-TBLSEQSTATUSIDTSNDB01330I- DDDQC12596801NOTACTIVE12
§ STATSall/dbid/dbid-dbid– WritesMUFin-memorydatabasestatisticstotheCXX
81 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MUFConsoleCommands
§ REQABORT– CancelsaspecificMUFrequestbyrequestnumber
§ TSN_ABORT– CancelsaspecificMUFrequestbytransactionsequencenumber
§ TASK_ABORT– CancelsaspecificMUFrequestbytasknumber
§ Othercommandsavailable
Continued
82 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBUTLTYCOMMCommands
§ Samefunctionalityasconsolecommands§ ExecuteinbatchaspartofDBUTLTY§ OutputgoestoSYSPRINT§ COMMOPTION=CONSOLE,OPTION2=‘consolecommand’
83 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicSystemTables
§ TablesexistasvirtualSQLviews§ TableinformationextractedfromCADatacom/DBmemory§ TablesonlyaccessibleviaSQLSELECTsorCASYSVIEW
PerformanceManagementdisplaypanels§ FullMUF,CXX,PXX,LXX,SQLstatusinformationavailable§ Someareupdateable§ BeginninginVersion14.0,SQLWebConnectfacilityavailable
fornon-SQLlicensedsites
84 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CASYSVIEWPerformanceManagement(z/OS)
§ ProvidesanintegratedinterfaceformonitoringMUF
§ Commandscanbeissuedfromonlineorbatch(TSO)
§ RetrievesinformationfromCADatacom/DBDynamicSystemTables
§ UsesstandardAPIforcompatibilitywithfuturereleasesofCADatacom
85 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
StoppingtheMulti-UserFacility
Issueaz/OS“/f“(MODIFY)
EOJ- RequestMulti-UsernormalEOJ– Waitsforexistingtaskstocomplete– Nonewtaskscanstart
EOJOFF– ReversesEOJrequest
SamefunctionsinbatchDBUTLTY
86 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Backups
§ CXX§ DD/DDD§ LXX/FXX§ VLSfiles§ Indexareas§ Dataareas
87 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
BackupsCXX
– Backupnightly– Criticaldataset– UseDBUTLTYorDASDutility
DD/DDD– BackupinconjunctionwithCXX– UseDBUTLTYorDASDutility
LXX/FXX– SpilltoRXXusingDBUTLTY– CanbebackedupusingDASDutility,butsynchronizationissuescould
bedifficultsonotrecommended
88 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Backups
§ VLSfiles– Datadictionary
§ DDMAP,DDOL2– IPC
§ ADRPNL,ADRLIB,ADROUT– Ideal
§ IDLSRC,IDLOBJ,IDLPNL,IDDAT,IDDVW
§ WithIDEALbackupVLS,DD,DDDtogether
§ Criticalforonlineprocessing
Continued
89 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Backups
§ IXXareas– One(oroptionallymore)perdatabaseID– NoDBUTLTYbackupfunction– CanuseDASDutilitytobackup– DBUTLTYRETIXrecreatesIXXfromDATAareabytableorbase– DBUTLTYLOADalwaysrebuildsIXX
Continued
90 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Backups
§ Dataareas– BackupasneededusingDBUTLTYorDASDutility– DBUTLTYBACKUP
§ PHYSICALcreatesimagecopy– Primarytypeofbackupusedinrecoveringdataareas
§ NATIVEprimarytypeofbackupusedforreorganization§ UseREORGforlargedataareas
– DBUTLTYEXTRACTproduces"flat"fileofalldatarecords– DASDutilitycanbeused,specialconsiderations- can’trestoreto
devicesofdifferenttracksizes
Continued
91 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Restores/Reorganizations
§ CXX§ DD/DDD§ LXX/FXX§ VLSfiles§ Indexareas§ Dataareas
92 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Restores/Reorganizations
§ CXX– Restoreonlyifneeded– DBUTLTYcanrestoreeitherentireCXXoraselecteddatabase– DASDutilityrestoresentiredataset– SynchronizationwithDDandDDDrequired
§ DD/DDD– RestoreinconjunctionwithCXX– UseDBUTLTYorDASDutility
§ LXX/FXX– NoDBUTLTYfunction,onlyrestoredbyDASDutility– Notusuallydone(possiblyusedfordisasterrecovery)
Continued
93 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ Namethemajorroutineoperationaltasks§ Identifyareastobackup
94 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module7:LoggingandRecovery
95 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
EXPLAINLOGGING
EXPLAINPIPELINING
DESCRIBEFORWARDANDBACKWARDRECOVERY
HOWTOACTIVATELOGGING,RECOVERYANDPIPELINING
1
2
3
4
96 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
LoggingandRecoveryFacilities
§ Logging§ Transactionbackout§ Pipeline§ SpillingtheLog(LXX)§ Forcedcheckpoint§ ForcedSPILL§ Restart§ Recovery
97 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Logging
§ Logsbothonlineandbatchtransactions§ Optionalbytable§ Usersmayalsologtheirownrecords§ Usercheckpointing
98 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImplementingLoggingFacility
§ Loggingduringinstallation– SmallLogArea(LXX)– Norecoverycapability
§ Productionsystemrequirements– LogAreaofsufficientsize– Recoverycapability
99 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImplementingLoggingFacility
§ Implementationsteps– AllocateandinitializeLXX
§ Logblocksize16Korgreater§ Minimumof103logicalblocks
§ Variableloggingstronglyrecommendedandrequires32,760blocksize
– AllocateandinitializeFXX§ MustbesameblocksizeasLXX
§ Allocationdependentontasks
– ReviewrelatedMulti-Userstartupoptions(discussedlaterindetail)
Continued
100 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
LogRecord
§ Controlinformation§ Pre-updaterecordimages§ Transactionimage
101 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RequestsThatGenerateLogBlocks
§ ADDIT§ UPDAT§ DELET§ LOGITandLOGDW§ DEQUE– internalcommandissuedbyCADatacomCICS
Servicesattheendofatask,performssamefunctionasCOMIT
Continued
102 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Log-RelatedStartupOptions
§ LOGPEND§ LOGOPTION§ LOGPOOL§ LOGRCV§ LOGSPILL
103 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImplementingTransactionBackout
§ Defineloggingattributesfordesiredtables§ CodeTXNUNDOinprograms’UserRequirementsTable§ EnsureLogAreasizeisadequate
104 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
TransactionBackout Processing
§ Invokedbyanyoneofthefollowing:– CADatacom/DBafteraprogramabend
§ WhenTXNUNDOiscodedintheURT– ApplicationprogramissuingaROLBKcommand– RestartingMUFafterasystemabendwhentransactionbackout tasks
wereactiveatthetimeoftheabend
105 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImpactonExclusiveControl
§ WithoutTransactionBackout– Readwithupdateintent– Obtainprimaryexclusivecontrol– Updatecompletes– Primaryexclusivecontrolisdropped
106 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ImpactonSecondaryExclusiveControl
§ WithTransactionBackout– Secondaryexclusivecontrolisdroppedwhen:
§ Taskcompletes§ Or,COMITisissuedbyprogram
107 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
LoggingandPipeline
§ SystemLevel– LOGPENDstartupoption– maximumnumberofblockswithpipelinependingtransactionsLOGPEND2000
§ TaskLevel– URTWRITE=parameter§ NO- Deferredwrite- Pipelineactive§ YES- Immediatewrite- PipelineInactive§ TaskLevelNOoverridesTableLevelY§ TaskLevelYESdoesnotoverrideTableLevelN
§ TableLevel– PIPELINE-OPTION=Y/N– Datadictionarytableentityoccurrenceattribute
108 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ConditionsCausingWrites
§ DataandIndexAreawritesoccurwhen:– Buffercontainingpipelinedrecordsrequiredforreuse– UserRequirementsTableclosesuponajobcompletion– Logblockcontainingrecordofupdatetransactionhasexceeded
LOGPEND=value– IndexAreablocksplitsbecauseofmaintenance– Spillofassociatedlogrecordsoccurs– DBUTLTYLOCK/UNLOCKCOMBINATION– DBUTLTYACCESSstatuschange
109 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ConditionsCausingWrites
§ LogAreawritesoccurwhen:– AssociatedIndexordataareablockiswritten– Logblockinmemorybecomesfull– DEQUE,ROLBK,COMIT(ifrequested),orforcedcheckpointoccurs
Continued
110 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Spilling(orArchiving)theLog
§ LXXblocksarecopiedtotheRXXdataset(s)
§ Onlycommittedupdatesarespilled
§ Onlycontiguousspillable blocksarespilled
§ WhentheLXXisfull,forcedcheckpointorforcedspillmayoccur
111 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ActiveSpilling
§ MUFautomaticallyspills
§ LOGRCV=YES
§ Requiresdedicatedtapedevice
§ NotallowedifMUFPLEXstartupoptionpresent
112 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ActiveSpillingContinued
113 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
InactiveSpilling
§ Spilloccursinaseparateregion
§ MUFstartupoptionLOGRCV=NO
§ DBUTLTYfunctionSPILL
§ DBUTLTYfunctionSPILLOPTSPILL=(MINorMAX)
114 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ActiveSpillingContinued
115 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NeverSpill
§ NothingiswrittentoRXX
§ MUFstartupoptionLOGRCV=NEVER
§ Goodfortestsystems
§ AllowsRESTARTandtransactionbackout uptoLXXcapacity
§ MakesureLXXislargeenoughtohandlethelargestamountofworkbetweenCOMITs(orbepreparedtorestore)
§ Recoveryisnotpossible
116 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NeverSpillContinued
117 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
LogSpillOptions
§ LOGSPILL35,100,20,30,20
§ LOGSPILL(a)– beginconsolemessagepercent
§ LOGSPILL(b)– earlyforcedcheckpointpercent
§ LOGSPILL(c)– beginSPILLpercent(LOGRCV=YES)
§ LOGSPILL(d)– %oflogfulltomovelastrequesttoFXX
§ LOGSPILL(e)– %oflogfulltomoveactiverequeststoFXX
118 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
LoggingPerformanceConsiderations
§ LXXusuallymostaccesseddataset
§ LargerLXXblocksizeswillreduceI/O
§ StronglyrecommendvariableLXX§ INITAREA=LXX,BLKSIZE=32760,VARIABLE=YES
§ Entiredatabasemustbedisabledforforwardrecovery
§ LOGPENDmayimpactRESTARTruntime
119 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RXXMessages
§ DB00308ILOGAREAIS50%FULL,150BLOCKSSPILLABLE– Occursininactiveloggingonly– Canoccuronlyonceperspill– BatchSPILLexpectedatthispoint– BaseduponLOGSPILL(a)
120 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RXXMessages
§ DB00309ILOGAREAIS50%FULL,JOBxxxxxxxxPREVENTINGSPILL– BaseduponLOGSPILL(a)– Spillnotcurrentlypossible
Continued
121 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RXXMessages
§ DB00310ILOGSPILL3-1,BLOCKS2-96,TIMES050103070000-050103100811– Aftereachspill– Informationaboutwhatwasspilled
Continued
122 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RXXMessages
§ DB00311ILOGAREAIS60%FULL,SPILLINGBLOCK50,OUTOF200– Ifnospill,messagerepeatseveryadditional5%fullupto90%– Ifnospill,messagerepeatseveryadditional1%fullafter90%– ‘Outof’valuegrowsuntilspillstarted– Blockshowsas'none'untilspillstarted– ‘Block’replacedby‘Track’ifvariableloggingused
Continued
123 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ForcedCheckpoint
§ WhenLXXfills,MUFupdateswaitforaspill
§ Activelogicalunitsofworkcannotbespilled
§ Ifaspillisexecuted,MUFwillcheckpointallactiveLUWsthatarepreventingaspill
§ Secondaryexclusivecontrollocksarereleasedforcheckpointed records
§ FXXcontainsloggingrelatedinformationthathasbeenforcedfromtheLXX
124 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ForcedCheckpoint
§ SettingMUFStartupparameterLOGSPLL(b)withavaluelessthan100%couldallowaforcedspillbeforeLXXisfull
§ Iftransactionbackout requestedforatask:– UndoallupdatesstillonLXX– PostmessagerequestingBACKWARDrecoverybeexecutedfortask
nnnnnn (RXXROLLBACK=YES)– Whenrecoverycompletes,recordlocksarereleased
Continued
125 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ForcedSPILL
§ MUFStartupparameter– RXXROLLBACK=YES(default)
§ WhenLXXfills,MUFupdateswaitforspill
§ Activelogicalunitsofworkcannotbespilled
§ IfaSPILLisexecuted,MUFwillspillallactiveLUWswithoutdoingacheckpoint
§ Secondaryexclusivecontrollocksremain
126 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RESTART(atStartup)
§ Rollsforwardincompleterequests
§ Backoutincompletelogicalunitsofwork
§ Databasesnotinvolvedinbackout areimmediatelyavailable
§ ResetsLXX
127 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RECOVERYUtility
§ RecoveryfromRXXonly
§ Forwardandbackwardrecoveryavailable
§ Restoreofbackuprequiredforforwardrecovery
§ Multipleoptionstoselectextentofrecovery– RECBASEDBID=,TABLE=– RECJOBJOBNAME=,DATE=,STIME=,ETIME=– RECOVERYOPTION=(FORWARD/BACKWARD),RANGEDT=,FORCE=
128 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
BackupsforRecovery
§ DBUTLTYbackups,PHYSICALwithRECID=YESonly
§ DASDtoolbackupsareOK– Ifbackupdonewithdatabaseclosed
§ Canrestoreindexdatasetalso§ orrunDBUTLTYINITandRETIXoncealldatarestored
– Ifbackupdonewithdatabaseactive§ MustdoDBUTLTYINITandRETIXafterrestore
§ Frequentbackupsminimizeforwardrecoverytime
129 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ProcedureforForwardRecovery
§ Closedatabasetoallprocessing
§ SpillLXXrecordstoRXX
§ DASDtoolrestoreofDBUTLTYLOADmostrecentbackupspriortorecoverypoint
§ LocateallapplicableRXXfiles
§ Runrecovery
§ Reviewoutput
130 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ProcedureforBackwardRecovery
§ Recommended,butnotrequired:– Closedatabasetoallprocessing– Backupexistingdatabase
§ SpillLXXrecordstoRXX
§ LocateallapplicableRXXfiles
§ Runbackwardrecovery
§ Reviewoutput
131 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
INDEX=NO
§ LOADandRECOVERYoption
§ IXXisnotupdatedduringtheLOADortheRECOVERY
§ MayimproveRECOVERYtime
§ RequiresRETIXafterRECOVERY
132 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ ExplainLogging
§ ExplainPipelining
§ DescribeForwardandBackwardRecovery
§ HowtoactivateLogging,RecoveryandPipelining
133 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module8:BatchandOnlineProgramAccess
134 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
NAMEANDEXPLAINTHETHREEBATCHPROGRAMACCESSMETHODS
DESCRIBETHEROLEOFTHEURT
CREATEADYNAMICBATCHURT
CREATEANONLINEURT
CREATEASTATICBATCHURT
1
2
3
4
5
135 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
BatchProgramAccess
§ 3ApplicationProgramInterfaces(APIs)– EachAPIissuitedtoarangeofapplications– EachAPI'sfunctionalityoverlapswiththeotherAPIs– Youcanbesuccessfulwithwhicheveroneyouuse– Youmayevenchoosetouseallthree
136 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
WhichOneShouldIUse?
§ RAAT(RecordAtATime)– Commandsbasedonretrieval/updateofaspecificrowbyaspecifickey
value
§ SAAT(SetAtATime)– Commandsbasedonretrieval/updateofaspecificsetofrowswithin
onetablewhereaspecifickeypathcanusuallybefound
§ SQL(StructuredQueryLanguage)– Commandsbasedonretrieval/updateofsetsofrowsinvolvingmultiple
tableswithcomplexselectioncriteriawherespecifickeypathsmaynotbeavailable
137 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess
§ CallLevelProgramming
§ RAAT
§ SAAT
§ URTs
138 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CallLevelProgramming
§ RAAT– CALL'DBNTRY'USINGuser-info,request-area,work-area,element-list
§ SAAT– CALL'DBNTRY'USINGuser-info,request-area,work-area,element-list,
request-qualification-area
§ Returncodefields– Return-code– Internal-return-code
139 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:RAAT
§ Record-at-a-timeaccess
§ ALLaccessbykey
§ RequiresuseofaURT
§ Languagessupported– COBOL,Assembler,PL/I,C
140 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
TypesofRAATRequests
§ Indexonly
§ Recordretrieval
§ Recordretrievalforupdate– Primaryexclusivecontrol
§ Update/Delete– Secondaryexclusivecontrol
141 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
TypesofRAATRequests(contd.)
– LOCKG– locateindexentryequaltoorgreaterthankeyvalue– REDKG– Readdatarowequaltoorgreaterthankeyvalue– RDUKG– Readandlockdatarowequaltoorgreaterthankeyvalue– REDNX– Readrowwithnextequalorhigherkeyvalue– ADDIT– Addarow– UPDAT– Updatearow(mustbelockedusingRDUxx commandfirst)– DELET– Deletearow(mustbelockedusingRDUxx commandfirst)– COMIT– Commit/checkpointalladds,updatesordeletestothispoint– OPEN– Openatableforaccess– CLOSE– Closeatable(servesasaCOMITifmaintenanceperformed)– GSETL/GETIT– Batchsequentialreadahead
RAATCommandExamples
142 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
TypesofRAATRequests
§ Readforupdate(RDUxx)commands– Primaryexclusivecontrolperrowread
§ Sequential/Physical"readaheadwithupdate“(GSETL/GETIT)– Primaryexclusivecontrolperrowreturned
§ Insert,updateanddeletecommands– SecondaryexclusivecontroluntilCOMITorCLOSE
Continued
143 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:SAAT
– Set-at-a-timeaccess– Chooseskey(s)touse– Maybuildatemporaryindex– Accesslimitedtoonetable(nojoins)– Processessetsofrecordsforretrieval– Record(s)canbeupdated/deleted– WillissueRAATcommandsforretrievalwhenpossible– Languagessupported– COBOL,Assembler,PL/I,C,invokedinternallybyCAIdealand
CADataquery forCADatacom
CompoundBooleanSelection
144 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:SAAT
§ SAATcomprisedof6commands
§ Normalsetcommands– SELFR(Selectfirstrecord)– SELNR(Selectnextrecord)– SELPR(Releaseset)
§ Specialcommands– SELCN(Continuesetrecordselection)– SELSM(Selectsamerecord)– SELST(Stopsetrecordselection)
Continued
145 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:URTs
§ UserRequirementsTable(URT)
§ Requiredforallprogramaccess– RAAT– SAAT– SQL
§ DefaultURTforSQLaccess
146 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:URTs
§ SpecifiesCADatacom/DBresourcesforprogramexecution– Tablesprogrammayaccess– Tablesprogrammayupdate– Sequentialprocessingbuffers– Transactionbackout requirements– ProcessingprioritywithinMUF
Continued
147 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:URTs
§ STATICURTsrequireall4macrosinoneassembly– DBURINF(oneinstance)– DBURSTR(oneinstance)– DBURTBL(onepertable)– DBUREND(oneinstance)
Continued
148 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
NavigationalProgramAccess:URTs
§ DYNAMICURTsrequiretwoseparateassemblies– MUFInterfacecomponent
§ DBURINF(oneinstance)§ DBUREND(oneinstance)
– Databasetablecomponent§ DBURSTR(oneinstance)§ DBURTBL(onepertable)§ DBUREND(oneinstance)
Continued
149 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURINFParameters
§ URTABLE=– DeterminestypeofURT
§ URTABLE=ASM(StaticURT)§ URTABLE=LOAD(DynamicURT)
§ LOADNAM=DynamicURTtablecomponentloadmodulename
§ LOADPRM=DynamicURTtablecomponentEXECparametervalue
§ OPEN=DatabasetablestobeopenedbyUSERorDB
150 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURINFParameters
§ MUFS=– Yes/NotomultipleMUFs
§ MUFSMSG=– 1-999issueDB00505IforeveryRC– 0nomessage
§ RRS=– Yes/NoinvokeResourceRecoveryServices
§ USRNTRY=– UserprogramentrypointwhereURTreturnscontrol
Continued
151 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURINFParameters
§ BACKSPT=– SupportforCADatacom/DBentrypointsusedinpriorreleases
§ DBMODS=– Rent/Norent
§ LE=– Languageenvironment
Continued
152 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURSTRParameters
§ AUTHID=– ForSQLprograms,providessystemdefaultoverride
§ DB00101=– Startedmessage,yesorno
§ CBSIO=– SELFRcommandI/Ointerruptlimit
§ TXUNDO=– Maintenancetransactionbackout ineffectforalltables,yesorno
§ CSECT=– AllowslinkingofmultipleURTsassingleloadmodule
153 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURSTRParameters
§ JOBSTAT=– Multi-Usertosavejobstatistics,yesorno
§ OPTMIZE=– ClosejobwithoutwritingPXXstatistics,yesorno
§ MULTUSE=– Multi-Usermode(default)orSingleUsermode,yesorno
§ WRITE=– Immediatelywritemaintenancetransactionstodisk,yesorno– YESdisablestheMUFpipelinefeature
Continued
154 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURSTRParameters
§ PRTY=– PrioritylevelwithinMulti-User
§ NO522=– Allow522timeouts,yesorno
§ SIDNAME=– UsedformultipleMUFaccess(Multi-MUFfeature)
§ TIMEMIN=– Exclusivecontrolwaittimeinminutes
§ TIMESEC=– Exclusivecontrolwaittimeinseconds
Continued
155 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURTBLParameters
§ TBLNAM=– 3-characterDatacomtablenameorcharacters‘BASE’
§ UPDATE=– Maintenanceallowedbyapplication(s)usingthisURT,yesorno
§ SYNONYM=– SameDatacomtablenameusedinmorethanonedatabases,yesorno
§ TABLES=– NumberoftablestoopenwhenTABNAME=BASE(1-999)
§ DBID=– DatabaseIDwheretableresides
156 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURTBLParameters
§ DBIDMUF=– DBIDasknowntoMUF
§ DBIDUSER=– DBIDasknowntoapplicationprogram
§ AUTODXC=– Automaticallydropexclusivecontrol,yesorno
§ BYPOPEN=– BypassedopenandcloseprocessingfortablenamedintheTBLNAM=
parameter,yesorno
Continued
157 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURTBLParameters
§ GETBLK=– BuffersizetobeusedforGETITandGETPScommands
§ GBMAXR=– MaximumnumberrowsallowedintheblockedGETIT/GETPSbuffer
§ SEQBUFS=– #MUFdatabufferstoreserveforblockedGETIT/GETPSprocessing
§ ELMCHG=– AllowrequestareaelementlistvaluechangesbetweenGETITcmds
§ READAHD=– Indexscanningorphysicalblockscanningtobedone,yesorno
Continued
158 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURTBLParameters
§ DBFLSUB=– UserRequirementsTableassociatedwithaprogramusingDBFLSUB,
yesorno§ AREANAM=
– 3-characterDatacomareanametobeloadedusingtheDBFLSUBsubroutine
Continued
159 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBURENDParameters
§ DBSQL=– ApplicationassociatedwiththisURTusingSQL,yesorno
§ USRINFO=– Upto16bytesofuserinfo(descriptivetextonly)
§ AMODE=– ANY,24,31,orNONE
§ RMODE=– ANY,24,31,orNONE
160 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
StaticBatchURTs
§ AllURTmacrosmustbepresentinassembly§ DBURINF§ DBURSTR§ DBURTBL(onepertable)§ DBUREND
§ AssembledURTcomponentlinkedwithuserprogram
161 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
StaticBatchMacroCoding
162 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicBatchURTs
§ Requirestwoassemblies– MUFinterfacecomponent
§ DBURINF§ DBUREND
– Databasetablecomponent§ DBURSTR§ DBURTBL(onepertable)§ DBUREND
§ MUFinterfacecomponentlinkedwithuserprogram§ Databasetablecomponentloadedatprogramruntime
163 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicBatchMacroCodingURTTITLE‘DBSURT--MULTI-USER/SINGLEDB’
Interface DBURINF XMacro URTABLE=LOAD X
LE=YES, XLOADPRM=DBURT, XOPEN=DB, XBACKSPT=NO, XCOBOL=YES
End DBUREND XMacro USRINFO=CA-INS-URT
END
URTTITLE‘DBSURT--MULTI-USER/SINGLEDB’Interface DBURINF XMacro URTABLE=LOAD X
LE=YES, XLOADNAME=DBURT031, XOPEN=DB, XBACKSPT=NO, XCOBOL=YES
End DBUREND XMacro USRINFO=CA-INS-URT
END
164 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DynamicBatchMacroCoding(contd)URTTITLE‘DBSURT--MULTI-USER/SINGLEDB’
Table DBURSTR XStart ABEND=YES XMacro MULTUSE=YES, X
PRTY=7, XTXNUNDO=YES
Entry DBURTBL XMacro READAHD=PHYSICAL, X
DBID=31, XELMCHG=NO, XGETBLK=8192, XSEQBUFS=24, XTBLNAM=CAR, XUPDATE=NO
Entry DBURTBL XREADAHD=INDEX, XDBID=31, XELMCHG=NO, XGETBLK=8192, XSEQBUFS=24, XTBLNAM=INS, XUPDATE=YES
End DBUREND XMacro USRINFO=CA-INS-URT
END
165 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
OnlineProgramAccess
§ SameRAAT/SAATsupportasbatchexcept:– GSETL/GETITandGSETP/GETPSnotallowed– ProgramslinkedwithDBCSRPRorDBCSVPRinsteadofaURTmodule
§ CADatacom/CICSServicesusesURTpooltoaccessaMUF– URTmodulenameshavesameprefixwithdifferentnumericsuffixes– URTssearchedinnumericsuffixorder– URTopensdonebyCADatacom/CICSServices– URTopenscanbeautomaticallydoneatCICSstartuptime– URTclosesandopenscanbedonemanuallyafterCICSstartup
166 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
OnlineProgramAccess
§ Samereturncodesasbatch
§ SomeadditionalreturncodesforCICS
Continued
167 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
OnlineMacroCodingURTTITLE‘DBURT031’
Table DBURSTR XStart ABEND=YES XMacro MULTUSE=YES, X
PRTY=7, XTXNUNDO=YES
Entry DBURTBL XMacro READAHD=PHYSICAL, X
DBID=31, XELMCHG=NO, XGETBLK=8192, XSEQBUFS=24, XTBLNAM=CAR, XUPDATE=NO
Entry DBURTBL XREADAHD=INDEX, XDBID=31, XELMCHG=NO, XGETBLK=8192, XSEQBUFS=24, XTBLNAM=INS, XUPDATE=YES
End DBUREND XMacro USRINFO=ONLINE-URT
END
168 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
OnlineSQLAccess
§ Samecommandsupportasbatch
§ ProgramsarelinkedwithDBCSRPRorDBCSVPR
§ UsesasingleURT(usuallyDBURT020)
§ SameSQLreturncodesasbatch
169 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ Nameandexplainthethreebatchprogramaccessmethods
§ DescribetheroleoftheURT
§ CreatebothbatchandonlineURTs
170 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module9:ProblemDetermination
171 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
LISTINFORMATIONNECESSARYBEFORECALLINGCASUPPORT
IDENTIFYPROBLEMSEVERITY
MONITORYOURISSUE
1
2
3
172 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ProblemDetermination
§ PrepareforCASupportcall
§ Placesupportcall
§ Worksupportcall
§ Completesupportcall
173 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
PrepareforCASupportCall
§ Havemanualsavailable
§ Knowyourproduct's:– Release– CARSlevelmostrecentlyapplied– AdditionalPTFsthatareapplied
§ Knowyouroperatingenvironment– Operatingsystemrelease– CICSrelease
174 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
PrepareforCASupportCall
§ Documentation– SVCorSdump– PXXReportorMasterlist Dump(s)– ConsoleLog– MUFJESLog– Errormessages– MemoryDS(fordataspace)– DBUTLTYAUTOINFOoutput
Continued
175 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
PrepareforCASupportCall
§ Problemhistory:– Howoftendoesitoccur?– Cantheproblemberecreated?– Whathaschanged?
§ Software§ Application§ Data§ Transactionvolume
Continued
176 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
PlacetheSupportCall
§ HaveyoursiteIDready
§ Havealldocumentationready
§ UseCASupportOnline(CSO)athttp://support.ca.com orcallCASupportat800-225-5224– Opencase- retainnumber– Describeproblemandwhatdocumentationisavailable
177 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
PlacetheSupportCall
§ Establishproblempriority– Priority1 Productionsystemdownormajorbusinessimpact– Priority2 Majorcomponentdown– Priority3 Minorproblem– Priority4 Information/question
Continued
178 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
WorktheSupportCall
§ CASupportwill:– Enterallinformationprovidedifcalled– Ifopenedonline,mustcall toupgradetoseverity1ifneeded– Level1willscanexistingsolutions,problemsandcasestotryand
matchyourscenario– ProvideapplicablesolutionsorwilltransferissuetoLevel2
§ SustainingEngineering(Level2)will:– Reviewtheavailabledocumentation– Possiblyrequestadditionalinformation– Providearesolutionfortheproblem
179 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CompletetheSupportCall
§ Updatethecontactorcallcustomertechnician– Confirmtheresolutiontotheproblem– Askthetechniciantoclosetheissue
180 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ ListinformationnecessarybeforecallingCASupport
§ Identifyproblemseverity
§ Monitoryourissue
181 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module10:CADatacomCICSServices
182 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
DESCRIBETHEPURPOSEOFCADATACOMCICS SERVICES
RECOGNIZEPRODUCTCOMPONENTS
RECOGNIZEENVIRONMENTALCONSIDERATIONS
1
2
3
183 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
CADatacomCICSServices
184 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ProductComponents
185 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Transactions
§ DBOC,DBEC,DBUT,DBUGshouldbesecured§ DBOCsupportsmasteroperators§ DBRCisaninternaltransaction
186 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Modules
187 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Modules
§ DBEC/DBEXwithSYSID– OrCRTEeachDBOCcommand
Continued
188 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
URTPool
189 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
EnvironmentalConsiderations
§ UsesCOMMANDlevelCICScalls§ SupportsCICSReleases:
– 3.2andlaterforz/OS(DBCVersion15.0)
190 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ DescribethepurposeofCADatacomCICSServices
§ Recognizetheproductcomponents– Transactions– Modules– URTs
§ Recognizeenvironmentalconsiderations
191 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module11:MonitoringOnlineURTs
192 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Agenda
ISSUEURT LEVELCOMMANDS
ISSUETABLELEVELCOMMANDS
UPDATETABLELEVELVALUES
UPDATEURT LEVELVALUES
ISSUEMUF LEVELCOMMANDS
1
2
3
4
5
193 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DisplayURTsandTables
194 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
INQuiry Commands
§ DBICINQ=????.???.????– ?or??or???or????on1stand3rdparameters– FirstseriesisURTnumber– SecondseriesisTablename– ThirdseriesisDatabaseID
§ DBICINQ=type,status,when– Type STD,DYNorSQL– Status OPENED,CLOSED,FAIL– WhenAUTO,DEFER,PLT
195 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
INQuiry Commands
§ DBECI,level(????),limiter,SYSID(aaaa)– LevelisURTorTBL– ????representsURTnumber– Limiteristype,status,when,condition
§ Type DYNorSQL§ StatusCLOSE,CLOSING,OPEN,UNOPENED§ When AUTO,DEFER,PLT§ Condition NOPPT
– SYSIDisCICSregion§ Defaultislocal§ ‘*’meansallCICSServicesattachedtoMUF
Continued
196 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
URTInquiry:Example1
197 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
URTInquiry:Example2
198 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
URTInquiry:Example3
199 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
URTInquiry:Example4
200 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DisplayURTParametersUsingDBEC/DBEX§ DBEXI,URT(001?)
CA-DATACOM CICS SERVICES APPLID = A06ICDQDDBEC I,URT(01?)A SYS URT TYP STATUS WHEN REL CBSIO PRTY UNDO MIN SEC CONDITIONS*LOC 0010 STD OPEN AUTO 81 000000 07 YES 000 000 ACTIVE=000 RESRVD=000*LOC 0011 NO PPT ENTRY FOR URT*LOC 0012 NO PPT ENTRY FOR URT*LOC 0013 NO PPT ENTRY FOR URT*LOC 0014 STD OPEN PLT 81 000000 07 YES 000 000 ACTIVE=000 RESRVD=000*LOC 0015 NO PPT ENTRY FOR URT*LOC 0016 STD OPEN PLT 80 000000 07 YES 000 000 ACTIVE=000 RESRVD=000*LOC 0017 NO PPT ENTRY FOR URT*LOC 0018 NO LOAD MODULE*LOC 0019 NO LOAD MODULE
201 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DisplayURTParametersUsingDBEC/DBEX§ DBEXI,URT(001?)DBEC I,TBL(10)SYS URT TYP STATUS TABLE DBID UPD BYP SYN AUT DBIDM SIDNAME MUF*LOC 0010 STD UNOPENED ACT 00010 YES NO YES YES DBSIDPR 01
CUS 00010 YES NO YES YESDTL 00010 YES NO YES YESORD 00010 YES NO YES YESITM 00010 YES NO YES YESNUM 00010 YES NO YES YESRCP 00010 YES NO YES YESSAL 00010 YES NO YES YESSHP 00010 YES NO YES YES
202 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
UniqueCommands
§ AvailableinDBOC/DBIC– DBICINQ=????.PAY– DBICINQ=????.???.0001– DBICINQ=FAIL– DBICINQ=PTF
§ AvailableinDBEC/DBEX– DBEXI,URT(????),CLOSING– DBEXI,URT(????),UNOPENED– DBEXI,URT(????),NOPPT
203 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DisplayPTFsUsingDBOC/DBIC
§ DBICI,PTF
204 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ControllingAccesstoURTPool
205 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ControlAccesstoURTs
§ DBUTLTYACCESS=NOMAINT– URTsdonotneedtobeclosed
§ DBOCcommand=????– Open,Close,Auto,Defer,Restart
§ DBECI,URT(????),SYSID(aaaa)– Useactioncodes,O,C,A,D,R,N
§ DBECP,action,URT(????),SYSID(aaaa)– Open,Close,Auto,Defer,Restart
206 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DisplayURTParametersUsingDBEC/DBEX
207 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModifyDBURSTRParameters
§ DBECI,URT(????),SYSID(aaaa)– CloseURT– Modifyparameter
§ CBSIO,PRTY,TIMEMIN/TIMESEC,TXNUNDO– OpenURT
208 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Display,UpdateaURTUsingDBEC
209 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModifyTablesinURT
§ DBOCDisable/Enable=nnnn.tbl– CloseURT– IssueDBOCDISABLE=nnnn.tbl– OpenURT
§ DBECI,URT(????),SYSID(aaaa)– CloseURT,SelectURT– Modifyparameter
§ Autodxc,Synonym,Update,Bypass– OpenURT
210 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ReplaceURT
§ DBOCmethod– DBOCCLOSE=nnnn– DBOCDELETE=nnnn– CEMTSPROG(DBURTnnnn)NEWCOPY– DBOCOPEN=nnnn
§ DBECmethod– DBECP,CLOSE,URT(nnnn),SYSID(aaaa)– DBECP,NEWCOPY,URT(nnnn),SYSID(aaaa)– DBECP,OPEN,URT(nnnn),SYSID(aaaa)
Code,AssembleandLinkURT
211 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ChangingPrefixofURTs
212 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBOCDemonstration
§ DisableTablebyClosingURTandthendisablingtable– DBOCCLOSE=0001– DBOCDISABLE=0001.PAYT,0001.PMF
§ OpentheURTcontainingthedisabledtables– DBOCOPEN=0001– URTisnowavailableforuse– PAYandPMFtablescannotbeaccessedatthistime,butanyother
tablesspecifiedinthisURTareavailableforuse
Step1
213 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBOCDemonstration
§ Differentvariationscanbeusedwiththiscommand– DBOCCLOSE=0001,0003– DBOCCLOSE=??(closesURTs00-99)– DBOCCLOSE=1?(closesURTs10-19)– DBOCCLOSE=????(closesURTs000-999)
§ VariationsalsovalidforOPENandRESTARTcommands
Step1Continued
214 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBOCDemonstration
§ DifferentvariationscanbeusedwithENABLEandDISABLEcommands– DBOCDISABLE-?.AAA
§ DisablesalltablesnamedAAAinURTs0-9– DBOCDISABLE=1.A??
§ Disablesalltablesthatbeginwiththeletter“A”inURT1
Step1Continued
215 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
DBOCDemonstration
§ Enablethetablesclosedinstep1– DBOCCLOSE=0001– DBOCENABLE=0001.PAY,0001.PMF– DBOCOPEN=0001
Step2
216 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
ModuleSummary
§ IssueURTlevelcommands
§ IssueTablelevelcommands
§ UpdateURTlevelvalues
§ UpdateTablelevelvalues
§ IssueMUFlevelcommands
217 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Module12:Wrap-Up
218 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
HowDidWeDo?
§ Whattopicwasmostusefultoyou?
§ Aretheretopicsyouwantedcoveredthatwerenot?
§ Howwouldyouimprovethiscourseforfutureattendees?
@CAWORLD#CAWORLD ©2016CA.AllRIGHTSRESERVED.219 @CAWORLD#CAWORLD
MainframeandWorkloadAutomation
FormoreinformationonMainframeandWorkloadAutomation,pleasevisit:http://cainc.to/9GQ2JI
220 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MustSeeDemos
DemoNameServicesYTheater#location
DemoNameSolutionYTheater#location
DemoNameProductXTheater#location
DemoNameProductXTheater#location
221 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
RecommendedSessions
SESSION# 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
MFX98SUsingSysview tomonitorandmeasureyourCADatacomenvironment– ADandDB 11/17/2016at3:00pm
MFX99S BirdsofaFeather/StumptheTechie! 11/17/2016at3:45pm
222 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
MustSeeDemos
DemoNameServicesYTheater#location
DemoNameSolutionYTheater#location
DemoNameProductXTheater#location
DemoNameProductXTheater#location
223 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Questions?
224 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
Thankyou.
Stayconnectedatcommunities.ca.com
225 ©2016CA.ALLRIGHTSRESERVED.@CAWORLD#CAWORLD
©2016CA.Allrightsreserved.Alltrademarksreferencedhereinbelongtotheirrespectivecompanies.
Thecontentprovidedinthis CAWorld2016presentationisintendedforinformationalpurposesonlyanddoesnotformanytypeofwarranty. The informationprovidedbyaCApartnerand/orCAcustomerhasnotbeenreviewedforaccuracybyCA.
ForInformationalPurposesOnlyTermsofthisPresentation