License management
Learn important information about the licenses for your HCL Link product.
- Registering the host computer with the license server
  Before you can run a licensed feature, the computer where the feature is installed must register with the license server. Registering the computer’s host name enables HCL Link to obtain the licenses required to run licensed features on that computer.
- License feature names
  The license names of the HCL Link features display in the entitlement on the license server and in the messages that the runtime servers log. The feature names are also keywords of the dtxlicutil -view command.
- License allocation and persistence
  A license is required for each logical processor on the host computer where the licensed feature runs. The number of logical processors is the number of physical processors, or cores, multiplied by the number of virtual processors.
- License availability and usage
  An entitlement must have enough licenses available for the number of logical processors on the requesting host. If there are not enough available licenses for all logical processors, the request fails and the host does not acquire any licenses.
- License status on the host computer
  The dtxlicutil -local command displays the licenses that the host computer currently has. The available count and maximum count reflect the number of logical processors on the host computer, so the values for a single host are always the same.
- Releasing licenses
  Use the dtxlicutil -release command to release the licenses of all features from a host computer. The licenses return to the entitlement pool, where they are available for other hosts to acquire.
- Acquiring licenses
  After a host computer releases a license, you can request the license again by running the dtxlicutil -acquire command on the host...
- Troubleshooting license errors
  - License-message logging for runtime features
  - License-message logging for Pack features
- The dtxlicutil command
  The dtxlicutil command works with the licensed features of HCL Link HCL Link. Use it to register a computer with a license server, acquire or release licenses, and display details about license usage for an entitlement.

License-message logging for Pack features

When a map fails because HCL Link cannot acquire the required Pack license, the error is logged in the map audit log as well as in the runtime log. The audit log specifies mapreturn=40 error code when a license is not available for the Pack for Financial Payments, the Pack for Healthcare, or the Pack for Supply Chain EDI. For example:


<MapAudit StartTime="05:47:20 February 7, 2018"> 
<Platform>Command Server for Windows - Version 9.0.1(31)</Platform> 
<ExecutionSummary MapStatus="Error" mapreturn="40" ElapsedSec="27.8466" BurstRestartCount="0"> 
<Message>Feature does not have a valid license</Message> 
<CommandLine>c:\temp\testput.mmc -ae -if1 readme.txt</CommandLine> 
</ExecutionSummary> 
</MapAudit>