z/OS Version 2 Release 4 DFSMStvs Administration Guide IBM GC52-1388-40 Note Before using this information and the product it supports, read the information in “Notices” on page 335. This edition applies to Version 2 Release 4 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2020-04-27 © Copyright International Business Machines Corporation 2003, 2020. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................ vii Tables.................................................................................................................. ix About this document...........................................................................................xiii Required product knowledge....................................................................................................................xiii z/OS information........................................................................................................................................xiii Notational Conventions............................................................................................................................. xiii How to send your comments to IBM......................................................................xv If you have a technical problem.................................................................................................................xv Summary of changes..........................................................................................xvii Summary of Changes for z/OS V2R4........................................................................................................xvii Summary of changes for z/OS Version 2 Release 3 (V2R3) and its updates.......................................... xvii z/OS Version 2 Release 1 summary of changes.......................................................................................xvii Chapter 1. Evaluating, planning, and installing DFSMStvs.......................................1 Evaluating and planning for DFSMStvs........................................................................................................1 Software dependencies..........................................................................................................................1 Processing restrictions...........................................................................................................................3 Migrating to z/OS Version 1 Release 4........................................................................................................ 4 SYS1.PARMLIB changes for DFSMStvs..................................................................................................5 JCL changes for DFSMStvs.....................................................................................................................6 System command changes for DFSMStvs............................................................................................. 6 Access method services.........................................................................................................................7 Changes to the executable macros......................................................................................................10 Messages and codes............................................................................................................................ 11 Migration tasks..................................................................................................................................... 11 Additional information......................................................................................................................... 12 Installing DFSMStvs...................................................................................................................................13 Enabling DFSMStvs on your z/OS system............................................................................................13 Coding IGDSMSxx.................................................................................................................................13 Chapter 2. Administering resources for DFSMStvs................................................ 15 Controlling access to VSAM data sets.......................................................................................................15 Accessing data sets in DFSMStvs mode.............................................................................................. 15 Specifying read integrity...................................................................................................................... 23 Specifying a timeout value for lock requests...................................................................................... 24 Defining data sets for DFSMStvs access................................................................................................... 24 Allocating data sets..............................................................................................................................24 Listing and controlling SMSVSAM recovery......................................................................................... 46 Altering data set attributes.................................................................................................................. 54 Defining alternate indexes................................................................................................................... 74 Defining attributes for clusters and cluster components................................................................... 89 Securing log streams............................................................................................................................... 116 Chapter 3. Customizing the DFSMStvs environment............................................117 Coding VSAM macros...............................................................................................................................117 iii Subparameters with GENCB, MODCB, SHOWCB, and TESTCB........................................................ 117 Use of list, execute, and generate forms of VSAM macros............................................................... 118 Examples of generate, list, and execute forms.................................................................................120 ACB—generate an access method control block at assembly time................................................. 121 EXLST—generate an exit list at assembly time................................................................................. 129 GENCB—generate an access method control block at execution time............................................ 131 GENCB—generate an exit list at execution time............................................................................... 138 IDALKADD—RLS record locking.........................................................................................................147 RPL—generate a request parameter list at assembly time...............................................................152 SCHBFR—search buffer......................................................................................................................160 SHOWCAT—display the catalog.........................................................................................................161 Understanding VSAM macro return and reason codes...........................................................................167 OPEN return and reason codes..........................................................................................................167 CLOSE return and reason codes........................................................................................................ 173 Control block manipulation macro return and reason codes........................................................... 174 Record management return and reason codes.................................................................................175 Return codes from macros used to share resources among data sets............................................194 End-of-volume return codes..............................................................................................................195 SHOWCAT return codes..................................................................................................................... 196 Coding VSAM user-written exit routines.................................................................................................196 General guidelines for coding exit routines.......................................................................................197 Programming guidelines.................................................................................................................... 198 IGW8PNRU routine for batch override.............................................................................................. 199 EODAD exit routine to process end of data.......................................................................................200 EXCEPTIONEXIT exit routine.............................................................................................................201 JRNAD exit routine to journalize transactions.................................................................................