The sys Object
- Updated2025-04-30
- 2 minute(s) read
PAscript provides a simple way to interact with the runtime system with the sys object.
The sys object is always available, so you do not need a variable of type sys but 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. |
| :expirationTime | timestamp | Returns the time stamp of the expiration date if using a temporary license. | |
| :licenseKind | sys:licensing:kind | Returns the license type stored in the dongle. | |
| :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. |
| :rtsld | int32 | Returns the number of the runtime system where the PAscript program runs. | |
| :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 a message of category error to the relevant destinations and returns the status. |
| :logInfo() | Sends a message of category info to the relevant destinations and returns the status. |
| :logSuccess() | Sends a message of category success to the relevant destinations and returns the status. |
| :logWarning() | Sends a message of category warning 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. |