Processes - Set Priority |
Declaration
<AMPROCESSES ACTIVITY="setpriority" DOMAINNAME="text" REMOTEMACHINE="text" USERNAME="text" PASSWORD="text (encrypted)" PROCESSNAME="text" PRIORITY="text (options)" /> |
Description
Changes the execution priority of one or more instances of a process. If multiple instances of the process exist, priority can be set for the oldest, newest, all or no instances of the process. This activity supports local and remote processes.
Practical Usage
Commonly used to adjust specific process priorities to improve performance or prevent badly behaved processes from negatively impacting the system's overall responsiveness. Note that in order toset the priority to Realtime, the user must have proper security permissions to do so.
Parameters
Process
Property |
Type |
Required |
Default |
Markup |
Description |
Find by Name |
Text |
No |
(Empty) |
|
If enabled, specifies the name of the process in which to set. This parameter supports entry of the absolute path (C:\folder\process.exe) or relative path (Notepad.exe) of the process. If this parameter is enabled, the Find by process ID parameter becomes inactive. This parameter is enabled by default. |
If multiple instances of the process exist, apply changes to |
Text (options) |
No |
Oldest |
SAMEPROCESS="nothing" |
Indicates which process instance should be set in case more than one instance of a given process is running. The available options are:
|
Find by Process ID |
Text |
No |
Yes |
PROCESSID="11452" |
If enabled, specifies the process ID of the process to set. If this parameter is enabled, the Find by Name parameter becomes inactive. This parameter is disabled by default. Note: Use the Processes - Get Information activity to retrieve the process ID of a given process. |
Change process priority to |
Yes/No |
No |
No |
PRIORITY="Idle" |
The priority level to set the process to. The available options are:
|
Computer
Property |
Type |
Required |
Default |
Markup |
Description |
Local computer |
If enabled, specifies that the process to set resides on the local machine. This parameter is enabled by default. If this parameter is selected, the Another computer parameter becomes inactive. This is a visual mode parameter used during design time only, therefore, it contains no markups. |
||||
Another computer |
If enabled, specifies that the process to set resides on a remote machine. The parameters below become active if this parameter is enabled. This is a visual mode parameter used during design time only, therefore, it contains no markups. |
||||
Computer |
Text |
Yes |
(Empty) |
|
The host name or IP address of the remote machine where the process to set resides. This parameter is available only if the Another computer parameter is enabled. |
Domain |
Text |
Yes |
(Empty) |
DOMAINNAME="netauto" |
The domain name of the remote machine where the process to set resides. This parameter is available only if the Another computer parameter is enabled. |
Username |
Text |
Yes |
(Empty) |
USERNAME="Bruce.Wayne" |
A valid username used to log onto the remote machine in which the process to set resides. This parameter is available only if the Another computer parameter is enabled. |
Password |
Text |
Yes |
(Empty) |
PASSWORD="encrypted" |
The password corresponding to the username entered in the Username field. This parameter is available only if the Another computer parameter is enabled. |
ExampleS
- The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
- Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.
Sample 1
Set priority of process "Photoshop.exe" on the local computer to "Above normal".
<AMPROCESSES ACTIVITY="setpriority" PROCESSNAME="Photoshop.exe" SAMEPROCESS="all" PRIORITY="abovenormal" /> |
SAMPLE 2
Set priority of process "Photoshop.exe" on "remoteMachine.com/theRemoteMachine" to "High".
<AMPROCESSES ACTIVITY="setpriority" DOMAINNAME="remoteMachine.com" REMOTEMACHINE="theRemoteMachine" USERNAME="user" PASSWORD="AM2ooXWPmWe55c=aME" PROCESSNAME="Photoshop.exe" SAMEPROCESS="all" PRIORITY="high" /> |