SuperC Compare Utility panel fields

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)

   Menu  RefList  Utilities  Help
 ───────────────────────────────────────────────────────────────────────────────
                     SuperC Compare Utility - Old Data Set

 Specify "Old" Data Set to be compared, then press the ENTER key to compare to
 "New" Data set . . : MYPROJ.DEV.SOURCE
                                                                    More:     +
    Project . . . MYPROJ  
    Group . . . . TEST     . . .          . . .          . . .         
    Type  . . . . SOURCE  
    Member  . . .         

 "Old" other Partitioned, Sequential or VSAM Data Set:
    Data Set Name . . .                                                        
    Volume Serial . . .            (If not cataloged)

 Listing DS Name  . . . SUPERC.LIST                                            
 Data Set Password  . .            (If Old data set password protected)

 Listing Type . . . . 1  1. Delta   2. CHNG    3. Long    4. OVSUM   5. Nolist

 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F10=Actions  F12=Cancel

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.

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.

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.