HELPLIB.HLB  —  RUN  Image
    Executes an image within the context of your process. You can
    abbreviate the RUN command to a single letter, R.

                                   NOTE

       If you are invoking an image that requires one or more
       parameters, you must use the Automatic Foreign Command
       format or the Foreign Command format. See the OpenVMS User's
       Manual for additional information.

    Format

      RUN  filespec

1  –  Parameter

 filespec

    Specifies an executable image to be executed. The file type
    defaults to .EXE. The asterisk (*)  and the percent sign (%)
    wildcard characters are not allowed.

2  –  Qualifier

2.1    /DEBUG

       /DEBUG
       /NODEBUG

    Executes the image under control of the debugger. The default
    is the /DEBUG qualifier if the image is linked with the /DEBUG
    qualifier and the /NODEBUG qualifier if the image is linked
    without the /DEBUG qualifier. The /DEBUG qualifier is invalid if
    the image is linked with the /NOTRACEBACK qualifier. The /NODEBUG
    qualifier overrides the effect of the LINK/DEBUG command. If
    the image was linked with the /TRACEBACK qualifier, traceback
    reporting is performed when an error occurs.

    If the image was not linked with the debugger, you can specify
    the /DEBUG qualifier to request the debugger at execution time;
    however, if the /NOTRACEBACK qualifier was specified when the
    image was linked, the /DEBUG qualifier is invalid.

    For a complete description of the OpenVMS Debugger, see the VSI
    OpenVMS Debugger Manual.

    To get help on debugger commands from the DCL level, type the
    following command:

    $ HELP/LIBRARY=SYS$HELP:DBG$HELP DEBUG

3  –  Examples

    1.$ RUN LIBRA

      The image LIBRA.EXE starts executing in the process. If the
      image LIBRA has been installed with amplified privileges, it
      runs with those privileges because you have not explicitly
      specified a version number or a semicolon. Alternatively, the
      image LIBRA.EXE still runs with its amplified privileges, if
      you enter the RUN command as follows:

        $ RUN LIBRA.EXE

    2.$ MACRO/ENABLE=DEBUG ORION
      $ LINK/DEBUG ORION
      $ RUN ORION

       OpenVMS I64 DEBUG64 Version V8.3-014

      %DEBUG-I-INITIAL, Language:IMACRO, Module:ORION
      DBG>
         .
         .
         .
      $ RUN/NODEBUG ORION

      A program is compiled, linked, and run with the debugger.
      Subsequently, a RUN/NODEBUG command requests that the debugger,
      which is present in the image, not issue a prompt. If an error
      occurs while the image executes, the debugger can perform
      traceback and report on the error.

    3.$ RUN AQUARIUS.EXE;1

      The image AQUARIUS.EXE starts executing in the process. If
      the image AQUARIUS.EXE has been installed with amplified
      privileges, it does not run with those privileges because you
      have specified a version number. Instead, the image runs with
      current process privileges only. When you specify a version
      number (or even just a semicolon), the image activator does not
      search its list of special images that have been installed with
      privileges. The process AQUARIUS still runs with only normal
      process privileges if you enter the RUN command as follows:

        $ RUN AQUARIUS.EXE;

      In this case, however, the highest version of the image
      AQUARIUS runs.
Close Help