System Object Functions
- Updated2025-10-31
- 2 minute(s) read
System object functions provide a simple way to interact with the runtime system.
The sys object is always available, so you do not need a sys variable. You can call functions and attributes directly.
In analogy to data types, the sys object has attributes and type functions. Access attributes and type functions with the : operator.
| Attribute | Data Type | Description |
|---|---|---|
| calender:time | timestamp | Returns the system time at the time of the query. |
| licensing:containerIds | text | Returns the license IDs stored in the dongle. |
| licensing:expirationTime | timestamp | Returns the time stamp of the expiration date if using a temporary license. |
| licensing:licenseKind | sys:licensing:kind | Returns the license type stored in the dongle. |
| licensing:licenseText | text | Returns the name of the license stored in the dongle. |
| programName | text | Returns the name of the currently running PAscript program. |
| slot | slot | Returns a reference to the own slot in a test component. |
| system:freePABMemory | int32 | Returns the free memory, in bytes, of the runtime system. |
| system:rtsld | int32 | Returns the number of the runtime system where the PAscript program runs. |
| system:rtsVersion | int32 | Returns the version of the runtime system in the format: MajorVersion.MinorVersion.ServicePack.Release. |
| task | task | Returns the task that executes the current PAscript program. |
| testName | text | Returns the name of the test that is currently running. |
| Type Functions | Definition |
|---|---|
| :logError() | Sends an error message to the relevant destinations and returns the status. |
| :logInfo() | Sends an info message to the relevant destinations and returns the status. |
| :logSuccess() | Sends a success message to the relevant destinations and returns the status. |
| :logWarning() | Sends a warning message to the relevant destinations and returns the status. |
| :systemLink:request | Sends an HTTP request to the specified SystemLink endpoint. If no user API key is specified, the client API key is used. Returns the response body as jsonValue and the HTTP status code, or -1, in case of any system error. |
| :terminateTest() | Finishes the test run. |