Making applications licensable for integration system vendors

When licensing AR System applications, you have two options:

• Application licensable—Users must obtain an "application license" so that they can access the form data in the application. Without a valid application license installed on the server, users receive a licensing error when they try to perform any data-related operations on forms in the unlicensed application. In other words, they cannot get, modify, search, create, delete, or merge entries on any form.
• Application and form licensable—In addition to the requirements for the application licensable option, users must obtain user-fixed or user-floating licenses based on individual forms. The application developer can select which forms in the application to make "user licensable," and users must have an application user license to access form data on these forms. These are the application user license types:
  • Fixed
  • Floating

  • Read
    Fixed and floating licenses have no restrictions and enable users to get, modify, search, create, delete, and merge entries. Read licenses enable users only to search, get, and create entries.

    Operation on entries	License requirements
    Create	Does not need application or application user license.
    Get	Needs application license only.
    Modify	Needs application and application user license.
    Delete	Needs application and application user license.
    Merge	If a merge operation results in a create, does not need application or application user license. If a merge operation results in a modify, needs application and application user license.

By default, an application comes with zero fixed licenses, zero floating licenses, and an unlimited number of read licenses. If users are not assigned a fixed or floating license, they automatically use a read license by default. Guest users automatically use a read license.

This feature is intended to license your access to form data in the application; it is not intended to license administrative operations such as modifying forms or workflow in an application. Even if no application license is installed for a licensable application, administrators can still change or delete a form or workflow object.

The procedures in this topic are intended for use only by authorized ISVs who plan to license their applications for sale. If you are not an ISV and you create Remedy applications that you want to license for sale, see the BMC Customer Support website (http://www.bmc.com/support) for details.

To configure your applications to make them licensable

In this procedure, the MusicManager application contains three forms, but you want to make only one of them (MusicManager Songs) user licensable.

1. Select Application > License Application. 
   
   Application Licensing dialog box
   

2. From the Licensing Mode menu, select one of the following options:

   Option	Description
   Do not license this application	Application is not licensed. Typically, you use this default option if you do not intend to sell this application or if the application is for internal use only.
   License this application	Entire application is licensed. An application license must be added to the Add or Remove Licenses form for users to access the form data in the application.
   Enable user licensing of this application and forms	Specific forms in the applications can be made user-licensable. You decide which forms to make licensable. Users must obtain a user license to create, modify, merge, or delete form data. These licenses can be fixed, floating, or read. Users have read license permission if they are not assigned fixed or floating licenses. By choosing which forms in your application to make user-licensable, you can customize the user licensability of your application.

3. In the Product Name field, enter the application license string, or in this scenario, XYZ:MusicManager.
4. If you enable user licensing for the application and its forms, perform one of these actions:
   • Click inside the User Licensable list adjacent to the form you want to license, then select Yes or No. Repeat for other forms.
   • To license all forms in your application, click Select All.
   • To clear all forms from the User Licensable list, click Clear All.
     This step is optional for applications and is needed only to make forms in your application user licensable.
5. Click OK.

Adding the application license to your server

Customers license ISV applications just like any other AR System application. The only difference is the unique naming convention of the application itself, indicating that the application comes from an ISV.  For information about adding application licenses to servers, see the Working with Remedy AR System licenses.