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