URL: http://www.firstbasesoftware.com/man/man8/fbgetlicense.htm
Last modified: 12 September 1995
Copyright © by FirstBase Software.
[
Index of Contents] [
FirstBase RDBMS Overview]
To obtain a floating license from the pool of network licenses, use the fbgetlicense command. If a license cannot be granted at the moment, the user is allowed to enter onto a queue awaiting the next available license. When a license is available, it will be granted without having to enter any more requests. A message is displayed when a license is granted. Commands to determine position in the queue and queue removal are also provided.
Similarly, fbputlicense is used to return the license to the available pool of network licenses. A message is issued on completion.
The -b option will execute these tools in a standard type of FirstBase batchmode which produces no output. The -n option forces fbgetlicense to not attempt to queue up awaiting a license.
Additionally, each of these tools will return a status of zero (0) when successful, and a non-zero status (1) when a failure has occurred. Also, fbgetlicense will return a status of two (2) if a FirstBase license is already been retrieved for the current user. Shell scripts can test this status after execution of fbgetlicense to determine whether or not to continue.
The FirstBase menu tool, dbshell(1), uses fbgetlicense and fbputlicense automatically to allow a smooth interface with the FirstBase Floating License system.
NOTE: To enable the FirstBase floating license mechanism, set the FirstBase environment variable SERVER to the machine name of the file server.
FirstBase User's Guide and Reference Manual