The RUN command initiates the execution of a task. The RUN command has five general forms, depending on the scheduling parameters and whether the task is installed. The five forms are: 1. RUN immediately (HELP RUN NOW) 2. RUN at a time increment from now (HELP RUN LATER) 3. RUN at a time increment from clock unit synchronization (HELP RUN CLOCK) 4. RUN at an absolute time of day (HELP RUN ABSOLUTE) 5. Install, immediately run, and remove on exit (HELP RUN INSTALL) 2 NOW RUN immediately: RUN taskname [/UIC=[g,m]] where taskname is the 1- to 6-character name of an installed task to be run. For information on /UIC, type HELP RUN UIC. 2 LATER RUN at a time increment from now: RUN taskname dtime [/RSI=magu][/UIC=[g,m]] taskname A 1- to 6-character task name. dtime The time at which the task will be initiated in time units from command issuance. The form of dtime is the same as for the /RSI keyword. For more information, type HELP RUN keyword. 2 CLOCK RUN at a time increment from clock unit synchronization: RUN taskname sync [dtime][/RSI=magu][/UIC=[g,m]] taskname A 1- to 6-character task name. sync The synchronization parameter in the following forms: H - synchronize on next hour M - synchronize on next minute S - synchronize on next second T - synchronize on next tick dtime The time at which the task will be inititated in time units from command issuance. If present, dtime is added to the synchronization unit to produce the actual run time for running the task. The format of dtime is the same as for the /RSI keyword. The system determines the task start-time by waiting for the first specified time unit to increment and then waiting for the specified time to elapse. For more information, type HELP RUN keyword. 2 ABSOLUTE RUN at an absolute time of day: RUN taskname atime[/RSI=magu][/UIC=[g,m]] taskname The 1- to 6-character task name. atime The absolute time of day at which to initiate this task. The parameter format is hh:mm:ss (decimal assumed). For more information, type HELP RUN keyword. 2 INSTALL Install, run immediately, and remove on exit: RUN [ddnn:][$]filename [/keyword(s)] ddnn: The device unit on which the task image file resides. $ Specifies that the file can be found in the System Task Directory on device LB: (if ddnn: is not specified). filename The name of the task image file to be run. Type HELP RUN INSTALL KEYWORDS for more information on the keywords. 3 KEYWORDS INSTALL, RUN and REMOVE Keywords: /CKP=YES or NO Specifies whether or not task will be checkpointable. /CMD="command" Pass the specified command line to the task for processing. /EST=YES or NO Specifies whether or not a task will wait for spawned task to complete and for RUN to emit exit status. /INC=size Increments the address space allocated to a task that runs in a system-controlled partition. /IOP=YES or NO Specifies that a privileged task can overmap the I/O page. /PAR=parname Specifies the partition in which the task is to be installed. /PMD=YES or NO Requests a Postmortum Dump when the task aborts; see HELP PMD. /PRI=n Specifies the priority of the task. The value range is 1 through 250(10). /ROPAR=pname Installs the read-only portion of a multiuser task into a specified partition (pname). /SLV=YES or NO Specifies the slave status of the task. /TASK=taskname Specifies the name the task will use while it is running. This name is a temporary assignment only. /TIME=nM or /TIME=nS Sets the time limit for a task that uses the CPU. Specify the time limit in minutes (M) or in seconds (S); M is the default. /UIC=[g,m] Specifies the UIC under which the task will requested to run. The square brackets are required syntax. 2 RSI The /RSI keyword specifies the reschedule interval for the task. The format of the /RSI keyword is: /RSI=magu mag The magnitude of the number of units to be clocked. The magnitude cannot exceed 24 hours in the specified units and is decimal by default. A magnitude of 0 is converted to a magnitude of 1. u The units: H = Hours M = Minutes S = Seconds T = Ticks 2 UIC The /UIC keyword is a privileged option on multiuser systems only. The format of the /UIC keyword is: /UIC=[g,m] /UIC Specifies the UIC under which the task will be requested to run. This UIC also determines which files the task can access. [g,m] Represents the group and member numbers, respectively. Legal group and member numbers range from 1 through 377(8). The square brackets are required syntax.