All rights reserved. This document contains proprietary and confidential material, and is only for use by licensees of the SyncSort for z/VSE proprietary software system. PROVEN performance SyncSort for z/ VSE Programmer's Guide Release 3. 7 SI-0328-G SyncSort is a registered trademark of Syncsort Incorporated 070809 © Syncsort Incorporated, 2009 All rights reserved. This document contains proprietary and confidential material, and is only for use by licensees of the SyncSort proprietary software system. This publication may not be reproduced in whole or in part, in any form, except with written permission from Syncsort Incorporated. SyncSort is a trademark of Syncsort Incorporated. All other company and product names used herein may be the trademarks of their respective companies. Table of Contents Summary of Changes . v Performance Improvements . v Data Utility Features. v Operating System . vi Messages. vi Chapter 1. Introduction . 1.1 An Introduction to SyncSort for z/VSE. 1.1 SyncSort’s Basic Functions . 1.1 SyncSort’s Data Utility and SortWriter Features . 1.2 Join Processing Sequence . 1.5 Sample SortWriter Report. 1.6 SyncSort’s Operational Features. 1.7 Structure of the Programmer’s Guide. 1.7 Related Reading. 1.9 Chapter 2. SyncSort Control Statements . 2.1 Control Statement Summary Chart . 2.3 Data Utility Processing Sequence. 2.17 Maximum Record Length Allowed . 2.23 Control Statement Examples . 2.25 Rules for Control Statements . 2.25 ALTSEQ Control Statement . 2.30 ANALYZE Control Statement. 2.32 DUPKEYS Control Statement . 2.33 Table of Contents i END Control Statement. 2.38 INCLUDE/OMIT Control Statement . 2.39 INPFIL Control Statement . 2.64 INREC Control Statement . 2.83 JOIN Control Statement . 2.86 JOINKEYS Control Statement . 2.88 MERGE Control Statement . 2.95 MODS Control Statement . 2.110 OMIT Control Statement . 2.113 OPTION Control Statement . 2.114 OUTFIL Control Statement. 2.141 OUTREC Control Statement . 2.174 RECORD Control Statement . 2.219 REFORMAT Control Statement . 2.224 SORT Control Statement . 2.227 SUM Control Statement. 2.246 XDUPFIL Control Statement . 2.249 XSUMFIL Control Statement . 2.250 Chapter 3. Using the SyncSort Dictionary Feature . 3.1 The Dictionary Feature . 3.1 Dictionary Statement Format . 3.8 The Constant_name Statement: Rules and Syntax . 3.11 The Field_name Statement: Rules and Syntax . 3.13 The Operator Statement: Rules and Syntax. 3.21 Using Dictionary_names in SyncSort Control Statements . 3.26 Error Handling for Dictionary Statements . 3.28 Chapter 4. How to Use SyncSort Data Utility Features . 4.1 Introduction . 4.1 Sample Data Utility Applications . 4.2 Selecting Input Records . 4.2 Selecting Relevant Fields from the Input Records . 4.7 Combining Records within a File . 4.13 Making Output Records Printable and Easy to Read . 4.16 Dividing a Report into Sections . 4.33 Writing Headers and Trailers for a Report . 4.36 Totaling and Subtotaling Data . 4.46 Counting Data Records . 4.53 Creating Multiple Output Files . 4.57 Chapter 5. Job Control Language and Sample Control Statement Streams . 5.1 Six Job Control Statements That May Be Needed for the Sort/Merge . 5.1 Symbolic Filenames and Symbolic Unit Names for Job Control . 5.5 Setting up Disk Work File Statements . 5.5 Calculating the Amount of Disk Work Space . 5.8 Setting up Multiple SORTOUT Files . 5.8 Sample JCL/Control Statement Streams . 5.8 ii SyncSort for z/VSE 3.7 Programmer’s Guide Chapter 6. EXEC PARM Options. 6.1 PARM Option Summary . 6.1 SyncSort PARM Options . 6.3 Chapter 7. Invoking SyncSort from a Program . 7.1 Invoking SyncSort from an Assembler Program . 7.1 Invoking SyncSort from a COBOL Program . 7.6 Chapter 8. User Exit Programs . 8.1 What Is an Exit? . 8.1 Loading an Exit Program into Main Storage . 8.1 Linking Exit Programs to the Sort/Merge . 8.3 EXITS E11 and E31 Checkpointing and Label Processing . 8.6 EXITS E15, E25, and E35 - Changing Records and Files . 8.10 Coding a COBOL E15 Exit Program . 8.14 Coding a C E15 Exit Routine . 8.23 E25 Programs. 8.32 E35 Programs . 8.33 Coding a COBOL E35 Exit Program . 8.35 EXIT E32 - Merge Only - Changing and Substituting Records, Reading Input . 8.54 Coding a COBOL E32 Exit Program . 8.57 Coding a C E32 Exit Program . 8.62 EXITS E17 and E37 - Writing and Processing Labels . 8.66 Exits E18, E38, and E39—VSAM Exits . 8.67 Coding REXX Exits . 8.73 REXX Variables Provided by SyncSort. 8.73 Sample REXX Exit. 8.75 Chapter 9. Creating VSAM Alternate Index Files with SyncSort . 9.1 Introduction . 9.1 Sample Alternate Index Definitions: IDCAMS and SYNCBIX. 9.2.