HELPLIB.HLB  —  CMS  DIFFERENCES  file  Description
    The DIFFERENCES command compares the contents of two files. If
    CMS finds differences, it creates a file named first-file-name.DIF
    in your current default directory (unless /OUTPUT is in effect.)
    If the files are the same, it issues a message to that effect
    and does not create a differences file. By default, CMS compares
    two files that are not located in a CMS library. However, you can
    direct CMS to use element generations from the current library by
    specifying the /GENERATION qualifier on one or both of the file
    name parameters.

    Note: If both file1 and file2 are element generations, both
    generations must reside in the same library of the search list
    or an error will occur.

    A difference is defined as one of the following:

    o  A line or lines that are in one file and not in the other.

    o  A replacement of n lines by m lines (n may or may not be equal
       to m).

    Only the lines that differ are displayed in the differences file
    (unless you specify /FULL).

    A heading at the beginning of the differences file includes the
    name of the user that issued the command, the date and time the
    command was issued, and the file specifications of the two files
    being compared. If you direct CMS to use element generations and
    you have specified the /FORMAT option generation-differences,
    the differences listing contains a section labeled "Generation
    Differences" that contains the replacement history for the
    element. Each generation used in the comparison is identified by
    an asterisk (*) in the first column of the transaction record.
    The differences between the files are contained in a section
    labeled "Text Differences." By default, each difference is
    formatted with the line or lines from the first file followed by
    the differing line or lines from the second file. If a difference
    consists of a line or lines in one file but not the other,
    only the lines from the file containing the additional text are
    displayed.

    If you specify the /SKIP, /SENTINEL, and /IGNORE qualifiers on the
    same command line, they are processed in the following order:

    (1) /IGNORE=HISTORY
    (2) /IGNORE=NOTES
    (3) /SKIP
    (4) /SENTINEL
    (5) /IGNORE options other than HISTORY or NOTES

    For example, if you specify /SKIP=5 and /SENTINEL=("sushi","bar"),
    DIFFERENCES disregards the first 5 lines in each of the compared
    files, and then searches the remainder of each file for the
    sentinel character strings "sushi" and "bar".
Close Help