DynamicStructure: Registering

Registering the Plugin

Demo mode
Once installed, the plugin runs in demo mode until you enter a valid license number, using the ds_Register routine:

ds_Register (selector; licence) <- errorCode
Parameter		Type	Description
->	selector	Integer	Kind of license
->	License	String	License number
<-	errorCode	Long Integer	Error Code (0 = no error, -30000 = not registered)

Possible values for selector
1 = Developer license for Mac OS
2 = Developer license for Windows
3 = Compiled Runtime Deployment
4 = Unlimited For One Application Compiled Deployment

If the license is valid the routine returns 0 (no error). Otherwise, it returns error code -30000 and still runs in demo mode.

There are 3 kinds of license:

The developer license, which allows the development (for one platform) in interpreted mode, and let the developer do some testing in compiled mode. One license per machine is needed. You can use the same license for every structure file you develop on this machine.
The compiled runtime license, which runs only in compiled mode, and does nothing in interpreted mode. This license is the one you must use if you use DynamicStructure at runtime, compiled. This license goes for one machine too.
At last, the unlimited runtime license for one app, which goes for only one application and one platform. You need this one if you want to distribute several copies of one compiled application.

Under Client/Server you must have one licence per machine that uses the plug-in.

Mac OS = one platform, whatever the OS is: OS 9 or OS X.

Examples:

A developer uses DynamicStructure only for optimizing his/her projects, doing better technical documentation. DynamicStructure is not used in his/her structures once installed at his/her customers' offices.
- He/She must buy one developer license.
This developer uses the plugin in some compiled product:
- He/She must buy one developer license and as much as runtime compiled licenses than machines that will use the plugin.
A developer uses the plug-in one his Mac and on his PC
- He/She must buy 2 developer licenses (one per platform).
DynamicStructure is used with 4D standalone Web Server, in a compiled structure.
- Only one runtime compiled license is needed.

For any question, please contact infos@osmose.net, check our web site http://www.osmose.net, or ask your distributor.

Demo Mode Limitations: Only 20 "Set" and 50 "Get" routines can be used. After that, the plugin does nothing but return the "not registered" error code. If no error occurs when calling a plugin routine in demo mode, error -30000 ("not registered") is returned instead of 0.

Registration method example
C_INTEGER($err)
C_STRING(255;$license)
`
$macLicense:="" ` <- Put your developer license number for Mac OS
$winLicense:="" ` <- Put your developer license number for Window
$runLicense:="" ` <- Put your runtime license number
If (Not(Compiled Application)) `This is a developer license
If (wßB_IsMac )
$err:=*ds_Register* (1; $macLicense) ` selector 1 = Mac developer license
Else
$err:=*ds_Register* (2; $winLicense) ` selector 2 = Windows developer license
End if
Else "Compiled Runtime", license
` If the license starts with "UNL", it is an Unlimited license for one application". Else, it is
` a usual Compiled Runtime Deployment license.
If ($runLicense ="UNL@")
$err:=*ds_Register* (4; $runLicense)
Else
$err:=*ds_Register* (3; $runLicense)
End if
`
` NOTICE: the developer license lets the developer test in compiled mode:
` If (wßB_IsMac )
` $err:=ds_Register (1;"DEV....")
` Else
` $err:=ds_Register (2;"DEV....")
` End if
`
End if
If ($err=-30000) ` -30000 = invalid license
...
End if