SCA$HELP.HLB  —  FIND
    [SCA Command] Locates occurrences described by the current SCA
    libraries.

    For information on the SCA query language, see SCA_Topics in online
    help.

    Format

      FIND  query-expression

1  –  Qualifiers

1.1    /DESCRIPTION

       /DESCRIPTION=string

    Specifies a single line of text that is displayed along with the
    query name when the query is displayed by issuing the SHOW QUERY
    command.

1.2    /DISPLAY

       /DISPLAY[=(option, . . . )]
       /DISPLAY=DEFAULT (D)
       /NODISPLAY

    Indicates how much information SCA displays concerning query
    results. Use one or more of the following keywords to request
    specific information:

    NAME            Symbol name

    CLASS           Class of item

    LINE_NUMBER     Compilation line number

    MODULE          Module name containing a symbol occurrence

    FILE_SPEC       File name and type containing a symbol occurrence

    FULL_FILE_SPEC  Complete file specification containing a symbol
                    occurrence

    RECORD_NUMBER   Record number within a source file

    RELATIONSHIP    Relationship type

    NUMBER          Number of the display line

    OCCURRENCE_     Type of symbol occurrence (such as declaration,
    TYPE            read, call)

    ALL             All of the previous options

    DEFAULT         Default settings of the display options

    NONE            Nothing (equivalent to the /NODISPLAY qualifier)

    You can prefix any keyword (except ALL, DEFAULT, and NONE) with NO
    to request that the information be excluded.

    The initial default for each type of new query is as follows:

    DISPLAY=(NAME,CLASS,MODULE,LINE,OCCURRENCE,RELATIONSHIP)

1.3    /LOG

       /LOG (D)
       /NOLOG

    Indicates whether the count of symbol occurrences will be
    reported.

1.4    /MODIFY

       /MODIFY[=query-name]
       /NOMODIFY (D)

    Indicates that an existing query is to be modified. By default,
    each FIND command creates a new query.

    The /MODIFY=query-name qualifier indicates that the specified
    query should be modified according to the specification of the
    FIND command. The specified query must already exist.

    By default, the /MODIFY qualifier specifies the current query.

1.5    /NAME

       /NAME[=query-name]

    Specifies the name of the query. If a query with the same name
    already exists, you must also specify the /REPLACE qualifier. If a
    query-name is not specified, then SCA assigns a unique name to the
    query. The query name can be a quoted string.

1.6    /OUTPUT

       /OUTPUT[=file-spec]

    Specifies that command output is to go to a file rather than be
    displayed on your screen (or go to a batch log file). The default
    output file specification is SCA.LIS.

1.7    /REPLACE

       /REPLACE
       /NOREPLACE (D)

    Indicates whether existing queries should be replaced by new
    queries. By default, a FIND command that creates a query with
    the same name as an already existing query will fail.

1.8    /RESULT

       /RESULT=option
       /RESULT=DEFAULT (D)
       /NORESULT

    Indicates the type of query results displayed. You must specify
    one of the following keywords:

    SYMBOLS       Only symbols are displayed.

    OCCURRENCES   Symbols and occurrences are displayed.

    DEFAULT       Either symbols or occurrences, or both are
                  displayed. SCA chooses the result type that is most
                  appropriate for the current query.

    The /NORESULT qualifier specifies that no results should be
    displayed. This means that no query evaluation is done. If a query
    result exists because you issued a FIND command, then specifying
    /NORESULT causes that result to be deleted.

1.9    /SYNCHRONIZE

       /SYNCHRONIZE
       /NOSYNCHRONIZE (D)

    Indicates that the query result must be synchronized with the
    current state of the virtual library being queried. By default,
    /NOSYNCHRONIZE causes SCA to do as little processing as necessary
    to evaluate the query. This can lead to query results that reflect
    the state of the virtual library at the time of a previous query.

    The /SYNCHRONIZE qualifier specifies that the query result must
    be synchronized with the current virtual library. SCA attempts
    to minimize the amount of processing, but the result is still
    synchronized with the virtual library that was in effect at the
    time the query was evaluated.

2  –  Parameter

 query-expression
    Specifies the set of occurrences to be found.
Close Help