Invoking the search on CMS using command line input

You can use the SuperC Search on CMS to search:

A file
Selected files within a file group
A file group
A member within a MACLIB or TXTLIB
Complete MACLIBs or TXTLIBs

This section describes how to invoke the SuperC Search directly from the command line, without using the Primary Search Menu. For information about using this menu, see Invoking the search on CMS using menu input.

To invoke the SuperC Search from the CMS command line, use the following format:


>>-ASMFSUPC--search_file_ID--(--SRCH---------------------------->

>--+-('--search_string--')-----------------------------------------+-->
   +-('--search_string--')--CNTL--(--process_statements_file_ID--)-+   
   +-('--search_string--')--PROMPT---------------------------------+   
   |                                     (1)                       |   
   +-CNTL--(--process_statements_file_ID------)--------------------+   
   |        (1)                                                    |   
   '-PROMPT--------------------------------------------------------'   

>--+--------------------------------+--+------------+----------><
   '-OLF--(--option_list_file_ID--)-'  | .--------. |   
                                       | V        | |   
                                       '---option-+-'

Notes:

When no search string is entered on the ASMFSUPC command line, it must be specified by a SRCHFOR process statement–either contained in a process statements file specified by the keyword CNTL, or entered via the Process Statements Entry Menu (displayed using the keyword PROMPT).

search_file_ID

The name of the file (or library) to be searched.

SRCH

If followed by a search string (within parentheses and apostrophes), specifies the string to be used in the search.

Note: When the search string is entered directly in the command line in this way, it is searched for in uppercase only. (If you want the string searched for regardless of case, use the ANYC process option.)

If not followed by a search string, one of the following must be used:

The keyword CNTL to specify the process statements file containing one or more SRCHFOR process statements, each specifying a search string.
The keyword PROMPT to display the Process Statements Entry Menu from which you can enter one or more SRCHFOR process statements (each specifying a search string). SuperC automatically enters these statements in the process statements file SRCHFOR SYSIN A.

Notes:

It is possible to specify a search string in the command line and one or more additional search_strings (using SRCHFOR process statements) in the process statements file:
- Whose ID follows the keyword CNTL, or
- SRCHFOR SYSIN A (using the keyword PROMPT to display the Process Statements Entry Menu).
The keywords CNTL and PROMPT cannot be used together. For further details, see “Process Statement ID”.

OLF

This is the keyword for the Options List File (when used). For further details, refer to “Options List File”.

option

Each type of option is described in detail following “Types of Options”.

Also, see CMS command line option directives and CMS command line statement option directives.