HELPLIB.HLB  —  ANALYZE  /IMAGE  Qualifiers  /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.
Close Help