HELP RUN — MicroVMS 4.6
Additional information available:
Image
Executes an image within the context of your process. Format RUN file-spec
Additional information available:
Parameters
file-spec Specification of a file containing an executable image. The file type defaults to EXE. Wildcard characters are not allowed.
Qualifiers
Additional information available:
/DEBUG
/NODEBUG Executes the image under control of the debugger. The default is /DEBUG if the image is linked with /DEBUG and /NODEBUG if the image is linked without /DEBUG. The /DEBUG qualifier is invalid if the image is linked with /NOTRACEBACK. The /NODEBUG qualifier overrides the effect of LINK/DEBUG.
Process
Creates a subprocess or a detached process to run an image and deletes the process when the image completes execution. Format RUN file-spec (process)
Additional information available:
Parameters
file-spec Specification of a file containing an executable image. The file type defaults to EXE. Wildcards are not allowed.
Qualifiers
Additional information available:
/ACCOUNTING/AST_LIMIT/AUTHORIZE/BUFFER_LIMIT
/DELAY/DETACHED/DUMP/ENQUEUE_LIMIT/ERROR
/EXTENT/FILE_LIMIT/INPUT/INTERVAL/IO_BUFFERED
/IO_DIRECT/JOB_TABLE_QUOTA/MAILBOX/MAXIMUM_WORKING_SET
/OUTPUT/PAGE_FILE/PRIORITY/PRIVILEGES/PROCESS_NAME
/QUEUE_LIMIT/RESOURCE_WAIT/SCHEDULE/SERVICE_FAILURE
/SUBPROCESS_LIMIT/SWAPPING/TIME_LIMIT/UIC
/WORKING_SET
/ACCOUNTING (default)
/NOACCOUNTING Requires the Secure User Environment Option. Requires ACNT privilege to disable accounting. Logs accounting records for the created process.
/AST_LIMIT=quota
Specifies the maximum number of asynchronous system traps (ASTs) that the created process can have outstanding. The default quota is that established at system generation time. The minimum required for any process to execute is 2. The AST limit quota is nondeductible.
/AUTHORIZE
/NOAUTHORIZE (default) Requires DETACH privilege. Searches the user authorization file to validate a detached process when the image to be executed is the system login image (LOGINOUT.EXE). The /NOAUTHORIZE qualifier creates a detached process that runs under the control of the command interpreter.
/BUFFER_LIMIT=quota
Specifies the maximum amount of memory, in bytes, that the process can use for buffered I/O operations or temporary mailbox creation. The quota default is that established at system generation time. The minimum amount required for any process to execute is 1024 bytes; the buffer limit quota is pooled.
/DELAY=delta-time
Places the created process in hibernation and awakens it after a specified time interval. If you specify both /DELAY and /INTERVAL, the first wakeup request occurs at the time specified by /DELAY and all subsequent wakeups occur at intervals as specified by /INTERVAL.
/DETACHED
/NODETACHED Creates a detached process with the same user identification code (UIC) as the current process. (Use the /UIC qualifier to create a detached process with a different UIC.) By default, the detached process has the same resource quotas as the current process; the DETACH privilege allows you to specify quotas for the detached process. The maximum number of detached processes that you can create is limited to the quota defined by MAX_DETACH in your user authorization file, unless you have the DETACH privilege.
/DUMP
/NODUMP (default) When an image terminates due to an unhandled error, writes the contents of the address space to the file named SYS$LOGIN:IMAGEDUMP.DMP
/ENQUEUE_LIMIT=quota
Specifies the maximum number of locks that a process can have outstanding at any one time. The default quota is that established at system generation time. The minimum required for any process to operate is 2.
/ERROR=file-spec
Defines an equivalence name string of from 1 to 63 alphanumeric characters for the logical device name SYS$ERROR. The logical name and equivalence name are placed in the process logical name table for the created process. (This qualifier is ignored if you are running SYS$SYSTEM:LOGINOUT.)
/EXTENT=quota
Specifies the maximum size to which the image being executed in the process can increase its physical memory size. The default quota is that established at system generation time. The minimum value required for any process to execute is 10 pages. The extent quota is nondeductible.
/FILE_LIMIT=quota
Specifies the maximum number of files that a process can have open at any one time. The default quota is that established at system generation time. The minimum amount required for any process to execute is 2. The file limit quota is pooled.
/INPUT=file-spec
Defines an equivalence name string of from 1 to 63 characters for SYS$INPUT. The logical name and equivalence name are placed in the process logical name table for the created process.
/INTERVAL=delta-time
Requests that the created process be placed in hibernation and awakened at regularly scheduled intervals. If you specify the /DELAY or /SCHEDULE qualifier with the /INTERVAL qualifier, the first wakeup occurs at the time specified by /DELAY or /SCHEDULE, and all subsequent wakeups occur at intervals specified by /INTERVAL. If you specify neither /DELAY nor /SCHEDULE with /INTERVAL, the first wakeup occurs immediately, by default.
/IO_BUFFERED=quota
Specifies the maximum number of system-buffered I/O operations that the created process can have outstanding at any one time. The default quota is that established at system generation time. The minimum required for any process to execute is 2. The buffered I/O quota is nondeductible.
/IO_DIRECT=quota
Specifies the maximum number of direct I/O operations that the created process can have outstanding at any one time. The default quota is that established at system generation time. The minimum required for any process to execute is 2. The direct I/O quota is nondeductible.
/JOB_TABLE_QUOTA=quota
Allows you to specify a quota for a detached process's job-wide logical name table. (Note that the /JOB_TABLE_QUOTA is specified in a RUN command which results in the creation of a subprocess, it will be ignored.
/MAILBOX=unit
Specifies the unit number of a mailbox to receive a termination message when the created process is deleted. (If no mailbox is specified, the creating process receives no notification of the subprocess's deletion.)
/MAXIMUM_WORKING_SET=quota
Specifies the maximum size to which the image being executed in the process can increase its working set size. The default quota is that established at system generation time. the minimum value required for any process to execute is 10 pages. The maximum working set quota is nondeductible.
/OUTPUT=file-spec
Defines an equivalence name string of from 1 to 63 characters for the logical device name SYS$OUTPUT. Both the equivalence name and the logical name are placed in the process logical name table for the created process.
/PAGE_FILE=quota
Specifies the maximum number of pages that can be allocated in the paging file for the process. The default quota is that established at system generation time. The minimum value required for a process to execute is 256 pages. The paging file quota is pooled.
/PRIORITY=n
Requires ALTPRI privilege to set the priority higher than your base priority. Specifies the base priority at which the created process will execute. The value of n is a decimal number from 0 through 31. The default priority is that of the current process.
/PRIVILEGES=(keyword,...)
Requires SETPRV privilege to specify privileges that you do not have. Defines user privileges for the created process. By default, the created process has the same privileges as its creator. If you specify a version number (or semi-colon) in the file-spec parameter, the current process privileges are used, overriding any privileges specified with the /PRIVILEGES qualifier. The following table lists process privileges: +--------------+-----------------------------------------------------+ | [NO]ACNT | Create processes for which no accounting messages | | | are written | +--------------+-----------------------------------------------------+ | [NO]ALL | Have all privileges | +--------------+-----------------------------------------------------+ | [NO]ALLSPOOL | Allocate spooled devices | +--------------+-----------------------------------------------------+ | [NO]ALTPRI | Set priority values | +--------------+-----------------------------------------------------+ | [NO]BUGCHK | Make bug check error log entries | +--------------+-----------------------------------------------------+ | [NO]BYPASS | Bypass UIC protection | +--------------+-----------------------------------------------------+ | [NO]CMEXEC | Change mode to executive | +--------------+-----------------------------------------------------+ | [NO]CMKRNL | Change mode to kernel | +--------------+-----------------------------------------------------+ | [NO]DETACH | Create detached processes | +--------------+-----------------------------------------------------+ | [NO]DIAGNOSE | Issue diagnostic I/O requests | +--------------+-----------------------------------------------------+ | [NO]EXQUOTA | Exceed quotas | +--------------+-----------------------------------------------------+ | [NO]GROUP | Control other processes in the same group | +--------------+-----------------------------------------------------+ | [NO]GRPNAM | Place names in the group logical name table | +--------------+-----------------------------------------------------+ | [NO]GRPPRV | Access group objects | +--------------+-----------------------------------------------------+ | [NO]LOG_IO | Issue logical I/O requests to a device | +--------------+-----------------------------------------------------+ | [NO]MOUNT | Issue a mount volume QIO request | +--------------+-----------------------------------------------------+ | [NO]NETMBX | Create a network device | +--------------+-----------------------------------------------------+ | [NO]OPER | Perform operator functions | +--------------+-----------------------------------------------------+ | [NO]PFNMAP | Create or delete sections mapped by page frame | | | number | +--------------+-----------------------------------------------------+ | [NO]PHY_IO | Issue physical I/O requests to a device | +--------------+-----------------------------------------------------+ | [NO]PRMCEB | Create permanent common event flag clusters | +--------------+-----------------------------------------------------+ | [NO]PRMGBL | Create permanent global sections | +--------------+-----------------------------------------------------+ | [NO]PRMMBX | Create permanent mailboxes | +--------------+-----------------------------------------------------+ | [NO]PSWAPM | Alter swap mode | +--------------+-----------------------------------------------------+ | [NO]READALL | Bypass existing restrictions on reading a file | +--------------+-----------------------------------------------------+ | [NO]SETPRV | Give higher privileges to other processes | +--------------+-----------------------------------------------------+ | [NO]SHARE | Assign a channel to a device, even if the channel | | | is allocated to another process | +--------------+-----------------------------------------------------+ | [NO]SHMEM | Create data structures in shared memory | +--------------+-----------------------------------------------------+ | [NO]SYSGBL | Create system global sections | +--------------+-----------------------------------------------------+ | [NO]SYSLCK | Request locks on system-wide resources | +--------------+-----------------------------------------------------+ | [NO]SYSNAM | Place names in the system logical name table | +--------------+-----------------------------------------------------+ | [NO]SYSPRV | Access system objects | +--------------+-----------------------------------------------------+ | [NO]TMPMBX | Create a temporary mailbox | +--------------+-----------------------------------------------------+ | [NO]VOLPRO | Override volume protection | +--------------+-----------------------------------------------------+ | [NO]WORLD | Control all other processes in the system | +--------------+-----------------------------------------------------+
/PROCESS_NAME=process-name
Specifies a name of from 1 to 15 characters for the created process. The process name is implicitly qualified by the group number of the process's UIC. By default, the name is null.
/QUEUE_LIMIT=quota
Specifies the maximum number of timer queue entries that the created process can have outstanding at any one time. The default quota is that established at system generation time. The timer queue entry quota is pooled.
/RESOURCE_WAIT (default)
/NORESOURCE_WAIT Places the created process in a wait state when a resource required for a particular function is not available. The /NORESOURCE_WAIT qualifier generates an error status code when a resource is unavailable.
/SCHEDULE=absolute-time
Places the created process in hibernation and awakens it at the specified time.
/SERVICE_FAILURE
/NOSERVICE_FAILURE (default) Signals an exception condition if an error occurs during a system service request. By default, an error status code is returned to the process.
/SUBPROCESS_LIMIT=quota
Specifies the maximum number of subprocesses that the created process is allowed to create. The default quota is that established at system generation time. The subprocess limit is pooled.
/SWAPPING (default)
/NOSWAPPING Requires PSWAPM privilege to inhibit swapping. Permits the process to be swapped.
/TIME_LIMIT=quota
Specifies the maximum amount of CPU time (in delta time) to be allocated to the created process. The resolution is to 10 milliseconds. When the time expires, the process is deleted. The default limit is that established at system generation time (usually infinite). A CPU time limit of 0 specifies that CPU time is not restricted. The time limit quota is deductible.
/UIC=uic
Specifies that the created process be a detached process and assigns it a UIC.
/WORKING_SET=default
Specifies the number of pages in the working set of the created process. The default working set size is that established at system generation time. The minimum number of pages required for a process to execute is 10 pages. The value specified cannot be greater than the quota specified with /MAXIMUM_WORKING_SET. The maximum working set quota is nondeductible.