sntl_lg_start Screen

Description

Starts the license definition process using the provided parameters. This function resets any license definition that may have been entered for the current handle. The sntl_lg_start screen contains the following fields:

License type

Select one of the available license types.

Vendor Code

If you are working online, this field displays an automatically generated list of Vendor Codes. Select the code that you require.

If you are not working online, use the browse button to navigate to and select the required Vendor Code file.

For more information about Vendor Codes, refer to the Sentinel LDK Software Protection and Licensing Guide (for Sentinel EMS or Sentinel LDK-EMS).

Current state

Path of a C2V file that contains the current state of the target license store (if any).

Use the browse button to navigate to and select the required C2V file.

The current state can be one of the following: NULL, resultant key state, fingerprint, acknowledgment received from end user after installation of a V2C file, or contents of a C2V file from a protection key.

>Fingerprint is used to generate the licenses for SL-AdminMode or SL-UserMode keys. It can also be used to generate a Trusted Storage Authorization file.

>The state may be left empty (NULL) to validate an input license definition without generating a license.

>The state must be left emtpy (NULL) to generate an Unlocked license or a generic update license.

The resultant key state is the value that was assigned to the 'resultant_state' parameter by the sntl_lg_generate_license() function in an earlier license generation cycle.

License Template

Select the template that most closely matches the license definition you want to create. An asterisk ("*") is displayed if you modify the license definition after selecting the license template.

License Definition

Definition of the license to be introduced. Leave this field empty if you do not want to introduce a license definition using this function.

For more information on XML tags for license definition, see License Definition Input XML Templates.

You can manually modify the XML code for the license definition in this field. You can also use the provided graphical interface to modify or replace the license definition. To access the graphical interface or for additional functions, use any of the following buttons:

New Definition

Displays a dialog box to enter a complete license definition. The XML code generated from this dialog box completely replaces the content of the License Definition field.

Delete Current Block

Deletes the block of XML code that contains the cursor. The XML code to be deleted is displayed in a dialog box and is deleted only after you confirm the action.

Edit Current Block

Displays a dialog box with information based on the current location of the cursor in the XML code. This enables you to easily set or change parameter values. When you click OK in the dialog box, the XML code in the License Definition field is automatically modified as required.

Check XML Code

Validates the XML code that you specified in the License Definition field.

Save As

Exports the XML code in the license definition to an external file.

Select a template and click Manage Templates to display the License Template Manager dialog box.

Click Save Template to open the Save Template dialog box. You can overwrite an existing template, or save a modified template with a new name.

Click OK to save, or Cancel to close the dialog box without saving.

Click Execute to transfer the function and field definitions to the Sentinel License Generation API. After the function is executed, corresponding values are displayed in the status fields and the executed function call is logged in the API Call History.

Related Topics

sntl_lg_start()

License Definition Example

License Definition Input XML Templates

Generated Code Pane

API Call History

Function Pane