Copyright Digital Equipment Corp. All rights reserved.
Qualifiers
/FIXUP_SECTION
/FIXUP_SECTION (VAX and Alpha only)
Positional qualifier.
Specifies that the analysis should include all information in the
fixup section of the image.
If you specify the /FIXUP_SECTION qualifier after the
ANALYZE/IMAGE command, the fixup section of each image file in
the parameter list is analyzed.
If you specify the /FIXUP_SECTION qualifier after a file
specification, only the information in the fixup section of that
image file is analyzed.
/FLAGVALUES
/FLAGVALUES (I64 only)
Several fields in an ELF module represent bit flags. Where
possible, these bit-flag values are examined and displayed
individually. By default, only the flag values that are set to
1 (ON) are displayed.
The keywords are as follows:
Keyword Description
ON The keyword ON displays all flags whose value is 1.
OFF The keyword OFF displays all flags whose value is 0.
ALL The keyword ALL displays all flag values. The keywords
ON and OFF, in contrast, indicate the value of each
specific flag bit.
/GST
/GST (VAX and Alpha only)
Positional qualifier.
Specifies that the analysis should include all global symbol
table records. This qualifier is valid only for shareable images.
If you specify the /GST qualifier after the ANALYZE/IMAGE
command, the global symbol table records of each image file in
the parameter list are analyzed.
If you specify the /GST qualifier after a file specification,
only the global symbol table records of that file are analyzed.
/HEADER
/HEADER (VAX and Alpha only)
Positional qualifier.
Specifies that the analysis should include all header items and
image section descriptions. The image header items are always
analyzed.
/INTERACTIVE
/INTERACTIVE
/NOINTERACTIVE (default)
Specifies whether the analysis is interactive. In interactive
mode, as each item is analyzed, the results are displayed on the
screen and you are asked whether you want to continue.
/MODULE
/MODULE [=(module_name[,...]) ] (I64 only)
Selectively formats debug or traceback information for the named
module or list of modules. You must request debug or traceback
information by using the /SECTIONS qualifier with keywords ALL,
DEBUG or TRACE. If debug or traceback information is selectively
formatted, then the module name is a subselection.
If you do not specify a module name, only debug or traceback meta
information about the available modules is printed. In this case,
any other debug or traceback selection is deactivated.
NOTE
This qualifier is only valid for ANALYZE/IMAGE. Although
ANALYZE/OBJECT can be used to format I64 images, Analyze
rejects the /MODULE qualifier.
/OUTPUT
/OUTPUT=filespec
Identifies the output file for storing the results of the image
analysis. The asterisk (*) and the percent sign (%) wildcard
characters are not allowed in the file specification. If you
specify a file type and omit the file name, the default file
name ANALYZE is used. The default file type is .ANL. If you omit
the qualifier, the results are output to the current SYS$OUTPUT
device.
/PAGE_BREAK
/PAGE_BREAK=keyword (I64 only)
Specifies if and where page breaks (form feeds) are inserted in
the report file. This qualifier is only useful if /OUTPUT is used
to write a report file. It is ignored if /INTERACTIVE is used to
specify an interactive analysis.
Keywords include NONE, which sets no page breaks; PRINTABLE_
REPORT, which creates page breaks as in listing files, and
SEPARATE_INFORMATION, which sets page breaks between section
information.
/PATCH_TEXT
/PATCH_TEXT (VAX only)
Positional qualifier.
Specifies that the analysis include all patch text records. If
you specify the /PATCH_TEXT qualifier after the ANALYZE/IMAGE
command, the patch text records of each image file in the
parameter list are analyzed.
If you specify the /PATCH_TEXT qualifier after a file
specification, only the patch text records of that file are
analyzed.
/SECTIONS
/SECTIONS [=(keyword[,...])] (I64 only)
Selects individual program sections or section types to display.
NOTE
This qualifier and its keywords can only be used to form an
inclusion list of sections to be displayed. This qualifier
is not negatable and cannot be used to form an exclusion
list. If no values are specified, the default keyword is
HEADERS.
The keywords are as follows:
Keyword Description
ALL Displays a detailed analysis of every section
in the module. Note that this keyword can
generate a large amount of output.
CODE Displays all of all sections of type SHT_
PROGBITS where the executable flag is set
(SHDR$M_SHF_EXECINSTR in the section header).
The section data will be displayed as machine
instructions.
DEBUG Analyzes and displays sections consisting
[=(suffix[,...])] of DWARF formatted debug information. In
addition, you can use a list of debug section
name suffixes to selectively format DEBUG
information.
EXTENSIONS Analyzes and displays sections of type SHT_
IA64_EXT. The data is displayed in hexadecimal
format.
GROUP Analyzes and displays sections of type SHT_
GROUP. Sections of this type consist of a list
of the section numbers of sections belonging
to that group.
HEADERS The default keyword. Displays the ELF header
and the section header details.
LINKAGES Analyzes and displays sections of type SHT_
VMS_LINKAGES.The data is displayed as a list
of linkage descriptors.
NOBITS Analyzes and displays sections of type SHT_
NOBITS. There is no module data associated
with sections of this type.
NOTE Analyzes and displays sections of type SHT_
NOTE. The data for this section is displayed
as a list of formatted OpenVMS note entries.
NULL Displays all sections of type PT_NULL. No a
data will be displayed for segments of this
type.
NUMBERS= Displays individual sections, as follows:
(number [,...])
o The selected sections will have a detailed
display of their header and their contents.
An informational message is displayed for
section numbers that do not exist in the
module.
o One or more numeric values may be
specified.
o Section numbers may be specified in
decimal, octal (using the %O prefix), or
hexadecimal (using the %X prefix).
STRTAB Analyzes and displays sections of type SHT_
STRTAB. The data for this section is displayed
as a string table.
SYMTAB Displays sections of type SHT_SYMTAB. The
data for this section is displayed as a symbol
table.
SYMBOL_VECTOR Sections of this type will only appear in
sharable image files. If present, they point
to the same data as the dynamic segment DT_
VMS_SYMVEC tags.
TRACE Analyzes and displays sections consisting of
[=(suffix[,...])] traceback information. In addition, you can
use a list of trace section name suffixes to
selectively format TRACE information.
UNWIND Analyzes and displays sections of type SHT_
IA64_UNWIND. Each section of this type has an
associated Unwind Information section of type
SHT_PROGBITS. This associated section is also
displayed.
/SEGMENTS
/SEGMENTS [=(keyword[,...])] (I64 only)
Selects individual program segments or program segments of a
specified type to be displayed.
NOTE
This qualifier and its keywords can only be used to form an
inclusion list of segments to be displayed. This qualifier
is not negatable and cannot be used to form an exclusion
list. If no values are specified, the default keyword is
HEADERS.
The keywords are as follows:
Keyword Description
ALL Analyzes and displays information for every program
segment. Note that this can generate a large amount of
output.
CODE Analyzes and displays all executable segments
(PHDR$M_PF_X bit set in the segment header). Segment
data is displayed as machine instructions.
DYNAMIC Analyzes and displays the segment of type PT_DYNAMIC.
EXTENSIONS Analyzes and displays segments of type IA_64_ARCHEXT.
HEADERS The default keyword. Analyzes and displays the ELF
header and segment header details.
LOAD Analyzes and displays segments of type PT_LOAD. If the
segment header indicates this is an executable segment
(PHDR$M_PF_X bit set in the segment header), the
contents will be formatted as machine instructions,
otherwise the contents are formatted as hexadecimal
data.
NULL Analyzes and displays segments of type PT_NULL. No a
data will be displayed for segments of this type.
NUMBERS= Analyzes and displays individual segments, as follows:
(number
[,...]) o The selected segments have a detailed display of
header and content information. For section numbers
that do not exist in the module, an informational
message is displayed.
o One or more numeric values may be specified.
o Segment numbers may be specified in decimal, octal
(using the %O prefix), or hexadecimal (using the %X
prefix).
/SELECT
/SELECT=(keyword[,...])
Allows for the collection of specific image file information and
displays the selected keyword items in the order specified.
Analyze creates DCL symbols for all selectable information with
the /SELECT qualifier. The symbol names consist of the prefix
ANALYZE$ and a descriptive name of the information they hold.
The symbol value is the selected information, usually printed
to SYS$OUTPUT. Effectively, all of the printed information
is duplicated in the symbols. For unselected information, the
corresponding symbols will contain the null string.
The keywords are as follows:
Keyword Description
ARCHITECTURE Writes the architecture information into the DCL
symbol ANALYZE$ARCHITECTURE. Returns "OpenVMS
IA64" if the file is an OpenVMS I64 image file.
Returns "OpenVMS Alpha" if the file is an OpenVMS
Alpha image file. Returns "OpenVMS VAX" if the
file is an OpenVMS VAX image file.
BUILD_ Writes build identification information into
IDENTIFICATION the DCL symbol ANALYZE$BUILD_IDENTIFICATION.
For OpenVMS I64 and Alpha image files, returns
the image build identification stored in the
image file, enclosed in quotation marks. For
OpenVMS VAX image files, the null string that
is represented by adjacent quotation marks is
returned.
FILE_TYPE Writes file type information into the DCL symbol
ANALYZE$FILE_TYPE. Returns "Image" if the file is
an OpenVMS I64, Alpha, or VAX image file.
IDENTIFICATION The possible keywords are as follows:
[=keyword]
o IMAGE (default) - Writes the image
identification information into the DCL symbol
ANALYZE$IDENTIFICATION. Returns the image
identification that is stored in the image
file, enclosed in quotation marks. Otherwise,
returns "Unknown".
o LINKER - Writes the linker identification
information into the DCL symbol
ANALYZE$LINKER_IDENTIFICATION. Returns the
identification of the linker used to link the
image.
IMAGE_TYPE Writes image type information into the DCL
symbol ANALYZE$IMAGE_TYPE. Returns "Shareable"
if the file is a shareable image file.
Returns "Executable" if the file is either an
OpenVMS I64, Alpha, or OpenVMS VAX executable
(nonshareable) image file.
LINK_TIME Writes link time information into the DCL symbol
ANALYZE$LINK_TIME. For image files, returns the
image link time that is stored in the image file,
enclosed in quotation marks.
NAME Writes link time information into the DCL symbol
ANALYZE$NAME. For image files, returns the image
name that is stored in the image file, enclosed
in quotation marks.
VERSION_ Writes the system and component version numbers
NUMBERS into DCL symbols. The DCL symbol names and
(Alpha and values are similar to the printed output of
I64 only) ANALYZE/IMAGE; that is, there is a symbol for
each component. The symbol names consist of the
prefix "ANALYZE$SYS$K_" and the component name
consists of "BASE_IMAGE", "MEMORY_MANAGEMENT",
and so forth. If the analyzed image depends on a
component, the component's version number saved
in the image is also in the corresponding DCL
symbol. The other DCL symbols contain an empty
string. The symbol value, the version, consists
of a major and minor version number, separated by
a dot and enclosed in parantheses.
In addition, if the image runs on the same
platform as Analyze, then the component's version
of the running system are stored in the DCL
symbols. Then, within the parentheses, the image
and system versions are separated by a slash.
In this case, both versions are compared. The
comparision is performed by an LEQUAL check for
major-/minor-IDs. If there is a mismatch, Analyze
prints an informational message. Note also that
the system version is saved in the DCL symbol of
the BASE_IMAGE component.
NOTE
The Analyze utility can work on several files. Because
there is only one set of DCL symbols, the symbols only
contain information from the last analyzed file. When an
error occurs, symbol values are undefined. Check for Analyze
errors first, then use the symbols.