All methods in the GX API require the user to have been granted the right to access that method in the way it is being used by your program. The entitlements of the end-user are checked when a GX (or external program) calls a GX function. Each function will fall under one of the license classes below:
Type | Description | |
|---|---|---|
Public | Available with the free Viewer, and the GX Developer redistributable libraries. Open | No entitlements are needed to access these classes and methods, and this includes all methods and functions that support data import and export. Note, that some of the Open methods that are public may have reduced functionality. For example, any size database can be read, but there are restrictions in the size of data that can be written to a Public license user.ControlledUser systems that use. |
Licensed | These methods require Oasis montaj to be installed with the Geosoft license installed for the end-user use the method. The GX_GEOSOFT_BIN_PATH environment variable, if defined, must point to the ' | |
Extended | These methods require specific licenses to execute. Since the license structure that enables these methods is dynamic it is Geosoft extensions. We recommended that GX Developers should not use Extended methods. |
A user that runs a GX or program that includes calls to method calls for which she is not entitled will receive an error like:
| Code Block |
|---|
geosoft.GX.Error: Unable to bind the "rGet_PG(h_gxx)" wrapper function. The DLL may not be present or a license may be missing. |
Well written programs or GXs should catch this error and report the problem to the user with a recommended course of action.
Malicious Code Protection
To protect against malicious code and viruses, Geosoft has instituted a Signed GX system. All GX’s compiled by Geosoft are signed and will only execute if they have been licensed for execution on your system. If a signed compiled GX is modified in any way it will not longer be considered safe code and will not execute.
All GX's you compile, or which are compiled and supplied by a third party are considerd considered un-signed. Oasis montaj users Users can still execute unsigned GX’s but a warning will appear indicating that this GX was not signed and asking will ask the user to:
...
Run Once (Run the GX but only this time)
Run Always (Store the GX’s signature and always allow that GX to run)
...
Deny (Do not execute this GX at all)
At this time, only members of the Geosoft Partners program partners can have their GX’s signed by Geosoft.
VIEWGX - Entitlement/License Analysis
To help GX developers using the Geosoft GXC language determine the entitlement requirements for their GX to execute, the VIEWGX program can provide a license analysis of a GX. To view this analysis run:
...
This will produce a listing of subscriptions/licenses under which this GX can be used. For example:
...