UPDATELIC {ERR=lineref}
Available in Visual PRO/5 4.12 and higher and BBj 4.0 and higher, the UPDATELIC verb automatically registers and installs license files for a BASIS License Manager 8.4 and higher for Windows. To use the UDATELIC verb, first complete a successful manual registration for the machine on which the BLM is installed. All platforms support UPDATELIC. However, on UNIX systems, the developer must connect the BLM directly to the internet without a proxy.
The UPDATELIC verb performs the following functions:
Sends the update license request to the current BLM.
Obtains license registration information on the server machine from the registry values under the registry key: KEY_LOCAL_MACHINE\SOFTWARE\BASIS\BasisReg. The user obtains this information by performing the license registration either from the VPRO/5/BBj installation program or by running ‘Register for a License’ from the BASIS shortcut or from the BASIS Admin tool.
Connects to the BASIS license generator using sockets via HTTP protocol, submits registry information, and obtains the appropriate license file.
Ensures that this license file is not already installed.
Ensures that this license file is the correct license for the machine (validates the hostid).
Checks for conflicting licenses by scanning the appropriate license directory, reading all license files for same feature(s), and renaming conflicting files to have an extension of .bak.
Installs the license file into the appropriate directory.
The BLM performs a re-read function in order to obtain a new license file.
<BLM install dir/autolic.log> contains an activity log.
UPDATELIC does not work with a redundant server configuration since the client issuing the command is speaking to only one vendor daemon, and only one BLM (the master) gets the update request. The user will see the following error if this is attempted:
!ERROR=99 (lmutil lmreread failed)
When the UPDATELIC verb fails, the resulting !ERROR=99 has a TCB(10) value containing either a positive BASIS internal error or a negative system error. The following is a list of the possible BASIS internal errors that TCB(10) could return:
1 A successful manual registration was not completed.
2 The requested license was already installed.
3 The provided registration information was invalid.
4 Sending the http request failed.
5 The hostid in the returned license file does not match the server machine.
6 The license returned from the BASIS license generator was invalid.
7 The BASIS License Manager directory was not found.
8 The license file could not be created.
9 The license file could not be read/written.
10 The license file could not be renamed.
50 Cannot connect to license server
51 Not supported by license server
52 Not possible while in nag mode
53 Cannot update a single user license
To retrieve the string associated with the TCB(10) value, call the LINFO(0,3,0) function.
The values for the expiration dates returned from INFO(2,6) & LINFO(handle,0,2) functions will not be updated until the interpreter is restarted.
Update a license being served by a BLM:
|
0010 BEGIN |