z/OS JCL example

Edit online

Figure 1 shows simplified z/OS® JCL to run the SuperC Comparison. This example is supplied with SuperC in the sample PDS (default is ASM.JMQ415A.SASMSAM2) as member ASMFMVC1.

Before running this example, edit the lines highlighted by numbers (such as 1 ) as described in the instructions following the example listing.

Figure 1. Sample z/OS JCL to run the SuperC comparison

⋮
/*
/* Run the comparison with these options (see  1  and  6 )
/*
//RUN      EXEC PGM=ASMFSUPC,REGION=4M,PARM='options'                      1 
/*
//STEPLIB   DD   DSN=#hlq.SASMMOD2,DISP=SHR                                2 
/*                                                                     ─┐
/* Define "new" data set to be compared                                 │
/*                                                                      │
//NEWDD    DD   DSN=new_file,DISP=SHR                                   ├─ 3 
/*                                                                      │
/* Define "old" data set to be compared                                 │
/*                                                                      │
//OLDDD    DD   DSN=old_file,DISP=SHR                                  ─┘
/*
/* Direct listing data set to SYSOUT
/*
//OUTDD    DD   SYSOUT=*                                                   4 
/*
/* Define update ("delta") data set
/*
//DELDD    DD   DSN=update_file                                            5 
//SYSIN    DD   *
process_statements                                                         6 
⋮
/*
//

1

Replace PARM='options' with a PARM parameter in the following format:

Format of ASMFSUPC PARM parameter for SuperC comparison

Note: Each option may be separated by either a space or a comma.

compare_type: The type of comparison you want performed: FILE, LINE, WORD, or BYTE. When specifying the compare type in the PARM parameter, add the suffix CMP (for example, WORD becomes WORDCMP).
For a description of each compare type, see Compare type.
listing_type: The type of listing you want from the comparison: OVSUM, DELTA, CHNG, LONG, or NOLIST. When specifying the listing type in the PARM parameter, add the suffix L (for example, CHNG becomes CHNGL).
For a description of each listing type, see Listing type.
process_options: Process options are keywords that direct SuperC how to perform the comparison or format the listing. Process options can be separated by spaces or commas.
For a description of each process option, see Process options.

For example:

PARM='LINECMP DPCBCMT DELTAL NOSUMS'

instructs SuperC to:

Perform a line-by-line comparison. (LINE compare type with CMP suffix.)
Ignore COBOL comment lines. (Process option DPCBCMT ignores lines with an * in column 7.)
Produce a listing showing changes, without an overall summary section. (Process option NOSUMS eliminates the group and final summary listing from the output listing.)

2

Replace #hlq with the high level qualifier where SuperC is installed (default load library is ASM.JMQ415A.SASMMOD2).

3

Replace new_file and old_file with the items to be compared. These can be:

Two sequential data sets
Two complete partitioned data sets
Two VSAM data sets
Members of two partitioned data sets
Concatenated data sets
A VSAM data set with a sequential data set

Note: The terms new and old are used only for the sake of identifying the files being compared, which might or might not be different versions of the same file.

If you specify partitioned data set (PDS) names for new_file and old_file, SuperC compares all members in the new PDS with any like-named members in the old PDS. Members in either PDS not having like-named members in the other data set are not compared, but are reported in the listing data set.

To restrict a comparison of partitioned data sets to selected members only, use the SELECT process statement. For example, the following process statement:

SELECT NEW1:OLD1,SAME

instructs SuperC to compare only:

Member NEW1 in the new PDS with member OLD1 in the old PDS
Member SAME in the new PDS with member SAME in the old PDS

For more information about the SELECT process statement, see Select PDS members (z/OS).

4

The listing data set, listing the results of the comparison. For example listings, see Understanding the listings.

5

(Required only if you specify a UPD… process option; see 1 .)

The update (or delta) data set. Most update data sets are intended to be used as input to other tools, rather than being human-readable reports (such as the listing data set; see 4 ). For instance, if you specify the UPDMVS8 process option, SuperC creates an update data set that you can use with the IEBUPDTE utility. You can use IEBUPDTE to apply to the old data set any updates that SuperC found in the new data set.

The file attributes of the update data set depend on the UPD… process option you specified.

For more information about producing an update data set, see the process options whose keywords start with UPD on Table 1. For a selection of sample update data sets, see Update files.

6

Insert any process statements (one statement per line) that you want to use.

For example, the following process statements:

CMPCOLM 7:72
LSTCOLM 1:72

instruct SuperC to compare only columns 7 to 72 in the new and old data sets (for example, if you want to compare COBOL source without comparing sequence numbers), but to include in the listing data set columns 1 to 72 (that is, the listing contains the sequence numbers).

For more information about process statements, see Process statements.