Front cover IM S in the Parallel Sysplex Volume III: IMSplex Implementation and Operations Implement and operate IMS data sharing Implement and operate IMS shared message queues Implement and operate the new IMS CSL features Jouko Jantti Juan Jesús Iniesta Martínez Knut Kub ein Bill Stillwell Gary Wicks ibm.com/redbooks International Technical Support Organization IMS in the Parallel Sysplex Volume III: IMSplex Implementation and Operations June 2003 SG24-6929-00 Note: Before using this information and the product it supports, read the information in “Notices” on p agexv. First Edition (June 2003) This edition applies to IMS Version 8 (program number 5655-C56) or later for use with the OS/390 or z/OS operating systems. © Copyright International Business Machines Corporation 2003. 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xv Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii The team that wrote this redbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xvii Become a published author. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Part 1. IMSplex implementation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 1. Data sharing implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1 Migration steps to implement data sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.2 Ensure that SHARECTL is set in the RECON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3 Register databases at SHARELVL(1). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.4 Parameters to review in IMS procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.4.1 DL/I batch processing regions: DBBBATCH and DLIBATCH procedures . . . . . . . 4 1.4.2 DL/I Separate Address Space: DLISAS procedure. . . . . . . . . . . . . . . . . . . . . . . . . 5 1.4.3 IMS Transaction Manager and IMS DBCTL: IMS and DBC procedures. . . . . . . . . 5 1.4.4 Message processing region: DFSMPR procedure . . . . . . . . . . . . . . . . . . . . . . . . . 6 1.4.5 Batch message processing: IMSBATCH procedure. . . . . . . . . . . . . . . . . . . . . . . . 6 1.4.6 Fast Path application: IMSFP procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.4.7 Fast Path utility region: FPUTIL procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.4.8 IRLM: DXRJPROC procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.5 Comments on data sharing overhead. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 1.6 Defining VSAM share options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.7 Set VSAM and OSAM data set dispositions to share. . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.8 Adjust ACCESS=xx in the DATABASE macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.9 Excluding a database from data sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 1.10 Examine DBRC skeletal JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 1.11 Buffer pool use in a data sharing environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 1.12 Calculate the size of the OSAM/VSAM XI structures . . . . . . . . . . . . . . . . . . . . . . . . . 15 1.13 Calculate the size of the IRLM lock structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 1.13.1 Sizing the lock structure lock table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 1.13.2 Sizing the lock structure record list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 1.13.3 Example of IRLM lock structure sizing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 1.14 Defining the OSAM, VSAM and IRLM CF structures . . . . . . . . . . . . . . . . . . . . . . . . . 18 1.15 Update DFSVSMxx with CFNAMES parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 1.16 Registering databases at SHARELVL(2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 1.17 Update IRLM start procedures for global data sharing. . . . . . . . . . . . . . . . . . . . . . . . 19 1.17.1 Startup the IRLM procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 1.18 Starting the CFRM policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 1.19 Registering databases at SHARELVL(3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 1.20 Cloning your IMS subsystems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 1.21 Starting the second IMS subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 1.22 Testing data sharing with simple applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 1.23 IMS implementation for VSO data sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 1.24 Fast Database Recovery implementation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 1.24.1 FDBR startup procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 © Copyright IBM Corp. 2003. All rights reserved. iii Chapter 2. Implementing IMS shared queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 2.1 What needs to be done in IMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 2.1.1 IMS system definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 2.1.2 IMS execution time parameters - DFSPBxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 2.1.3 DFSDCxxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 2.1.4 DFSSQxxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 2.1.5 DFSVSMxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 2.2 Shared queues components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 2.2.1 BPE for CQS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 2.2.2 BPE PPT entry for CQS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 2.2.3 CQS start procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 2.2.4 CQSIPxxx (initialization) PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 2.2.5 CQSSLxxx local structure definition PROCLIB member. . . . . . . . . . . . . . . . . . . . 40 2.2.6 CQSSGxxx global structure definition PROCLIB member . . . . . . . . . . . . . . . . . . 41 2.2.7 IMS and CQS library relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 2.2.8 CQS PROCLIB member relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 2.2.9 Shared queues structure sizing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 2.2.10 Shared queues structure definitions in CFRM . . . . . . . . . . . . . . . . . . . . . . . . . . 46 2.2.11 Security definitions for CQS structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 2.2.12 Allocation of CQS data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 2.2.13 System Logger definitions in LOGR policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 2.3 Additional System Logger considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 2.4 Other Parallel Sysplex policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Chapter 3. Implementing the Common Service Layer (CSL) . . . . . . . . . . . . . . . . . . . . 55 3.1 Before the first IMS joins the IMSplex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 3.2 Setting up a CSL environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 3.2.1 CSL definitional requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 3.2.2 Checking the requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 3.2.3 Basic rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 3.2.4 Hardware and software currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 3.3 Updating the CFRM couple data set (CDS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 3.3.1 Reformatting the CFRM control data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 3.3.2 Sample resource structure definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 3.3.3 Resource structure failure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 3.3.4 Shared queue structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 3.4 Setting up the Base Primitive Environment (BPE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 3.4.1 Base Primitive Environment PROCLIB members. . . . . . . . . . . . . . . . . . . . . . . . . 60 3.4.2 Update the OS/390 program properties table (PPT). . . . . . . . . . . . . . . . . . . . . . . 60 3.4.3 BPE user-supplied exit routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 3.4.4 BPE configuration parameter PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . 61 3.4.5 BPE user exit PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 3.4.6 BPEINIT parameter in BPE execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 3.5 Setting the Structured Call Interface (SCI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 3.5.1 SCI startup procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 3.5.2 SCI execution parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 3.5.3 SCI initialization PROCLIB member CSLSIxxx. . . . . . . . . . . . . . . . . . . . . . . . . . . 65 3.5.4 SCI security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 3.6 SCI user exit routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 3.7 Setting up the Operations Manager (OM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 3.7.1 OM startup procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 3.7.2 OM execution parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 3.7.3 OM initialization parameters PROCLIB member CSLOIxxx. . . . . . . . . . . . . . . . . 69 iv IMS in the Parallel Sysplex, Volume III: IMSplex Implementation and Operations 3.7.4 OM command security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 3.8 OM user exit routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 3.9 Setting up the Resource Manager (RM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 3.9.1 RM infrastructure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 3.9.2 Maintaining global resource information in the resource structure . . . . . . . . . . . . 73 3.10 RM definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 3.10.1 RM startup procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 3.10.2 RM execution parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 3.10.3 RM initialization parameters PROCLIB member CSLRIxxx . . . . . . . . . . . . . . . . 75 3.10.4 RM security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 3.11 RM user exit routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 3.12 Setting up the IMS control region for CSL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 3.13 Setup IMS PROCLIB members. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 3.13.1 DFSPBxxx PROCLIB member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 3.13.2 DFSCGxxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 3.13.3 DFSDCxxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 3.13.4 DFSVSMxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 3.14 DBRC address spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3.15 IMSplex security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3.15.1 Security issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3.16 Miscellaneous considerations when implementing CSL. . . . . . . . . . . . . . . . . . . . . . . 80 3.16.1 RSR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 3.16.2 Features not affected by CSL or STM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Chapter 4. Implementing the sysplex terminal management (STM). . . . . . . . . . . . . . . 83 4.1 Enabling sysplex terminal management (STM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 4.1.1 Prerequisites for STM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 4.1.2 Migration and coexistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 4.2 Recovery and recoverability status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 4.2.1 System defaults in DFSDCxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 4.2.2 Setting status recovery mode (SRM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 4.2.3 Setting status recoverability (RCVYxxxx) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 4.2.4 SRMDEF and RCVxxxx rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 4.2.5 ETO descriptors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 4.3 Overriding SRM and RCVYxxxx defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 4.3.1 Logon exit (DFSLGNX0). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 4.3.2 Signon exit (DFSSGNX0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 4.4 Resource structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 4.4.1 CFSIZER tool for resource structure definition. . . . . . . . . . . . . . . . . . . . . . . . . . . 89 4.5 Resource types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 4.5.1 IMSplex global resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 4.5.2 Static transaction and MSNAME resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 4.5.3 CPI-C transaction resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 4.5.4 APPC descriptor resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 4.5.5 Sysplex terminal resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 4.6 Resource number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 4.6.1 Methods to calculate the resource number. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 4.6.2 QUERY STRUCTURE command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 4.7 Data element number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 4.7.1 Methods to calculate the data element number . . . . . . . . . . . . . . . . . . . . . . . . . . 92 4.7.2 QUERY STRUCTURE command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 4.8 Resource table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 4.8.1 Calculating an initial resource structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Contents v 4.9 Defining the resource structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 4.9.1 CFRM policy definition options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 4.10 Adjusting the size of the resource structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 4.11 IMS exits using STM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 4.11.1 Logon exit (DFSLGNX0). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 4.11.2 Signon exit (DFSSGNX0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 4.11.3 Output creation exit (DFSINSX0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 4.11.4 Command authorization exit (DFSCCMD0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 4.12 Considerations when STM is active . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 4.12.1 Global callable services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 4.12.2 Extended Recovery Facility (XRF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 4.12.3 Rapid Network Reconnect (RNR). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Chapter 5. Other Common Service Layer (CSL) functionalities. . . . . . . . . . . . . . . . . . 99 5.1 Global online change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 5.1.1 Setting up the global online change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 5.1.2 Requirements for the global online change. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 5.1.3 Preparation for the global online change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 5.1.4 Overview of execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 5.1.5 DFSCGxxx PROCLIB member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 5.1.6 Mixed environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 5.2 Resource consistency checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 5.2.1 Checking function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 5.2.2 Checking choice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 5.3 OLCSTAT data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 5.3.1 Definition of OLCSTAT data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 5.3.2 OLCSTAT data set header record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 5.3.3 OLCSTAT data set IMS record. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 5.3.4 OLCSTAT data set examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 5.4 Global online change utility (DFSUOLC0). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 5.4.1 DFSUOLC procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 5.4.2 Initializing OLCSTAT data set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 5.5 Online change utility (DFSUOCU0). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 5.5.1 OLCUTL procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 5.5.2 Migration to global online change. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 5.5.3 Fallback to local online change. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 5.6 Setting up the single point of control (SPOC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 5.7 Setting up the TSO SPOC program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 5.7.1 Updating the logon procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 5.7.2 Using ALTLIB and LIBDEF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 5.7.3 Invoking IMS single point of control (SPOC). . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 5.7.4 Setting SPOC preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 5.8 Setting up a user written interface to Operations Manager. . . . . . . . . . . . . . . . . . . . . 113 5.8.1 REXX SPOC functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 5.8.2 REXX SPOC file allocation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 5.8.3 The REXX SPOC environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 5.8.4 CSLULXSB TSO command program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 5.8.5 IMSSPOC environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 5.8.6 CSLULGTS() REXX external function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 5.9 REXX SPOC API return and reason codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 5.9.1 API return codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 5.9.2 API warning reason codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 5.9.3 API parameter error reason codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 vi IMS in the Parallel Sysplex, Volume III: IMSplex Implementation and Operations 5.9.4 API system error reason codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 5.10 Automatic RECON loss notification (ARLN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 5.10.1 Using DBRC with SCI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 5.11 Two choices to enable ARLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 5.11.1 IMSPLEX execution parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 5.11.2 DBRC SCI registration exit (DSPSCIX0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 5.12 Implementing ARLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 5.12.1 Getting started with ARLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 5.12.2 Specifying IMSPLEX parameter in batch and utility regions. . . . . . . . . . . . . . . 120 5.13 Changing and removing the IMSplex name in RECON . . . . . . . . . . . . . . . . . . . . . . 121 5.14 DSPSCIX0 details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 5.14.1 The IMS provided default exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 5.15 Recommendations for ARLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 5.16 Language environment (LE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 5.16.1 Defining LE run-time options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 5.16.2 Changing LE run-time options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 5.17 Dynamic LE run-time option support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 5.17.1 DFSCGxxx LEOPT parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 5.18 Migration considerations for LE dynamic overrides. . . . . . . . . . . . . . . . . . . . . . . . . . 125 5.19 DFSBXITA IMS exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 5.19.1 DFSBXITA logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 5.19.2 CEEBXITA as an installation-wide exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 5.19.3 LE option recommendations for IMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 Chapter 6. Implementing VTAM Generic Resources and RNR . . . . . . . . . . . . . . . . . . 131 6.1 VTAM Generic Resource implementation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 6.2 VTAM components of VTAM Generic Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 6.2.1 VTAM start option parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 6.2.2 Coupling Facility structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 6.2.3 VTAM Generic Resources resolution exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 6.3 IMS definitions for VTAM Generic Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 6.3.1 IMS start-up parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 6.3.2 Affinity management parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 6.3.3 IMS ESTAE processing parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 6.3.4 Logoff and signoff user exits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 6.4 Tasks related to generic resource implementation. . . . . . . . . . . . . . . . . . . . . . . . . . . 133 6.5 Implementing VTAM Generic Resources for IMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 6.6 How to implement Rapid Network Reconnect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 6.6.1 Rapid Network Reconnect special notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Part 2. IMSplex operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Chapter 7. Operations in a data sharing environment. . . . . . . . . . . . . . . . . . . . . . . . . 139 7.1 Support procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 7.2 Online change procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 7.2.1 Overview of IMS Version 8 global online change . . . . . . . . . . . . . . . . . . . . . . . . 141 7.3 Job and region scheduling procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 7.3.1 Submitting BMPs on any IMS in the Parallel Sysplex. . . . . . . . . . . . . . . . . . . . . 142 7.3.2 /START REGION command enhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 7.4 Command recognition character support for TM and DCCTL. . . . . . . . . . . . . . . . . . . 144 7.5 IMS global scope commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 7.5.1 Alternative to global commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 7.5.2 IMSplex command support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 7.6 Commands associated with Coupling Facility operation. . . . . . . . . . . . . . . . . . . . . . . 146 Contents vii 7.6.1 Display commands associated with Coupling facility and structures . . . . . . . . . 146 7.6.2 SETXCF commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 7.6.3 Manipulating the Coupling Facility links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 7.7 Commands used by IRLM in support of data sharing. . . . . . . . . . . . . . . . . . . . . . . . . 150 7.7.1 MODIFY IRLM STATUS command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 7.7.2 Other MODIFY command options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 7.7.3 IRLM Version 2 Release1 tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 7.8 DBRC and IMS data sharing operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 7.9 Automated operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 7.10 Shared VSO operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 7.10.1 Connecting to the SVSO structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 7.10.2 Preloading the data into the structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 7.10.3 Reading from and writing to the CF structure. . . . . . . . . . . . . . . . . . . . . . . . . . 156 7.10.4 Cast-out to DASD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 7.10.5 New and changed VSO commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 7.10.6 System managed rebuild and automatic alter support for SVSO . . . . . . . . . . . 158 7.11 Shared SDEP operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 7.12 FDBR operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 7.12.1 FDBR initialization and synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 7.12.2 FDBR tracking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 7.12.3 FDBR surveillance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 7.12.4 FDBR recovery processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 7.12.5 Restarting IMS after FDBR completion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 7.12.6 DBRC authorizations with FDBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 7.12.7 General FDBR operational recommendations . . . . . . . . . . . . . . . . . . . . . . . . . 163 Chapter 8. Data sharing backup, recovery, and restart. . . . . . . . . . . . . . . . . . . . . . . . 165 8.1 Database backup and recovery responsibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 8.2 Database backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 8.2.1 Database image copy (DFSUDMP0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 8.2.2 Concurrent image copy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 8.2.3 Online image copy (DFSUICP0). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 8.2.4 HSSP image copy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 8.2.5 Database Image Copy 2 (DFSUDMT0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 8.2.6 Restrictions for concurrent updates with different image copy types . . . . . . . . . 171 8.3 Log archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 8.4 Change accumulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 8.5 Database recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 8.5.1 Forward recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 8.5.2 Time stamp recovery considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 8.5.3 Dynamic backout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 8.5.4 Batch backout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 8.5.5 Remote Site Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 8.6 IMS Online Recovery Service (ORS) support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 8.7 Failure and recovery scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 8.8 Testing the data sharing sysplex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 8.9 Major data sharing component recovery restart processes . . . . . . . . . . . . . . . . . . . . 175 8.9.1 Failures of the CF component and its structures . . . . . . . . . . . . . . . . . . . . . . . . 175 8.9.2 Use of the event notification facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 8.9.3 Failures with individual Coupling Facility structure components. . . . . . . . . . . . . 176 8.9.4 DEDB VSO structure read and write errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 8.9.5 Failures of the Coupling Facility link component. . . . . . . . . . . . . . . . . . . . . . . . . 181 8.9.6 Failure of the OS/390 component. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 viii IMS in the Parallel Sysplex, Volume III: IMSplex Implementation and Operations