|
VMS Help ANALYZE, /IMAGE, Qualifiers, /SELECT *Conan The Librarian |
/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.
|
|