Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Image

Process

Parameters

Qualifiers

/DEBUG

Parameters

Qualifiers

/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

HELP RUN — MicroVMS 4.5B

Additional information available:

ImageProcess

Image

Executes an image within the context of your process.

Format
 RUN file-spec

Additional information available:

ParametersQualifiers

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

/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:

ParametersQualifiers

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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026