VMS Help ANALYZE, /IMAGE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Analyzes the contents of an executable image file or a shareable
    image file on Alpha systems, VAX systems, and translated VAX images
    and checks for obvious errors in the image file. The /IMAGE
    qualifier is required. For general information about image files,
    see the description of the linker in the OpenVMS Linker Utility
    Manual. (Use the ANALYZE/OBJECT command to analyze the contents
    of an object file.)

    Format

      ANALYZE/IMAGE  filespec[,...]

1 - Parameter

    filespec[,...]

    Specifies the name of one or more image files that you want
    analyzed. You must specify at least one file name. If you specify
    more than one file, separate the file specifications with either
    commas (,)  or plus signs (+). The default file type is EXE.

    The asterisk (*) and the percent sign (%) wildcard characters
    are allowed in the file specification.

2 - Description

    The ANALYZE/IMAGE command provides a description of the
    components of an executable image file or shareable image file.
    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.

    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.

    The ANALYZE/IMAGE command distinguishes Alpha system image files
    from VAX system image files by examining the extended image
    header (EIHD).

    The ANALYZE/IMAGE command provides the following information:

    o  Image type - Identifies whether the image is executable or
       shareable.

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

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

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

    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.

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

    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.

    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.

    o  Fixup vectors - Contain information that the image activator
       needs to ensure the position independence of shareable image
       references.

    o  System version categories - For an image that is linked against
       the executive (the system shareable image on 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. 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.

3 - Qualifiers

 3.1 - /FIXUP_SECTION

    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.

 3.2 - /GST

    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.

 3.3 - /HEADER

    Positional qualifier.

    Specifies that the analysis should include all header items and
    image section descriptions. The image header items are always
    analyzed.

 3.4 - /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.

 3.5 - /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.

 3.6 - /PATCH_TEXT

    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.

 3.7 - /SELECT

      /SELECT=(keyword[,...])

    Allows for the collection of specific image or object file
    information and displays the selected keyword items in the
    order specified.

    The keywords are as follows:

    Keyword         Description

    ARCHITECTURE    Returns "OpenVMS Alpha" if the file is either
                    an OpenVMS Alpha image or object file.  Returns
                    "OpenVMS VAX" if the file is either an OpenVMS VAX
                    image or object file.  Otherwise, returns "Unknown".

    BUILD_          For OpenVMS Alpha image files, returns the image build
    IDENTIFICATION  identification stored in the image header, enclosed in
                    quotation marks.  For OpenVMS VAX image files, the null
                    string that is represented by adjacent quotation marks
                    is returned.  Otherwise, returns "Unknown".

    FILE_TYPE       Returns "Image" if the file is an OpenVMS VAX or
                    Alpha image file.  Returns "Object" if the file
                    is an OpenVMS VAX or Alpha object file.  Otherwise,
                    returns "Unknown".

    IDENTIFICATION  For both OpenVMS Alpha and VAX image files, returns the
                    image identification that is stored in the image header,
                    enclosed in quotation marks.  Otherwise, returns
                    "Unknown".

    IMAGE_TYPE      Returns "Shareable" if the file is either an OpenVMS
                    Alpha or OpenVMS VAX sharable image file.  Returns
                    "Executable" if the file is either an OpenVMS Alpha
                    or OpenVMS VAX executable (nonsharable) image file.
                    Otherwise, returns "Unknown".

    LINK_TIME       For both OpenVMS Alpha and VAX image files, returns
                    the image link time that is stored in the image header,
                    enclosed in quotation marks.  Otherwise, returns
                    "Unknown".

    NAME            For both OpenVMS Alpha and VAX image files, returns
                    the image name that is stored in the image header,
                    enclosed in quotation marks.  Otherwise, returns
                    "Unknown".

4 - Examples

   1.$ ANALYZE/IMAGE LINEDT

      The ANALYZE/IMAGE command in this example produces a
      description and an error analysis of the image LINEDT.EXE.
      Output is sent to the current SYS$OUTPUT device. By default,
      the entire image is analyzed.

   2.$ ANALYZE/IMAGE/OUTPUT=LIALPHEX/FIXUP_SECTION/PATCH_TEXT LINEDT,ALPRIN

      The ANALYZE/IMAGE command in this example produces a
      description and an error analysis of the fixup sections
      and patch text records of LINEDT.EXE and ALPRIN.EXE in file
      LIALPHEX.ANL. Output is sent to the file LIALPHEX.ANL.

   3.$ ANALYZE/IMAGE/SELECT=(ARCH,FILE,NAME,IDENT,BUILD,LINK) *.EXE
     DISK:[DIRECTORY]ALPHA.EXE;1
     OpenVMS ALPHA
     Image
     "Test image ALPHA"
     "A11-27"
     "X5SC-SSB-0000"
     13-APR-2000 07:16:19.24
     DISK:[DIRECTORY]NO_HEADER.EXE;1
     Unknown
     Unknown
     Unknown
     Unknown
     Unknown
     Unknown
     DISK:[DIRECTORY]VAX.EXE;1
     OpenVMS VAX
     Image
     "Test image VAX"
     "V11-27"
     ""
     4-NOV-2000 13:18:40:70

      This example displays the information requested about the executable
      file, ALPHA.EXE, the unknown file, NO_HEADER.EXE, and the executable
      file, VAX.EXE.