RUN[/qualifier[s]] [$]filespec Qualifiers /[NO]CHECKPOINT /COMMAND:"taskcommand" /EXTENSION:n /PARTITION:parname /PRIORITY:n /STATUS:COMMAND :TASK /TASK_NAME:name /TIME_LIMIT:arg /UIC:[g,m] The RUN command can be used to initiate the execution of either an installed task or an uninstalled task from a task image file. Most RUN commands are of this variety. The RUN command in this case is a combination INSTALL-RUN-REMOVE command. The $ requests that the task be run from a file in the System Directory (or Library Directory on RSX-11M-PLUS). Abbreviation: R See HELP RUN INSTALLED_TASK for information on the other flavor of the RUN command. 2 NOCHECKPOINT #CHECKPOINT 2 CHECKPOINT RUN/[NO]CHECKPOINT filespec The /CHECKPOINT qualifier specifies whether or not the task is to be checkpointable as it runs. The default is set at link-time. This quali- fier overrides the link-time specification. 2 COMMAND RUN/COMMAND:"task_command" taskname The /COMMAND qualifier makes it possible for you to pass a command to a task at the same time as you run it. For example, >RUN/COMMAND:"/LI" $PIP 2 EXTENSION RUN/EXTENSION:n filespec The /EXTENSION qualifier specifies that 'n' additional words of address space are to be allocated to a task. 2 PARTITION RUN/PARTITION:parname filespec The /PARTITION qualifier specifies into what partition the task is to run. The default is set at link-time. This qualifier overrides the link time specification. 2 DUMP #POSTMORTEM 2 POSTMORTEM RUN/POSTMORTEM taskname The /POSTMORTEM qualifier specifies that you wish a postmortem dump in the case of an abnormal exit of the task. See HELP PMD. 2 PRIORITY RUN/PRIORITY:n filespec The /PRIORITY qualifier specifies at what priority the task is to run. The default is set at link-time. This qualifier overrides the link-time specification. 2 STATUS RUN/STATUS:COMMAND taskname RUN/STATUS:TASK taskname The /STATUS:TASK qualifier specifies that you wish exit status from the task being run and not from the RUN command. The default is /STATUS:COMMAND and need not be specified. The /STATUS:TASK qualifier may be necessary in user batch jobs that run tasks where the batch processor must wait for the task to exit before attempt- ing to execute the next command. For instance, if the user batch job includes a command to run an task that writes a file followed by a command to print that file, the /STATUS:TASK qualifier to RUN prevents the PRINT command from being issued before the task has finished writing the file. 2 TASK RUN/TASK_NAME:name filespec The /TASK_NAME qualifier specifies the name by which the task is to be refered. The default is set at link-time. This qualifier overrides the link-time specification. 2 TIME_LIMIT RUN/TIME_LIMIT:arg The /TIME_LIMIT qualifier permits you to set a time limit on the task's execution time on RSX-11M-PLUS systems. Specify either m and a number for minutes or s and a number for seconds of CPU time. The default is m. 2 UIC RUN/UIC:[uic] filespec The /UIC qualifier specifies the default UIC for the task. This task UIC determines into what file-protection class it belongs, and thus durectly influences file access. The square brackets are required syntax. 2 DELAY RUN/DELAY:nu taskname The /DELAY qualifier specifies that the specified task be run after the specified amount of time passes. The argument 'nu' specifies the amount of the delay as a number of units. 'n' is the number of units and 'u' is one of the time unit qualifiers as follows: TICKS SECONDS MINUTES HOURS For example, to delay execution for 5 seconds after issuing the command, /DELAY:5S should be specified. 2 INTERVAL RUN/INTERVAL:nu taskname The /INTERVAL qualifier specifies that the specified task is to be run at a regular interval. The argument 'nu' specifies the interval as a number of units of time. 'n' is the number of units. 'u' is one of the time units qualifiers as follows: TICKS SECONDS MINUTES HOURS For example, to run a task every 5 seconds, /INTERVAL:5S should be specified. 2 SCHEDULE RUN/SCHEDULE:hh:mm:ss taskname The /SCHEDULE qualifier specifies that the specified task be run at a particular time of day. 2 STATUS RUN/STATUS:COMMAND taskname RUN/STATUS:TASK taskname The /STATUS:TASK qualifier specifies that you wish exit status from the installed task being run and not from the RUN command. The default is /STATUS:COMMAND and need not be specified. The /STATUS:TASK qualifier may be necessary in user batch jobs that run installed tasks where the batch processor must wait for the installed task to exit before attempt- ing to execute the next command. For instance, if the user batch job includes a command to run an installed task that writes a file followed by a command to print that file, the /STATUS:TASK qualifier to RUN prevents the PRINT command from being issued before the installed task has finished writing the file. This is not a privileged qualifier. 2 SYNCHRONIZE RUN/SYNCHRONIZE:u taskname The /SYNCHRONIZE qualifier specifies that the execution of the speci- fied task be synchronized on a particular clock unit. 'u' is one of the time unit qualifiers as follows: TICKS SECONDS MINUTES HOURS For example, if you wanted to run a task 'A' every hour on the hour, you would enter the following command: RUN/SYNCHRONIZE:H/INTERVAL:1H A This command says to synchronize on the hour and then run at intervals of 1 hour. 2 INSTALLED_TASK RUN[/qualifier] installed_task Qualifiers /DELAY:nu /INTERVAL:nu /SCHEDULE:hh:mm:ss /STATUS:arg COMMAND TASK /SYNCHRONIZE:u /UIC:[g,m] This flavor of the RUN command initiates the exection of an installed tasks. Nonprivileged users can run installed tasks and can specify the /STATUS qualifier, but all other qualifiers are privileged. You cannot use RUN with tasks with names in the form ...xxx. To run these tasks, use a command in the form >MCR xxx See HELP RUN qualifier for more information.