1 INSPECT [SCA Command] Inspects the consistency between declarations or references for the same symbol. Format INSPECT query-expression 2 Qualifiers /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. /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. /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) /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. /LOG /LOG (D) /NOLOG Indicates whether the count of symbol occurrences will be reported. /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. /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. /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. /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. /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. /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 /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.