This is the legacy 4D documentation web site. Documentations are progressively being moved to developer.4d.com
Get license usage
| Get license usage -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| Function result | Collection |
|
A collection of objects with information on the retained licenses. | |||||
The Get license usage command returns a collection of objects containing information on the retained licenses.
Each object in the returned collection has the following attributes:
| Property name | Type | Description |
| productId | Number | ID of the license type |
| productName | Text | Name of the license type |
| productUsedCount | Number | Number of retained licenses (including this one) when the license was retained |
| productBalance | Number | Number of remaining licenses for the product (just after the action) |
| globalProductUsedCount | Number | When several servers are running on the same machine, shows the retained count for all of them |
| token | Number | Operation's unique ID |
| time | Text | Timestamp that indicates when the license was retained, in ISO 8601 format |
| reason | Text | The reason/caller of this license usage |
| session | Object | Contains specific information about the retained license's session |
Depending on the type of session (4D client or REST for example), the contents of the session object in the above table will vary. See below for details.
Inside the returned collection for 4D sessions, each element contains a session object identical to the one returned by the Process activity command:
| Property name | Type | Description |
| type | Text (enum) | Session type. Possible values: "remote", "storedProcedure", "web", "rest" |
| userName | Text | User name |
| machineName | Text | Name of the remote machine |
| systemUserName | Text | Name of the system session opened on the remote machine |
| IPAddress | Text | IP address of the remote machine |
| hostType | Text (enum) | Host type. Possible values: "windows", "mac", "browser" |
| creationDateTime | Date ISO 8601 | Date and time of connection of the remote machine |
| state | Text (enum) | Session state. Possible values: "active", "postponed", "sleeping" |
| ID | Text | Session UUID |
| persistentID | Text | Session's persistent ID |
This table details the contents of the session object for SQL sessions:
| Property name | Type | Description |
| IPAddress | Text | IP address of the session |
| userAgent | Text | User Agent |
| userName | Text | User Name |
| userId | Number | User ID |
This table details the contents of the session object for REST sessions:
| Property name | Type | Description |
| userName | Text | User Name |
| sessionID | Text | REST session ID |
| IPAddress | Text | ID of the client that initiated the REST session |
| isDatastore | Boolean | True if the REST request comes from a datastore |
Product: 4D
Theme: Licenses
Number:
1782
Created: 4D v19 R4
4D Language Reference ( 4D v20 R7)
