Comparex VSE User Guide

Total Page:16

File Type:pdf, Size:1020Kb

Comparex VSE User Guide SERENA COMPAREX 8.7 for z/OS User’s Guide Serena Proprietary and Confidential Information Copyright Copyright © 2001–2011 Serena Software, Inc. All rights reserved. This document, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by such license, no part of this publication may be reproduced, photocopied, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Serena. Any reproduction of such software product user documentation, regardless of whether the documentation is reproduced in whole or in part, must be accompanied by this copyright statement in its entirety, without modification. This document contains proprietary and confidential information, and no reproduction or dissemination of any information contained herein is allowed without the express permission of Serena Software. The content of this document is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Serena. Serena assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. Trademarks Serena, TeamTrack, StarTool, PVCS, Collage, Comparex, Dimensions, Serena Dimensions, Mashup Composer, Mashup Exchange, Prototype Composer, Mariner and ChangeMan are registered trademarks of Serena Software, Inc. The Serena logo, Version Manager, Meritage and Mover are trademarks of Serena Software, Inc. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners. U.S. Government Rights Any Software product acquired by Licensee under this Agreement for or on behalf of the U.S. Government, its agencies and instrumentalities is "commercial software" as defined by the FAR. Use, duplication, and disclosure by the U.S. Government is subject to the restrictions set forth in the license under which the Software was acquired. The manufacturer is Serena Software, Inc., 1900 Seaport Boulevard, 2nd Floor, Redwood City, California 94063-5587. Publication date: April 2011 (updated 17 June 2011) CONTENTS About This Book 17 Audience 17 Code Conventions 17 Legend 18 Related Documents 19 Chapter 1: Introduction In This Chapter 21 Comparex Overview 22 Types of Files You Can Compare 22 Running Comparex: All-Defaults or Keywords 23 All-Defaults 23 Keywords 24 DATA or TEXT File Comparison 24 DATA 24 TEXT 24 Environment Definitions 26 Chapter 2: Major Processing Steps Processing Steps 29 Comparex with No Keywords 30 Comparex Defaults 31 Comparex with Keywords 33 Processing of SYSPRINT 34 Files Opened 34 Reading of Records 35 Comparison of Records - DATA 35 Comparison of Records - TEXT 36 Writing of SYSUT3 36 Writing of SYSUT3x 36 Writing of SYSPRINT 37 End-of-Job Processing 38 Keyword General Comments 39 Sample Run 41 3 Contents Chapter 3: TEXT Keywords What Is TEXT? 43 TEXT Processing Keywords 44 What Is TEXT Comparison Logic? 45 TEXT Examples 47 Keywords Not Available with TEXT 50 DUMMY File 50 KEYs 50 SEGMENTs 50 DATA 50 IDENTITYs 50 Fields 51 DESENs 51 MASKs 51 FLDSONLY 51 LINE 51 LINELIM 51 NIBBLE 51 PRINTs 52 Advantages of TEXT 52 Disadvantages of TEXT 53 Decisions About DATA and TEXT 53 End-of-Job Counts 53 TEXT Keywords 53 BUFF 54 FRAME 55 MLC 55 PRINT 56 SQUEEZE 56 TEXT 56 Chapter 4: DATA Keywords DATA File Synchronization Keywords 63 What Is DATA? 64 What Is DATA Comparison Logic? 64 DUMMY Files 64 KEY Synchronization 65 SEGMENT Synchronization 67 Physical-Record-Number Synchronization 71 Keywords Not Available with DATA 73 Advantages of DATA 73 4 Serena® Comparex® 8.7 for z/OS User’s Guide Disadvantage of DATA 74 Decisions About DATA and TEXT 74 End-of-Job Counts 74 CPX74I - Bytes Underscored 74 CPX73I - COPYSPLIT Record Counts 74 CPX75I - Record Counts 75 CPX76I - Unusable Fields, IDENTITYs, SEGMENTs, DESENs 75 CPX78I - Member Counts 75 DATA Keywords 75 KEY, KEY1, and KEY2 Keywords 75 KEY1 77 KEY2 77 SEGMENT 77 Chapter 5: Input Processing Keywords List of Keywords 81 Comparex Keyword Input 84 Comments 84 HELP 84 Incorrect Keywords 85 Correct Keywords 85 Correct and Incorrect Keywords on Same SYSIN Record 85 End of Data on SYSIN 85 SYSUT1, SYSUT2, and SYSUT3 or SYSUT3x Opened 85 SYSUT1 and SYSUT2 Opened 85 SKIPUT1 and SKIPUT2 86 SYSUT3 Opened 86 SYSUT3x Opened 86 SYSUT1 and SYSUT2 Read 86 STOPAFT 87 CONTINUE 87 Displacement 87 Selecting Records for Comparison 87 Keywords 88 Form of Keywords 88 Inclusive Keywords 89 Exclusive Keywords 89 Pairing Records for Comparison 90 Types of DATA Synchronization 90 TEXT 91 Comparing Only on Specific Fields 91 5 Contents FIELD 91 MASK 92 IDENTITY 92 Keywords for Input Processing 93 CCSID1 and CCSID2 93 CONTINUE 95 CPXEXIT 95 CPXIFACE 96 DATA 96 CSECT Parsing Enhancements 98 DESEN 99 DESEN1 100 DESEN2 100 DIRECTORY 100 END 103 FIELD, FIELD1, and FIELD2 Keywords 104 FIELD1 108 FIELD2 108 FILTERIN 108 FILTEROUT 110 FILTORIN 110 FILTOROUT 111 IDENTITY 111 A-IDENTITY 113 IGNORSIN 114 MASK 114 MASK1 115 MASK2 116 MODE 116 SCAN 117 SKIPUT1 118 SKIPUT2 118 STOPAFT 119 SYSUT1 119 SYSUT2 122 WILDCARD 122 Chapter 6: Display Processing Keywords Printing the Comparison Results 125 Display Processing Keywords 125 All-Defaults Difference Report 128 6 Serena® Comparex® 8.7 for z/OS User’s Guide All-Defaults Difference Report with DATA 128 Modifying the Difference Report 129 ASCII 129 CASE 130 DASH 131 DECIMAL 131 EBCDIC 132 FLDSONLY 132 FORMAT 133 Smart Fields 136 GENFLDS 137 HALT 137 HEX 138 IGNORSIN 138 INTERLEAVE 139 KEYSONLY 139 KILLECHO 139 KILLRC 140 KILLSPIE 140 LINE 140 LINELIM 141 MAXDIFF 141 MAXMATCH 142 MBRHDR 142 NIBBLE 143 PAGE 144 PLUS 144 PRINT 145 UNICODE 146 Chapter 7: Copyfile to Output Files Copyfile Keywords 147 Output Definition SYSUT3 148 Output Definitions SYSUT3A Through SYSUT3E 149 Copying Differing Records 150 Identifying Differing Records 150 COPYDIFF 152 COPYDIFF Format Options 153 ChangeMan ZMF (TEXT), GEM, Panvalet, or Librarian Format Types 154 Generating Delta Deck Control Cards 156 INSERT 157 7 Contents DELETE 157 REPLACE 158 Delta Deck Examples 159 Copying Matching Records 161 COPYSAME 161 End-of-Job Record Count 161 Copying Matching and Differing Records Concurrently 162 COPYSPLIT 162 End-of-Job Record Count 163 Chapter 8: Using Comparex Interactively ISPF Interface 165 Accessing Interactive Comparex Functions 165 Comparex Primary Menu 165 Interactive Workflow 167 Keyword Support 167 Using Option Profiles 168 Save an Option Profile 168 Load a Previously Saved Option Profile 169 Example ISPF Sessions 170 DATA Comparison in Foreground 170 TEXT Comparison Via Short Cut 176 Comparing z/OS Unix Directories 178 Comparing a Panvalet Directory to a PDS Using an Edited Batch Job 179 Parsing Copybooks 180 Chapter 9: Copybook and Copylib Assisted Comparisons Copybook and Copylib Parser 183 Chapter 10: DB2 Comparisons in ISPF and Batch Advanced DB2 Support 197 Interfaces 197 Performance 198 Requirements 198 Interactive DB2 Table Comparisons in ISPF 198 Selecting the DB2 Tables to Compare 199 Specifying Columns for Selection and Comparison 202 Viewing and Editing SQL Statements 205 Assessing the Results of the Comparison 206 Batch DB2 Table Comparisons with Rexx 206 Sample Rexx Program DB2SMPL 206 8 Serena® Comparex® 8.7 for z/OS User’s Guide Source Code to Establish DB2 Connection 207 Source Code to Create Comparex Input Parameters 208 Source Code to Write DB2 Data to a Flat File 209 Error Diagnostics 210 Batch JCL to Run DB2SMPL 210 Batch JCL to Execute Comparex 211 Assessing the Results of the Comparison 212 Limitations of Comparison in DB2 Environments 212 Chapter 11: CPXIFACE Integration with External Data Managers Panvalet, Librarian, and GEM 213 Panvalet 213 Librarian 215 GEM 216 All DBMS Products 218 ADABAS 218 CINCOM 223 Condor CAMLIB 224 DATACOM 226 DB2 (Legacy Interface) 227 DL/1 233 DMS: DASD Management System 236 FOCUS 237 IAM 239 IDMS 240 ORACLE 245 OWL - Online Without Limits 247 RAMIS II 248 ROSCOE 250 WYLBUR 251 Roll Your Own 252 Synchronizing Databases 254 Chapter 12: Delta Deck Option Delta Deck Option 259 Panvalet Format 259 Librarian Format 260 ChangeMan ZMF Format 262 PDS Versus Proprietary Structure 263 Relative Line Numbers in ChangeMan ZMF Format 263 Update Directive 263 9 Contents Line Directives 264 Execution JCL 265 File Attributes 265 Multiple Decks 266 Integrity 266 Directory Statistics 266 Sample Report 267 Explanation 267 Error Messages 269 Appendix A: Examples 305 SCENARIO 1 - Scanning for Date Fields 305 SCENARIO 2 - Comparing Source Code to Detect Changes 306 SCENARIO 3 - Detecting Missing Source or Load Modules 308 SCENARIO 4 - Generating Test Data 309 SCENARIO 5 - Verifying Field Modifications 310 SCENARIO 6 - Validating Database Conversions 314 Select One Account - FILTERIN 317 Select Two Accounts - FILTORINs 317 Exclusive Filters 317 Filter Out One Record 318 Filter Out All But Certain Records 318 Filter Out and Filter In 318 Disregard Inserted Records 318 Complex Filtering 319 IDENTITYs and FIELDs 319 COBOL Source Code Changes 319 Filters with TEXT 319 Audit PDS Libraries 320 Compare JCL Libraries 321 Regression Test in Database Environment 321 Compare to Backup 321 Find Latest Versions 322 IEBUPDTE Formatting of Audit Trail 322 Delta Deck in ChangeMan ZMF Format Audit Trail 323 Desensitize Live Production Data 324 Reverse Delta Deck 325 Appendix B: Effective Testing 327 Some Effective Testing Flowcharts
Recommended publications
  • Business System 300A
    OPERATOR'S GUIDE ~ Business System 300A Part No. 2240275·9701 * B July 1985 ~rEXAS INSTRUMENTS LIST OF EFFECTIVE PAGES INSERT LATEST CHANGED PAGES AND DISCARD SUPERSEDED PAGES Note: The changes in the text are indicated by a change number at the bottom of the page and a vertical bar in the outer margin of the changed page. A change number at the bottom of the page but no change bar indicates either a deletion or a page layout change. Business System 300A Operator's Guide (2240275-9701) Original Issue ................................... March 1984 Change 1 ..................................... May 1985 Change 2 ..................................... July 1985 Total number of pages in this publication is 128 consisting of the following: PAGE CHANGE PAGE CHANGE PAGE CHANGE NO. NO. NO. NO. NO. NO. Cover ............ , .. 2 1-5 .................. 2 0-1/0-2 .............. 0 Effective Pages ....... 2 1-6 .................. 2 E-1 - E-2 ............. 0 iii ................... 0 1-6A/1-6B ............ 2 F-1 - F-6 ............. 0 iv ................... 2 1-7 - 1-8 .............. 1 G lossary-1 - v ................ , .. 1 2-1-2-8 .............. 0 Glossary-8 ......... 0 vi ................ " .. 2 2-9/2-10 .............. 1 Index-1 .............. 0 vii/viii ............ " .. 0 3-1 - 3-12 ............. 0 Index-2 .............. 1 ix ................ " .. 2 3-13 - 3-15 . .. 1 I ndex-3 - I ndex-4 ...... 0 x - xi ............. " .. 0 3-16 - 3-22 ............ 0 User's Response ...... 2 xii .................. 2 4-1 - 4-12 ............. 0 Business Reply ....... 2 1-1 .................. 2 5-1 - 5-16 ............. 0 I nside Cover ......... 2 1-2 ............... , .. 0 A-1-A-12 ............ 0 Cover ............... 2 1-3 ............... , .. 2 B-1 - B-6 ............
    [Show full text]
  • DX10 Poller Operations Manual
    Model 990 Computer DX10 Poller Operations Manual Part No. 2302679-9701 * * 1 November 1981 TEXAS INSTRUMENTS Texas Instruments Incorporated 1981 All Rights Reserved, Printed in U.S.A. The information and/or drawings set forth in this document and all rights in and to inventions disclosed herein and patents which might be granted thereon disclosing or employing the materials, methods, techniques or apparatus descnbed herein, are the exclusive property of Texas Instruments Incorporated. MANUAL REVISION HISTORY Model 990 Computer DX10 Paller Operations Manual (2302679-9701) Original Issue ................................... 1 November 1981 , The total number of pages in this publication is 196. ~------------------------------- Preface This manual provides operating instructions to the operator, and planning and installation instruc­ tions for the network administrator. The operators portion of this manual includes instructions and procedures for operating the Poller, as well as descriptions of operator commands. The in­ tended audience for this portion of the manual is an operator familiar with operation of the DX10 operating system in a Model 990 Computer and with operation of Model 990 Computer peripheral devices. The operator is not necessarily trained in computer science or. programming. The administators portion of this manual provides information for a network administrator or systems analyst who plans, installs, and modifies the Poller network. The network administrator must be a systems programmer familiar with DX10 and with communications systems. Specifically, com­ munications systems include the DX10 3780 Emulator and DX10 Bubble Memory Terminal Support (BMTS). The network administrator should also be familiar with the TIBOL language and applica­ tions, and the Model 763, 765, 767, and 769 Bubble Memory Terminals.
    [Show full text]
  • Pascal News Communications About the Programming Language Pascal by Pascalers I I
    It- r;11dI1~~~ '10.00 PASCAL USERS G;OUP ~ Pascal News Communications about the Programming Language Pascal by Pascalers I I . Pascal Processor Validation Procedure . A Better Referencer . Use of Generic Capsules . Implementation Reports . Validation Suite Reports . Announcements I r Number 25 APRIL83 , I POUCY: PASCAL NEWS (Jan. 83) .Pascal News is the official but Informal publication 01 the User's Group. Pascal News Purpose: The Pascal User's Group (PUG) promotes the usa 01 the programming language Pascal as well as the Ideas behind Pascal through the vehicle 01 Pascal News. PUG is intentionally de- Communications about the Programming Language Pascal b~ PasCalers signed to be non political, and as such, tt is not an "entity" which takes stands on issues or support causas or other ellorts however well-intentioned. Inlormality is our guiding principle; there are no olficers or meetings 01 PUG. APRIL 1983 Number 25 The increasing availability 01 Pascal makes tt a viable alternative lor software production and justifies hs further usa. We all strive to make using Pascal a respectable activity. Membership: Anyone can join PUG, particularly the Pascal usar, teacher, main- teiner,lmpIementor, distributor, or just plain Ian. Memberships !rom IIbreri88 are aIeo encouraged. Sea the COUPON lor details. 2 EDITORS NOTES .Pascal News Is produced 4 times during a year; January, AprIl, July October. All THE NEWS THArS FIT, WE PRINT. Please send material (brevity is a virtue) lor Pascal News single- 3 PASCAL USERS GROUP (UK) spaced and camera-ready (usa dark ribbon and 15.5 em linasl) 3 LT. and M.I.S.S.
    [Show full text]
  • DX10 3270 Interactive Communications Software (ICS)
    USER'S GUIDE .. DX10 3270 Interactive Communications Software (ICS) Part No. 2250954·9701 • D 15 September 1983 TEXAS INSTRUMENTS © Texas Instruments Incorporated 1979, 1980, 1982, 1983 All Rights Reserved, Printed in U.S.A. The information and/or drawings set forth in this document and all rights in and to inventions disclosed herein and patents which might be granted thereon disclosing or employing the materials, methods, techniques or apparatus described herein, are the exclusive property of Texas Instruments Incorporated. MANUAL REVISION HISTORY DX10 3270 Interactive Communications Software (ICS) User's Guide (2250954-9701) Original Issue ................................ 1 May 1979 Revision ..................................... 15 March 1980 Revision 1 March 1982 Revision 15 September 1983 The total number of pages in this publication is 218. The computers offered in this agreement, as well as the programs that TI has created to use with them, are tools that can help people better manage the information used in their business; but tools - including TI computers - cannot replace sound judgment nor make the manager's business decisions. Consequently, TI cannot warrant that its systems are suitable for any specific customer application. The manager must rely on judgment of what is best for his or her business. Preface The DX10 3270 Interactive Communications Software (lCS) provides a 990 family computer with the DX10 operating system to emulate the operation of a subset of the IBM .3270 Information Display System. This emulation allows an ICS-supported video terminal, or any DX10-supported sequential output device, to receive data from an IBM host application program. When an ICS display station receives the data, the operator can read, delete, or modify it, then send it back to the host application.
    [Show full text]
  • National Directory of Rehabilitation Facilities Using Wisconsin Univ
    DOCUMENT RESUME ED 251 716 CE 040 394 AUTHOR McCray, Paul M.; Blakemore, Thomas F. TULE National Directory of Rehabilitation Facilities Using Computers. INSTITUTION Wisconsin Univ.-Stout, Menomonie. Stout Vocational Rehabilitation Inst. :PONS AGENCY National Inst. of Handicapped Research (ED), Washington, DC. PUB DATE 84 NOTE 179p. PUB TYPE Reference Mate"ials Directories/Catalogs (132) -- Reports - Research/Teehn'cal (143) EDRS PRICE MF01/PC08 Plus Postage. DESCRIPTORS Adults; *Computer Oriented Programs; *Computer Software; Disabilities; Facility Manning; Information Networks; *Information Sources; Mental Health Programs; Mental Retardation; Program Development; *Rehabilitation Centers; *Rehabilitation Programs; *Resources ", ABSTRACT This directory represents the culmination of a national research project designed to assess the extent to which computer technology is being integrated into rehabilitation facility operations. The directory is divided into six major sections. The first section is a research summary that provides a concise description of how the information included in the direct9xy was derived. It contains ipformation regarding training needs experienced by most facilities, cost of implementing computerized operations, problem areas frequently experienced by facilities, software applications, and so on. Section 2 provides an introduction to computer use as well as applications that specifically apply to many facility operations. Of particular interest may be the information describing the key steps involved in selecting a system for a facility as well as integrating it into existing operations. Sections 3,4, and 5 are designed primarily to provide readers with specific information on the hardware being used by facilities, software ratings, names and addresses of agencies and contact persons willing to share their expertise, and related information.
    [Show full text]
  • Communications Capabilities of Minicomputers and Small Business
    C13-010-221 Processors Communications Capabilities of Minicomputers and Small Business Computers ( Industrial Infomark Infotecs Infomark Inforex Control Center MANUFACTURER & MODEL Micro Systems OMS-II OMS-III 9000 5000SX II MAIN STORAGE Min.lMax. capacity, words or bytes 512K 256K 512K 256K 1M NO. WORKSTATIONS CONNECTABLE 16 16 24 24 16 COMMUNICATIONS Maximum no. of lines 24 16 24 - 16 Synchronous Optional Opt.; 19.2K bps Opt.; 19.2K bps Std.; 9600 bps Std.; 300-19,200 bps Asynchronous Std.; 9600-19.2K bps Std.; 19.2K bps Std.; 19.2K bps Optional Std.; 300-19,200 bps Protocols supported Async 2780/3780 2780/3780 2780/3780, HASP, - Network architecture supported Turbodos (opt.) - - ULTRANET, ARCNET - RJE terminals emulated - 2780/3780 2780/3780 See Comments - IBM 3270 emulation No - - Yes - PRICING & AVAlLA81L1TY Purchase price of basic system, $ 3,000-12,000 67,000 113,300 44,630 6,995 Purchase price of memory module, $ - - - - - Monthly maint. price of basic system, $ - - - 800 - Discounts available Dealer, OEM - - - - Date of first U.S. delivery May 1979 1976 1976 July 1981 April 1980 Number installed to date 500 110 40 Contact vendor Over 1000 COMMENTS New table-top pack- 8asic system price 8asic system price RJE terminals Programs compatible age; 5.5M-byte includes hardware, includes hardware, emulated include with DEC PDP-8; Winchester drive application software application software, 2770, 2780, 3770, complete systems and available installation, and train- installation, and 3780, RES; System software sold & ser- ing; *600- and 900- training 9000 is a distributed viced nationwide by Ipm printers are information processing Infotecs' dealers optional system, specifically addressing distributed data entry and file management solutions for business MAli Basic Four MAl/Basic Four MAl/Basic Four MAli Basic Four MANUFACTURER & MODEL MAl/Basic Four System 210 System 310 System 510 System 610 System 710 MAIN STORAGE Min.lMax.
    [Show full text]