Troubleshooting your AS/400 system

After installing LexiCom to the mapped drive, (e.g., “L:\”), the message “The installation of LexiCom is finished, but some warnings occurred during the install.  Please see the installation log for details.”  

When examining the LexiComInstallLog.log file, 7 Warnings are found.

All the warnings are “WARNING - String index out of range: -1” and are related to Install Uninstaller and Create LaunchAnywhere Java Executable Components.

This error occurs because LexiCom was installed to a drive letter and the Installer did not find a path. Since this is a mapped location, these are benign warnings and no further action needs to be taken.

When running AS/400 command "CALL INSTLEX" an error is returned that a jar file cannot be found

User did not install LexiCom using a network drive mapped to the AS/400 IFS directory /LexiCom

Verify that the IFS folder /LexiCom has been created and a drive has been mapped to it.

Verify that LexiCom has been installed to that mapped drive and not the default directory

C:\Program Files\LexiCom

Cannot access the AS/400 from System i Navigator.

User did not configure TCP/IP on the AS/400 properly.

User did not define the host and domain name on the AS/400.

Verify that TCP/IP is configured properly.

Use the command "GO CFGTCP".  

  Verify that a TCP/IP host table entry has been added for your system (option 10).

  Verify that a host name and domain name have been configured for your system (option 12).

When sending a message to a host (specified as a host name instead of an IP address), an UnknownHostException error is returned.

User did not configure DNS on the AS/400 properly.

Configure DNS by typing the command "GO CFGTCP" (on the green screen) and choosing option 12.  

Enter a valid internet address in the "Domain name server" field.

The times displayed in the LexiCom log entries are off by several hours.

User's system clock is not correctly defined for the appropriate time zone.

Using System i Navigator, go to the Configuration and Service > System Values > Date and Time panel.

Click the Time tab.

Click Change Time Zone… to reflect your current time zone.

After installing the permanent key, the AS/400 features are no longer available or the STRLEXSVR command no longer runs.

User does have not the AS/400 license specified on his permanent key.

The AS/400 option is available on the temporary key for evaluation purposes.  Contact Cleo Sales for information and pricing of AS/400 features.

User cannot start LexiCom after installing the permanent key.  It is returning the error:

"java.io.FileNotFoundException: 'Path':\.license\.lc\.lcf (Access is denied)

The temp key was installed under a different user than the one attempting to install the permanent key.

Verify the owner of the .lcf file by viewing the "Properties" in System i Navigator.

Install the permanent key using the same user as the owner of the file.

LexiCom fails to start when the STRLEXSVR command is invoked.  No indication of the problem is displayed in the job log.

Various issues could cause LexiCom to fail to start.

If the failure has occurred before logging has started, the error should be recorded in the logs\exception.txt file.

If there is no exception.txt file, check the LexiCom.xml file and the LexiCom.dbg file.

The error message displayed in the exception.txt file indicating that the required Java version is not installed.

User does not have Java Developer Kit (Option 17) properly installed on the AS/400. 

Verify that Option 17, Feature 5117 - Java SE 8 64 bit is installed by typing the green screen command: DSPSFWRSC.

If it is not there, obtain it from IBM (if you don't already have it on your installation media) and install it.

The error message "NoClassDefFoundError: com/ibm/as400/resource/ChangeableResource" is displayed when attempting to click the "New" button on the AS/400 Configuration panel.

The IBM jt400.jar file is not installed in the LexiCom home directory.

The IBM jt400.jar is not in the class path.

Obtain the jt400.jar file using Cleo's software update process.

Obtain a newer version of LexiCom.

Exceptions are being logged: “Problem initializing decryption cipher.  Illegal key size.”

Encryption of sensitive data requires that unlimited strength jurisdiction policy files are properly installed in your JRE. 

  Verify that you have installed LexiCom with the bundled VM.

  Examine the lax file and verify that the “lax.nl.current.vm” path points to the jre directory where LexiCom was installed.

When you launch the LexiCom executable, the error “Windows error 216 occurred while loading the Java VM”

This occurs when the Windows 64- bit JRE installer was used to install LexiCom on the IFS and you have mapped a drive to access it from a Windows 32-bit  machine.

  If all users that will be launching the LexiCom executable are using Windows 32-bit machines, re-install LexiCom using the Windows 32-bit JRE installer.

  If  there are some users that will launching the LexiCom executable from Windows 32-bit machines and others from Windows 64-bit machines, contact Cleo Support for further instructions on creating an alternate set of LexiCom executables for your Windows 32-bit machine users.

When you launch the LexiCom executable from a Windows 10 mapped drive, the LexiCom UI either never appears and/or the message “Error: Could not find or load main class com.zerog.lax.LAX ” is displayed, or it takes several hours for the UI to appear and once it does, the messages in the messages panel do not display at all.

Windows 10 is incompatible with some versions of IBM i.