VMS Help  —  ANALYZE  /IMAGE  Description
    The ANALYZE/IMAGE command provides a description of the
    components of an executable image file or shareable image file on
    OpenVMS VAX and Alpha systems, and of an Executable and Linkable
    Format (ELF) image file or sharable image file on OpenVMS I64
    systems. It also verifies that the structure of the major parts
    of the image file is correct. However, the ANALYZE/IMAGE command
    cannot ensure that program execution is error free.

    On OpenVMS I64 systems, the ANALYZE/IMAGE command automatically
    distinguishes between I64, Alpha, and VAX images by examining the
    header information.

    If errors are found, the first error of the worst severity is
    returned. For example, if a warning (A) and two errors (B and
    C) are found, the first error (B) is returned as the image exit
    status. The image exit status is placed in the DCL symbol $STATUS
    at image exit.

                                  NOTES

       For I64 images and objects, the Analyze utility determines
       whether the file it analyzes is an image file or object
       file. Although Analyze allows you to specify ANALYZE/OJBECT
       on an ELF image file, use ANALYZE/IMAGE for ELF image files
       and ANALYZE/OJBECT for ELF object files.

       When parsing output from ANALYZE/IMAGE, be aware that the
       output for ELF images may change.

    When using ANALYZE without a qualifier, the default is /OBJECT.
    Therefore, when using this default to analyze an image in the
    output file, the utility correctly identifies itself as "Analyze
    Object File".

    The OpenVMS VAX and Alpha versions of ANALYZE/IMAGE do not have
    the capability of analyzing all non-platform images. For example,
    ANALYZE/IMAGE cannot analyze I64 images on VAX or Alpha images on
    older versions of VAX.

    When you analyze I64 images on I64 platforms, ANALYZE/IMAGE
    accepts VAX-only or Alpha-only qualifiers, but ignores any effect
    of these qualifiers.

    Depending on the platform, the ANALYZE/IMAGE command
    distinguishes I64 images from VAX and ALpha images by examining
    the meta information (e.g., ELF, EIHD, or IHD).

    The ANALYZE/IMAGE command provides the following information for
    image files:

    o  Image architecture and type - The OpenVMS platform and whether
       the image is executable or shareable.

    o  Image name - The name of the image or shareable image.

    o  Image identification - The identification given in a link
       operation.

    o  Creating linker identification - The linker that generated the
       image.

    o  Link date and time - The date and time of the link operation.

    o  Image transfer addresses - The addresses to which control is
       passed at image execution time.

    o  Image version - The revision level (major ID and minor ID) of
       the image.

    o  Location and size of the image's symbol vector (Alpha and I64
       only).

    o  List of required sharable images - The dependencies on
       sharable images.

    o  Location of the debugger symbol table (DST)-Identifies the
       location of the DST in the image file. DST information is
       present only in executable images that have been linked with
       the /DEBUG or the /TRACEBACK command qualifier. (VAX and Alpha
       only.)

    o  Location and interpretation of the debug and traceback
       information - The sections that contain the information and
       formats the data (DWARF) (I64 only).

    o  Location of the global symbol table (GST)- The location of
       the GST in the image file. GST information is present only in
       shareable image files. (VAX and Alpha only.)

    o  Location of the global symbol table (.symtab) - The location
       of the GST in the image file. GST informaton is present only
       in sharable image files (I64 only.)

    o  Patch information-Indicates whether the image has been patched
       (changed without having been recompiled or reassembled and
       relinked). If a patch is present, the actual patch code can be
       displayed. (VAX and Alpha only.)

    o  Image section descriptors (ISD)-Identify portions of the image
       binary contents that are grouped in OpenVMS Cluster systems
       according to their attributes. An ISD contains information
       that the image activator needs when it initializes the address
       space for an image. For example, an ISD tells whether the ISD
       is shareable, whether it is readable or writable, whether it
       is based or position independent, and how much memory should
       be allocated. (VAX only.)

    o  Summary of internal tables - Lists the program segments and
       sections of which the image consists. (I64 only.)

    o  Fixup vectors-Contain information that the image activator
       needs to ensure the position independence of shareable image
       references. (VAX and Alpha only.)

    o  Fixup information-Information that the image activator
       needs to ensure the position independence of sharable image
       references. (I64 only.)

    o  System version categories-For an image that is linked against
       the executive (the system shareable image on I64 and Alpha or
       the system symbol table on VAX), displays both the values of
       the system version categories for which the image was linked
       originally and the values for the system that is currently
       running. You can use these values to identify changes in the
       system since the image was linked last.

    The ANALYZE/IMAGE command has command qualifiers and positional
    qualifiers. For VAX and Alpha images, by default, if you do not
    specify any positional qualifiers (for example, /GST or /HEADER),
    the entire image is analyzed. If you do specify a positional
    qualifier, the analysis excludes all other positional qualifiers
    except the /HEADER qualifier (which is always enabled) and any
    qualifier that you request explicitly.

    The default behavior for analyzing ELF images differs from the
    behavior for analyzing Alpha or VAX images. For ELF images,
    a summary of the major ELF tables is displayed. With this
    information, you can select specific segments and/or sections for
    analysis. To locate errors, analyze the entire image by selecting
    all sections and segments.
Close Help