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.