Record-Level Compare
Line Sequential or ASCII/Text Files
  Table of Contents  v-24.01.01 - cpls4k01.htm 
  Introduction
  Primary Functions
  CMD Files for Data File Comparison
  Equal Compare Results
  NOT Equal Compare Results
  COBOL Program, Data File Compare
  Secondary Functions
  Generate a File Compare Program
  The Process Control File, an Example
  Ancillary Functionality
  Set the Environment
  Display and Log Messages
  Create Test Files
  Create Test Files using a Windows CMD File
  Summary
  Software Agreement and Disclaimer
  Downloads and Links
  Current Server or Internet Access
  Internet Access Required
  Glossary of Terms
  Contact or Feedback
  Company Overview
The SimoTime Home Page 

Table of Contents Previous Section Next Section Introduction

The 1st section (Primary Functions) of this document will focus on doing an actual compare of two line sequential (or ASCII/Text) files. The 2nd section (Secondary Functions) will focus on the preparation tasks required prior to doing file compare. The 3rd section (Ancillary Functions) will describe some of the supporting tasks (such as creating test files) that are required.

This example will use the Windows ECHO command to create three line sequential files. The files will be used to demonstrate the capabilities of the data file compare processes. The first two files contain the same record content and produce an equal compare result. The third file has a record with different content and the compare process will identify the difference.

This example includes Windows CMD Files and a COBOL program. In the world of programming there are many ways to solve a problem. This suite of programs is provided as one of the many possible solutions for comparing data files. The files used in this suite of sample programs use Line Sequential files with variable length record and a maximum record length of 4,096 bytes. The positions within the records to be compared are defined at execution time. When the files are compared and if a difference is found the COBOL compare program will call SIMOHEX4.CBL and SIMOLOGS.CBL. These programs and their associated copy files are part of the SIMOLIBR package. Refer to the Downloads and Links section of this document for additional information.

Many companies are looking for ways to compare data files using a mainframe system or a distributed system (i.e. Linux, UNIX and/or Windows or "LUW") running Micro Focus sub-systems. This utility program (UTCOMPRT) is intended to assist in these efforts. The UTCOMPRT program runs in the Windows environment and generates comparison programs (COBOL Source Code) that may be compiled and executed on a distributed LUW platform with Micro Focus.


We have made a significant effort to ensure the documents and software technologies are correct and accurate. We reserve the right to make changes without notice at any time. The function delivered in this version is based upon the enhancement requests from a specific group of users. The intent is to provide changes as the need arises and in a timeframe that is dependent upon the availability of resources.

Copyright © 1987-2024
SimoTime Technologies and Services
All Rights Reserved

Table of Contents Previous Section Next Section Primary Functions

This section will focus on the items (process and procedures) that do the actual data file comparison. A second group of items will be used to generate the comparison program and prepare the environment for the compare tasks. These secondary command files and programs will be described in the Secondary Functions section of this document.

Table of Contents Previous Section Next Section CMD Files for Data File Comparison

This section will focus on two CMD Files that execute a simple file compare process. The first CMD File will compare to files that are identical.. The second CMD File will compare two files that have a difference embedded within the files. The Data File Compare programs will find the difference and produce a NOT-Equal result.

Table of Contents Previous Section Next Section Equal Compare Results

This CMD File (CPLS4KW1.cmd) will compare two sequential files that are identical. The job execution will result in a zero return code and display the record counts to the SYSOUT device.

@echo OFF
     set CmdName=CPLS4KW1
rem  * *******************************************************************
rem  *               CPLS4KW1.cmd - a Windows Command File               *
rem  *       This Job Script is provided by SimoTime Technologies        *
rem  *           (C) Copyright 1987-2019 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Compare two line sequential files
rem  * Author - SimoTime Technologies
rem  * Date   - January 24, 1996
rem  *
rem  * This Job Script was created and tested on a Windows System
rem  * using Micro Focus COBOL.
rem  *
rem  *                     ************
rem  *                     * CPLS4KW1 *
rem  *                     ********cmd*
rem  *                          *
rem  *                          *
rem  *    ************     ************     ************
rem  *    *  SYSUT1  *-----* CPLS4KC1 *--*--* SYSLUSER *
rem  *    *******lseq*  *  ********cbl*  *  *******lseq*
rem  *                  *       *        *
rem  *    ************  *       *        *  ************
rem  *    *  SYSUT2  *--*       *        *--*  SYSOUT  *
rem  *    *******lseq*          *           *******lseq*
rem  *                          *
rem  *                     ************
rem  *                     *   EOJ    *
rem  *                     ************
rem  *
rem  * This Job Script calls the following Windows Command Files.
rem  * 1. ENV1BASE.cmd - this provides a single point for setting commonly
rem  *                   used environment variables.
rem  * 2. SIMONOTE.cmd - this provides a consistent process for displaying
rem  *                   messages to the screen and writing to a journal
rem  *                   or log file.
rem  *
rem  * Note: The test files for this Job Script are created in a separate
rem  *       Windows Command File. Refer to the CPLS4KW8.cmd command for
rem  *       additional information.
rem  *
rem  * *******************************************************************
rem  * Prepare the System Environment
rem  *
     call ..\ENV1BASE %CmdName%
     set JobStatus=0
rem  *
     call SIMONOTE "*******************************************************%CmdName%"
     call SIMONOTE "* Job_Step 01 of 03, Prepare the Job Environment..."
     set SYSUT1=%BaseLib1%\DATA\APPL\SIMOTIME.TESTEQ.CPLS4KD1.txt
     set SYSUT2=%BaseLib1%\DATA\APPL\SIMOTIME.TESTEQ.CPLS4KD2.txt
     set SYSLUSER=%BaseLib1%\LOGS\SIMOTIME.COMPARES.%CmdName%.txt
rem  *
rem  * *******************************************************************
     call SIMONOTE "* Job_Step 02 of 03, Execute the Compare Program with EQ Results"
rem  *
     run CPLS4KC1
     set ERRORLEVELTWO=%ERRORLEVEL%
rem  *
rem  * *******************************************************************
:Eoj
     call SIMONOTE "* Job_Step 03 of 03, End of Job Processing..."
     call SIMONOTE "* SYSUT1.... %SYSUT1%"
     call SIMONOTE "* SYSUT2.... %SYSUT2%"
     call SIMONOTE "* SYSLUSER.. %SYSLUSER%"
     if not "%ERRORLEVELTWO%" == "0" goto :EojNok
rem  *
:EojAok
     call SIMONOTE "* Finished JobName %CmdName%, Job Status is %JobStatus% "
     goto :End
:EojNok
     set JobStatus=%ERRORLEVELTWO%
     call SIMONOTE "* ABENDING JobName %CmdName%, Job Status is %JobStatus% "
:End
     pause
     exit /b

Table of Contents Previous Section Next Section NOT Equal Compare Results

This CMD File (CPLS4KW2.cmd) will compare two sequential files that have a difference embedded within the files. The Data File Compare programs will find the difference and produce a NOT-Equal or non-Zero result. The record counts and the difference will be displayed to the SYSOUT device.

@echo OFF
     set CmdName=CPLS4KW2
rem  * *******************************************************************
rem  *               CPLS4KW2.cmd - a Windows Command File               *
rem  *       This Job Script is provided by SimoTime Technologies        *
rem  *           (C) Copyright 1987-2019 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Compare two line sequential files
rem  * Author - SimoTime Technologies
rem  * Date   - January 24, 1996
rem  *
rem  * This Job Script was created and tested on a Windows System
rem  * using Micro Focus COBOL.
rem  *
rem  *                     ************
rem  *                     * CPLS4KW2 *
rem  *                     ********cmd*
rem  *                          *
rem  *                          *
rem  *    ************     ************     ************
rem  *    *  SYSUT1  *-----* CPLS4KC1 *--*--* SYSLUSER *
rem  *    *******lseq*  *  ********cbl*  *  *******lseq*
rem  *                  *       *        *
rem  *    ************  *       *        *  ************
rem  *    *  SYSUT2  *--*       *        *--*  SYSOUT  *
rem  *    *******lseq*          *           *******lseq*
rem  *                          *
rem  *                     ************
rem  *                     *   EOJ    *
rem  *                     ************
rem  *
rem  * This Job Script calls the following Windows Command Files.
rem  * 1. ENV1BASE.cmd - this provides a single point for setting commonly
rem  *                   used environment variables.
rem  * 2. SIMONOTE.cmd - this provides a consistent process for displaying
rem  *                   messages to the screen and writing to a journal
rem  *                   or log file.
rem  *
rem  * Note: The test files for this Job Script are created in a separate
rem  *       Windows Command File. Refer to the CPLS4KW8.cmd command for
rem  *       additional information.
rem  *
rem  * *******************************************************************
rem  * Prepare the System Environment
rem  *
     call ..\ENV1BASE %CmdName%
     set JobStatus=0
rem  *
     call SimoNOTE "*******************************************************%CmdName%"
     call SimoNOTE "* Job_Step 01 of 03, Prepare the Job Environment..."
     set SYSUT1=%BaseLib1%\DATA\APPL\SIMOTIME.TESTNE.CPLS4KD1.txt
     set SYSUT2=%BaseLib1%\DATA\APPL\SIMOTIME.TESTNE.CPLS4KD2.txt
     set SYSLUSER=%BaseLib1%\LOGS\SIMOTIME.COMPARES.%CmdName%.txt
rem  *
rem  * *******************************************************************
     call SimoNOTE "* Job_Step 02 of 03, Execute the Compare Program with NE Results"
rem  *
     run CPLS4KC1
     set ERRORLEVELTWO=%ERRORLEVEL%
rem  *
rem  *
rem  * *******************************************************************
:Eoj
     call SIMONOTE "* Job_Step 03 of 03, End of Job Processing..."
     call SIMONOTE "* SYSUT1.... %SYSUT1%"
     call SIMONOTE "* SYSUT2.... %SYSUT2%"
     call SIMONOTE "* SYSLUSER.. %SYSLUSER%"
     if not "%ERRORLEVELTWO%" == "0" goto :EojNok
rem  *
:EojAok
     call SIMONOTE "* Finished JobName %CmdName%, Job Status is %JobStatus% "
     goto :End
:EojNok
     set JobStatus=%ERRORLEVELTWO%
     call SIMONOTE "* ABENDING JobName %CmdName%, Job Status is %JobStatus% "
:End
     pause
     exit /b

Table of Contents Previous Section Next Section COBOL Program, Data File Compare

This File Compare program (CPLS4KC1.cbl) was generated by the SimoTime Utility for Data File Compare. For addition information refer to the Generating a Data File Comparison Program section of this document for additional information.

       IDENTIFICATION DIVISION.
       PROGRAM-ID.    CPLS4KC1.
       AUTHOR.        SIMOTIME TECHNOLOGIES.
      *****************************************************************
      *           This program was generated by SimoZAPS              *
      *             A product of SimoTime Technologies                *
      *        Our e-mail address is: helpdesk@simotime.com           *
      *     Also, visit our Web Site at http://www.simotime.com       *
      *                                                               *
      *  Generation Date: 2020-06-25  Generation Time: 19:20:21:94    *
      *                                                               *
      *                                   Record    Record     Key    *
      *  Function  Name     Organization  Format    Max-Min  Pos-Len  *
      *  PRIMARY   SYSUT1   ASCII/CRLF    FIXED      04096            *
      *                                                               *
      *  SECONDARY SYSUT2   ASCII/CRLF    FIXED      04096            *
      *                                                               *
      *****************************************************************
       ENVIRONMENT DIVISION.
       INPUT-OUTPUT SECTION.
       FILE-CONTROL.
           SELECT SYSUT1-FILE  ASSIGN TO       SYSUT1
                  ORGANIZATION  IS LINE SEQUENTIAL
                  ACCESS MODE   IS SEQUENTIAL
                  FILE STATUS   IS SYSUT1-STATUS.
           SELECT SYSUT2-FILE  ASSIGN TO       SYSUT2
                  ORGANIZATION  IS LINE SEQUENTIAL
                  ACCESS MODE   IS SEQUENTIAL
                  FILE STATUS   IS SYSUT2-STATUS.

      *****************************************************************
       DATA DIVISION.
       FILE SECTION.
       FD  SYSUT1-FILE
           DATA RECORD    IS SYSUT1-REC
           .
       01  SYSUT1-REC.
           05  SYSUT1-DATA-01 PIC X(04096).

       FD  SYSUT2-FILE
           DATA RECORD    IS SYSUT2-REC
           .
       01  SYSUT2-REC.
           05  SYSUT2-DATA-01 PIC X(04096).

      *****************************************************************
      * This program was created using the SYSCOMP5.TXT file as the   *
      * template for the data file comparison. This program template  *
      * has the following characteristics.                            *
      * 1. The positions to be compared are determined during the     *
      *     program generation based on the &COMPARE statements in    *
      *     the Process Control File.                                 *
      * 2. The Hex-Dump information will be written to a Line         *
      *    Sequential (LSEQ) File using the SIMOL32K program.         *
      * 3. The DRECLMAX function is supported using this template.    *
      *                                                               *
      * For more information or questions please contact SimoTime     *
      * Technologies. The version control number is 20.05.22          *
      *                                                               *
      *        Our e-mail address is: helpdesk@simotime.com           *
      *     Also, visit our Web Site at http://www.simotime.com       *
      *****************************************************************
       WORKING-STORAGE SECTION.
       01  SIM-TITLE.
           05  T1 pic X(11) value '* CPLS4KC1 '.
           05  T2 pic X(34) value 'Compare LSEQ, SYSUT3 and KEYFIELD '.
           05  T3 pic X(10) value ' v20.05.22'.
           05  T4 pic X(24) value '   helpdesk@simotime.com'.
       01  SIM-COPYRIGHT.
           05  C1 pic X(11) value '* CPLS4KC1 '.
           05  C2 pic X(32) value 'This Data File Compare Member wa'.
           05  C3 pic X(32) value 's generated by SimoTime Technolo'.
           05  C4 pic X(04) value 'gies'.

       01  SIM-THANKS-01.
           05  C1 pic X(11) value '* CPLS4KC1 '.
           05  C2 pic X(32) value 'A Data File Compare Program gene'.
           05  C3 pic X(32) value 'rated by using SimoTime Technolo'.
           05  C4 pic X(04) value 'gies'.

       01  SIM-THANKS-02.
           05  C1 pic X(11) value '* CPLS4KC1 '.
           05  C2 pic X(32) value 'Please send all comments or sugg'.
           05  C3 pic X(32) value 'estions to the helpdesk@simotime'.
           05  C4 pic X(04) value '.com'.

       01  SYSUT1-STATUS.
           05  SYSUT1-STATUS-L     pic X.
           05  SYSUT1-STATUS-R     pic X.
       01  SYSUT1-EOF              pic X       value 'N'.
       01  SYSUT1-OPEN-FLAG        pic X       value 'C'.
       01  SYSUT1-LRECL            pic 9(5)    value 04096.

       01  SYSUT2-STATUS.
           05  SYSUT2-STATUS-L     pic X.
           05  SYSUT2-STATUS-R     pic X.
       01  SYSUT2-EOF              pic X       value 'N'.
       01  SYSUT2-OPEN-FLAG        pic X       value 'C'.
       01  SYSUT2-LRECL            pic 9(5)    value 04096.

      *****************************************************************
      * The following buffers are used to create a four-byte status   *
      * code that may be displayed.                                   *
      *****************************************************************
       01  IO-STATUS.
           05  IO-STAT1            pic X.
           05  IO-STAT2            pic X.
       01  IO-STATUS-04.
           05  IO-STATUS-0401      pic 9     value 0.
           05  IO-STATUS-0403      pic 999   value 0.
       01  TWO-BYTES-BINARY        pic 9(4)  BINARY.
       01  TWO-BYTES-ALPHA         redefines TWO-BYTES-BINARY.
           05  TWO-BYTES-LEFT      pic X.
           05  TWO-BYTES-RIGHT     pic X.

      *****************************************************************
      * Message Buffer used by the Z-POST-MESSAGE-TO-USER routine.    *
      *****************************************************************
       01  MESSAGE-BUFFER.
           05  MESSAGE-HEADER      pic X(11)   value '* CPLS4KC1 '.
           05  MESSAGE-TEXT.
               10  MESSAGE-TEXT-1  pic X(68)   value SPACES.
               10  MESSAGE-TEXT-2  pic X(188)  value SPACES.
       01  MSG-LSB                 pic 9(3)    value 267.

      *****************************************************************
       01  APPL-RESULT             pic S9(9)    comp.
           88  APPL-AOK            value 0.
           88  APPL-EOF            value 16.

       01  KEY-ACTIVE              pic X       value 'Y'.
       01  KEY-CONTROL-1.
           05  K-PS-1              pic 9(5)    value 00001.
           05  K-LN-1              pic 9(5)    value 00010.
       01  KEY-CONTROL-2.
           05  K-PS-2              pic 9(5)    value 00001.
           05  K-LN-2              pic 9(5)    value 00010.

       01  KEYRECID-ACTIVE         pic X       value 'N'.
       01  KEYRECID-CONTROL-1.
           05  E-PS-1              pic 9(5)    value 00000.
           05  E-LN-1              pic 9(5)    value 00000.
       01  KEYRECID-CONTROL-2.
           05  E-PS-2              pic 9(5)    value 00000.
           05  E-LN-2              pic 9(5)    value 00000.

       01  READ-FLAGS.
           05  READ-1          pic X       value 'Y'.
           05  READ-2          pic X       value 'Y'.
       01  DUMP-FLAGS.
           05  DUMP-RPI        pic X       value 'Y'.
           05  DUMP-ASC        pic X       value 'Y'.
           05  DUMP-EBC        pic X       value 'Y'.
           05  DUMP-HEX        pic X       value 'Y'.
           05  DUMP-DET-GRP.
               10  DUMP-DET    pic X       value 'Y'.
               10  DUMP-DET-2  pic XX      value 'NE'.
           05  DUMP-SUM        pic X       value 'Y'.
           05  DUMP-STATUS     pic x       VALUE 'Y'.
       01  DUMP-PGM            pic X(8)    value 'SIMOL32K'.

       01  DPOS-UT1            pic 9(5)    value 1.
       01  DLEN-UT1            pic 9(5)    value 00000.
       01  DPOS-UT2            pic 9(5)    value 1.
       01  DLEN-UT2            pic 9(5)    value 00000.

       01  FUNCTION-FLAGS.
           05  FF-01       pic X       value '1'.
           05  FF-02       pic X       value '0'.
           05  FF-03       pic X       value '0'.

       01  HTML-FONT-TAG-02.
           05  filler          pic x(13) value '<FONT STYLE="'.
           05  filler          pic x(08) value 'color: #'.
           05  FONT-02-CLR     pic x(06) value '000000'.
           05  filler          pic x(02) value '; '.
           05  filler          pic x(19) value 'background-color: #'.
           05  FONT-02-BG-CLR  pic x(06) value 'FFBFBF'.
           05  filler          pic x(02) value '">'.

       01  COMPACT-STATUS      pic XX        value 'EQ'.
       01  COMPACT-PENDED      pic XX        value 'EQ'.
       01  COMPARE-STATUS      pic XX        value 'EQ'.
       01  FLAG-EQ             pic XX        value 'EQ'.
       01  FLAG-NE             pic XX        value 'NE'.
       01  FLAG-QT             pic XX        value 'QT'.
       01  DELTA-LINE-1        pic X(04096)  value all '-'.
       01  DELTA-LINE-2        pic X(04096)  value all '-'.
       01  PTR-1               pic 9(5)      value 0.
       01  PTR-2               pic 9(5)      value 0.
       01  IDX-1               pic 9(5)      value 0.
       01  IDX-2               pic 9(5)      value 0.
       01  BYPASS-UT1-CTR      pic 9(3)      value 0.
       01  BYPASS-UT2-CTR      pic 9(3)      value 0.

       01  WORK-02-COMP            pic 9(4)  COMP.
       01  WORK-02-X               redefines WORK-02-COMP.
           05  WORK-02-X-X1        pic X.
           05  WORK-02-X-X2        pic X.

       01  WORK-05         pic X(5)    value SPACES.
       01  WORK-05-A       pic X(5)    value SPACES.
       01  WORK-05-E       pic X(5)    value SPACES.
       01  PTR-A-ZD-3      pic 999     value 0.
       01  PTR-E-ZD-3      pic 999     value 0.
       01  A-FLAG          pic X       value 'N'.
       01  E-FLAG          pic X       value 'N'.

       01  DELTA-MAX-ABEND.
           05  FILLER          pic X(10)
                               value 'ABENDING, '.
           05  FILLER          pic X(24)
                               value 'Not Equal count exceeds '.
           05  FILLER          pic X(22)
                               value 'user-defined limit of '.
           05  DELTA-MAXIMUM-X pic X(9)
                               value '&&&&&&&&&'.
           05  DELTA-MAXIMUM   redefines DELTA-MAXIMUM-X
                               pic 9(9).
           05  FILLER          pic X(19)
                               value ', ABEND process is '.
           05  DELTA-PROCESS   pic X(4)
                               value 'EOF '.

       01  IFNECODE-GROUP.
           05  IFNECODE-VALUE pic 9(4) value 0004.

       01  YES-YES         pic XX      value 'YY'.
       01  N-BYTE          pic X       value 'N'.
       01  Y-BYTE          pic X       value 'Y'.
       01  GROUP-DELIMITER pic X       value 'Y'.

       01  POS-1           pic 9(5)    value 1.
       01  LEN-1           pic 9(5)    value 128.
       01  POS-2           pic 9(5)    value 1.
       01  LEN-2           pic 9(5)    value 128.

       01  SYSUT1-LRECL-M  pic 9(5)    value 04096.
       01  SYSUT2-LRECL-M  pic 9(5)    value 04096.

       01  D-LEN           pic 9(5)    value 04096.
       01  D-POS           pic 9(5)    value 1.

       01  W-LEN           pic 9(5)    value 0.
       01  W-POS           pic 9(5)    value 10.

       01  LEN-UT1         pic 9(5)    value 128.
       01  POS-UT1         pic 9(5)    value 1.
       01  LEN-UT2         pic 9(5)    value 128.
       01  POS-UT2         pic 9(5)    value 1.

       01  DUMP-RECL-MAX-S pic X       value 'N'.
       01  DUMP-RECL-MAX   pic 9(5)    value 00000.

       01  CONTINUE-FLAG   pic X       value 'Y'.

       01  ASC-OR-EBC      pic 9(3)    comp    value 0.
       01  ASC-OR-EBC-R    redefines ASC-OR-EBC.
           05  ASC-A       pic X.
           05  EBC-A       pic X.

      *    Header row for positional indicator...
       01  DUMP-H10.
           05  FILLER      pic X(5)    value '....:'.
           05  POS-NO      pic 9(5)    value 10.
           05  FILLER      pic X(10)   value '....:.....'.
       01  DUMP-W10.
           05  FILLER      pic X(5)    value '....:'.
           05  W10-POS-NO  pic X(5)    value '00000'.
           05  FILLER      pic X(10)   value '....:.....'.

       01  DUMP-HEADER     pic X(04096)  value all '.'.
       01  D-P1            pic 9(5)      value 0.
       01  WK-1            pic 9(5)      value 0.
       01  WK-2            pic 9(5)      value 0.

       01  RECORD-HEADER.
           05  RECORD-ID   pic X(8)    value 'SYSUT1'.
           05  filler      pic X(2)    value '..'.
           05  REC-NUMBER  pic 9(9)    value 0.
           05  filler      pic X       value '('.
           05  RECORD-POS  pic 9(5)    value 0.
           05  filler      pic X       value ':'.
           05  RECORD-LEN  pic 9(5)    value 0.
           05  filler      pic X(2)    value ') '.
           05  REC-CTYPE   pic X(10)   value 'UNKNOWN   '.
           05  filler      pic X(2)    value SPACES.
           05  REC-CMODE   pic X(10)   value 'UNKNOWN   '.

       01  INFO-STATEMENT.
           05  filler      pic X(2)    value '* '.
           05  INFO-SHORT.
               10  INFO-ID pic X(8)    value 'Starting'.
               10  filler  pic X(4)    value '  - '.
               10  INFO-34 pic X(34)
                   value   'Compare LSEQ, SYSUT3 and KEYFIELD '.
           05  filler      pic X(31)
               value '        http://www.SimoTime.com'.

       01  UT1-MISSING.
           05  filler      pic X(5)  value 'This '.
           05  filler      pic X(31)
                           value 'record is MISSING from SYSUT1'.
           05  filler      pic X(7)  value ' - the '.
           05  filler      pic X(29)
                           value 'record is PRESENT in SYSUT2'.

       01  UT2-MISSING.
           05  filler      pic X(5)  value 'This '.
           05  filler      pic X(29)
                           value 'record is PRESENT in SYSUT1'.
           05  filler      pic X(7)  value ' - the '.
           05  filler      pic X(31)
                           value 'record is MISSING from SYSUT2'.

       01  SYSUT1-TOTAL.
           05  SYSUT1-RDR  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  filler      pic X(25) value 'Record count for SYSUT1'.
       01  SYSUT2-TOTAL.
           05  SYSUT2-RDR  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  filler      pic X(25) value 'Record count for SYSUT2'.
       01  SYSUT1-OMIT.
           05  SYSUT1-OMT  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  filler      pic X(25) value 'Bypass count for SYSUT1'.
       01  SYSUT2-OMIT.
           05  SYSUT2-OMT  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  filler      pic X(25) value 'Bypass count for SYSUT2'.
       01  COMPARE-NE-TOTAL.
           05  COMPARE-NE  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  COMPARE-TAG.
               10  filler  pic X(25) value 'NOT Equal count for compa'.
               10  filler  pic X(25) value 're of existing records   '.
       01  COMPACT-NE-TOTAL.
           05  COMPACT-NE  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  COMPACT-TAG.
               10  filler  pic X(25) value 'NOT Equal count for compa'.
               10  filler  pic X(25) value 'ct of existing records   '.
       01  COMPARE-EQ-TOTAL.
           05  COMPARE-EQ  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  filler      pic X(25) value 'Number of matching record'.
           05  filler      pic X(25) value ' pairs for Compare Task  '.
       01  COMPACT-EQ-TOTAL.
           05  COMPACT-EQ  pic 9(9)  value 0.
           05  filler      pic X(3)  value ' - '.
           05  filler      pic X(25) value 'Number of matching record'.
           05  filler      pic X(25) value ' pairs for Compact Task  '.

       01  FORMAT-TYPE     pic X     value 'B'.

       COPY PASSULOG.
       COPY PAENVARS.

      *****************************************************************
       PROCEDURE DIVISION.
           perform JOB-STARTING

           perform
               until COMPARE-STATUS = 'QT'
               or    SYSUT1-STATUS not = '00'
               or    SYSUT2-STATUS not = '00'
               if  READ-1 = 'Y'
                   perform SYSUT1-READ
               end-if
               if  READ-2 = 'Y'
                   perform SYSUT2-READ
               end-if
               if  SYSUT1-STATUS = '00'
               and SYSUT2-STATUS = '00'
                   move 'EQ' to COMPARE-STATUS
                   move 'N' to DUMP-STATUS
                   move all '-' to DELTA-LINE-1
                   move all '-' to DELTA-LINE-2
                   if  KEY-ACTIVE = 'Y'
                   and COMPARE-STATUS = FLAG-EQ
                       perform COMPARE-KEYS
                   end-if
                   if  COMPARE-STATUS = FLAG-EQ
                       perform COMPARE-RECORDS
                   end-if

                   if  DUMP-STATUS = 'Y'
                       if  GROUP-DELIMITER = 'Y'
                           perform DUMP-ASTERISK-ONE
                       end-if
                       add SYSUT1-LRECL-M to ZERO giving D-LEN
                       if  DUMP-RPI = 'Y'
                           perform DUMP-POSITION-INDICATOR
                       end-if
                       perform DUMP-PRIMARY-RECORD
                       perform DUMP-POSITION-DIFFERENCES-1
                       perform DUMP-SECONDARY-RECORD
                       perform DUMP-POSITION-DIFFERENCES-2
                       add SYSUT2-LRECL-M to ZERO giving D-LEN
                       move 'N' to DUMP-STATUS
                   end-if

                   if  COMPARE-STATUS = FLAG-NE
                       add 1 to COMPARE-NE
                   end-if
               else
                   if  SYSUT1-STATUS = '00'
                   or  SYSUT2-STATUS = '00'
                       if  KEY-ACTIVE = 'Y'
                           perform COMPARE-KEYS
                       end-if
                   end-if
                   move 'NE' to COMPARE-STATUS
               end-if
               if  COMPARE-STATUS = 'EQ'
                   add 1 to COMPARE-EQ
               end-if
               if  DELTA-PROCESS = 'QUIT'
               and COMPARE-NE > DELTA-MAXIMUM
                   perform JOB-FINISHED
                   move DELTA-MAX-ABEND to MESSAGE-TEXT
                   move 'POST' to ULOG-REQUEST
                   add 256 to ZERO giving ULOG-LENGTH
                   move MESSAGE-BUFFER to ULOG-MESSAGE
                   call DUMP-PGM using ULOG-PASS-AREA
                                       ULOG-MESSAGE
                   perform Z-ABEND-PROGRAM
               end-if
               if  DELTA-PROCESS = 'EOF '
               and COMPARE-NE > DELTA-MAXIMUM
                   move DELTA-MAX-ABEND to MESSAGE-TEXT
                   move 'POST' to ULOG-REQUEST
                   add 256 to ZERO giving ULOG-LENGTH
                   move MESSAGE-BUFFER to ULOG-MESSAGE
                   call DUMP-PGM using ULOG-PASS-AREA
                                       ULOG-MESSAGE
                   perform Z-POST-MESSAGE-TO-CONSOLE
                   move 'QT' to COMPARE-STATUS
               end-if
           end-perform

           perform JOB-FINISHED

           GOBACK.

      *****************************************************************
       COMPARE-RECORDS.
      *    Physical Comparison with NE Output of SIMOL32K
           move 'COMPARISON' to REC-CTYPE
           move 'PHYSICAL  ' to REC-CMODE
           move all '=' to DELTA-LINE-1(00001:00016)
           move all '=' to DELTA-LINE-2(00001:00018)
           if SYSUT1-REC(00001:00016) not = SYSUT2-REC(00001:00018)
              move FLAG-NE to COMPARE-STATUS
              move 'Y' to DUMP-STATUS
           end-if
           if  DUMP-DET    = 'Y'
           and DUMP-STATUS = 'Y'
               add 00001 to ZERO  giving POS-UT1
               add 00001 to ZERO  giving POS-UT2
               add 00016 to ZERO  giving LEN-UT1
               add 00018 to ZERO  giving LEN-UT2
               add 00016 to ZERO  giving ULOG-LENGTH
               perform CALC-DELTA-FOR-NE-EQ-NO
           end-if
      *    Physical Comparison with NE Output of SIMOL32K
           move 'COMPARISON' to REC-CTYPE
           move 'PHYSICAL  ' to REC-CMODE
           move all '=' to DELTA-LINE-1(00020:00061)
           move all '=' to DELTA-LINE-2(00020:00061)
           if SYSUT1-REC(00020:00061) not = SYSUT2-REC(00020:00061)
              move FLAG-NE to COMPARE-STATUS
              move 'Y' to DUMP-STATUS
           end-if
           if  DUMP-DET    = 'Y'
           and DUMP-STATUS = 'Y'
               add 00020 to ZERO  giving POS-UT1
               add 00020 to ZERO  giving POS-UT2
               add 00061 to ZERO  giving LEN-UT1
               add 00061 to ZERO  giving LEN-UT2
               add 00061 to ZERO  giving ULOG-LENGTH
               perform CALC-DELTA-FOR-NE-EQ-NO
           end-if
           exit.


      *****************************************************************
       COMPARE-KEYS.
           move YES-YES to READ-FLAGS
           if  SYSUT1-REC(K-PS-1:K-LN-1)
            >  SYSUT2-REC(K-PS-2:K-LN-2)
               move N-BYTE to READ-2
               move FLAG-NE to COMPARE-STATUS
               if  COMPARE-NE < DELTA-MAXIMUM
               and DUMP-DET-GRP = 'YNE'
                   perform DUMP-SECONDARY-MISSING
               end-if
           end-if
           if  SYSUT1-REC(K-PS-1:K-LN-1)
            <  SYSUT2-REC(K-PS-2:K-LN-2)
               move N-BYTE to READ-1
               move FLAG-NE to COMPARE-STATUS
               if  COMPARE-NE < DELTA-MAXIMUM
               and DUMP-DET-GRP = 'YNE'
                   perform DUMP-PRIMARY-MISSING
               end-if
           end-if
           exit.

      *****************************************************************
       DUMP-ASTERISK-ONE.
           move SPACES       to ULOG-MESSAGE
           move 'TEXT'       to ULOG-REQUEST
           add 4 to ZERO giving ULOG-LENGTH
           move '*   '       to ULOG-MESSAGE(1:4)
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           exit.

      *****************************************************************
       DUMP-ASTERISK-ROW.
           move SPACES        to ULOG-MESSAGE
           move 'TEXT'        to ULOG-REQUEST
           add 79 to ZERO giving ULOG-LENGTH
           move all '*'       to ULOG-MESSAGE(1:ULOG-LENGTH)
           call DUMP-PGM   using ULOG-PASS-AREA ULOG-MESSAGE
           exit.

      *****************************************************************
      *    Build the position header row...
      *****************************************************************
       DUMP-POSITION-INDICATOR.
           add 10 to ZERO giving POS-NO
           subtract 1 from D-POS giving WK-1
           divide 10 into WK-1 giving WK-1 remainder WK-2
           add 1 to WK-2
           perform varying D-P1 from 1 by 10 until D-P1 > D-LEN - 10
               move DUMP-H10 to DUMP-W10
               inspect W10-POS-NO replacing leading ZEROES by '.'
               move DUMP-W10(WK-2:10) to DUMP-HEADER(D-P1:10)
               add 10 to POS-NO
           end-perform

           move 'TEXT'               to ULOG-REQUEST
           if  DUMP-RECL-MAX-S = 'Y'
           and DUMP-RECL-MAX < D-LEN
               add DUMP-RECL-MAX to ZERO giving ULOG-LENGTH
           else
               add D-LEN to ZERO giving ULOG-LENGTH
           end-if
           move DUMP-HEADER(1:ULOG-LENGTH) to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           exit.

      *****************************************************************
       DUMP-PRIMARY-MISSING.
           move 'TEXT' to ULOG-REQUEST
           add 79 to ZERO giving ULOG-LENGTH
           if  GROUP-DELIMITER = 'Y'
               move SPACES  to ULOG-MESSAGE
               move all '*' to ULOG-MESSAGE(1:79)
               call DUMP-PGM using ULOG-PASS-AREA
                                   ULOG-MESSAGE
           end-if
      *    Present in SYSUT2, missing from SYSUT1...
           move 'HYPE' to ULOG-REQUEST
           move UT1-MISSING to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA
                               ULOG-MESSAGE

           add SYSUT2-LRECL-M to ZERO giving D-LEN
           if  DUMP-RPI = 'Y'
               perform DUMP-POSITION-INDICATOR
           end-if
           perform DUMP-SECONDARY-RECORD
           move all '-' to DELTA-LINE-1(1:DLEN-UT1)
           move all '#' to DELTA-LINE-1(K-PS-1:K-LN-1)
           perform DUMP-POSITION-DIFFERENCES-1
           exit.

      *****************************************************************
       DUMP-PRIMARY-RECORD.
           add DPOS-UT1 to ZERO giving RECORD-POS
           add DLEN-UT1 to ZERO giving RECORD-LEN
           add DPOS-UT1 to ZERO giving D-POS
           add DLEN-UT1 to ZERO giving D-LEN
           move 'SYSUT1..' to RECORD-ID
           add SYSUT1-RDR to ZERO giving REC-NUMBER

           move 'HYPE'         to ULOG-REQUEST
           add 128 to ZERO giving ULOG-LENGTH
           move RECORD-HEADER  to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           move 'DUMP'                    to ULOG-REQUEST
           if  DUMP-RECL-MAX-S = 'Y'
           and DUMP-RECL-MAX < SYSUT1-LRECL-M
               add DUMP-RECL-MAX to ZERO giving ULOG-LENGTH
           else
               add SYSUT1-LRECL-M to ZERO giving ULOG-LENGTH
           end-if
           call DUMP-PGM using ULOG-PASS-AREA
                               SYSUT1-REC
           exit.

      *****************************************************************
       DUMP-SECONDARY-MISSING.
           move 'TEXT' to ULOG-REQUEST
           add 79 to ZERO giving ULOG-LENGTH
           if  GROUP-DELIMITER = 'Y'
               move SPACES  to ULOG-MESSAGE
               move all '*' to ULOG-MESSAGE(1:79)
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           end-if
      *    Present in SYSUT1, missing from SYSUT2...
           move 'HYPE' to ULOG-REQUEST
           move UT2-MISSING to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           add SYSUT1-LRECL-M to ZERO giving D-LEN
           if  DUMP-RPI = 'Y'
               perform DUMP-POSITION-INDICATOR
           end-if
           perform DUMP-PRIMARY-RECORD
           move all '#' to DELTA-LINE-2(K-PS-2:K-LN-2)
           perform DUMP-POSITION-DIFFERENCES-2
           exit.

      *****************************************************************
       DUMP-SECONDARY-RECORD.
           add DPOS-UT1 to ZERO giving RECORD-POS
           add DLEN-UT1 to ZERO giving RECORD-LEN
           add DPOS-UT1 to ZERO giving D-POS
           add DLEN-UT1 to ZERO giving D-LEN
           move 'SYSUT2..' to RECORD-ID
           add SYSUT2-RDR to ZERO giving REC-NUMBER

           move 'HYPE'         to ULOG-REQUEST
           add 128 to ZERO giving ULOG-LENGTH
           move RECORD-HEADER  to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           move 'DUMP'                    to ULOG-REQUEST
           if  DUMP-RECL-MAX-S = 'Y'
           and DUMP-RECL-MAX < SYSUT2-LRECL-M
               add DUMP-RECL-MAX to ZERO giving ULOG-LENGTH
           else
               add SYSUT2-LRECL-M to ZERO giving ULOG-LENGTH
           end-if
           call DUMP-PGM using ULOG-PASS-AREA
                               SYSUT2-REC
           exit.

      *****************************************************************
       DUMP-POSITION-CALCULATIONS.
           add POS-1 to ZERO giving PTR-1
           add POS-2 to ZERO giving PTR-2
           perform until PTR-1 > POS-1 + LEN-1 - 1
                      or PTR-2 > POS-2 + LEN-2 - 1
               if SYSUT1-REC(PTR-1:1)
                = SYSUT2-REC(PTR-2:1)
                  move '=' to DELTA-LINE-1(PTR-1:1)
                  move '=' to DELTA-LINE-2(PTR-2:1)
               else
                  move '#' to DELTA-LINE-1(PTR-1:1)
                  move '#' to DELTA-LINE-2(PTR-2:1)
               end-if
               add 1 to PTR-1
               add 1 to PTR-2
           end-perform
           exit.
      *****************************************************************
       CALC-DELTA-FOR-NE-EQ-NO.
           add POS-UT1 to ZERO giving PTR-1
           add POS-UT2 to ZERO giving PTR-2
           perform until PTR-1 > POS-UT1 + LEN-UT1 - 1
                      or PTR-2 > POS-UT2 + LEN-UT2 - 1
               if SYSUT1-REC(PTR-1:1)
                = SYSUT2-REC(PTR-2:1)
                  move '=' to DELTA-LINE-1(PTR-1:1)
                  move '=' to DELTA-LINE-2(PTR-2:1)
               else
                  move '#' to DELTA-LINE-1(PTR-1:1)
                  move '#' to DELTA-LINE-2(PTR-2:1)
               end-if
               add 1 to PTR-1
               add 1 to PTR-2
           end-perform
           exit.

      *****************************************************************
       DUMP-POSITION-DIFFERENCES-1.
           move 'TEXT' to ULOG-REQUEST
           if  DUMP-RECL-MAX-S = 'Y'
           and DUMP-RECL-MAX < SYSUT1-LRECL-M
               add DUMP-RECL-MAX to ZERO giving ULOG-LENGTH
           else
               add SYSUT1-LRECL-M to ZERO giving ULOG-LENGTH
           end-if
           add 1 to ZERO giving PTR-1
           if  ULOG-SYSLOG-FORMAT = 'HTML'
               move HTML-FONT-TAG-02 to ULOG-MESSAGE(PTR-1:ULOG-LENGTH)
               add length of HTML-FONT-TAG-02 to PTR-1
           end-if
           move DELTA-LINE-1(1:ULOG-LENGTH)
                                     to ULOG-MESSAGE(PTR-1:ULOG-LENGTH)
           if  ULOG-SYSLOG-FORMAT = 'HTML'
               inspect ULOG-MESSAGE replacing first '       '
                                                 by '</FONT>'
               add 7 to ULOG-LENGTH
               add length of HTML-FONT-TAG-02 to ULOG-LENGTH
           end-if
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           exit.

      *****************************************************************
       DUMP-POSITION-DIFFERENCES-2.
           move 'TEXT' to ULOG-REQUEST
           if  DUMP-RECL-MAX-S = 'Y'
           and DUMP-RECL-MAX < SYSUT2-LRECL-M
               add DUMP-RECL-MAX to ZERO giving ULOG-LENGTH
           else
               add SYSUT2-LRECL-M to ZERO giving ULOG-LENGTH
           end-if
           add 1 to ZERO giving PTR-1
           if  ULOG-SYSLOG-FORMAT = 'HTML'
               move HTML-FONT-TAG-02 to ULOG-MESSAGE(PTR-1:ULOG-LENGTH)
               add length of HTML-FONT-TAG-02 to PTR-1
           end-if
           move DELTA-LINE-2(1:ULOG-LENGTH)
                                     to ULOG-MESSAGE(PTR-1:ULOG-LENGTH)
           if  ULOG-SYSLOG-FORMAT = 'HTML'
               add ULOG-LENGTH to PTR-1
               move '</FONT>' to ULOG-MESSAGE(PTR-1:7)
               add 7 to ULOG-LENGTH
               add length of HTML-FONT-TAG-02 to ULOG-LENGTH
           end-if
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           exit.

      *****************************************************************
       JOB-FINISHED.
           if  SYSUT1-STATUS = '00'
           and DELTA-PROCESS   = 'EOF '
               perform until SYSUT1-STATUS not = '00'
                 perform SYSUT1-READ
                 add 1 to COMPARE-NE
               end-perform
           end-if
           if  SYSUT2-STATUS = '00'
           and DELTA-PROCESS   = 'EOF '
               perform until SYSUT2-STATUS not = '00'
                 perform SYSUT2-READ
                 add 1 to COMPARE-NE
               end-perform
           end-if
           perform SYSUT2-CLOSE
           perform SYSUT1-CLOSE

           move 'POST' to ULOG-REQUEST
           add 80 to ZERO giving ULOG-LENGTH

           if  GROUP-DELIMITER = 'Y'
               move SPACES  to ULOG-MESSAGE
      *        call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
               move all '*' to ULOG-MESSAGE(1:79)
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           end-if

           move 'Conclude' to INFO-ID
           move INFO-SHORT to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           move 'Finished' to INFO-ID

           move SYSUT1-TOTAL to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           if  SYSUT1-OMT > ZERO
               move SYSUT1-OMIT to ULOG-MESSAGE
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           end-if

           move SYSUT2-TOTAL to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           if  SYSUT2-OMT > ZERO
               move SYSUT2-OMIT to ULOG-MESSAGE
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           end-if

           if  SYSUT1-RDR not = SYSUT2-RDR
               move 'WARNING!  - Record counts are not equal'
                 to ULOG-MESSAGE
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
               move 'ABENDING' to INFO-ID
           end-if

           if  FF-01 = '1'
               if  COMPARE-NE = 0
                   inspect COMPARE-TAG
                   replacing first ' of existing records '
                                by ' is ZERO             '
               else
                   move 'ABENDING' to INFO-ID
               end-if
               move COMPARE-NE-TOTAL to ULOG-MESSAGE
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
               move COMPARE-EQ-TOTAL to ULOG-MESSAGE
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           end-if

           if  FF-02 = '1'
               if  COMPACT-NE = 0
                   inspect COMPACT-TAG
                   replacing first ' of existing records '
                                by ' is ZERO             '
               else
                   move 'ABENDING' to INFO-ID
               end-if
               move COMPACT-NE-TOTAL to ULOG-MESSAGE
               call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           end-if

           if  SYSUT1-EOF not = 'Y'
           or  SYSUT2-EOF not = 'Y'
               move 'ABENDING' to INFO-ID
           end-if

           perform DUMP-ASTERISK-ROW
           move INFO-STATEMENT to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           perform DUMP-ASTERISK-ONE

      *    move INFO-SHORT to MESSAGE-TEXT
      *    perform Z-POST-MESSAGE-TO-SYSOUT

           perform Z-THANK-YOU.

           move 'WRAP' to ULOG-REQUEST
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           if  COMPARE-NE > 0
           or  SYSUT1-RDR not = SYSUT2-RDR
               add IFNECODE-VALUE to ZERO giving RETURN-CODE
           end-if
           exit.

      *****************************************************************
       JOB-STARTING.
           perform Z-POST-COPYRIGHT
           perform Z-DETERMINE-ENVIRONMENT
           perform SYSUT1-OPEN
           perform SYSUT2-OPEN
           move 'Y' to READ-1
           move 'Y' to READ-2
           if  DELTA-MAXIMUM not numeric
               add 100 to ZERO giving DELTA-MAXIMUM
           end-if
           if  K-PS-1 > 0
           and K-PS-2 > 0
           and K-LN-1 > 0
           and K-LN-2 > 0
               move 'Y' to KEY-ACTIVE
               move 'Key control is ENABLED...'
                 to MESSAGE-TEXT
           else
               move 'N' to KEY-ACTIVE
               move 'Key control is NOT enabled...'
                 to MESSAGE-TEXT
           end-if
           perform Z-POST-MESSAGE-TO-SYSOUT

           move 'PREP' to ULOG-REQUEST
           move SPACES        to ULOG-MESSAGE
           move 'SIMOL32K'    to ULOG-SYSLOG-MODE
           move 'TEXT'        to ULOG-SYSLOG-FORMAT
           move 'DISABLED'    to ULOG-SYSOUT-MODE
           move 'TEXT'        to ULOG-SYSOUT-FORMAT
           move 'DISABLED'    to ULOG-SYSCON-MODE
           move 'TEXT'        to ULOG-SYSCON-FORMAT
           move 'Y'           to ULOG-DUMP-ASC
           move 'Y'           to ULOG-DUMP-HEX
           move 'Y'           to ULOG-DUMP-EBC
           move 'Y'           to ULOG-DUMP-RPI
           move 'Y'           to ULOG-DUMP-DTL

           move DUMP-ASC      to ULOG-DUMP-ASC
           move DUMP-EBC      to ULOG-DUMP-EBC
           move DUMP-HEX      to ULOG-DUMP-HEX

           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           move 'MAKE' to ULOG-REQUEST
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE

           move 'POST' to ULOG-REQUEST
           add 79 to ZERO giving ULOG-LENGTH
           move all '*' to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           move SIM-TITLE to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           move SIM-COPYRIGHT to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           move all '*' to ULOG-MESSAGE(1:79)
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           move INFO-STATEMENT to ULOG-MESSAGE
           call DUMP-PGM using ULOG-PASS-AREA ULOG-MESSAGE
           exit.

      *****************************************************************
      * I/O Routines for the Primary File...                          *
      *****************************************************************
       SYSUT1-CLOSE.
           add 8 to ZERO giving APPL-RESULT.
           close SYSUT1-FILE
           if  SYSUT1-STATUS = '00'
               subtract APPL-RESULT from APPL-RESULT
           else
               add 12 to ZERO giving APPL-RESULT
           end-if
           if  APPL-AOK
               CONTINUE
           else
               move 'CLOSE Failure with SYSUT1  ' to MESSAGE-TEXT
               perform Z-POST-MESSAGE-TO-USER
               move SYSUT1-STATUS to IO-STATUS
               perform Z-DISPLAY-IO-STATUS
               perform Z-ABEND-PROGRAM
           end-if
           exit.
      *---------------------------------------------------------------*
       SYSUT1-READ.
           read SYSUT1-FILE
           if  SYSUT1-STATUS = '00'
               subtract APPL-RESULT from APPL-RESULT
               add 1 to SYSUT1-RDR
           else
               if  SYSUT1-STATUS = '10'
                   add 16 to ZERO giving APPL-RESULT
               else
                   add 12 to ZERO giving APPL-RESULT
               end-if
           end-if
           if  APPL-AOK
               CONTINUE
           else
               if  APPL-EOF
                   move 'Y' to SYSUT1-EOF
               else
                   move 'READ Failure with SYSUT1  ' to MESSAGE-TEXT
                   perform Z-POST-MESSAGE-TO-USER
                   move SYSUT1-STATUS to IO-STATUS
                   perform Z-DISPLAY-IO-STATUS
                   perform Z-ABEND-PROGRAM
               end-if
           end-if
           exit.
      *---------------------------------------------------------------*
       SYSUT1-OPEN.
           add 8 to ZERO giving APPL-RESULT.
           open input SYSUT1-FILE
           if  SYSUT1-STATUS = '00'
               subtract APPL-RESULT from APPL-RESULT
               move 'O' to SYSUT1-OPEN-FLAG
           else
               add 12 to ZERO giving APPL-RESULT
           end-if
           if  APPL-AOK
               CONTINUE
           else
               move 'OPEN Failure with SYSUT1  ' to MESSAGE-TEXT
               perform Z-POST-MESSAGE-TO-CONSOLE
               perform Z-POST-MESSAGE-TO-USER
               move SYSUT1-STATUS to IO-STATUS
               perform Z-DISPLAY-IO-STATUS
               perform Z-ABEND-PROGRAM
           end-if
           exit.

      *****************************************************************
      * I/O Routines for the Secondary File...                        *
      *****************************************************************
       SYSUT2-READ.
           read SYSUT2-FILE
           if  SYSUT2-STATUS = '00'
               subtract APPL-RESULT from APPL-RESULT
               add 1 to SYSUT2-RDR
           else
               if  SYSUT2-STATUS = '10'
                   add 16 to ZERO giving APPL-RESULT
               else
                   add 12 to ZERO giving APPL-RESULT
               end-if
           end-if.
           if  APPL-AOK
               CONTINUE
           else
               if  APPL-EOF
                   move 'Y' to SYSUT2-EOF
               else
                   move 'READ Failure with SYSUT2  ' to MESSAGE-TEXT
                   perform Z-POST-MESSAGE-TO-USER
                   move SYSUT2-STATUS to IO-STATUS
                   perform Z-DISPLAY-IO-STATUS
                   perform Z-ABEND-PROGRAM
               end-if
           end-if
           exit.
      *---------------------------------------------------------------*
       SYSUT2-OPEN.
           add 8 to ZERO giving APPL-RESULT.
           open input SYSUT2-FILE
           if  SYSUT2-STATUS = '00'
               subtract APPL-RESULT from APPL-RESULT
               move 'O' to SYSUT2-OPEN-FLAG
           else
               add 12 to ZERO giving APPL-RESULT
           end-if
           if  APPL-AOK
               CONTINUE
           else
               move 'OPEN Failure with SYSUT2  ' to MESSAGE-TEXT
               perform Z-POST-MESSAGE-TO-CONSOLE
               perform Z-POST-MESSAGE-TO-USER
               move SYSUT2-STATUS to IO-STATUS
               perform Z-DISPLAY-IO-STATUS
               perform Z-ABEND-PROGRAM
           end-if
           exit.
      *---------------------------------------------------------------*
       SYSUT2-CLOSE.
           add 8 to ZERO giving APPL-RESULT.
           close SYSUT2-FILE
           if  SYSUT2-STATUS = '00'
               subtract APPL-RESULT from APPL-RESULT
               move 'C' to SYSUT2-OPEN-FLAG
           else
               add 12 to ZERO giving APPL-RESULT
           end-if
           if  APPL-AOK
               CONTINUE
           else
               move 'CLOSE Failure with SYSUT2  ' to MESSAGE-TEXT
               perform Z-POST-MESSAGE-TO-USER
               move SYSUT2-STATUS to IO-STATUS
               perform Z-DISPLAY-IO-STATUS
               perform Z-ABEND-PROGRAM
           end-if
           exit.

      *****************************************************************
      * The following Z-ROUTINES provide administrative functions     *
      * for this program.                                             *
      *****************************************************************
      * ABEND the program, post a message to the console and issue    *
      * a STOP RUN.                                                   *
      *****************************************************************
       Z-ABEND-PROGRAM.
           if  MESSAGE-TEXT not = SPACES
               perform Z-POST-MESSAGE-TO-USER
           end-if
           move 'PROGRAM-IS-ABENDING...'  to MESSAGE-TEXT
           perform Z-POST-MESSAGE-TO-USER
           add 12 to ZERO giving RETURN-CODE
           STOP RUN.
      *    exit.

      *****************************************************************
       Z-DETERMINE-ENVIRONMENT.
           add 16833 to ASC-OR-EBC
           if  ASC-A = 'A'
               move 'Compiled for an ASCII environment...'
                 to MESSAGE-TEXT
           else
               if  EBC-A = 'A'
                   move 'Compiled for an EBCDIC environment...'
                     to MESSAGE-TEXT
               else
                   move 'Compiled for an UNKNOWN environment...'
                     to MESSAGE-TEXT
               end-if
           end-if
           perform Z-POST-MESSAGE-TO-USER
           exit.


      *****************************************************************
       Z-CALCULATE-MESSAGE-LSB.
           if  MESSAGE-TEXT-2 = SPACES
               add  79 to ZERO giving MSG-LSB
           else
               add 267 to ZERO giving MSG-LSB
           end-if
           perform until MSG-LSB < 80
                      or MESSAGE-BUFFER(MSG-LSB:1) not = SPACE
             if MESSAGE-BUFFER(MSG-LSB:1) = SPACE
                subtract 1 from MSG-LSB
             end-if
           end-perform
           exit.

      *****************************************************************
      * Display message to SYSOUT device...                           *
      *****************************************************************
       Z-POST-MESSAGE-TO-SYSOUT.
           perform Z-CALCULATE-MESSAGE-LSB
           display MESSAGE-BUFFER(1:MSG-LSB)
           move all SPACES to MESSAGE-TEXT
           exit.

      *****************************************************************
      * Display message to CONSOLE device...                          *
      *****************************************************************
       Z-POST-MESSAGE-TO-CONSOLE.
           perform Z-CALCULATE-MESSAGE-LSB
           display MESSAGE-BUFFER(1:MSG-LSB) upon console
           exit.

      *****************************************************************
       Z-POST-MESSAGE-TO-USER.
           perform Z-POST-MESSAGE-TO-CONSOLE
           perform Z-POST-MESSAGE-TO-SYSOUT
           exit.

      *****************************************************************
      * Display the file status bytes. This routine will display as   *
      * four digits. If the full two byte file status is numeric it   *
      * will display as 00nn. If the 1st byte is a numeric nine (9)   *
      * the second byte will be treated as a binary number and will   *
      * display as 9nnn.                                              *
      *****************************************************************
       Z-DISPLAY-IO-STATUS.
           if  IO-STATUS not NUMERIC
           or  IO-STAT1 = '9'
               move IO-STAT1 to IO-STATUS-04(1:1)
               subtract TWO-BYTES-BINARY from TWO-BYTES-BINARY
               move IO-STAT2 to TWO-BYTES-RIGHT
               add TWO-BYTES-BINARY to ZERO giving IO-STATUS-0403
               move 'File Status is: nnnn' to MESSAGE-TEXT
               move IO-STATUS-04 to MESSAGE-TEXT(17:4)
               perform Z-POST-MESSAGE-TO-USER
           else
               move '0000' to IO-STATUS-04
               move IO-STATUS to IO-STATUS-04(3:2)
               move 'File Status is: nnnn' to MESSAGE-TEXT
               move IO-STATUS-04 to MESSAGE-TEXT(17:4)
               perform Z-POST-MESSAGE-TO-USER
           end-if
           exit.

      *****************************************************************
       Z-POST-COPYRIGHT.
           move SIM-TITLE to MESSAGE-BUFFER
           perform Z-POST-MESSAGE-TO-SYSOUT
           move SIM-COPYRIGHT to MESSAGE-BUFFER
           perform Z-POST-MESSAGE-TO-SYSOUT
           exit.

      *****************************************************************
       Z-THANK-YOU.
           move SIM-THANKS-01 to MESSAGE-BUFFER
           perform Z-POST-MESSAGE-TO-SYSOUT
           move SIM-THANKS-02 to MESSAGE-BUFFER
           perform Z-POST-MESSAGE-TO-SYSOUT
           exit.
      *****************************************************************
      *           This program was generated by SimoZAPS              *
      *             A product of SimoTime Technologies                *
      *        Our e-mail address is: helpdesk@simotime.com           *
      *     Also, visit our Web Site at http://www.simotime.com       *
      *                                                               *
      *  Generation Date: 2020-06-25  Generation Time: 19:20:21:97    *
      *****************************************************************

Table of Contents Previous Section Next Section Secondary Functions

This section will focus on the items (process and programs) that do the generation and compilation of a data file compare programs.

Table of Contents Previous Section Next Section Generate a File Compare Program

The SimoTime Utility Program for Data File Comparison runs on a Windows System with Micro Focus and will generate the COBOL source code for a program that will do a compare of two data files. The generation of the COBOL source code requires a Windows System with Micro Focus Studio or Micro Focus Server, version 6.0 or later. The generated COBOL source code may be compiled and executed on the following systems and will do the actual comparison of the two data files.

IBM Mainframe The Compilation and Execution of the generated COBOL source code is supported. COBOL for OS/390 or later should be used (this provided for Y2K compliance) to compile the generated source code.
Note: the SimoTime Utility program has the capability of generating COBOL Source code that can compare ASCII/Text (or LINE SEQUENTIAL) files. Programs that are generated with Line Sequential dependencies will not compile and execute in the ZOS environment of an IBM Mainframe.
Windows The Generation, Compilation and Execution of the generated COBOL source code is supported. To compile and execute the generated COBOL programs the Micro Focus Studio is recommended. However, Net Express and Mainframe Express may be used. Once a program is compiled with Micro Focus Studio it may be executed using Micro Focus Server.
Linux The Compilation and Execution of the generated COBOL source code is supported. To compile and execute the generated COBOL programs the Micro Focus Server Express is recommended. Once a program is compiled with Micro Focus Server Express it may be executed using Micro Focus Server.
UNIX The Compilation and Execution of the generated COBOL source code is supported.
  Express is recommended. Once a program is compiled with Micro Focus Server Express it may be executed using Micro Focus Server.
  System Possibilities for Generated Data File Comparison Programs

The SimoTime Utility for Data File Compare will provide additional detail about creating a Process Control File and generating the COBOL source code for a data file compare program.

Table of Contents Previous Section Next Section The Process Control File, an Example

The following is the Process Control File (CPLS4K01.pcf) that will define the process and parameters required for generating a COBOL program that will compare two record sequential file (RSEQ) containing 80-byte, fixed length records.

***********************************************************************
*                CPLS4K01.pcf - a Process Control File                *
*               SimoTime Program Generation Technologies              *
*             (C) Copyright 1987-2019 All Rights Reserved             *
*               Web Site URL:   http://www.simotime.com               *
*                     e-mail:   helpdesk@simotime.com                 *
***********************************************************************
* This is an example of the advanced compare specifications that
* track inserts and/or deletes and determines the record positions to
* be compared at compile time.
***********************************************************************
*
* The following group of statements will define the high level
* functions and processes to be performed.
*
&SIMOPREP  call ..\..\ENV1BASE
&USERPREP  call USERCOMP
&FUNCTION  COMPARE
&CONFORM   MF
&USRMODEL  SYSCOMP5.txt
*
* The following statements will cause an HTML document to be created
* for the record structure defined by a COBOL copy file. For this
* example the statements have been commented.
*
*COPYFILE  CHAR80B1.CPY
*HTMLFILE  cpls80h1.htm
*
* The following group of statements will define the behavioral
* characteristics and environment variables for the file I/O
* functions within the Program to be generated.
*
*HEAD34    ....:....1....:....2....:....3....
&HEAD34    Compare LSEQ, SYSUT3 and KEYFIELD
&PROGID    CPLS4KC1
&SYSUT1    org=ASCII/Text recfm=FIXED rlen=4096
&SYSUT2    org=ASCII/Text recfm=FIXED rlen=4096
*
* The following group of statements will define the behavioral
* characteristics and environment variables for the compare functions
* within the Program to be generated.
*
&KEYFIELD  SYSUT1 pos  1 len 10 SYSUT2 pos  1 len 10
&COMPARE   SYSUT1 pos  1 len 16 SYSUT2 pos  1 len 18
&COMPARE   SYSUT1 pos 20 len 61 SYSUT2 pos 20 len 61
*
* The following group of statements will define the behavioral
* characteristics and environment variable for the compare functions
* within the Program to be generated.
*
&DELTAMAX  50 EOF
&IFNECODE  0004
*
&DFORMAT   ASC HEX EBC RPI
&SYSLOG    SIMOL32K TEXT
*
&END

Table of Contents Previous Section Next Section Ancillary Functionality

This section provides additional detail about the CMD files and programs that are used to support this set of sample programs.

Table of Contents Previous Section Next Section Set the Environment

A Windows command file (ENV1BASE.cmd) is called from other command files to set commonly used environment variables. This provides a single point of definition. The following is a listing of the contents of the command file.

@echo OFF
rem  * *******************************************************************
rem  *               ENV1BASE.cmd - a Windows Command File               *
rem  *        This program is provided by SimoTime Technologies          *
rem  *           (C) Copyright 1987-2021 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Provide a single point to set common environment variables.
rem  * Author - SimoTime Technologies
rem  * Date   - January 24, 1996
rem  *
rem  * Set the commonly used environment variables. This is used to provide
rem  * a single point for managing the commonly used environment variables.
rem  *
     set SimoLIBR=c:\SimoLIBR
     set BASELIB1=c:\SIMOSAM1\DEVL
     set BASELIB8=c:\SimoSAM8
     set BaseWIP1=c:\SimoSAM1\WIP1
     set DATAZERO=c:\SIMODATA\DEVL\DATA\ZERO
     set BASEAPP=%BaseLib1%
     set BASESYS=%BaseLib1%\SYS1
     set BASECAT=%BaseLib1%\DATA
     set UMAPALIB=%BASECAT%\ASC1
     set UMAPELIB=%BASECAT%\EBC1
     set SYSLOG=%BASESYS%\LOGS\SYSLOG_USER.DAT
     set SYSOUT=%BASEAPP%\LOGS\SYSOUT_SIMSAM01.txt
     set SLZMSG=%BASEAPP%\LOGS\SLZMSG_USER.TXT
     set PostNOTE=%BASEAPP%\LOGS\JOBLOG_SIMONOTE.TXT
     set SIMONOTE=%BASEAPP%\LOGS\JOBLOG_SIMONOTE.txt
     set USERPOST=%BASEAPP%\LOGS\ASSIGNED_USER_POST_FILE.txt
     if [%1]==[] goto NO_POST
     set SYSOUT=%BaseLib1%\LOGS\SYSOUT_%1.txt
     call SIMONOTE "+ ENV1BASE *"
     call SIMONOTE "+ ENV1BASE ********************************************************************%1"
     call SIMONOTE "+ ENV1BASE is preparing the System Environment..."
     call SIMONOTE "+ SIMOLIBR is %SIMOLIBR%"
     call SIMONOTE "+ MIFOSYS1 is %MIFOSYS1%"
     call SIMONOTE "+ BASELIB1 is %BASELIB1%"
:NO_POST
     call SIMONOTE "+ SIMONOTE Job Log File is %SIMONOTE% "
rem  *
     set MQBASE=C:\Program Files\IBM\WebSphere MQ
rem  *
rem  * Set the location for the Apache-Tomcat Server...
     set CATALINA_HOME=C:\APACHETC\apache-tomcat-7.0.52
rem     set CATALINA_HOME=C:\Program Files (x86)\Java\jdk1.8.0_112
rem  *
rem  * Set the Environment for the Java Environment...
rem     set JAVABASE=C:\APACHETC\apache-tomcat-7.0.52
     set JAVABASE=C:\Program Files (x86)\Java\jdk1.8.0_112
     set JAVASDK="%JAVABASE%\bin"
     set JAVA_HOME=%JAVABASE%
     set JRE_HOME=%JAVABASE%
     set SIMOTCAT=%CATALINA_HOME%\webapps\simotcat
     set SIMPACKS=%CATALINA_HOME%\webapps\simotcat\WEB-INF\classes\simpacks
rem  *
rem  * Set the environment for the Micro Focus technology...
     set MIFOEDEV=C:\Program Files (x86)\Micro Focus\Enterprise Developer
     set MIFOVCBL=C:\Program Files (x86)\Micro Focus\Visual COBOL Build Tools
     set MIFOESTU=C:\Program Files (x86)\Micro Focus\Studio Enterprise Edition 6.0
     set MIFOEMFE="C:\Program Files (x86)\Micro Focus\Mainframe Express"
rem  *
rem  * Large file support, performance tuning and record locking of the File Handler
     set EXTFH=%BASESYS%\CONFIG\EXTFHBIG.CFG
rem  *
rem  * For IMS Support
     set ES_IMSLIB=%BASEAPP%\IMSLIB
     set ES_ACBLIB=%BASEAPP%\IMSLIB
rem  *
rem  * EZASOKETS Check EZASOKETS Enabled box or set ES_EZASOKET_SUPPORT=YES
     set EZACONFG=BASESYS1\CONFIG\EZACONFG.dat
rem  *
rem  * Resource Allocation and Performance for SORT and non-Relational Data
rem  set MFJSENGINE=SYNCSORT
     set SORTSCHEME=1
     set SORTSPACE=750000000
     set TMP=C:\SORTWORK
rem  *
     set ES_ALLOC_OVERRIDE=%BASESYS%\CONFIG\CATMAPA1.cfg
rem  * For CORE_ON_ERROR function, ABEND Dump
rem  *     set COBCONFIG_=%BASESYS%\CONFIG\diagnose.cfg
rem  *
rem  * Consolidated Trace Facility (CTF)
rem  *     set MFTRACE_CONFIG=%BASESYS%\CONFIG\ctf.cfg
rem  *     set MFTRACE_LOGS=c:\ctflogs
rem  *
rem  * For Job Restart, ABEND Recovery
     set MF_UCC11=Y
     set ES_JES_RESTART=Y
rem  *
rem  * Set environment for MFBSI (Micro Focus Batch Scheduling Interface)
     set ES_EMP_EXIT_1=mfbsiemx
     set MFBSI_DIR=%BASESYS%\LOGS\%JESSERVERNAME%
     set MFBSIEOP_CMD=ENABLE
     set MFBSIEOP_CSV=ENABLE
     set MFBSIEOP_HTM=ENABLE
     set MFBSIEOP_XML=ENABLE
rem  *
rem  * Set Behavior and Trace Flags for GETJOBDD
rem  *   Position=12345678/12345678
     set JDDFLAGS=nnnWnnnn/YYnnnnnn
rem  *
rem  * If not already set then set the PATH for Micro Focus Directories
     if "%SIMOPATH%" == "Y" goto JUMPPATH
     if "%MIFOSYS1%" == "EDEV" goto JUMPEDEV
     if "%MIFOSYS1%" == "VCBL" goto JUMPVCBL
     if "%MIFOSYS1%" == "ESTU" goto JUMPESTU
     if "%MIFOSYS1%" == "EMFE" goto JUMPEMFE
:JUMPEDEV
     set path=%BASESYS%\LOADLIB;%MIFOEDEV%\bin;%JAVASDK%;%BASEAPP%\JAVA;%PATH%;
     set CobCpy=%BASEAPP%\CobCpy1;%BASEAPP%\CobCpy2;%BASEAPP%\CobCpy6;%SimoLIBR%;%MIFOEDEV%\CPYLIB
     set MIFOBASE=%MIFOEDEV%
     goto JUMPPATH
:JUMPVCBL
     set path=%MIFOVCBL%\bin;%MIFOVCBL%;%JAVASDK%;%BASEAPP%\JAVA;%PATH%;
     set MIFOBASE=%MIFOVCBL%
     goto JUMPPATH
:JUMPESTU
     set MIFOBASE=%MIFOESTU%\Base
     set MIFOBIN=%MIFOBASE%\bin
     set path=%BASESYS%\LOADLIB;%MIFOBASE%;%MIFOBIN%;%JAVASDK%;%BASEAPP%\JAVA;%PATH%;
     set CobCpy=%BASEAPP%\CobCpy1;%BASEAPP%\CobCpy2;%BASEAPP%\CobCpy6;%SimoLIBR%;%MIFOBASE%\SOURCE
     goto JUMPPATH
:JUMPEMFE
     set MIFOBASE=%MIFOEMFE%\Base
     set MIFOBIN=%MIFOBASE%\bin
     set path=%BASESYS%\LOADLIB;%MIFOBASE%;%MIFOBIN%;%JAVASDK%;%BASEAPP%\JAVA;%PATH%;
     set CobCpy=%BASEAPP%\CobCpy1;%BASEAPP%\CobCpy2;%BASEAPP%\CobCpy6;%SimoLIBR%;%MIFOBASE%\SOURCE
     goto JUMPPATH
rem  *
:JUMPPATH
     set SIMOPATH=Y
rem  *
     set MAINFRAME_FLOATING_POINT=true
     set COBIDY=%BASEAPP%\COBIDY
     set COBPATH=.;%BASEAPP%\LOADLIB;%BASEAPP%\LOADLIB\GNTS;%BASESYS%\LOADLIB;%SimoLIBR%
     set LIBPATH=.;%BASEAPP%\LOADLIB;%BASEAPP%\LOADLIB\GNTS;%BASESYS%\LOADLIB;%SimoLIBR%
     set TXDIR=%BASESYS%\LOADLIB;%MIFOBASE%
     set CobCpy=%BASEAPP%\CobCpy1;%BASEAPP%\CobCpy2;%BASEAPP%\CobCpy6;%SimoLIBR%
rem  *
     set USERCLASS=%BASELIB1%\LOADLIB
     set CLASSPATH=.
     set CLASSPATH=%CLASSPATH%;%JAVABASE%
     set CLASSPATH=%CLASSPATH%;%JAVABASE%\lib
     set CLASSPATH=%CLASSPATH%;\%USERCLASS%\simpacks
     set CLASSPATH=%CLASSPATH%;C:\APACHETC\apache-tomcat-7.0.52\webapps\simotcat\WEB-INF\classes
     set CLASSPATH=%CLASSPATH%;C:\APACHETC\apache-tomcat-7.0.52\webapps\simotcat\WEB-INF\classes\simpacks
rem  *
     if "%MIFOSYS1%" == "ESTU" set CLASSPATH=%CLASSPATH%;%MIFOBIN%
     if "%MIFOSYS1%" == "EDEV" set CLASSPATH=%CLASSPATH%;%MIFOEDEV%
     if "%MIFOSYS1%" == "VCBL" set CLASSPATH=%CLASSPATH%;%MIFOVCBL%
     if "%MIFOSYS1%" == "VCBL" set CLASSPATH=%CLASSPATH%;%MIFOVCBL%\bin\mfcobol.jar
rem  *
     set JobStatus=0000
     call SIMONOTE "+ ENV1BASE is returning to caller"


Table of Contents Previous Section Next Section Display and Log Messages

The following (SIMONOTE.cmd) is a listing of the contents of the SimoNOTE.CMD command file.

@echo OFF
rem  * *******************************************************************
rem  *               SIMONOTE.cmd - a Windows Command File               *
rem  *         This program is provided by SimoTime Technologies         *
rem  *            (C) Copyright 1987-2019 All Rights Reserved            *
rem  *              Web Site URL:   http://www.simotime.com              *
rem  *                    e-mail:   helpdesk@simotime.com                *
rem  * *******************************************************************
rem  *
rem  * Text    - Display message on screen and write to a log file.
rem  * Author  - SimoTime Technologies
rem  *
rem  * This script may be called from other scripts and expects a single
rem  * parameter enclosed in double quotes. The double quotes will be
rem  * removed. Before writing to the log file a date and time stamp
rem  * will be inserted in front of the message text.
rem  *
rem  * Note: The tilde (~) removes leading/trailing double-quotes.
rem  *
if "%SimoNOTE%" == "" set SimoNOTE=c:\SimoLIBR\LOGS\SimoTime.LOG
echo %date% %time% %~1>> %SimoNOTE%
echo %~1

Table of Contents Previous Section Next Section Create Test Files

This example uses three data files to demonstrate the basic functions of the data file compare process. the first two files are sequential files containing three records of identical content. The third file is different from the first two files and is used to shows the results when a NOT-Equal condition occurs.

Table of Contents Previous Section Next Section Create Test Files using a Windows CMD File

This Windows CMD file (CPLSEQW8.cmd) will use the Windows ECHO Command to create three ASCII/Text (or Line Sequential) files. The ASCII/Text files will then be converted to sequential files that will be used to test the Data File Compare program that was generated.

@echo OFF
     set CmdName=CPLSEQW8
rem  * *******************************************************************
rem  *               CPLSEQW8.cmd - a Windows Command File               *
rem  *       This Job Script is provided by SimoTime Technologies        *
rem  *           (C) Copyright 1987-2019 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Create Test Files
rem  * Author - SimoTime Technologies
rem  * Date   - January 24, 1996
rem  *
rem  * This Job Script was created and tested on a Windows System
rem  *
rem  * This Job Script calls the following Windows Command Files.
rem  * 1. ENV1BASE.cmd - this provides a single point for setting commonly
rem  *                   used environment variables.
rem  * 2. SIMONOTE.cmd - this provides a consistent process for displaying
rem  *                   messages to the screen and writing to a journal
rem  *                   or log file.
rem  *
rem  * *******************************************************************
rem  * Prepare the System environment...
rem  *
     call ..\ENV1BASE %CmdName%
     set JobStatus=0
rem  *
     call SimoNOTE "*******************************************************%CmdName%"
     call SimoNOTE "* Job_Step 01 of 07, Prepare the Job Environment"
     set WRKUT1=%BaseLib1%\DATA\APPL\SIMOTIME.TESTEQ.CPLSEQD1.txt
     set WRKUT2=%BaseLib1%\DATA\APPL\SIMOTIME.TESTEQ.CPLSEQD2.txt
     set WRKUT3=%BaseLib1%\DATA\APPL\SIMOTIME.TESTNE.CPLSEQD1.txt
     set WRKUT4=%BaseLib1%\DATA\APPL\SIMOTIME.TESTNE.CPLSEQD2.txt
     set WRKUT5=%BaseLib1%\PARMLIB\CPLSSEG2.ctl
rem  *
     if exist %WRKUT1% erase %WRKUT1%
     if exist %WRKUT2% erase %WRKUT2%
     if exist %WRKUT3% erase %WRKUT3%
     if exist %WRKUT4% erase %WRKUT4%
     if exist %WRKUT5% erase %WRKUT5%
rem  *
rem  * The Line Sequential Files created by Job Steps 2 and 3 are provided
rem  * for testing the following functions.
rem  * 1. Do a partial compare using segments of a record
rem  * 2. Produce an Equal (EQ) result when files have known differences.
rem  *
     call SimoNOTE "* Job_Step 02 of 07, Create 1st File for Compare with EQ Result"
rem  *    ....:....1....:....2....:....3....:....4....:....5....:....6....:....
     echo 0000000010 File 001, Record 001>%WRKUT1%
     echo 0000000020 File 001, Record 002>>%WRKUT1%
     echo 0000000030 File 001, Record 003>>%WRKUT1%
     echo 0000000040 File 001, Record 004>>%WRKUT1%
     echo 0000000050 File 001, Record 005>>%WRKUT1%
     echo 0000000060 File 001, Record 006>>%WRKUT1%
     echo 0000000070 File 001, Record 007>>%WRKUT1%
     echo 0000000080 File 001, Record 008>>%WRKUT1%
     echo 0000000090 File 001, Record 009>>%WRKUT1%
     echo 0000000100 File 001, Record 010>>%WRKUT1%
rem  *
     call SimoNOTE "* Job_Step 03 of 07, Create 2nd File for Compare with EQ Result"
rem  *    ....:....1....:....2....:....3....:....4....:....5....:....6....:....
     echo 0000000010 File 002, Record 001>%WRKUT2%
     echo 0000000020 File 002, Record 002>>%WRKUT2%
     echo 0000000030 File 002, Record 003>>%WRKUT2%
     echo 0000000040 File 002, Record 004>>%WRKUT2%
     echo 0000000050 File 002, Record 005>>%WRKUT2%
     echo 0000000060 File 002, Record 006>>%WRKUT2%
     echo 0000000070 File 002, Record 007>>%WRKUT2%
     echo 0000000080 File 002, Record 008>>%WRKUT2%
     echo 0000000090 File 002, Record 009>>%WRKUT2%
     echo 0000000100 File 002, Record 010>>%WRKUT2%
rem  *
rem  * The Line Sequential Files created by Job Steps 4 and 5 are provided
rem  * for testing the following functions.
rem  * 1. Do a partial compare using segments of a record
rem  * 2. Produce a Not Equal (NE) result when record segments are different.
rem  * 3. Identify missing or inserted records based on a key field.
rem  * Note: To track inserts and missing records the files must be arranged
rem  *       arranged in a sequence based on the content of a key field
rem  *       (Positions 1-10).
rem  *       This capability was originally intended for use with a
rem  *       VSAM/KSDS but will work with sequential files.
rem  *
     call SimoNOTE "* Job_Step 04 of 07, Create 1st File for Compare with NE Result"
rem  *    ....:....1....:....2....:....3....:....4....:....5....:....6....:....
     echo 0000000010 File 003, Record 001>%WRKUT3%
     echo 0000000030 File 003, Record 003>>%WRKUT3%
     echo 0000000050 File 003, Record 005>>%WRKUT3%
     echo 0000000060 File 003, Record 006>>%WRKUT3%
     echo 0000000070 File 003, Record 007>>%WRKUT3%
     echo 0000000080 File 003, Record 008>>%WRKUT3%
     echo 0000000090 File 003, Record 009>>%WRKUT3%
     echo 0000000100 File 003, Record 010>>%WRKUT3%
rem  *
     call SimoNOTE "* Job_Step 05 of 07, Create 2nd File for Compare with NE Result"
rem  *    ....:....1....:....2....:....3....:....4....:....5....:....6....:....
     echo 0000000020 File 004, Record 002>%WRKUT4%
     echo 0000000040 File 004, Record 004>>%WRKUT4%
     echo 0000000050 File 004, Record 005>>%WRKUT4%
     echo 0000000090 File 004, record 009>>%WRKUT4%
rem  *
rem  * The Line Sequential File created by Job Steps 6 is provided for
rem  * testing the following functions.
rem  * 1. Submit /COMPARE statements at Program Execution Time.
rem  * 2. Define the record segments to be included in the compare processing.
rem  * 3. Submit and process multiple /COMPARE statements
rem  * Note: The File Identifier located at positions 17-19 will not be
rem  *       included in the compare processing.
rem  *
     call SimoNOTE "* Job_Step 06 of 07, Create PARMLIB File for Compare Specifications"
rem  *    ....:....1....:....2....:....3....:....4....:....5....:....6....:....
     echo * *******************************************************************>%WRKUT5%
     echo *     CPLS1KT3.ctl - Program Behavior Statements for Compare        *>>%WRKUT5%
     echo *    Processed at Execution Time by Generated Compare Program       *>>%WRKUT5%
     echo *         This Member is provided by SimoTime Technologies          *>>%WRKUT5%
     echo *           (C) Copyright 1987-2019 All Rights Reserved             *>>%WRKUT5%
     echo *             Web Site URL:   http://www.simotime.com               *>>%WRKUT5%
     echo *                   e-mail:   helpdesk@simotime.com                 *>>%WRKUT5%
     echo * *******************************************************************>>%WRKUT5%
     echo *...:....1....:....2....:....3....:....4....:....5....:....6>>%WRKUT5%
     echo /COMPARE   SYSUT1 pos 01 len 16 SYSUT2 pos 01 len 16>>%WRKUT5%
     echo /COMPARE   SYSUT1 pos 20 len 61 SYSUT2 pos 20 len 61>>%WRKUT5%
rem  *
rem  * *******************************************************************
:Eoj
     call SIMONOTE "* Job_Step 07 of 07, End of Job Processing"
     if exist %WRKUT1% goto EojJ02
     set JobStatus=16
     call SIMONOTE "* TESTFILE missing, WRKUT1 is %WRKUT1%"
:EojJ02
     if exist %WRKUT2% goto :EojJ03
     set JobStatus=16
     call SIMONOTE "* TESTFILE missing, WRKUT2 is %WRKUT2%"
:EojJ03
     if exist %WRKUT3% goto :EojJ04
     set JobStatus=16
     call SIMONOTE "* TESTFILE missing, WRKUT3 is %WRKUT3%"
:EojJ04
     if exist %WRKUT4% goto :EojJ05
     set JobStatus=16
     call SIMONOTE "* TESTFILE missing, WRKUT4 is %WRKUT4%"
:EojJ05
     if exist %WRKUT5% goto :EojJ06
     set JobStatus=16
     call SIMONOTE "* TESTFILE missing, WRKUT5 is %WRKUT5%"
:EojJ06
     if not "%JobStatus%" == "0" goto :EojNok
:EojAok
     call SimoNOTE "* Finished JobName %CmdName%, Job Status is %JobStatus% "
     goto :End
:EojNok
     call SimoNOTE "* ABENDING JobName %CmdName%, Job Status is %JobStatus% "
:End
     if not "%SIMOGENS%" == "BATCH" pause
     exit /b

Table of Contents Previous Section Next Section Summary

This document will focus on doing an actual compare of two line sequential (or ASCII/Text) files. This document may be used to assist as a tutorial for new programmers or as a quick reference for experienced programmers.

In the world of programming there are many ways to solve a problem. This documentation and software were developed and tested on systems that are configured for a SIMOTIME environment based on the hardware, operating systems, user requirements and security requirements. Therefore, adjustments may be needed to execute the jobs and programs when transferred to a system of a different architecture or configuration.

SIMOTIME Services has experience in moving or sharing data or application processing across a variety of systems. For additional information about SIMOTIME Services or Technologies please contact us using the information in the  Contact or Feedback  section of this document.

Table of Contents Previous Section Next Section Software Agreement and Disclaimer

Permission to use, copy, modify and distribute this software, documentation or training material for any purpose requires a fee to be paid to SimoTime Technologies. Once the fee is received by SimoTime the latest version of the software, documentation or training material will be delivered and a license will be granted for use within an enterprise, provided the SimoTime copyright notice appear on all copies of the software. The SimoTime name or Logo may not be used in any advertising or publicity pertaining to the use of the software without the written permission of SimoTime Technologies.

SimoTime Technologies makes no warranty or representations about the suitability of the software, documentation or learning material for any purpose. It is provided "AS IS" without any expressed or implied warranty, including the implied warranties of merchantability, fitness for a particular purpose and non-infringement. SimoTime Technologies shall not be liable for any direct, indirect, special or consequential damages resulting from the loss of use, data or projects, whether in an action of contract or tort, arising out of or in connection with the use or performance of this software, documentation or training material.

Table of Contents Previous Section Next Section Downloads and Links

This section includes links to documents with additional information that are beyond the scope and purpose of this document. The first group of documents may be available from a local system or via an internet connection, the second group of documents will require an internet connection.

Note: A SimoTime License is required for the items to be made available on a local system or server.

Table of Contents Previous Section Next Section Current Server or Internet Access

The following links may be to the current server or to the Internet.

Note: The latest versions of the SimoTime Documents and Program Suites are available on the Internet and may be accessed using the Link to Internet icon. If a user has a SimoTime Enterprise License the Documents and Program Suites may be available on a local server and accessed using the Link to Server icon.

Link to Internet   Link to Server   Explore the Principles of Data File Validation. This link includes guidelines for defining requirements and determining the scope of effort for a data validation effort. This effort includes a data file compare process, a technique for accumulating summary totals with a record count and a technique for reading a VSAM, KSDS and producing a hex-dump output based on a list of user-defined keys.

Link to Internet   Link to Server   Explore How to Generate a Data File Compare, Validate or Hex-Dump Program using simple specification statements in a Process Control File (PCF). This link to the User Guide includes the information necessary to create a Process Control File and generate the COBOL programs that will do a data file compare, accumulate summary totals with a record count or produce a Hex-Dump of records in a VSAM, KSDS based on a list of user-defined keys. The User Guide contains a list of the PCF statements that are used for the data file compare, validate or dump process.

Link to Internet   Link to Server   Explore How to Create Line Sequential or ASCII/Text Files that will be used as test data. The files will be used to test programs that do compare processing.

Link to Internet   Link to Server   Explore the COBOL Connection for more examples of COBOL programming techniques and sample code.

Link to Internet   Link to Server   Explore The ASCII and EBCDIC Translation Tables. These tables are provided for individuals that need to better understand the bit structures and differences of the encoding formats.

Link to Internet   Link to Server   Explore The File Status Return Codes that are used to interpret the results of accessing VSAM data sets and/or QSAM files.

Table of Contents Previous Section Next Section Internet Access Required

The following links will require an internet connect.

This suite of programs and documentation is available for download. Link to an Evaluation zPAK Option that includes the program members, documentation and control files.

A good place to start is The SimoTime Home Page for access to white papers, program examples and product information. This link requires an Internet Connection

Explore The Micro Focus Web Site for more information about products (including Micro Focus COBOL) and services available from Micro Focus. This link requires an Internet Connection.

Table of Contents Previous Section Next Section Glossary of Terms

Link to Internet   Link to Server   Explore the Glossary of Terms for a list of terms and definitions used in this suite of documents and white papers.

Table of Contents Previous Section Next Section Contact or Feedback

This document was created and is maintained by SimoTime Technologies. If you have any questions, suggestions, comments or feedback please use the following contact information.

1. Send an e-mail to our helpdesk.
1.1. helpdesk@simotime.com.
2. Our telephone numbers are as follows.
2.1. 1 415 763-9430 office-helpdesk
2.2. 1 415 827-7045 mobile

 

We appreciate hearing from you.

Table of Contents Previous Section Next Section Company Overview

SimoTime Technologies was founded in 1987 and is a privately owned company. We specialize in the creation and deployment of business applications using new or existing technologies and services. We have a team of individuals that understand the broad range of technologies being used in today's environments. Our customers include small businesses using Internet technologies to corporations using very large mainframe systems.

Quite often, to reach larger markets or provide a higher level of service to existing customers it requires the newer Internet technologies to work in a complementary manner with existing corporate mainframe systems. We specialize in preparing applications and the associated data that are currently residing on a single platform to be distributed across a variety of platforms.

Preparing the application programs will require the transfer of source members that will be compiled and deployed on the target platform. The data will need to be transferred between the systems and may need to be converted and validated at various stages within the process. SimoTime has the technology, services and experience to assist in the application and data management tasks involved with doing business in a multi-system environment.

Whether you want to use the Internet to expand into new market segments or as a delivery vehicle for existing business functions simply give us a call or check the web site at http://www.simotime.com


Return-to-Top
Record-by-Record Compare of Two Line Sequential Files
Copyright © 1987-2024
SimoTime Technologies and Services
All Rights Reserved
When technology complements business
http://www.simotime.com