| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
Process.SetQOSClass
Sets the Quality Of Service class for the current thread.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| Process | 16.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "Process.SetQOSClass"; QOS ) More
Parameters
| Parameter | Description | Example |
|---|---|---|
| QOS | The new QOS class. From highest level 5 down to background activity 1. |
1 |
Result
Returns OK or error.
Description
Sets the Quality Of Service class for the current thread.The Quality Of Service class for a thread tells the scheduler how to prioritize the thread and whether to run this on a faster or more efficient CPU core.
MacOS can run threads marked as background on an efficient core to safe battery life.
Linux does not allow to set higher priority (4 or 5) unless you have permissions to do so.
Returns a native error code or OK in case of success.
| Name | Value | Description |
|---|---|---|
| QOS_CLASS_USER_INTERACTIVE | 5 | The thread handles user input. |
| QOS_CLASS_USER_INITIATED | 4 | The user requested this action. |
| QOS_CLASS_DEFAULT | 3 | Default |
| QOS_CLASS_UTILITY | 2 | Utility thread running with reduced priority, e.g. menubar utility app. |
| QOS_CLASS_BACKGROUND | 1 | Background thread with reduced priority, e.g. backup. |
| QOS_CLASS_UNSPECIFIED | 0 | Unknown level. |
You may use this on the FileMaker server to mark long running scripts doing maintenance work as background thread, so they can run on efficient thread.
Examples
Set QOS to background:
MBS( "Process.SetQOSClass"; 1 )
See also
Blog Entries
This function checks for a license.
Created 8th March 2026, last changed 8th March 2026
