FLEXlm Error Codes

> ## Appendix E

> ## FLEXlm Error Codes

> ### E.1 Error Message Format

> FLEXlm error messages presented by applications have the following components:

> - FLEXlm Error Number—a negative number starting at -1.
> - FLEXlm Error Text—short sentence (< 80 characters) summarizing problem.
> - FLEXlm Error Explanation (optional)—short paragraph (3-5 lines) explaining problem and possible solutions or workarounds.
> - FLEXlm Minor Error Number—a positive number starting at 1. These numbers are unique error identifiers and are used by FLEXlm vendors for more advanced support assistance. Their meaning is not documented.
> - System Error Number (optional)—a UNIX or Windows OS error code last set by the operating system.
> - System Error Explanation (optional)—a short sentence (< 80 characters) explaining the system error.
> - Other supporting information (optional)

> Error messages were improved in v6. FLEXlm Error Explanation, and supporting information are only available in applications using v6.0+.

> These error messages may occur in two formats available with FLEXlm or may appear in a format customized by the application.

> #### E.1.1 Format 1 (short):

> FLEXlm error text (-`lm_errno`, `minor_num`[:`sys_errno`]) [`sys_error_text`]

> The system error information may be missing.

> Example:

> Can’t connect to license server (-15,12:61) Connection refused

> #### E.1.2 Format 2 (long—version 6.0+):

> FLEXlm error text
> FLEXlm error explanation
> [Optional Supporting information]
> FLEXlm error: -`lm_errno`, `minor_num.` [System Error: `sys_errno`] [“`system_error_text`”]

> Example:

> Cannot connect to license server
> The server (lmgrd) has not been started yet, or
> the wrong port@host or license file is being used, or the
> port or hostname in the license file has been changed.
> Feature: f1
> Server name: localhost
> License path: @localhost:license.dat:./*.lic
> FLEXlm error: -15,12. System Error: 61 “Connection refused”

> ### E.2 Error Code Descriptions

> The following table lists the most common errors produced by FLEXlm-licensed products.

> Table 8-1: FLEXlm Error Codes
> Error Code | Description
> --- | ---
> -1 | Cannot find license file.
> -2 | Invalid license file syntax.
> -3 | No server for this feature.
> -4 | Licensed number of users already reached.
> -5 | No such feature exists.
> -6 | No TCP/IP port number in license file and FLEXlm service does not exist. (pre-v6 only)
> -7 | No socket connection to license manager service.
> -8 | Invalid (inconsistent) license key or signature. The license key/signature and data for the feature do not match. This usually happens when a license file has been altered.
> -9 | Invalid host. The hostid of this system does not match the hostid specified in the license file.
> -10 | Feature has expired.
> -11 | Invalid date format in license file.
> -12 | Invalid returned data from license server.
> -13 | No SERVER lines in license file.
> -14 | Cannot find SERVER host name in network database. The lookup for the host name on the SERVER line in the license file failed. This often happens when NIS or DNS or the hosts file is incorrect. Workaround: Use IP address (e.g., 123.456.789.123) instead of host name.
> -15 | Cannot connect to license server. The server (`lmgrd`) has not been started yet, or the wrong `port``@``host` or license file is being used, or the TCP/IP port or host name in the license file has been changed.
> -16 | Cannot read data from license server.
> -17 | Cannot write data to license server.
> -18 | License server does not support this feature.
> -19 | Error in select system call.
> -21 | License file does not support this version.
> -22 | Feature checkin failure detected at license server.
> -23 | License server temporarily busy (new server connecting).
> -24 | Users are queued for this feature.
> -25 | License server does not support this version of this feature.
> -26 | Request for more licenses than this feature supports.
> -29 | Cannot find ethernet device.
> -30 | Cannot read license file.
> -31 | Feature start date is in the future.
> -32 | No such attribute.
> -33 | Bad encryption handshake with daemon.
> -34 | Clock difference too large between client and server.
> -35 | In the queue for this feature.
> -36 | Feature database corrupted in daemon.
> -37 | Duplicate selection mismatch for this feature. Obsolete with v8.0+ vendor daemon.
> -38 | User/host on EXCLUDE list for feature.
> -39 | User/host not on INCLUDE list for feature.
> -40 | Cannot locate dynamic memory.
> -41 | Feature was never checked out.
> -42 | Invalid parameter.
> -47 | Clock setting check not available in daemon.
> -52 | FLEXlm vendor daemon did not respond within timeout interval.
> -53 | Checkout request rejected by vendor-defined checkout filter.
> -54 | No FEATURESET line in license file.
> -55 | Incorrect FEATURESET line in license file.
> -56 | Cannot compute FEATURESET data from license file.
> -571 | socket() call failed.
> -59 | Message checksum failure.
> -60 | Server message checksum failure.
> -61 | Cannot read license file data from server.
> -62 | Network software (TCP/IP) not available.
> -63 | You are not a license administrator.
> -64 | lmremove request before the minimum lmremove interval.
> -67 | No licenses to borrow.
> -68 | License BORROW support not enabled.
> -69 | FLOAT_OK can’t run standalone on SERVER.
> -71 | Invalid TZ environment variable.
> -73 | Local checkout filter rejected request.
> -74 | Attempt to read beyond end of license file path.
> -751 | SYS$SETIMR call failed (VMS).
> -76 | Internal FLEXlm error—please report to Macrovision.
> -77 | Bad version number must be floating-point number with no letters.
> -82 | Invalid PACKAGE line in license file.
> -83 | FLEXlm version of client newer than server.
> -84 | USER_BASED license has no specified users - see server log.
> -85 | License server doesn’t support this request.
> -87 | Checkout exceeds MAX specified in options file.
> -88 | System clock has been set back.
> -89 | This platform not authorized by license.
> -90 | Future license file format or misspelling in license file. The file was issued for a later version of FLEXlm than this program understands.
> -91 | ENCRYPTION_SEEDS are non-unique.
> -92 | Feature removed during lmreread, or wrong SERVER line hostid.
> -93 | This feature is available in a different license pool. This is a warning condition. The server has pooled one or more INCREMENT lines into a single pool, and the request was made on an INCREMENT line that has been pooled.
> -94 | Attempt to generate license with incompatible attributes.
> -95 | Network connect to `this_host` failed. Change `this_host` on the SERVER line in the license file to the actual host name.
> -96 | Server machine is down or not responding. See the system administrator about starting the server, or make sure that you’re referring to the right host (see `LM_LICENSE_FILE` environment variable).
> -97 | The desired vendor daemon is down. 1) Check the `lmgrd` log file, or 2) Try lmreread.
> -98 | This FEATURE line can’t be converted to decimal format.
> -99 | The decimal format license is typed incorrectly.
> -100 | Cannot remove a linger license.
> -101 | All licenses are reserved for others. The system administrator has reserved all the licenses for others. Reservations are made in the options file. The server must be restarted for options file changes to take effect.
> -102 | A FLEXid borrow error occurred.
> -103 | Terminal Server remote client not allowed.
> -104 | Cannot borrow that long.
> -106 | License server out of network connections. The vendor daemon can't handle any more users. See the debug log for further information.
> -110 | Dongle not attached, or can’t read dongle. Either the hardware dongle is unattached, or the necessary software driver for this dongle type is not installed.
> -112 | Missing dongle driver. In order to read the dongle hostid, the correct driver must be installed. These drivers are available at www.macrovision.com or from your software vendor.
> -113 | Two FLEXlock checkouts attempted. Only one checkout is allowed with FLEXlock-enabled applications.
> -114 | SIGN= keyword required, but missing from license. This is probably because the license is older than the application. You need to obtain a SIGN= version of this license from your vendor.
> -115 | Error in Public Key package.
> -116 | CRO not supported for this platform.
> -117 | BORROW failed.
> -118 | BORROW period has expired.
> -119 | lmdown and lmreread must be run on license server machine.
> -120 | Cannot lmdown the server when licenses are borrowed.
> -121 | FLOAT_OK license must have exactly one dongle hostid.
> -122 | Unable to delete local borrow info.
> -123 | Support for returning a borrowed license early is not enabled. The vendor must have enabled support for this feature in the vendor daemon. Contact the vendor for further details.
> -124 | An error occurred while returning a borrowed license to the server.
> -125 | Attempt to checkout just a PACKAGE. Need to also checkout a feature.
> -126 | Error initializing a composite hostid.
> -127 | A hostid needed for the composite hostid is missing or invalid.
> -128 | Error, borrowed license doesn't match any known server license.

> 1Indicates errors due to an operating system failure.

FLEXlm End Users Guide
July 2003