|  | October 1999
| The Magic Application Feature License |
| Dear Developer, Magic version 8.30 Service Pack 2 allows the developer to control access to features in a Magic application. |
| The License Server utility lets the developer create a feature license for a Magic application. Users can then check out and in instances of a specific license. The modules for the feature license implementation are listed below: LMCHKOUT – Allows the user to check out a user instance of a specified feature license. LMCHKIN – Allows the user to check in a user instance of a feature license. Makekey.exe – Creates the feature license for a Magic application. |
| General As the Magic product uses the licensing facility to count the instances of use, it now allows the Magic developer to control the amount of instances of the applications that are deployed. The implementation of this new feature is done in two stages: 1. First the Magic developer needs to create an appropriate license entry (similar to the license entry of the Magic product in the license file.) This license entry will define the number of instances of the application. This license entry is generated using the FlexLM utility of Makekey.exe. 2. Inside the application logic the Magic developer has two new functions that allow him at any given time through the application logic to check out a user instance ( LMCHKOUT) and to check it back in (LMCHKIN). The LMCHKOUT function will fail if the maximum allowed instances has reached. According to the success or failure of the function the Magic developer can decide how the Application logic should continue. |
| License Manager Functions LMCHKOUT Allows the user to check out a user instance of a specified feature license. If the execution of the function is successful then one user instance will be counted out of the maximum allowed instances. If the maximum allowed instances has reached the function will fail. |
Syntax: | LMCHKOUT (license file name, feature name, version)
Parameters: | License file name - A string value that indicates the license data file or the location of the license server. The license location is set once by the first evaluation of this function throughout the application. Feature name - A string that specifies the name of the feature. Version - A string that specifies the version of the requested feature.
Returns: | The function returns a numeric value indicating success or failure of the function execution as follows: 0 - Success. 1 - Failure to initialize connection to the license server. 2 - The license file is damaged or does not exist. 3 - The value of the feature name in the function is blank. 4 - The specified feature does not exist in the license file. 5 - The expiration date of the feature has passed 6 - The feature requested does not exist in the license file of the server. 7 - Failed to check out a user instance of a license.
LMCHKIN Allows the Magic developer to check in a user instance of a specified license.
Syntax: | LMCHKIN (Feature name)
Parameters: | Feature name - A string that specifies the name of the feature of which an instance was checked out.
Returns | The function returns a numeric value indicating success or failure of the function execution as follows: 0 – Success. 8 - Failed to check in a user instance of a selected license.
| Makekey utility With this service pack installation we provide you with the makekey utility. This utility will enable any Magic developer to create a proprietary license entry to be used as a feature license for checking out and checking in users of a Magic application. The makekey.exe utility should be run inside the directory of the installed license server product. The makekey utility takes you through a series of information input needed for creating your new license entry. The following information will provide the procedure and clarify the input this utility requires: Run the Makekey.exe utility. If the folder in which you are running already has a 'License.dat' file, this utility will prompt you to enter a new output file name: "license.dat exists, please enter output filename:" If a license.dat file does not exists the utility will automatically choose it as your output file. In order to create the SERVER and DAEMON header of the license file you can either specify your own header details or extract it of an existing license file: "Do you want to use an existing file for SERVER and DAEMON lines [y/n] ?" Yes, No If you choose to use an existing file for the header you will be suggested with the option of using the existing license.dat file: "Do you want to use C:\FlexLM\license.dat ? [y/n]:" Yes, No If you choose not to use the default file for the header you will be asked to enter the name of the source file yourself: "What file do you want to use?" Enter a valid file name with a license file header and proceed to enter the features If you choose not to use an existing file for the header you will need to provide the header information of the servers names and hostid. The servers' information entry procedure is cyclic. You can end this procedure by entering a blank host name after the last server details, "Enter hostname:" Here you should enter the name of the host computer. Enter blank value to end the servers' entry procedure. "Enter the hostid:" Here you should enter the physical id of the host computer. To use any physical computer, enter the value "any". "Use IPX as transport protocol? [y/n]:" Yes, No Specify if you want your license transport protocol to be of IPX. "Enter the IPX socket number [1234]:" Enter the value of the IPX socket number. The default IPX socket is 1234. "Enter the IPX node number [000000000001]:" Enter the value of the IPX node number. The default IPX node number is 000000000001. "Enter the IPX network number [00000000]:" Enter the value of the IPX network number, The default IPX network number 00000000. "Use TCP/IP as transport protocol? [y/n]:" Yes, No Specify if you want your license transport protocol to be of TCP/IP. "Enter the TCP/IP port number [7412]:" Enter the TCP/IP port number. The default port number is 7412. You now can enter details for another server. "Enter DAEMON "MAGIC" path:" Enter the patch of the LMG.exe daemon. Now that the header information is completed you need to enter the information for the feature licenses you want to create. The feature entry is a cyclic procedure that allows you to enter numerous features. You can end this procedure by entering a blank Feature name after the last feature has been entered. "Feature name:" Enter a short descriptive name for the feature you want to create. "FEATURE/INCREMENT/UPGRADE line? [f/i/u, default: f]:" Specify the default entry for FEATURE. "Version of [Feature name][default 1.0]:" Specify the version of your feature license. The default is 1.0. "Number of licenses [default: 4]:" Specify the number of licenses this feature allows. The default number of licenses is 4. "Number of OVERDRAFT licenses [default: 0]:" Specify the number of overdraft allowed by this feature. The default overdraft of licenses is 0. The overdraft licenses are the extra user count you allow on top of the given licenses. "Duplicate grouping parameter [NONE, SITE, [UHDV], default: not specified]:" Press Enter to use the default 'Not specified option. "Intellectual Property Notice [default: ""]:" Here you can specify additional remark for your license. This remark wil be placed in the license created as the value of a property called NOTICE. "Expiration date [dd-mmm-yyyy, default: 1-jul-97]:" Enter the expiration date for your license. If no expiration date is desired enter the date 1-jan-0. If you enter an expiration date which already passed you will be prompt with a confirmation line: " If you want to use 1jul-97, type "y":" "Start date [dd-mmm-yyyy, default: 1-jan-95]:" Specify the date from which this libe active. The default dateis 1 January 1995). "Your vendor-defined string:" Specify the type of license you want to use. For creating a license that will work through the license server enter the string "P=S" (without the quotation marks). For creating a license that will NOT work through the license server enter the string "P=N" (without the quotation marks). "Host id (if locking to a single host):" Enter the value 'any'. If you want to create additional feature enter the next feature name. Now that the makekey is completed you can use this license file or incorporate the created feature for you application in your existing license file. |
| Thank you, The Magic Version 8 Team |