Developer Testing Licenses

This chapter explains the complimentary Micro Focus Server licenses that are provided for application testing.

In this Chapter

Introduction

To test your applications developed using Server Express, you need to run them under Micro Focus Server.

When you install Server Express, complimentary Micro Focus Server licenses are automatically generated and installed on the same machine. These are called Developer Testing Licenses. You are allowed to use them only for testing applications, on the machine containing your Server Express. These licenses are are linked to the directory in which your Server Express is installed, as defined by the $COBDIR environment variable

You cannot use Developer Testing Licenses for system testing, production or deployment, or any reason other than to test the application. They allow you to run both from Animator and from the command line.

Developer Testing Licenses behave like server licenses (concurrent processes).

The number of Developer Testing Licenses generated is as follows: for each Server Express license on the machine, you get five licenses for the base Micro Focus Server, and one license for Enterprise Server.

Unlike Micro Focus Server licenses for end users, Developer Testing Licenses for the base Micro Focus Server are not equivalent to Developer Testing Licenses for Enterprise Server.

If your Server Express is from Enterprise Edition, then the generated license for Enterprise Server is an Micro Focus Server Enterprise Edition license, allowing you to run applications including those using CICS or JCL. Otherwise, it is a Micro Focus Server Premier Edition license, which does not allow applications using CICS or JCL to run.

Installing Developer Testing Licenses

Developer Testing Licenses are by default standard licenses if you are using Model 1 licensing, or server licenses (concurrent processes) if you are using Model 2 licensing, as descrbed in the section Types of Licenses in the Introduction chapter.

Developer Testing Licenses are automatically installed or uninstalled on the license database, whenever you install or uninstall Server Express licenses. You do not need to run AppTrack.

You might need to take special action in one instance. If you already have a licensed Micro Focus development system (such as Server Express or Object COBOL Developer Suite) installed from a previous version or update, you need to trigger the automatic installation of the Developer Testing Licenses corresponding to the Micro Focus development system licenses you already have. To do this:

  1. Change to the directory in which the licenses for your Micro Focus development system are installed. By default, this is either /usr/lib/mflmf or /opt/lib/mflmf
  2. Type the command sh ./devas at the prompt

    For example:

    cd /usr/lib/mflmf
    sh ./devas

You only need to run this command once; however, running it again causes no problems.

If you need more Micro Focus Server licenses for testing your application than those automatically generated, you must purchase additional Micro Focus Server licenses. You can then install them as described in the section Installing and Uninstalling Licenses Using AppTrack in the chapter Installing and Administering Micro Focus Server Licenses. However, you must install them using the Apptrack in the development system, that is, when you enter $COBDIR/aslmf/apptrack, $COBDIR must point to the installation directory of the development system.

Linking Micro Focus Server Licenses to a New Development System

If you receive an updated version of your Micro Focus development system, you might want to install it to a new location so that you can continue to use the older version until you are satisfied that your applications work correctly on the new system. The complimentary Developer Testing Licenses that are automatically installed for testing applications are available on both the old and the new development systems.

However, any additional Micro Focus Server licenses that you have installed are, by default, not available to the newly installed system, because the licenses are linked to the directory in which your development system is installed. This directory is defined by the $COBDIR environment variable

To link the Micro Focus Server licenses to the location of the new development system, add a line to the text file DEVASSHARE in the installation directory of the new development system. This line should specify the name of the installation directory path of the original development system. The file must have general read permissions for all users. If this file does not exist, create it with a text editor and give it full read permissions. You can have multiple lines in this file, referencing multiple Micro Focus development systems.

For example, if the the original development system is installed in /usr/original/dev and the new development system is installed in /usr/new/dev, DEVASSHARE should contain the line:

/usr/original/dev

Problems Using Developer Testing Licenses

If you test an application and get a message telling you that there are no licenses available, this might be because the license database does not contain the Developer Testing Licenses.

You can check that these Developer Testing Licenses exist by using License List in AppTrack. There should be entries marked **AS Developer Usage or **ES Developer Usage or **MTO Developer Usage for the installed development system. AS or ES indicates a Micro Focus Server Premier Edition license; MTO indicates a Micro Focus Server Enterprise Edition license.

To monitor licenses

If you cannot find these entries:

  1. Run the License Administration Services as described in the section Starting the License Manager in the chapter Administration Tasks in your Development System Licensing Guide.
  2. Press F7=refresh

    The missing Developer Testing Licenses are installed onto the license database. The application can now be run.