The Dummies Guide to

Datacom
An Introduction To CA-Advantage
Datacom ®
 Agenda
ƒ Datacom Overview
ƒ Datacom Utilities
ƒ Backup Restore Consideration
ƒ Datacom Upgrades
ƒ Q&A
 A Little bit about… me
ƒ A DBA for 3M UK PLC
ƒ 7 years DBA experience
ƒ 19 years IT experience (14 years at 3M)
ƒ Responsible for 3M Europe's entire
Datacom systems
– 37 Regular MUF’s
– 1 Datacom/AD MUF
 Datacom Overview
ƒ 2 versions
– Full
ƒ All functionality available
ƒ SQL option available
ƒ JAVA and XML can be used
– AD
ƒ Provides a ‘black box’ DBMS for CA’s appication
portfolio (e.g. CA7)
ƒ No user DB’s can be created
 Introduction to the MUF
ƒ Multi User Facility
ƒ Usually run as a started task
ƒ Handles the DB requests
ƒ Performs Logging, Rollbacks etc.
ƒ Must be running to give access to the DB
ƒ Provides many startup parameters for tuning
and functions
ACCESS MAXELRQ STATBFR
ACCT MESSAGE SUBTASK
ACCTPRM MUF SYSOUT
BREAK MUFMSG SYSPOOL
CBS MUFPLEX SYSTEMDBID
COVERED NORESTART TASKS
CSAFREE NONSWAP VIRTUAL
DATACOM PLANSEC X_COVERED_MAX_SIZE
DATAPOOL PROCEDURE X_DUMP_NUMBER_BLKS
DATASPACE PXXSTATS X_IO_SQA
DATETIME RCERROR X_IO_SRM
DICTIONARY READAHD X_LOG_CONTROL_BLKS
ECHO RESTART X_LOG_DELAY_BLK
EXCTLNO RRS X_LOG_DELAY_SEC
EXPAND RXX X_LOG_DELAY_TIME
FLEXPOOL RXXROLLBACK X_LOG_FULL_BLK
FORCE_NO_64BIT RXX_VARIABLE_BLK X_LOG_SPILL_BLKS
IOTASK SECURITY X_LOG_STABLE_BLKS
LOGOPTION SMPTASK X_LOG_WRITE_OLD_BLKS
LOGPEND SQLDEFAULT X_PEND_WRITE_BLKS
LOGPOOL SQLOPTION XCFFROM
LOGRCV STAR
LOGRSYS
LOGSPILL
 Introduction to Database structures
ƒ Database
– 1 to 240 Area’s
ƒ 1 to 240 tables
– 1 to 255 Elemets
ƒ 1 to more fields
ƒ Each Database has a IXX dataset
ƒ Each Area has a data dataset
ƒ Datasets conform to MVS (or VSE) rules.
ƒ SMS can be used for volume management
 Introduction To the Data Dictionary
ƒ DD records are in database Id 002.
ƒ Defines the User and system Databases
ƒ Defined in Test Status then moved to PROD
status
ƒ Each entity has an occurrence name and an
internal ID name
– Database ORDERS has DBID 250
– Table BACKORDERS on DB 250 has ID BAK
ƒ At Least 1 key must be defined for the native order
 Introduction To the CXX
ƒ Once defined to Data Dictionary structures
are catalogued to the CXX
ƒ Short CXX Report C:\Documents and
ttings\uk064778\Des

ƒ Full CXX Report C:\Documents and

ttings\uk064778\Des
 Introduction to Dataviews
ƒ Used to provide programs with data access.
ƒ Created in the Data Dictionary
ƒ Catalogued in Ideal
ƒ Can be readonly or Update
ƒ Do not need all elements
ƒ Elements can be defined in any order
DATAVIEW DB_MAINT
(TABLE/RECORD) DB_MAINT
ELEMENT ACTL_EXTT_QTY ACTEX
ELEMENT ACTL_MAX_PCT AMXPC
ELEMENT ACTL_PCT ACPRC
ELEMENT ACTL_TRK_QTY ACTRK
ELEMENT AREA_ID AREID
ELEMENT DBS_ID DBID
ELEMENT DD_IND DDOLI
ELEMENT DIFF_PCT DIFPC
ELEMENT DISK_ID DISKI
ELEMENT DTST_NAME DSNNM
ELEMENT EXTD_TYPE_CODE EXTYP
ELEMENT KEEP_IND KEIND
ELEMENT LAST_MANT_DATE LASTM
ELEMENT MANT_NOW_IND MAINT
ELEMENT MAX_EXTT_QTY MAXEX
ELEMENT MAX_PCT MAXPC
ELEMENT MIN_PCT MINPC
ELEMENT MOVE_IND MOVIN
ELEMENT PCT_TO_ADD_QTY PADDQ
DATACOM/DB STRUCTURE MAINTENANCE
TUVU
............................ DATAVIEW ATTRIBUTES ..............................
Name: DB_MAINT Status/Version: T001
Table : DB_MAINT
Update:

................... ELEMENTS accessed by the DATAVIEW ...................

Name
====== ============= T O P ============
000001 ACTL_EXTT_QTY
...... ________________________________
000002 ACTL_MAX_PCT
000003 ACTL_PCT
000004 ACTL_TRK_QTY
000005 AREA_ID
000006 DBS_ID
000007 DD_IND
000008 DIFF_PCT
000009 DISK_ID
000010 DTST_NAME
000011 EXTD_TYPE_CODE
000012 KEEP_IND
000013 LAST_MANT_DATE
000014 MANT_NOW_IND
000015 MAX_EXTT_QTY
000016 MAX_PCT
=> cat dvw db_maint

-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
IDEAL: DISPLAY DATAVIEW DVW DB_MAINT (001) PROD SYS:
SYS: USR DISPLAY

Commnd Seq Level Field name T I Ch/Dg Occur K Value/Redef/Dep

Value/Redef/Dep on
====== ================================ T O P =================================
=================================
000001 CATALOGED 11/28/05 15:42 DATACOM/DB UPD=NO DBID=00089
DBID=00089
000002
000003 1 1 DB_MAINT
000004 2 2 ACTL_EXTT_QTY U Z 2
000005 3 2 ACTL_MAX_PCT U Z 4
000006 4 2 ACTL_PCT U Z 3
000007 5 2 ACTL_TRK_QTY U Z 8
000008 6 2 AREA_ID X 3
000009 7 2 DBS_ID X 4 P
000010 8 2 DD_IND X 1
000011 9 2 DIFF_PCT U Z 3
000012 10 2 DISK_ID X 6
000013 11 2 DTST_NAME X 26 P
000014 12 2 EXTD_TYPE_CODE X 1
000015 13 2 KEEP_IND X 1
000016 14 2 LAST_MANT_DATE X 8
000017 15 2 MANT_NOW_IND X 1
000018 16 2 MAX_EXTT_QTY U Z 2
000019 17 2 MAX_PCT U Z 3
000020 18 2 MIN_PCT U Z 2
000021 19 2 MOVE_IND X 1
000022 20 2 PCT_TO_ADD_QTY U Z 2
000023 21 2 RORG_FREQ_IN_WKS U Z 3
000024 22 2 RORG_TYPE_IND X 1
000025 23 2 STAT_REQ_1_IND X 1
 Introduction to URT’s
ƒ User Requirements Table
ƒ Ties batch programs and database’s
together
ƒ Each CIC’s AOR needs a URT
ƒ DBOC works at URT level
ƒ Many URT options are available
TITLE 'ZIQC56U USER REQUIREMENTS TABLE ASSEMBLY'
DBURSTR X
ABEND=NO, X
CSECT=ZIQC56U,MULTUSE=YES,TXNUNDO=YES
DBURTBL X
DBID=089,TBLNAM=HIS,SEQBUFS=0,SYNONYM=YES, X
UPDATE=YES, X
ACCESS=RAN
DBURTBL X
DBID=089,TBLNAM=MAN,SEQBUFS=0,SYNONYM=YES, X
UPDATE=YES, X
ACCESS=RAN
DBUREND X
SYSTEM=OS,USRINFO=ZIQC56U27/10/99
END
TITLE 'DB/CICS URT FOR GBT '
PRINT NOGEN
DBURSTR ABEND=NO,MULTUSE=YES,TXNUNDO=YES,PRTY=10, X
WRITE=NO,TIMEMIN=0,TIMESEC=60
DBURTBL UPDATE=YES,TBLNAM=DCA, X
SYNONYM=YES,DBID=089
DBURTBL UPDATE=YES,TBLNAM=DCD, X
SYNONYM=YES,DBID=089
DBURTBL UPDATE=YES,TBLNAM=DID, X
SYNONYM=YES,DBID=089
DBURTBL UPDATE=YES,TBLNAM=DIS, X
SYNONYM=YES,DBID=089
DBURTBL UPDATE=YES,TBLNAM=HIS, X
SYNONYM=YES,DBID=089
DBURTBL UPDATE=YES,TBLNAM=JCL, X
SYNONYM=YES,DBID=089
DBURTBL UPDATE=YES,TBLNAM=MAN, X
SYNONYM=YES,DBID=089
DBUREND SYSTEM=OS,USRINFO=DB2CLURT
END
 DBOC Example
DBC1 INQ=096.??? DDELIM &

URT 096(STD OPEN AUTO ) ACTIVE=000 RESRVD=000 PRTY=10 TXNUD

ECWAIT=0060
096 TABLE:CUP DBID:00096 UPDATE SYNONYM
096 TABLE:DCA DBID:00096 UPDATE SYNONYM
096 TABLE:DCC DBID:00096 UPDATE SYNONYM
096 TABLE:DCD DBID:00096 UPDATE SYNONYM
096 TABLE:DCE DBID:00096 UPDATE SYNONYM
096 TABLE:DCF DBID:00096 UPDATE SYNONYM
096 TABLE:DCK DBID:00096 UPDATE SYNONYM
096 TABLE:DCT DBID:00096 UPDATE SYNONYM
096 TABLE:FLD DBID:00096 UPDATE SYNONYM
DC00380I TRANSACTION COMPLETED.
 Datacom Utilities
ƒ Used to maintain the database’s
– REPORT
– INIT
– RETIX
– EXTEND
– EXTRACT
– LOAD
ƒ Many others
 Datacom Utilities
//DBUTGBT PROC WORK=WORKDA,
// SYSOUT='*',
// SNAPER=DUMMY,
// REG=8M,
// TRK=500,
// PTRK=100,
// PTRK2=0
//DBUTLTY EXEC PGM=DBUTLTY,REGION=&REG
//STEPLIB DD DISP=SHR,DSN=ATADR.MUFTA.LOADLIB
// DD DISP=SHR,DSN=ESLCA.DATACOM.R11.CUSLIB FIXS
FIXS
// DD DISP=SHR,DSN=ESLCA.DATACOM.R11.CAILIB 11.0
11.0
// DD DISP=SHR,DSN=ESLCA.DBTT.V10C.LOADLIB
// DD DISP=SHR,DSN=ESLCA.IM9511.LOADLIB
// DD DISP=SHR,DSN=ESLCA.DBTT.LOADLIB
//SYSPRINT DD SYSOUT=&SYSOUT
//SYSDUMP DD SYSOUT=&SYSOUT
//SNAPER DD &SNAPER
//SORTWK01 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK,&TRK),RLSE)
//SORTWK02 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK,&TRK),RLSE)
//SORTWK03 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK,&TRK),RLSE)
//SORTWK04 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK2,&TRK),RLSE)
//SORTWK05 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK2,&TRK),RLSE)
//SORTWK06 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK2,&TRK),RLSE)
//SORTWK07 DD UNIT=(&WORK,3),SPACE=(TRK,(&PTRK2,&TRK),RLSE)
//CXX DD DSN=ATADR.DBCXX000.DBCXX,DISP=SHR
 Datacom Utilities
ƒ Report
//CXXREP EXEC DBUTGBT,
// PTRK=0,TRK=0,COND=(4,LT)
//SYSIN DD *
REPORT AREA=CXX,DBID=089,TYPE=A
/*

C:\Documents and
ttings\uk064778\Des
 Datacom Utilities
ƒ New Area
//INIT EXEC DBUTGBT,REGION=6000K,PTRK=0,TRK=0,COND=(4,LT)
//DCA089 DD DSN=GBTDCM.DB0089.ARDCA,
// UNIT=3390, VOL=(,,,50),
// DISP=(NEW,CATLG,DELETE),
// SPACE=(TRK,(0020))
//SYSIN DD *
ACCESS STATUS=OFF,DBID=089,USERS=WAIT
INIT AREA=DCA,DBID=089
LOAD AREA=DCA,DBID=089,FORMAT=NONE
ACCESS STATUS=WRITE,DBID=089
/*
 Datacom Utilities
ƒ RETIX
– Rebuilds the index
REPORT AREA=CXX,DBID=089,TYPE=A
ACCESS STATUS=OFF,DBID=089,USERS=FAIL
COMM OPTION=CLOSE,DBID=089
INIT AREA=IXX,DBID=089
RETIX AREA=MAN,DBID=089,OPTIMIZE=YES,SORT=6183,
SORTWK=7,UNIT=WORKDA
RETIX AREA=DID,DBID=089,OPTIMIZE=YES,SORT=5516,
SORTWK=7,UNIT=WORKDA
RETIX AREA=DCA,DBID=089,OPTIMIZE=YES,SORT=5018,
SORTWK=7,UNIT=WORKDA
ACCESS STATUS=WRITE,DBID=089
REPORT AREA=CXX,DBID=089,TYPE=A
 Datacom Utilities
ƒ EXTEND
– Adds more extents to the dataset
//EXTEND EXEC DBUTGBT,
// PTRK=0,TRK=0,COND=(4,LT)
//DCA089 DD DSN=GBTDCM.DB0089.ARDCA,
// DISP=SHR,SPACE=(TRK,(00020,7))
//SYSIN DD *
ACCESS STATUS=OFF,DBID=089,USERS=FAIL
COMM OPTION=CLOSE,DBID=089
REPORT AREA=CXX,DBID=089,TYPE=A
EXTEND AREA=DCA,DBID=089
ACCESS STATUS=WRITE,DBID=089
REPORT AREA=CXX,DBID=089,TYPE=A
/*
 Datacom Utilities
ƒ EXTRACT
– Provides a sequential file of the table in a
readable format
//DCA089E DD DSN=DBADMIN.DBJCL.GBT.D089DCA.EXT2811.VER1,
// SPACE=(TRK,(4,999),RLSE),
// DISP=(NEW,CATLG,DELETE)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
REPORT AREA=CXX,DBID=089,TYPE=A
ACCESS STATUS=OFF,DBID=089
EXTRACT DBID=089,AREA=DCA,TABLE=DCA,DDNAME=DCA089E,
SEQ=NATIVE,SLACK=0
/*
C:\Documents and
ttings\uk064778\Des
 Datacom Utilities
ƒ BACKUP
– Extracts AREA data to sequential file in backup
format
//DCA089O DD DSN=DBADMIN.DBJCL.GBT.D089DCA.BAK2811.VER1,
// UNIT=3390,DISP=(NEW,CATLG,DELETE),
// SPACE=(TRK,(20,999),RLSE)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
REPORT AREA=CXX,DBID=089,TYPE=A
ACCESS STATUS=OFF,DBID=089,USERS=FAIL
COMM OPTION=CLOSE,DBID=089
BACKUP AREA=DCA,DBID=089,DDNAME=DCA089O,SEQ=NATIVE,
C:\Documents and
SEQBUFS=128,RECID=YES,BLKSIZE=18452 ttings\uk064778\Des

ACCESS STATUS=WRITE,DBID=089
/*
 Datacom Utilities
ƒ LOAD
– Clears the data area and loads data from
sequential file

ACCESS STATUS=OFF,DBID=089,USERS=FAIL
COMM OPTION=CLOSE,DBID=089
LOAD AREA=DCA,DBID=089,
FORMAT=EXTRACT,
SORT=5018,OPTIMIZE=YES,
TABLE=DCA,
DDNAME=DCA089E,
KBYTES=9999
ACCESS STATUS=WRITE,DBID=089
 Datacom Utilities
ƒ REORG
– Use EXTRACT or BACKUP & LOAD
– Load’s the data into Native key sequence
– Can aid performance if high deletes/adds
– Also rebuilds the index for the table
– REORG command available for large tables
ƒ Up to 25 Parallel BACKUPS/LOADS by key ranges
 Datacom Utilities
ƒ Move files to different Volumes
– Not a true Utility function
– Use Backup/Delete/INIT
– Use DFDSS
 Logging
ƒ Datacom writes details to LXX area
ƒ Regular LXX to RXX spill needed
ƒ RXX as GDG’s
ƒ Spill direct to tape or disk file?
ƒ Set MUF to warn when LXX gets to around
50%
– MUF parameter LOGSPILL 50,89,70,40,30
 BACKUP, RESTORE
ƒ Choose method
– DBUTILITY Backups
– DFDSS Copies
– DFDSS SNAPSHOTS
– Volume Backups
– Mirror Splits
ƒ QUIESCE or Full outage?
ƒ Real or Virtual tape?
ƒ Onsite or Offsite?
ƒ Include or Exclude Indexes?
ƒ Backup CXX
 BACKUP, RESTORE
ƒ Restores
– For DBUTIL backups LOAD JCL steps need to
be built
– For DFDSS backups or snapshots you need
RESTORE steps
– Rebuild Indexes
– Roll Forwards using RXX tapes
 Datacom Updates
ƒ New Release’s
– CA provide sample JCL that needs to be
adapted
– Plan timing of upgrade process
– Backup everything first
– Prepare fallback
ƒ Hypers are issued for major bug fixing
ƒ Fix’s are available from Support Connect
website
Questions?