Version 1 Release 1 IBM Z Table Accelerator Programming Guide IBM SC28-3233-00 Notices © Copyright International Business Machines Corporation 2020 © Data Kinetics Ltd. 2020 Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Figures............................................................................................................... xiii Tables................................................................................................................. xv Preface..............................................................................................................xvii Audience for this Guide............................................................................................................................ xvii What you should know to use this Guide.................................................................................................xvii What is covered in this Guide................................................................................................................... xvii IBM Z Table Accelerator basics.......................................................................................................... xvii How to call IBM Z Table Accelerator.................................................................................................. xvii Operational considerations.................................................................................................................xvii Accessing IBM Z Table Accelerator...................................................................................................xviii Diagnosing errors............................................................................................................................... xviii Supplementary material.................................................................................................................... xviii Naming protocol...................................................................................................................................... xviii Conventions Used in this Guide...............................................................................................................xviii Conventions for entering parameters..................................................................................................xix Glossary..................................................................................................................................................... xix Additional IBM Z Table Accelerator references........................................................................................ xx Chapter 1. Introduction......................................................................................... 1 Base product................................................................................................................................................ 1 IBM Z Table Accelerator terminology......................................................................................................... 1 tableSPACE Region (TSR).......................................................................................................................1 VTS (Virtual Table Share)....................................................................................................................... 2 Program Call Server (PC Server)............................................................................................................ 2 Tables......................................................................................................................................................2 Table organization.................................................................................................................................. 2 Indexes and Alternate Indexes..............................................................................................................3 Search methods......................................................................................................................................3 Libraries.................................................................................................................................................. 5 Protecting IBM Z Table Accelerator tables............................................................................................5 Chapter 2. IBM Z Table Accelerator basics............................................................. 7 Getting started with IBM Z Table Accelerator............................................................................................ 7 Calling protocol.......................................................................................................................................7 Using IBM Z Table Accelerator...............................................................................................................8 Defining a table.......................................................................................................................................8 Opening a table.......................................................................................................................................8 Populating IBM Z Table Accelerator tables.........................................................................................10 Retrieval and update processing......................................................................................................... 10 Close processing.................................................................................................................................. 12 Searching libraries................................................................................................................................12 Return values........................................................................................................................................12 Advanced IBM Z Table Accelerator functionality..................................................................................... 13 Date-sensitive processing....................................................................................................................13 Generations.......................................................................................................................................... 14 Operational parameters and switches................................................................................................ 14 Version control..................................................................................................................................... 14 iii Multitasking batch................................................................................................................................14 Sophisticated memory management...................................................................................................15 Summary of IBM Z Table Accelerator commands................................................................................... 15 IBM Z Table Accelerator command categories by TSR access................................................................ 19 Chapter 3. IBM Z Table Accelerator commands.....................................................21 Retrieval commands.................................................................................................................................. 21 Update commands.....................................................................................................................................22 Table control commands...........................................................................................................................22 Opening an Alternate Index.................................................................................................................23 Open Indirect....................................................................................................................................... 23 Library maintenance commands...............................................................................................................24 System control commands........................................................................................................................24 IBM Z Table Accelerator command descriptions..................................................................................... 24 Allocate (AL)......................................................................................................................................... 25 Banner Retrieval (BN)...........................................................................................................................25 Create Alternate Index Definition (CA)................................................................................................26 Change Table Definition (CD)...............................................................................................................27 Change Generations (CG).....................................................................................................................28 Close Table (CL)....................................................................................................................................29 Change Name (CN)..............................................................................................................................