Skip to content

Troubleshooting

This section describes problems you may encounter and how to solve them.

Invalid Value for Key

If you receive the following messages:

LIC0161E Invalid value for "Key" element: (Line nn, Column nn).
LIC0102E License utility terminated with errors. Return code 12.

it is probably because you modified the license data, which caused the Key element to become invalid.

To correct this error, rerun the LICUPDAT program with the unmodified license as you received it from Micro Focus.

No Applications with Valid Licenses or No License Found

With the XML licensing format, there is a change to the SERNET started task. The apl keyword, formerly used to assign a TCP/IP port to an instance running under the task, now also has the function of starting the specified instance. For example, one of the values of the apl keyword is ZDD. Coding "ZDD=portid" (or "ZDD" alone tells the SERNET started task that you want to run ChangeMan ZDD under this SERNET instance.

This new function of the SERNET apl keyword applies to all products that run as an instance under SERNET. If your product install guide contains a section on "SERNET Keyword Options", you can see all possible values of the apl keyword.

With this new on/off switch you may receive messages similar to the following:

SERxxxxE No applications with valid licenses; Shutting down

This message may indicate that there is no apl keyword in the started task. To correct this problem, add the keyword with the correct value to the SERNET parms. For example, to start an instance of ChangeMan SSM, add "SYN" to the parm list, as follows:

//SERSTC EXEC PGM=SERVER,
// REGION=0M,
// PARM='SYN,...'

If this keyword is in the started task and is correct, then the message indicates that the license is not valid.

You may also receive messages similar to the following (instead of or in addition to the above messages):

...

LIC0020E License file could not be opened: DD:SERLIC(LIC00204)
LIC0020E Trying to open non-existent file for READ
LIC0024E No license found for ChangeMan ZDD (Product ID 204)
LIC0043E ChangeMan ZDD terminating due to license validation errors. 
SER3801I Serena/Network - Initialization in progress; CSA=00D000
SER3805I Execution Parameters:
SER3805I DDNAME=SERSYSIN
SER3805I SUBSYS=3
SER3805I CMN=portid
SER3805I ZDD=portid
SER3805I STAX=NO

The messages in the above example indicate that you have the SERNET Keyword Option to start ZDD (ZDD=portid), but you do not have a ZDD license.

To correct this problem:

  • Remove the ZDD parameter from your SERNET parms and bounce the started task.

    or

  • Obtain a ZDD license and rerun LICUPDAT.