|
A default compare type, listing type, listing data set name, and
Browse option are provided if you choose not to specify your own.
The fields on the SuperCE Utility panel are:
- New DS Name and Old DS Name
- Specify the name of
a sequential data set, PDS, or membered PDS. Use standard TSO naming
conventions, including quotes for fully qualified names. Leave either
or both of these fields blank to display a panel on which you can
specify concatenated, uncataloged, and password-protected data sets.
These panels are shown in Figure 1 (foreground
compare) and Figure 1 (batch
compare).
- PDS Member List
- Leave
this field blank to display a member selection list for the new data
set. Otherwise, enter either a pattern or an asterisk (*). See SuperC member lists for more information.
- pattern
- Entering a pattern causes ISPF to display a list of the members
in the new data set that match the pattern, unless Bypass Selection
List has been specified. For more information about using patterns,
see the "ISPF Libraries and Data Sets" topic of
the z/OS ISPF User's Guide Vol I.
For example:
PDS Member List . . ISR*
- *
- Entering an asterisk causes all the members in the new data set
to be compared to any like-named members in the old data set. A member
list is not displayed. For example:
PDS Member List . . *
Members
in either data set not having like-named members in the other data
set are not compared, but are listed in the output list data set.
When
entire data sets are compared by using an asterisk for a member name
pattern, each real member that appears in both the old and new data
sets is compared once. Alias entries are processed but only to determine
if they have matching alias and/or real entries.
Note: You can also use SELECT
process statements in the statements data set to specify an optional
set of PDS members to be searched. However, the SELECT statement turns
off the PDS member list function.
- Compare Type
- The
type of comparison you want SuperC to perform. Choose one of these:
- File
- Compares source
data sets for differences, but does not show what the differences
are. This is the simplest and fastest method with the least amount
of processing overhead. For this compare type, SuperC prepares summary
information only and causes all listing types to produce the same
output, except NOLIST, which does not produce any output listing.
A message is returned to notify you of the compare results.
- Line
- Compares source
data sets for line differences. Reformatted lines (that is, lines
with blanks inserted or deleted) are automatically detected for lines
less than or equal to 256 characters. This compare type is the default.
It is most useful for comparisons of program source code because it
is record-oriented and points out inserted or deleted lines of code.
Lines can be of unlimited size.
- Word
- Compares source
data sets for word differences. In this context, a word is
a group of characters that begins and ends with a blank or other line
delimiter. If you use
the XWDCMP process option, all non-alphanumeric characters are considered
to be delimiters. Also, a word cannot be longer than 256 characters.
The Word compare type is most useful for comparing text data sets.
If two data sets contain the same words in the same order, SuperC
considers them to be identical, even if those words are not on the
same lines.
- Byte
- Compares source
data sets for byte differences. The output listing data set consists
of a hexadecimal printout with character equivalents listed on the
right. A BYTE compare with a LONG listing of a data set against itself
results in a hexadecimal dump of that data set. This compare type
is most useful for comparing machine readable data.
- Listing Type
- The
type of listing you want SuperC to create when it compares the data
sets. Listing Type is not a required field in SuperCE. If you do not
specify a listing type, the default is DELTA. See the topic about
Listing Formats in the z/OS ISPF User's Guide Vol I for
sample listings.
- OVSUM
- Lists only the
general summary of the comparison. However, a PDS comparison generates
an individual summary line for each PDS member.
- Delta
- Lists the differences
between the source data sets, followed by the general summary.
- CHNG
- Lists the differences
between the source data sets, plus up to 10 matching lines before
and after the differences. This listing is a variation of the DELTA
listing; the matching lines before and after help you recognize changed
areas of the source data sets.
- Long
- Lists all the
new data set source lines, plus old data set deleted lines. Both inserted
and deleted lines are flagged.
- Nolist
- Produces no
listing output. In foreground mode, a message is returned to show
the outcome of the comparison.
- Listing Dsn
- The
name of the list data set to which SuperC writes the results of the
comparison. However, if you enter NOLIST in the Listing Type field,
SuperC does not create an output listing, so this name is ignored.
If you leave this field blank, SuperC allocates a list data set,
using default data set attributes and this data set name: prefix.userid.SUPERC.LIST
where prefix is
your TSO prefix and userid is your user ID.
If your prefix and user ID are identical, only your prefix is used.
Also, if you do not have a prefix, only your user ID is used.
Note: If
the ISPF configuration table field USE_ADDITIONAL_QUAL_FOR_PDF_DATA_SETS
is set to YES, an additional qualifier defined with the ISPF_TEMPORARY_DATA_SET_QUALIFIER
keyword is included before the SUPERC qualifier.
If you
enter a fully qualified data set name SuperC uses it as specified.
Otherwise, SuperC only appends your TSO prefix to the front of the
data set name specified. If you run with TSO PROFILE NOPREFIX, SuperC
uses the name as you entered it, which can result in an attempt to
catalog the name in the master catalog.
If you enter the name
of a data set that already exists, the contents of that data set are
replaced by the new output listing. However, if the data set is sequential,
you can add this listing to the data set instead of replacing it by
using the APNDLST process option.
If you enter the name of
a data set that does not exist, SuperC allocates it for you. The data
set is allocated as a sequential data set unless you enter a member
name after it, in which case it is allocated as a member of a partitioned
data set.
- Process Options
- Keywords
that tell SuperC how to process the compare operation. You can type
these keywords in the Process Options fields or select them from a
panel. See the Process Options selection in Process options - select process options for a table of keywords.
- Statements Dsn
- The
name of the data set that contains your process statements. All statements
data sets must be fixed block with 80-byte records (FB 80). See the
Edit Statements selection in Process options - select process options for
more information.
- Update Dsn
- Tells
SuperC the name of the data set that will contain column-oriented
results of the comparison. This data set is normally used as input
to post processing programs and can be specified besides the normal
listing data set.
If you leave this field blank and use an update
(UPD xxxx) option, SuperC uses this default
name: prefix.userid.SUPERC.UPDATE
where prefix is
your TSO prefix and userid is your user ID.
If your prefix and user ID are identical, only your prefix is used.
Also, if you do not have a prefix, only your user ID is used.
Note: If
the ISPF configuration table field USE_ADDITIONAL_QUAL_FOR_PDF_DATA_SETS
is set to YES, an additional qualifier defined with the ISPF_TEMPORARY_DATA_SET_QUALIFIER
field is included before the SUPERC qualifier.
If you enter
a fully qualified data set name SuperC uses it as specified. Otherwise,
SuperC only appends your TSO prefix to the front of the data set name
specified. If you run with TSO PROFILE NOPREFIX, SuperC uses the name
as you entered it, which can result in an attempt to catalog the name
in the master catalog.
If you enter the name of a data set
that already exists, the contents of that data set are replaced by
the new update output. However, if the data set is sequential, you
can add this listing to the data set instead of replacing it by using
the APNDUPD process option.
If you enter the name of a data
set that does not exist, SuperC allocates it for you. The data set
is allocated as a sequential data set unless you enter a member name
after it, in which case it is allocated as a partitioned data set.
Note: For the UPDMVS8, UPDCMS8, UPDSEQ0, and UPDPDEL process options,
the update data set contains valid data, but only after a successful
compare when differences are detected. The data set is always empty
after a comparison that shows the data sets or members being compared
have no differences.
- Display Output
- Tells
ISPF whether you want to display the output listing in Browse mode.
Enter one of these:
Note: The NOLIST listing type overrides Yes,
No, and Cond.
- Yes
- Call
Browse to display the listing data set after processing the comparison.
This is the default.
- No
- Do
not call Browse to display the SuperC listing data set.
- Cond
- Do not
call Browse unless SuperC finds differences between the data sets.
- UPD
- Browse
the update data set instead of the list data set. This parameter is
not valid unless you create an update data set by using one or more
of the SuperC process options that begin with UPD (UPDxxxx).
- Bypass Selection List
- When a member pattern is entered in the PDS Member List field,
selecting this field causes SuperC to process all members matching
that pattern without displaying a member selection list. Leaving this
field blank causes the member list to be displayed.
- Output Mode
- The output mode for displaying the listing file. Choose one of
these:
- 1
- View. This enables
the listing file to be displayed in view mode. All View functions
are enabled in this mode.
- 2
- Browse. This enables
the listing file to be displayed in the browse mode. All Browse
functions are enabled in this mode.
- 3
- Eview. This option
only appears on non-English panels. It operates exactly the same as
View except that SuperC is invoked with an English language constants
module. All titles and headings are in English. This facilitates use
of hiliting of SuperC listings on non-DBCS terminals.
|