All Cadence products should support queuing for licenses as an option. Check the product's documentation on how to enable queuing. When a Cadence application queues for a license, all queued requests are attached to the first server containing the requested feature in the license server path. Even as licenses become available on other servers in the path, the request will remain queued on the first server. This is the default FlexNet behavior.
Cadence now supports an optional polling option, which allows the application to poll other servers in the server path for available licenses while queued on the first server. When there are enough licenses to satisfy the queued request, the application will check out the available licenses and dequeue from the attached server.
Note: Please note that this option has just been made available and not all Cadence products would have implemented this option yet. Please check the product notes to ascertain whether this option is supported.
Even when the product supports this option, it is turned off by default. To turn on the option, set the environment variable CDS_LIC_QUEUE_POLL as follows:
If you are using Bourne or ksh:
CDS_LIC_QUEUE_POLL=1;
export CDS_LIC_QUEUE_POLL;
If you are using csh:
setenv CDS_LIC_QUEUE_POLL 1;
Polling Interval
The polling interval depends on how often the application polls. But the minimum poll interval is set to 30 seconds.
To increase the polling interval, set the environment variable CDS_LIC_QUEUE_POLL_INT as follows:
If you are using Bourne or ksh:
CDS_LIC_QUEUE_POLL_INT=n;
export CDS_LIC_QUEUE_POLL_INT;
If you are using csh:
setenv CDS_LIC_QUEUE_POLL_INT n;
where n is greater than 30 seconds.
If CDS_LIC_QUEUE_POLL_INT is set to a value less than 30 seconds, it will be reset back to 30 seconds.
Server reset timeout when queued for a license
If polling encounters a condition where the server was reset, it will attempt to re-establish connection with the server. If it fails to reconnect with the server within a timeout, the resulting behavior is dependent on the individual running application.
The default timeout is 5 minutes (300 seconds).
To increase the queue retry, set the environment variable CDS_LIC_QUEUE_RETRY_TIMEOUT as follows:
If you are using Bourne or ksh:
CDS_LIC_QUEUE_RETRY_TIMEOUT=n;
CDS_LIC_QUEUE_RETRY_TIMEOUT;
If you are using csh:
CDS_LIC_QUEUE_RETRY_TIMEOUT n;
where, n is greater than 300 seconds.
If CDS_LIC_QUEUE_RETRY_TIMEOUT is set to a value less than 300 seconds, it will be reset back to 300 seconds.
A complete polling operation for a queued license consists of checking the servers for available licenses, performing a checkout, and dequeuing. Thus, the run time of an application can be longer with the option turned on and when there are many licenses queued. The polling time will also depend on the number of servers to search and their location settings. The server logging will also show more activity than usual with the option turned on.
