Types of options (additional)

You can specify any of the following options in the CMS command line or in the Options List file):

Member Names

This option specifies the names of the members within a library.


>>-NMEM--(--new_member_name--)--OMEM--(--old_member_name--)----><

For example:

ASMFSUPC MACLIB NEW A MACLIB OLD A (NMEM(ABC) OMEM(DEF)

compares the member ABC in MACLIB NEW A with the member DEF in MACLIB OLD A.

Note: Member names can only be used as options when the new_file_ID and old_file_ID specified refer to either macro or text libraries.

Compare Type

This option specifies the type of comparison to be performed.

Can be one of the following keywords:

FILE: File comparison
LINE: Line comparison
WORD: Word comparison
BYTE: Byte comparison

For further descriptions of each compare type, see topic Compare type.

Listing Type

This option specifies the type of listing output required.

Can be one of the following keywords:

OVSUM: Overall summary
DELTA: Differences only
CHNG: Lines before/after differences
LONG: Entire file
NOLIST: No listing output

For further descriptions of each listing type, see topic Listing type.

Listing File

This option specifies the alternative name to be assigned to the listing file generated as a result of the comparison process.


>>-LISTING--(--listing_file_ID--)------------------------------><

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (LISTING(TSTLIST RESULTS A)

creates a listing file named TSTLIST RESULTS A.

Notes:

If you do not use the LISTING option, the listing file is generated with a default ID consisting of:
fn

File name of the new file

ft

SUPERC

fm

A
A listing file is always generated unless the NOLIST listing type is specified.

Display Output

This option specifies if the results of the comparison are to be displayed.


         .-(NO)---.   
>>-DSPL--+--------+--------------------------------------------><
         +-(YES)--+   
         +-(COND)-+   
         '-(UPD)--'

NO: Do not display output
YES: Display output
COND: Display output if differences found
UPD: Display differences if update option used

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (DSPL(YES)

causes the comparison results to be displayed.

Note: If you specify an editor or browse program (see following option), the "Display Output" option defaults to YES.

For a further description of the Display Output option, see Display output.

Auto Display Program

This option is used with the Display Output option. It allows you to use the editor or browse program of your choice (if it is supported in your processing environment). The default is XEDIT.

Examples:

ASMFSUPC TEST1 NEW A TEST1 OLD A (EPDF

ASMFSUPC TEST1 NEW A TEST1 OLD A (XEDIT

ASMFSUPC TEST1 NEW A TEST1 OLD A (BROWSE

These examples specify editors EPDF and XEDIT, and browse program BROWSE.

For a further description of the Auto Display Program, see Auto display pgm.

Update File ID

This option specifies the alternative name to be assigned to the update file generated (if applicable) as a result of the comparison process.


>>-UPD--(--update_file_ID--)-----------------------------------><

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (UPD(TSTUPD DETAILS A)

creates an update file named TSTUPD DETAILS A.

Notes:

An update file is only generated if one of the "UPD…" process options was specified. For further details, see Process options.
If you do not use the UPD option, the update file is generated with a default ID consisting of:
fn

File name of the new file

ft

UPDATE

fm

A

Process Options

This option specifies the process options to be used in the comparison process.

These can be one or more of the process option keywords which are valid for the compare type used. For details of these, see Process options.

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (ANYC

specifies the process option ANYC with the result that the case of characters in the two input files is ignored when performing the comparison process.

Option Directives

You can use any of the following option directive keywords:

ERASRC0: Erase listing file if no differences
MENU: Display Primary Comparison Menu
NOIMSG: No information messages
NONAMES: No SUPERC NAMES * file
NOOLF: No Options List file
PRINT: Print results

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (NOOLF

specifies that any options contained in the Options List file are not to be used in the comparison process.

For further descriptions of each Option Directive, see CMS command line option directives.

Process Statement Directives

The following directives are transformed into process statements. They can be one of the following keywords:

CC: Compare columns
LC: List columns
LT: Line count
RR: Revision code reference

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (LC(7:14)

selects columns 7 to 14 to be listed in the output.

For further descriptions of each Process Statement Directive, see CMS command line statement option directives.

Process Statement ID

This option specifies how process statements are to be supplied to the SuperC Comparison.

One of two keywords can be used:

CNTL

Use the CNTL keyword if you want to use an existing file that contains the process statements you require.


>>-CNTL--(--process_statement_file_ID--)-----------------------><

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (CNTL(TSTPRO OPTS A)

specifies that the process statements in file TSTPRO OPTS A are to be used.

PROMPT

PROMPT indicates to SuperC that the file SUPERC SYSIN A is to be used to supply the process statements and causes the Process Statements Entry Menu to be displayed. This menu contains examples of the more widely used process statements. It also has a field that allows you to input one process statement at a time into the SUPERC SYSIN A file.

For example:

ASMFSUPC TEST1 NEW A TEST1 OLD A (PROMPT

causes the Process Statements Entry Menu to be displayed.

Note: If SUPERC SYSIN A already exists, its contents are erased before creating the new file.

Options List File

You can use the Options List file to hold a set of default options (to save you entering them each time on the CMS command line). Any of the options described in this section can be placed in the Option List file. They take effect unless overridden by options in the command line.

If you do not specify a name for the Options List file, SuperC looks for a file with the default name SUPERC OLIST A and, if found, uses the options contained in that file for the comparison process.

However, you can nominate an alternative Options List file by using the keyword OLF. OLF allows you to specify either a fully qualified file ID (fn ft fm) or a partially qualified file ID for the Options List file that you want SuperC to use (see “Default Naming Convention for Options List File”).

Note: SuperC uses options contained in an OLF-specified Options List file before those in SUPERC OLIST A (see Command line priority and overriding).


>>-OLF--(--options_list_file_ID--)-----------------------------><

For example:

ASMFSUPC TEST1 NEW A (SRCH('ABC') OLF(MYOPTS FILE A)

specifies that the options in file MYOPTS FILE A are to be used.

Note: Not all options in the Options List file can be overridden since there is no way to negate them. Take care when considering which options to include in the file when using OLF.

To examine this further, let's look at an example of an Options List file containing the following:

DELTA XEDIT CNTL(MYFILE STMTS A)

If the Options List file that you nominate in the CMS command line (by using the OLF keyword) contains the above options, you can:

Override the DELTA option by specifying any of the other listing types (for example, NOLIST) in the command line.
Nullify the XEDIT Auto Display Program by including the Display Output option DSPL(NO) in the command line.

but you cannot override the Process Statements ID keyword CNTL (and therefore the process statements contained in the file MYFILE STMTS A take effect).

Default Naming Convention for Options List File: The command line uses the following defaults in the naming of the Options List file:

Command Line	OLF ID Used
`ASMFSUPC…(…`	SUPERC OLIST A
`ASMFSUPC…(NOOLF…`	(none)
`ASMFSUPC…(OLF(TST1)…`	TST1 OLIST A
`ASMFSUPC…(OLF(TST1 OPTS)…`	TST1 OPTS A
`ASMFSUPC…(OLF(TST1 OPTS A)…`	TST1 OPTS A