z/OS 2.4 DFSMS Access Method Services Commands IBM SC23-6846-40 Note Before using this information and the product it supports, read the information in “Notices” on page 545. 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: 2021-06-21 © Copyright International Business Machines Corporation 1973, 2021. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures............................................................................................................... xiii Tables................................................................................................................xvii About this document...........................................................................................xix Required product knowledge.................................................................................................................... xix Referenced documents............................................................................................................................. xix z/OS information.........................................................................................................................................xx Notational conventions....................................................................................... xxi How to code access method services commands................................................ xxiii Commands............................................................................................................................................... xxiii Positional and keyword parameters........................................................................................................xxiii How to code subparameters................................................................................................................... xxiv Alphanumeric, national, and special characters.....................................................................................xxvi How to continue commands and parameters........................................................................................xxvii The terminator........................................................................................................................................ xxvii How to send your comments to IBM................................................................... xxix If you have a technical problem.............................................................................................................. xxix Summary of changes......................................................................................... xxxi Summary of changes for z/OS Version 2 Release 4 (V2R4)................................................................... xxxi Summary of changes for z/OS Version 2 Release 3 (V2R3).................................................................. xxxii Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................xxxiii Chapter 1. Using Access Method Services...............................................................1 Identifying Data Sets and Volumes............................................................................................................. 1 Dynamic Allocation.................................................................................................................................1 JCL DD Statements.................................................................................................................................2 Direct Allocation Using JCL.................................................................................................................... 4 Invoking Access Method Services............................................................................................................... 4 Using a Job or Jobstep to invoke Access Method Services...................................................................4 From a Time Sharing Option Session..................................................................................................... 5 Access Method Services Tape Library Support........................................................................................... 6 Summary of Tape Library Support......................................................................................................... 6 Access Method Services Commands for Tape Library Support............................................................ 6 Order of Catalog Use.................................................................................................................................... 9 Catalog Search Order for ALTER.............................................................................................................9 Catalog Selection Order for BLDINDEX..................................................................................................9 Catalog Selection Order for DEFINE...................................................................................................... 9 Catalog Search Order for DELETE.......................................................................................................... 9 Catalog Selection Order for EXPORT DISCONNECT............................................................................10 Catalog Search Order for LISTCAT....................................................................................................... 10 Generic Catalog Selection for DELETE and LISTCAT...........................................................................11 Understanding the Order of Assigned Data Set Attributes.......................................................................12 iii Chapter 2. Modal Commands............................................................................... 15 Modal Commands...................................................................................................................................... 15 Commonly used single job step command sequences.............................................................................15 Avoiding Potential Command Sequence Failures..................................................................................... 15 IF-THEN-ELSE Command Sequence.........................................................................................................15 Using Nested IF Commands: Example 1............................................................................................. 17 Using Nested IF Commands: Example 2............................................................................................. 17 Null Command........................................................................................................................................... 17 DO-END Command Sequence................................................................................................................... 17 Using the LASTCC Parameter...............................................................................................................18 SET Command............................................................................................................................................18 Using the SET command and MAXCC Parameter................................................................................ 18 CANCEL Command.....................................................................................................................................19 Using the CANCEL Command...............................................................................................................19 PARM Command........................................................................................................................................ 19 Using the PARM Command: Example 1............................................................................................... 21 Using the PARM Command: Example 2............................................................................................... 21 Using the PARM Command: Example 3............................................................................................... 22 Condition Codes.........................................................................................................................................22 Common Continuation Errors in Coding Modal Commands..................................................................... 23 Chapter 3. Functional Command Syntax............................................................... 25 Functional Command Syntax Summary.................................................................................................... 25 Chapter 4. ALLOCATE...........................................................................................29 Restrictions................................................................................................................................................ 29 Allocating Storage Management Subsystem Managed Data Sets............................................................30 Allocating Non-SMS Managed Data Sets...................................................................................................30 Return Codes for the ALLOCATE Command.............................................................................................. 30 Syntax for ALLOCATE