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

 Format

     INSPECT   query-expression

Additional information available:

QualifiersParameter

=TITLE Qualifiers

Additional information available:

/CHARACTERISTICS/DESCRIPTION/DISPLAY/ERROR_LIMIT
/LOG/MODIFY/NAME/OUTPUT/REPLACE/RESULT/SEVERITY_LEVEL
/SYNCHRONIZE

    /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
 DECLARATIONS        explicitly 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.

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

    /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
 TYPE            declaration, 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)

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

    /LOG (D)
    /NOLOG

 Indicates whether the count of symbol occurrences will
 be reported.

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

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

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

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

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

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

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

    INFORMATIONAL
    WARNING
    ERROR
    FATAL_ERROR

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

=TITLE Parameter

query-expression
 Specifies the set of occurences to be inspected.