LCHECKOUT() Function - Check Out License

For BBj-specific information, see LCHECKOUT() Function - BBj.

Syntax

LCHECKOUT(feature,version {,nagOnFailure} {,ERR=lineref})

Description

In PRO/5 Rev. 3.10 and higher, the LCHECKOUT function checks out one license of the specified feature. LCHECKOUT returns an integer handle. The version is a string that contains a number that can be less than or equal to the version that is available. An attempt to checkout a license for a version that is greater than the version that is available will fail. LINFO(handle,1,1) can be used to determine which version was actually checked out. For more information about using licenses in your application (FLEXlm/FLEXnet Application Licensing), please contact your sales representative.

In BBj 9.0 and higher, the optional numeric parameter nagOnFailure is available. If this value is set to be non-zero and the lcheckout fails, BBj will nag the user about the failed checkout. The nag will continue until the specified feature/version is successfully checked out or until the program executes START.

See also LCHECKIN Verb - Check In License and LINFO() Function - License Information.

Example

B=LCHECKOUT("ACCTRECEIVE","1.0",ERR=210)