IMS Version 13 System Utilities SC19-3662-01 IMS Version 13 System Utilities SC19-3662-01 Note Before using this information and the product that it supports, be sure to read the general information under “Notices” on page 623. This edition applies to IMS Version 13 (program number 5635-A04), IMS Database Value Unit Edition, V13.1 (program number 5655-DSM), IMS Transaction Manager Value Unit Edition, V13.1 (program number 5655-TM2), and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 1974, 2014. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this information ........vii Compilation statements .........250 Prerequisite knowledge ..........vii Running the utility in standard mode .....256 IMS function names used in this information . vii Running the utility in batch mode ......260 How new and changed information is identified . vii Running the utility in test mode .......263 How to read syntax diagrams ........viii MFS library backup procedure .......266 Accessibility features for IMS Version 13 .....ix MFS restore procedure ..........268 How to send your comments .........x Chapter 5. Program Specification Part 1. Generation utilities......1 Block (PSB) Generation utility ....271 Utility control statements .........274 Chapter 1. Application Control Blocks Alternate PCB statement.........274 Full-function or Fast Path database PCB Maintenance utility ..........3 statement..............278 Examples of the ACB Maintenance utility ....12 GSAM PCB statement .........291 Managing dynamic option (DOPT) PSBs.....13 SENSEG statement ..........293 SENFLD statement ..........297 Chapter 2. Database Description (DBD) PSBGEN statement ..........298 Generation utility ..........15 END statement ............303 DBD generation for database types ......19 Examples of the PSBGEN utility .......303 DBD generation input record structure (except Running the PSBGEN procedure .......321 for DEDB DBDs) ...........25 DEDB DBD generation input record structure . 27 Part 2. IMS catalog utilities ....323 DBD generation coding conventions .....28 DBDGEN statements ...........28 Chapter 6. ACB Generation and DBD statements ............30 DATASET statements ..........48 Catalog Populate utility (DFS3UACB) . 325 AREA statement ............63 SEGM statements ...........66 Chapter 7. IMS Catalog Alias Names LCHILD statements ..........94 utility (DFS3ALI0)..........337 FIELD statements ...........102 XDFLD statements ..........121 Chapter 8. IMS Catalog Copy utility DFSMARSH statements .........126 DFSMAP statements ..........133 (DFS3CCE0, DFS3CCI0) .......339 DFSCASE statements ..........136 DBDGEN, FINISH, and END statements . 140 Chapter 9. IMS Catalog Partition Examples of the DBDGEN utility .......140 Definition Data Set utility (DFS3UCD0) 353 Examples without secondary indexes or logical relationships.............141 Chapter 10. IMS Catalog Populate Examples with logical relationships .....149 utility (DFS3PU00) .........357 Examples with secondary indexes .....155 Running the DBDGEN procedure ......161 Chapter 11. IMS Catalog Record Purge Chapter 3. MFS Device Characteristics utility (DFS3PU10) .........367 Table utility (DFSUTB00) ......163 Running the DFSUTB00 utility .......166 Part 3. Analysis utilities and reports..............377 Chapter 4. MFS Language utility (DFSUPAA0) ............169 Chapter 12. Fast Path Log Analysis Utility control statements and syntax rules . 175 utility (DBFULTA0) .........379 Summary of control statements ......178 Fast Path report types ..........387 Message definition statements .......180 Format definition statements .......192 Partition set definition statements .....245 Table definition statements ........248 © Copyright IBM Corp. 1974, 2014 iii Chapter 13. File Select and Formatting Chapter 23. Dynamic SVC utility Print utility (DFSERA10) .......401 (DFSUSVC0) ............515 Examples of the DFSERA10 utility ......410 Examples of the DFSUSVC0 utility ......517 DFSERA10 utility modules .........416 Record Format and Print module (DFSERA30) 416 Chapter 24. Global Online Change Program Isolation Trace Record Format and utility (DFSUOLC0) .........519 Print module (DFSERA40) ........424 Examples of the DFSUOLC0 utility ......523 DL/I Call Image Capture module (DFSERA50) 427 IMS Trace Table Record Format and Print module (DFSERA60) ..........428 Chapter 25. MFS Service utility Enhanced Select module (DFSERA70) ....428 (DFSUTSA0) ............525 OM Audit Trail Format and Print module (CSLULALE) ............431 Chapter 26. Multiple Systems Verification utility (DFSUMSV0)....541 Chapter 14. IMS Monitor Report Print utility (DFSUTR20) .........433 Chapter 27. Online Change Copy Examples of the DFSUTR20 utility ......435 utility (DFSUOCU0) .........553 OLCUTL procedure ...........558 Chapter 15. Log Transaction Analysis Initializing the IMS.MODSTAT data set.....560 utility (DFSILTA0)..........437 Chapter 28. Spool SYSOUT Print Chapter 16. Offline Dump Formatter utility (DFSUPRT0) .........563 utility (DFSOFMD0) .........443 Examples of the DFSUPRT0 utility ......566 Running the DFSOFMD0 utility .......445 Chapter 29. Time-Controlled Chapter 17. Statistical Analysis utility Operations Verification utility (DFSISTS0) ............449 (DFSTVER0) ............567 Examples of the DFSISTS0 utility .......457 Examples of the DFSTVER0 utility ......569 Part 4. Log utilities ........465 Part 6. Dynamic resource definition utilities .........573 Chapter 18. Log Archive utility (DFSUARC0)............467 Chapter 30. Repository to RDDS utility Examples of the DFSUARC0 utility ......477 (CSLURP20) ............575 Examples of the CSLURP20 utility ......578 Chapter 19. Log Merge utility (DFSLTMG0) ............479 Chapter 31. RDDS to Repository utility (CSLURP10) ............579 Chapter 20. Log Recovery utility Examples of the CSLURP10 utility ......582 (DFSULTR0) ............483 Examples of the DFSULTR0 utility ......497 Chapter 32. Copy RDDS utility (DFSURCP0) ............585 Part 5. Service utilities ......503 Examples of the DFSURCP0 utility ......587 Chapter 21. Batch SPOC utility Chapter 33. Create RDDS from Log (CSLUSPOC)............505 Records utility (DFSURCL0) .....589 Examples of the Batch SPOC utility ......507 Examples of the DFSURCL0 utility ......593 Chapter 22. Database Recovery Chapter 34. Create RDDS from Control utility (DSPURX00) .....509 MODBLKS utility (DFSURCM0) ....599 Examples of the DSPURX00 utility ......512 Examples of the DFSURCM0 utility ......603 Invoking the utility using entry point DSPURXRT 512 Chapter 35. DRD IMS SYSGEN stage 1 pre-parser utility (DFSURST0) ....607 Examples of the DFSURST0 utility ......611 iv System Utilities Chapter 36. RDDS Extraction utility Trademarks ..............625 (DFSURDD0)............615 || Privacy policy considerations ........626 Examples for the DFSURDD0 utility......618 Bibliography............627 Part 7. Appendixes ........621 Index ...............629 Notices ..............623 Programming interface information ......625 Contents v vi System Utilities About this information These topics provide reference information for the utilities that you can use with the IMS™ system to generate IMS resources, work with the IMS catalog, analyze IMS activity, manage IMS logging, run the IMS Database Recovery Control (DBRC) facility, maintain IMS networking services, and use dynamic resource definition (DRD). This information is available in IBM® Knowledge Center at www.ibm.com/ support/knowledgecenter. Prerequisite knowledge Before using this information, you should understand z/OS®, and with IMS concepts, facilities, and access methods. The prerequisite publications are: v IMS Version 13 Communications and Connections v IMS Version 13 Database Administration v IMS Version 13 System Administration You can learn more about z/OS by visiting the “z/OS basic skills education” topics in IBM Knowledge Center. You can gain an understanding of basic IMS concepts by reading An Introduction to IMS, an IBM Press publication. An excerpt from this publication is available in the IBM Knowledge Center. IBM offers a wide variety of classroom and self-study courses to help you learn IMS. For a complete list of courses available, go to the IMS home page at ibm.com/ims and link to the Training and Certification page. IMS function names used in this information In this information, the term HALDB Online Reorganization refers to the integrated HALDB Online Reorganization function that is part of IMS Version 13, unless otherwise indicated. How new and changed information is identified New and changed information in most IMS library PDF publications is denoted by a character (revision marker) in the left margin. The first edition (-00) of Release Planning, as well as the Program Directory and Licensed Program Specifications,donot include revision markers. Revision markers follow these general conventions: v Only technical changes are marked; style and grammatical changes are not marked. v If part of an element, such as a paragraph, syntax diagram, list item, task step, or figure is changed, the entire element is marked with revision markers, even though only part of the element might have changed. v If a topic is changed by more than 50%, the entire topic is marked with revision markers (so it might seem to be a new topic, even though it is not). © Copyright IBM Corp. 1974, 2014 vii Revision markers do not necessarily indicate all the changes