listLMLicenses

Lists the licenses that currently exist for the given Licensee and (optionally) customer and pool.

Parameters:

Field
Type
Required Description
sessionid String yes The sessionid returned by loginLMLicensee()
licensee String yes The company code (not the company name) for the Licensee.
customer String no The company code (not the company name) for the Customer.
pool String no The name of the customer's pool. If this is filled in, then customer must be filled in too. If the pool does not have a name, then passing "Pool ##" where ## is the pool number will also work.


Return values: A LicenseCountList structure:

Field
Type
Description
counts Array of LicenseCount A list of license information, one row per unique expiration date.
fault FaultData If an error has occurred on the server, this will contain information about the error. This field will be null if no error occurred.

LicenseCount

Field
Type
Description
count int The number of licenses for the specified licensee/customer/pool.
countFree int The number of unused licenses for the specified licensee/customer/pool.
expirationData long The expiration/paid-to date of the group of licenses. The date is given as the number of milliseconds since January 1, 1970 (a standard Java time value).

Example:

NitroAdminAccessServiceLocator service = new NitroAdminAccessServiceLocator();
NitroAdminAccess server = service.getNitroAdminAccess();
LicenseCountList list = server.listLMLicenses(sessionid, "smith", "cust1", "Pool 18");
if (list.getFault()!=null) {
	System.err.println("Error: " + list.getFault().getFaultString());
	return;
}
if (list!=null && list.getCounts()!=null) {
        LicenseCount rec;
        for (int i=0; i<list.getCounts().length; i++) {
                rec = list.getCounts(i);
                // report on contents of count object
        }
}
Comments