VMS Help SCA, INSPECT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    [SCA Command] Inspects the consistency between declarations or
    references for the same symbol.

    Format

      INSPECT   query-expression

1 - Qualifiers

 1.1 - /CHARACTERISTICS

       /CHARACTERISTICS=(option[ . . . ])
       /CHARACTERISTICS=ALL (D)

    Indicates which characteristics of the occurrences should be
    checked. You can use one or more of the following options to
    request specific information:

    IMPLICIT_           Checks that all symbols are explicitly
    DECLARATIONS        declared.

    TYPE                Checks that the types of all occurrences of
                        each symbol match.

    UNIQUENESS          Checks that multiple declarations of the same
                        symbol have the same name.

    UNUSED_SYMBOLS      Checks that all symbols are used.

    USAGE               Looks for symbols that are read but never
                        written, or written but never read.

    ALL                 Checks all of the preceding characteristics.

    Any of these options (except ALL) can have the prefix NO to
    indicate that the characteristic should not be checked.

    Each of the characteristic options takes a query-expression as
    an optional value. The characteristic-specific query expression
    specifies the set of occurrences for which that characteristic
    will be checked. If the prefix NO is present, then the query
    expression indicates occurrences for which that characteristic
    will not be checked. The default query expression for each
    characteristic option is to check all occurrences.

 1.2 - /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.3 - /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

    FILE_NAME       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

    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 information be excluded.

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

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

 1.4 - /ERROR_LIMIT

       /ERROR_LIMIT=(global-limit[,symbol-limit])
       /NOERROR_LIMIT (D)

    Specifies the maximum number of errors that the INSPECT command
    should report. This causes the INSPECT command to stop if the
    number of errors exceeds the maximum.

    The global-limit parameter specifies the maximum number of errors
    reported for all symbols before the INSPECT command stops.

    The symbol-limit parameter specifies the maximum number of errors
    reported for a particular symbol before the INSPECT command stops
    reporting errors for that symbol.

 1.5 - /LOG

       /LOG (D)
       /NOLOG

    Indicates whether the count of symbol occurrences will be
    reported.

 1.6 - /MODIFY

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

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

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

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

 1.7 - /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.

 1.8 - /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.9 - /REPLACE

       /REPLACE
       /NOREPLACE (D)

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

 1.10 - /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 an INSPECT command, then
    specifying /NORESULT causes that result to be deleted.

 1.11 - /SEVERITY_LEVEL

       /SEVERITY_LEVEL=severity-level
       /SEVERITY=INFORMATIONAL (D)

    Indicates the lowest severity level for diagnostics to be
    reported, as follows:

       INFORMATIONAL
       WARNING
       ERROR
       FATAL_ERROR

 1.12 - /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 occurences to be inspected.