Table Of ContentFront cover
VSAM Demystified
Learn the latest VSAM functions and
manage VSAM data
Understand, evaluate, and use
VSAM properly
Learn problem determination
and recommendations
Mary Lovelace
Jose Dovidauskas
Alvaro Salla
Valeria Sokal
ibm.com/redbooks
International Technical Support Organization
VSAM Demystified
Auguest 2022
SG24-6105-02
Note: Before using this information and the product it supports, read the information in “Notices” on
pagexi.
Third Edition (Auguest 2022)
This edition applies to z/OS Version 1 Release 13 DFSMS (product number 5694-A01).
© Copyright International Business Machines Corporation 2001, 2022. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
The team who wrote this book. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Now you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Stay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Summary of changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
August 2022, Third Edition (minor update) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
March 2013, Third Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii
Chapter 1. VSAM basics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 VSAM functions by release level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 What is VSAM?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.1 What is an access method? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.2 VSAM access types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 VSAM functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.1 Catalog management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.2 Record management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4 VSAM terminology and concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4.1 Logical record. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4.2 Physical record. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.4.3 Control interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.4.4 Spanned records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.4.5 Control area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.4.6 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4.7 Clusters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.8 Alternate indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4.9 Sphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.4.10 Splits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.4.11 VSAM buffering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.4.12 String multiprocessing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.4.13 Catalog Search Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.4.14 Extended Address Volume. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
1.5 VSAM data set organizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.5.1 Key-sequenced data set (KSDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.5.2 Entry-sequenced data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.5.3 Relative record data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
1.5.4 Variable relative record data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.5.5 Linear data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.5.6 Comparing VSAM data set organizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.5.7 Selecting a VSAM data set type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.6 Data striping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
1.7 Processing a VSAM data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.7.1 Defining VSAM data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.7.2 Allocating a VSAM data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.7.3 Opening a VSAM data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
© Copyright IBM Corp. 2001, 2022. All rights reserved. iii
1.7.4 Accessing VSAM data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
1.7.5 Unallocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
1.8 VSAM exploiters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
1.8.1 DB2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.8.2 zSeries file system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.8.3 Hierarchical file system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.8.4 CICS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.8.5 DFSMShsm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.8.6 DFSMSrmm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.8.7 Java Record I/O (JRIO). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Chapter 2. Managing your VSAM data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.1 Reorganization considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
2.1.1 Reorganizing because of lots of CI/CA splits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
2.1.2 Reorganizing because of loss of useful space in data CA . . . . . . . . . . . . . . . . . . 47
2.1.3 DB2 table space reorganization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.2 Sharing VSAM data sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.2.1 Integrity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
2.2.2 Sharing VSAM data sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
2.2.3 Write and read integrity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
2.2.4 VSAM sharing mechanisms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.2.5 Sharing data in a single VSAM control block structure. . . . . . . . . . . . . . . . . . . . . 58
2.2.6 Sharing data with many VSAM control block structures. . . . . . . . . . . . . . . . . . . . 60
2.2.7 General share options considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2.2.8 Protecting VSAM data set through DISP parameter. . . . . . . . . . . . . . . . . . . . . . . 63
2.3 Extended format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.3.1 Extended format characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.3.2 Creating an extended format data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.4 Extended addressability (EA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.5 Catalog Search Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.5.1 CSI highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.5.2 DITTO/ESA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2.6 Major sources of VSAM processing options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.6.1 Access method Control Block (ACB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
2.6.2 DD statement keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
2.6.3 Catalog BCS and VVDS entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
2.6.4 SMS constructs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
2.7 Media Manager, Open, Close, EOV in VSAM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.8 VSAM and 64 bits in real storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.9 Special considerations for COBOL users and SMB . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.9.1 Positioning error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.9.2 Waits and hangs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.9.3 ISAM data set programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Chapter 3. Guidelines for ICF catalog and VSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
3.1 ICF catalog basics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
3.1.1 Basic catalog structure (BCS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
3.1.2 VSAM volume data set (VVDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
3.2 Factors affecting catalog performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
3.2.1 Catalog configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
3.2.2 BCS definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
3.2.3 VVDS definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
3.2.4 Caching catalogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
iv VSAM Demystified
3.2.5 GRS configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
3.3 Catalog problem determination. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
3.3.1 Using the EXAMINE command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
3.3.2 Using DIAGNOSE command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
3.3.3 Locking Catalogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
3.4 Catalog management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
3.4.1 Catalog sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
3.4.2 Creating a balanced catalog environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
3.4.3 Reorganizing catalogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
3.4.4 Using the Catalog Search Interface (CSI). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
3.4.5 SYSZTIOT catalog contention detection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
3.4.6 Catalog autotuning function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
3.4.7 Catalog backup and recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
3.4.8 BCS forward recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
3.4.9 RACF and REPRO MERGECAT command. . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.4.10 Catalog IMBED/REPLICATE health check. . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.4.11 Helpful frequently asked questions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.4.12 Diagnosing prolonged catalog ENQ times . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
3.4.13 Monitoring the catalog address space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Chapter 4. VSAM performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.1 Performance analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.1.1 Service level agreement (SLA). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
4.1.2 Transaction response time components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
4.1.3 External throughput rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
4.1.4 I/O performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
4.2 VSAM performance management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.3 VSAM defaults and rule-of-thumbs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.4 Parameters affecting performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.4.1 Allocation units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.4.2 Optimizing control area (CA) size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.4.3 Partial release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
4.4.4 Allocation constraint relief. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
4.4.5 Control interval size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
4.4.6 FREESPACE definition for KSDS and VRRDS . . . . . . . . . . . . . . . . . . . . . . . . . 140
4.4.7 Data Control Area Reclaim. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
4.4.8 Index options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4.4.9 Keyrange and ordered options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4.4.10 Share options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
4.4.11 Initial load option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
4.4.12 Region size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
4.4.13 Buffering options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.4.14 How BUFFERSPACE, BUFSP, BUFND, and BUFNI affect buffering . . . . . . . 151
4.4.15 Buffering techniques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4.4.16 Data compression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
4.4.17 VSAM data striping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
4.5 VSAM performance by scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
4.5.1 I/O response time components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
4.5.2 Performance scenario that uses RMF reports . . . . . . . . . . . . . . . . . . . . . . . . . . 187
4.5.3 Reducing the number of I/Os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
4.5.4 Decreasing the VSAM I/O response time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
4.5.5 Decreasing VSAM CPU time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
4.5.6 MIDAW facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Contents v
4.6 Performance monitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
4.6.1 Resource measurement facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
4.6.2 Tivoli Decision Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
4.6.3 Generalized trace facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Chapter 5. VSAM Record Level Sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
5.1 Introducing VSAM RLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
5.1.1 What is VSAM RLS?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
5.1.2 Why RLS?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
5.1.3 How does RLS work?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
5.1.4 RLS in a single system (monoplex). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
5.1.5 CICS and VSAM RLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
5.1.6 SHAREOPTIONS and VSAM RLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
5.1.7 RLS restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
5.2 RLS terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
5.2.1 SMSVSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
5.2.2 VSAM sphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
5.2.3 RLS client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
5.2.4 Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
5.2.5 Batch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
5.2.6 Record lock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
5.2.7 True contention. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
5.2.8 False contention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
5.2.9 True/False or False/False contention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.10 Deadlocks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.11 Read integrity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.12 Retained lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.13 Lost Locks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.14 Recoverable VSAM data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.15 Non-recoverable VSAM data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
5.2.16 Quiesce a VSAM data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.2.17 Quiesce transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.2.18 Quiesce a volume or a cache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.2.19 Sharing control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.2.20 RLS mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.3 Planning for RLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.3.1 Hardware requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
5.3.2 Software requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
5.4 Implementing VSAM RLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
5.4.1 Defining Sharing Control Data Sets (SHCDS) . . . . . . . . . . . . . . . . . . . . . . . . . . 220
5.4.2 Defining CF cache structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
5.4.3 Defining the primary CF lock structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
5.4.4 Defining secondary lock structures (optional). . . . . . . . . . . . . . . . . . . . . . . . . . . 225
5.4.5 SMS definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
5.4.6 Modifying the PARMLIB IGDSMSxx Member. . . . . . . . . . . . . . . . . . . . . . . . . . . 233
5.4.7 Security definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
5.4.8 Using a VSAM data set in RLS mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
5.4.9 RLS Recoverable data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
5.5 RLS problem determination and recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
5.5.1 Hang or Wait condition in RLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
5.5.2 Internal logic errors in RLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
5.5.3 Data integrity: VSAM Data Trap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
5.5.4 VSAM_DATA_TRAP Health Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
vi VSAM Demystified
5.5.5 Data integrity: VSAM index trap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
5.5.6 Errors during RLS record management processing . . . . . . . . . . . . . . . . . . . . . . 243
5.5.7 Transaction recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
5.5.8 Lock structure full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
5.5.9 SHCDS recovery procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
5.5.10 Latch contention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
5.5.11 RLS rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
5.6 Operational procedures for RLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
5.6.1 Working with the SMSVSAM address space . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
5.6.2 Working with the CF structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
5.6.3 Working with the SHCDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
5.6.4 Monitoring data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
5.6.5 Changing SMS parameters dynamically. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
5.6.6 Fallback procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
5.6.7 Switching between RLS and non-RLS mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
5.6.8 Working with the IDCAMS SHCDS command . . . . . . . . . . . . . . . . . . . . . . . . . . 264
5.7 RLS enhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
5.7.1 VSAM extended addressability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
5.7.2 VSAM RLS CF lock structure duplexing and rebuilding . . . . . . . . . . . . . . . . . . . 266
5.7.3 RLS CF caching enhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
5.7.4 VSAM RLS data buffers above the 2-GB bar . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
5.7.5 VSAM data striping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
5.7.6 Reliability and availability enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
5.7.7 Multiple lock structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
5.8 RLS performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
5.8.1 Speed of the CF hardware and software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
5.8.2 DASD performance of the SHCDS data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
5.8.3 CF synchronous and asynchronous requests. . . . . . . . . . . . . . . . . . . . . . . . . . . 271
5.8.4 Local buffer pool sizing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
5.8.5 RLS cache structures sizing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
5.8.6 RLS lock structure sizing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
5.8.7 Data set level parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
5.8.8 Serialization at record level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
5.8.9 Effect of a write dominant I/O workload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
5.8.10 RLS lock structure duplexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
5.8.11 Recoverable VSAM data sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
5.8.12 Dealing with deadlocks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
5.8.13 RLS performance gains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
5.8.14 CICSPlex RLS performance comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
5.8.15 Using RLS mode in an ESDS organization. . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
5.9 RMF and VSAM RLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
5.9.1 RMF III reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
5.9.2 RMF Post Processor reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
5.9.3 SMF records covering VSAM RLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
5.10 VSAM and high availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
5.10.1 Using multiple CFs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
5.10.2 Defining multiple cache structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
5.10.3 Placement of the SHCDSs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
5.10.4 Remote copying your data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
5.10.5 Making backup copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
5.10.6 Recovery protocols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Chapter 6. DFSMStvs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Contents vii
6.1 Introducing DFSMStvs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
6.2 Why DFSMStvs?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
6.2.1 Extending CICS availability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
6.2.2 Reducing the batch window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
6.3 DFSMStvs terms and concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
6.3.1 Backward recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
6.3.2 Forward recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
6.3.3 Atomic updates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
6.3.4 Unit of work and unit of recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
6.3.5 Two-phase commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
6.3.6 In-flight and in-doubt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
6.3.7 Repeatable read. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
6.3.8 Recoverable data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
6.4 CICS support for recoverable VSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
6.5 The RLS connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
6.6 DFSMStvs logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
6.7 Recovery coordination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
6.8 Ordering and installing DFSMStvs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
6.9 Implementing DFSMStvs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
6.9.1 Defining list structures in the CFRM policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
6.9.2 Defining the log structures and logstreams in LOGR policy . . . . . . . . . . . . . . . . 325
6.9.3 DASD staging data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
6.9.4 Setting up RRS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
6.9.5 Setting up security definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
6.9.6 Modifying IGDSMSxx parmlib member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
6.10 Application requirements for DFSMStvs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
6.11 Operational considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
6.11.1 Quiescing a data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
6.11.2 Closing/deleting/renaming a data set with inflight UR. . . . . . . . . . . . . . . . . . . . 332
6.11.3 Displaying DFSMStvs information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
6.11.4 Controlling DFSMStvs processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
6.12 Changes to support DFSMStvs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
6.12.1 Changes to job control language (JCL). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
6.12.2 Changes to IDCAMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
6.12.3 Macros that have been changed to support DFSMStvs . . . . . . . . . . . . . . . . . . 343
Chapter 7. VSAM problem determination and recovery . . . . . . . . . . . . . . . . . . . . . . . 345
7.1 VSAM problem determination hints and tips. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
7.1.1 Checking your VSAM data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
7.1.2 z/OS system messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
7.1.3 System LOGREC messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
7.1.4 GTF CCW traces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
7.1.5 What can you get from the SMF records? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
7.2 Common VSAM problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
7.2.1 Lack of virtual storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
7.2.2 Initial loading problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
7.2.3 Mismatch between catalog and data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
7.2.4 Hardware errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
7.2.5 Bad data or bad channel program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
7.2.6 Structural damage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
7.2.7 Improper sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
7.2.8 Mismatch between catalog and VTOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
7.2.9 VSAM does not produce expected output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
viii VSAM Demystified
