How to directly invoke SuperC and search-for

You can run the SuperC and Search-For programs directly without using the ISPF-provided utilities (Options 3.12, 3.13, 3.14, or 3.15). This requires an installation (or system programmer) to customize a CLIST (for interactive usage) or a PROCLIB procedure (for batch execution of a catalog procedure). Although these methods are not warranted by the ISPF product, a sample CLIST and a sample PROCLIB procedure are distributed as an aid in the SAMPLIB data set as members ISRSCLST and ISRSPROC.

The sample CLIST allows a TSO user to enter a line command to communicate the operational parameters directly to the SuperC program without displaying the ISPF panels. The sample CLIST will request entry of a search pattern or string. A sample SuperC call as entered on the terminal might look like:

    superc newfile(.newdata.file) oldfile(ludlow.olddata.file)

    exec clist(superc) 'new(.newdata.file) old(ludlow.olddata.file)'

where superc is the command and newfile and oldfile are the keywords for the input files.

The SuperC load module may be supported using a private library or a concatenated system library. The installation is responsible for making the corresponding changes to the sample CLIST.

The sample CLIST uses this format:

SUPERC NEW(dsn) OLD(dsn) {keyword(parameter) .... }

Note: Avoid using uninitialized data sets (that is, empty sequential data data sets with no end-of-file marker) in the concatenation of data sets to be compared. Including these data sets in the search can lead to unpredictable results.

The keywords and parameters are:

CTYPE: Specifies the compare type. The parameter can be one of the SuperC compare types (File, Line, Word, or Byte). To call the Search-For program, use CTYPE(SRCH).
LISTING: Specifies the listing type. The parameter can be one of the SuperC listing types.
OUTDD: Specifies the name of the Listing Data Set. Use a fully qualified dsn or use a period (.) to precede the dsn with SYSPREF. The use of the period is a compromise because fully qualified names enclosed in quotes are difficult to pass in CLISTs.
BROWSE: Specifies the auto display program.
SYSIN: Specifies whether SuperC prompts the user for the process statements or uses a statements data set. The parameters can be PROMPT or the name of the statements data set.
DELDD: Specifies the name of the update data set.
PROCESS: Specifies the process options. The parameter can be a SuperC or Search-For process option. Not all options are allowed with each compare type (for example, GWCBL is valid only with Line and Word compare) or with other options (for example, you cannot use SEQ with COBOL). See Process options for more information.