[Flexlm] Flexlm error code

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.