|
All the fields on this panel are explained in the "ISPF Libraries and Data Sets" topic of the z/OS ISPF User's Guide Vol I,
except: - Profile DSN
- The
name of an optional data set that can contain a compare type, listing
type, sequence numbers setting, Browse setting, process options, and
process statements. All these elements, when combined in one data
set or member, are called a profile. See Profiles and defaults - activate profiles and defaults for
information about using the SuperCE utility (option 3.13) to create
a profile data set.
The listing type and sequence numbers setting
of the profile are copied onto the panel used to specify the old data
set name (Figure 1), but can be typed over
or blanked out. However, other elements of the profile are in effect,
even though they are not shown on the panel.
- Mixed Mode
- Select this field to have SuperC scan and parse the input data
set lines for DBCS text strings.
Note: Mixed Mode is not valid for
the File or Byte compare.
- Bypass Selection List
- When a member pattern is entered in the PDS Member List field
or the member name portion of the data set field (such as MY.DATA.SET(pattern)),
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.
- Execution Mode
- The
processing mode you want to use when comparing the data sets. Choose
one of these:
- 1
- Foreground.
After the old data set panel and member selection, if any, are completed,
foreground mode compares the new and old data sets and stores the
results in the data set specified in the Listing DS Name field,
which you can browse at the terminal.
- 2
- Batch. After the old data set
panel and the member list, if any, are completed, batch mode causes
the display of the SuperC Utility - Submit Batch Jobs panel, so you
can specify job card and print disposition information or edit the
JCL. Then, the batch job is submitted to compare the new and old data
sets. See Submitting a SuperC job in batch mode for more information.
Note: You cannot specify a data set password in batch mode. If your
data sets are password protected, use foreground mode.
- Output Mode
- The output mode you want to use when 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.
When you complete the New Data Set panel and press Enter, ISPF
displays the panel shown in Figure 1. Of
the five fields shown at the bottom of the panel (Volume Serial, Listing
DS Name, Data Set Password, Listing Type, and Sequence Numbers), all
except Listing Type may not appear, depending on the mode you choose
(foreground or batch) and the contents of the profile data set. Also,
if you request a member list or specify an asterisk (*) in the Member
field on the new data set panel, ISPF does not display a Member field
on the old data set panel. Note: In this context, an old data
set is a base version of a data set, such as a data set in a production
library.
Figure 1. SuperC Utility - Old Data
Set panel (ISRSSOLD)
Specify the name of an old data set. The type of old data set that
you can specify depends on the type of new data set you specified
on the previous panel. For example, you can compare:
- A complete new PDS to a complete old PDS
- A new sequential data set to:
- An old sequential data set
- An old membered PDS
- A new membered PDS to an old sequential data set.
In this context, the term membered PDS refers to a PDS for
which a single member has been specified, such as: 'USERID.TEST.SCRIPT(NEWDATA)'
SuperC treats a membered PDS as a sequential data set because the
comparison is done on a one-to-one basis. However, SuperC cannot compare
a sequential data set to a complete PDS because it cannot compare
one data set to more than one member of another data set.
When you press Enter, ISPF either displays a member selection list
or begins the comparison. All the fields on this panel are explained
in the "ISPF Libraries and Data Sets" topic of
the z/OS ISPF User's Guide Vol I,
except: - Update DS Name
- Tells SuperC the name of the data set that will
contain column-oriented results of the comparison.
Note: This field
is not displayed unless your profile data set contains an update (UPDxxxx)
process option.
This data set is normally used as input
to post processing programs and can be specified in addition to the
normal listing data set. See the Process Options selection in Process options - select process options for information about the SuperC
process options.
If you leave this field blank, 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.
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.
- Listing Type
- The type of listing you want
SuperC to create when it compares the data sets. This is a required
field, so you must choose one of the listing types shown here. See Understanding the listings for sample listings.
- DELTA
- Lists the differences
between the source data sets, followed by the overall 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.
- OVSUM
- Lists only the
overall summary of the comparison. However, a PDS comparison generates
an individual summary line for each PDS member.
- NOLIST
- Produces no
listing output. In foreground mode, only a message is returned to
show the outcome of the compare.
- Listing DS Name
- 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. Also, if you chose batch
mode, this field does not appear on the panel. The SuperC Utility
- Submit Batch Jobs panel is used instead.
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
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 output listing. However, if the data set is sequential, you
can add this listing to the data set instead of replacing it by including
the APNDLST process option in your profile data set.
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.
- Sequence Numbers
- A value that tells SuperC whether to exclude
sequence number fields from its comparison of your data sets. This
field is not displayed if the compare type is FILE or BYTE. You can
choose one of these:
- blank
- Exclude
Sequence Number fields from the comparison if the data set is F 80
or V 255 and the compare type is
Line
Otherwise,
treat as data.
- SEQ
- Exclude
Sequence Number fields from the comparison. Sequence numbers are assumed
in columns 73-80 in F 80 and in columns 1-8 in V 255 data sets.
- NOSEQ
- Treat
F 80/V 255 standard sequence number columns as data.
- COBOL
- Ignore
columns 1-6 in F 80 data sets. Data in columns 1-6 is assumed to be
sequence numbers.
|