Licensing Errors

General Errors

• A license contains a maintenance period. If the build date of a WinCC OA version (e.g. a new patch update) is younger than the maintenance period, the project cannot be started with the WinCC OA license. The following log message is written. Contact ETM to obtain a new license.

  WCCILevent (0), <date time>, SYS,  SEVERE,  105, Invalid license, Software Update Service expired. WinCC OA build date: <date time>

• If the license server cannot be reached the following log message is written.

  WCCILevent (0), <date time>, SYS,  SEVERE,  105, Invalid license, CodeMeter descriptor check for event (9921) returned: CodeMeter License Server not found, Error 101.

• The following log message occurs when a UI license is retrieved and the container is unreachable.

  WCCILevent (0), <date time>, SYS,  SEVERE,  105, Invalid license, CodeMeter request for: ui (9724) - in CmContainer 3-4736112 - returned: A network error occurred, Error 100.

• When the time period for the "7-day license mode" has expired, the following log message is written.

  WCCILevent (0), <date time>, SYS, FATAL, 105, Invalid license, License lost and grace period expired

• If a license has been re-hosted or the license dongle has been removed, at the next cyclic check (after a maximum of 10 minutes) the following log messages are written:

  WCCILevent   (0), <date> 16:41:21.039, SYS,  SEVERE,    105, Invalid license, CodeMeter descriptor check for event (9921) returned: An invalid handle was specified, Error 106.
  WCCILevent   (0), <date> 16:41:21.040, SYS,  SEVERE,    105, Invalid license, CodeMeter descriptor check for ios (9922) returned: An invalid handle was specified, Error 106.
  WCCILevent   (0), <date> 16:41:21.044, SYS,  WARNING,   105, Invalid license, 10070 minutes left.
  WCCILevent   (0), <date> 16:51:22.012, SYS,  WARNING,   105, Invalid license, 10060 minutes left.
  WCCILevent   (0), <date> 17:01:23.029, SYS,  SEVERE,    105, Invalid license, Disabling para-license because cyclic license check found no valid license
  WCCILevent   (0), <date> 17:01:23.029, SYS,  WARNING,   105, Invalid license, 10050 minutes left.
  WCCOAui      (1), <date> 17:01:23.029, SYS,  FATAL,     105/_errors, Invalid license, Shutdown para because it is not licensed

  The information "Invalid license, <N> minutes left" is written at each license check (10-minute interval). If the license cannot be restored within 30 minutes, all UI managers with "PARA" option are shut down. This is documented by the log message "Shutdown para because it is not licensed". The system runs in "7-day license mode".

  The number of invalid handle messages depends on which license options were pulled from the running project.

• If a network error occurs when using a license server, the log message below is written. The behavior afterwards is the same as for re-hosted licenses: 7 days grace period and the remaining time is displayed every 10 minutes until the WinCC OA Event Manager shuts down.

  WCCILevent (0), <date time>, SYS, SEVERE, 105, Invalid license, CodeMeter descriptor check for event (9921) returned: CodeMeter License Server not found, Error 101.

• The license was activated again. On the next cyclic check (after maximum of 10 minutes) or on applying any value change to _Event.ReadLicense, the following message indicates a valid license:

  WCCILevent (0), <date time>, SYS, INFO, 108, License information, License recovery was successful - all CodeMeter descriptors are valid

License option Errors

• If a license option is not available, the following log message is written. In this example a license for the WinCC OA feature "recipe" is missing. Purchase a license or activate a license by using the license ticket ID - see chapter License Activation with Online PC.

  WCCILevent (0), <date time>, SYS, SEVERE, 105, Invalid license, CodeMeter request for: recipe (95261) - in CmContainer 3-4800804 - returned: CmContainer Entry not found, Error 200.

• If the available number of licenses for a particular option is already in use in a container, the following log message is written. In this example, all UI licenses are already in use.

  WCCILevent (0), <date time>, SYS, SEVERE, 105, Invalid license, CodeMeter request for: ui (9724) - in CmContainer 130-2851789952 - returned: The user maximum of the CodeMeter license is reached, Error 21

Container Errors

• If a container is not found because a wrong container number was specified (config entry "[general] useCMContainerSerialNumber), the following log message is written. Specify a correct container number.

  WCCILevent (0), <date time>, SYS,  SEVERE,  105, Invalid license, Requested CodeMeter container 4-5678 not found

Errors when changing container at runtime

The DP element _Event(_2).License.setCMContainer can be used to change the CodeMeter container used at runtime. If errors occur while setting the container, the following log messages are written.

• A wrong container number was written to the DP element _Event(_2).License.setCMContainer.

  WCCILevent (0), <date time>, SYS,  SEVERE,  105, Invalid license, Requested CodeMeter container 4-12345678 not found

• The container could not be changed.

  WCCILevent (0), <date time>, SYS, SEVERE, 108, License information, Container change: Error getting license for event 

• The release of a licensing option is not possible, because a switchover of the license container is in progress.

  WCCILevent (0), <date time>, SYS, WARNING, 108, License information, License operation "connection close" blocked due to service operation running

• The already used container number was written again to the DP element _Event(_2).License.setCMContainer.

  WCCILevent (0), <date time>, SYS, SEVERE, 108, License information, Container change: repeated container identification string "130-121432558"