|
|
Polling for a License |
|
|
Polling for a License |
Use CHECKIN and CHECKOUT to manage Alchemy CATALYST licenses within ezScript. These commands only function correctly if you've deployed the Alchemy NLM (Network License Manager) software on a server.
Catalyst /LICENSE CHECKOUT:server_name [HOURS:n_hours RETRY:n_times INTERVAL:n_seconds]
Catalyst /LICENSE CHECKIN:server_name [CLIENT:client-machine-name] [ezLogFile:ezLogFile] [/write] [/open]
|
/License |
Polls for a license |
|
CHECKOUT:server_name |
Checkout an available license from server_name. (An Alchemy NLM Server).
server_name can also be used to pass the path to a license file containing the appropriate license server information. |
|
CHECKIN:server_name |
Checkin and return your license to server_name (An Alchemy NLM Server).
server_name can also be used to pass the path to a license file containing the appropriate license server information. |
|
CLIENT:client-machine-name |
When a license on a machine was checked out when a user was connected via Remote Desktop Services and tries to return the license when connected to the same machine but via a different client machine. |
|
HOURS:n_hours |
The number of hours the licence is required for. Minimum value 1 hour, maximum 336 hours (14 days). The default duration when not specified is 24 hours. |
|
RETRY:n_times |
The number of times to retry a Checkout request if no license is available on the server. The default is 1 retry. |
|
INTERVAL:n_seconds |
The interval, in seconds, between retries. Minimum is 10 seconds. The maximum is 600 seconds. The default value is 60 seconds.
The maximum overall time allowed for pooling the license is the equivalent of 1209600 seconds (14 days). |
|
ezLogFile:ezLogFile |
The user can optionally specify a log file to which results of each Catalyst ezScript command are output. If the log file is not specified by the user or is invalid, the default log file (ezScriptBatchLog.txt in the Public location) is used. |
|
/write |
The command line which has been processed by Catalyst will be written into the ezScript batch log file. This will help to debug your command if something is not behaving as expected. |
|
/open |
Launches MS Notepad and displays the content of ezScript batch log when the command finishes. |
Checkout a license from Server01
Catalyst /LICENSE CHECKOUT:Server01
Checkout a license from Server01, polling every 20 seconds for a maximum of 60 retries.
Catalyst /LICENSE CHECKOUT:Server01 HOURS:8 RETRY:60 INTERVAL:20
Return a license to Server01
Catalyst /LICENSE CHECKIN:Server01
Checkout a license from the server listed in the file MyClient.lic which was configured with the appropriate license server information
Catalyst /LICENSE CHECKOUT:"C:\Users\Public\Alchemy Software\Catalyst 10.0\MyClient.lic"
Mary has 2 machines. Machine01 and Machine02. She has logged onto a build machine called CodeBuilder from Machine01 and set off some ezScript batch files. The Catalyst license resides on a machine called LicenseServer. Later that same day, the Mary connects to CodeBuilder using the same user name and password but has connected from Machine02. To successfully return that license which was borrowed during a remote desktop session to Machine01, the following command must be used.
|
Catalyst /LICENSE CHECKOUT:LicenseServer |
'Remote desktop session started from Machine01 onto CodeBuilder. |
|
Catalyst /LICENSE CHECKIN:LicenseServer CLIENT:Machine01 |
'Remote desktop session started from Machine02 onto CodeBuilder. |
