IBM Support

YCP0089 (User Exit definition not found) error while starting application server.

Troubleshooting


Problem

YCP0089 (User Exit definition not found) error while starting application server.

Symptom

This issue can occur when upgrading the HF for SSCAP version 8.0 and above. After the application of the HF, the YCP0089 error is shown on the server console during startup. The full error stack trace is:

<Errors>
ErrorDescription="User Exit definition not found. [UniqueExceptionId='01000100108512399076327420000000000001']" ErrorRelatedMoreInfo="">
<Attribute Name="ErrorDescription" Value="User Exit definition not found."/>
<Attribute Name="ErrorRelatedMoreInfo" Value=""/>
<Attribute Name="UserExitPropertyName" Value="yfs.ue.massageApiOutputBeforeReturning.class"/>
<Attribute Name="UserId" Value="system"/>
<Attribute Name="ProgId" Value="system"/>
<Stack>com.yantra.yfc.util.YFCException
at com.yantra.ycp.core.YCPUserExitManager.getUserExitKey(YCPUserExitManager.java:415)
at com.yantra.ycp.core.YCPUserExitManager.getUserExitImpl(YCPUserExitManager.java:202)
at com.yantra.ycp.core.YCPUserExitManager.getUEImplDetailsFromDB(YCPUserExitManager.java:373)
at com.yantra.ycp.core.YCPUserExitManager.getUserExit(YCPUserExitManager.java:113)
at com.yantra.ycp.core.YCPContext.getUserExit(YCPContext.java:759)
at com.yantra.yfs.common.YFSUserExitHelper.getUserExit(YFSUserExitHelper.java:14)
at com.yantra.ysc.ep.MassageAPIOutputEPImpl.callUserExit(MassageAPIOutputEPImpl.java:52)
at com.yantra.ysc.ep.MassageAPIOutputEPImpl.contribute(MassageAPIOutputEPImpl.java:48)
at com.yantra.ycp.core.YCPExtensionPointRegistry.invokeExtensions(YCPExtensionPointRegistry.java:63)
at com.yantra.interop.services.api.ApiHelper.handleAPIOutputThroughEP(ApiHelper.java:658)
at com.yantra.interop.services.api.ApiHelper.invoke(ApiHelper.java:511)

Resolving The Problem

The issue would occur if the data migration step was not performed properly after installing the HF. It is possible that new user exits are introduced into the product as a part of an HF. The user exit definition (which is part of the factory setup) would need to be inserted into the YFS_USER_EXIT table.

To perform the data migration step correctly:

1. In the {RUNTIME.EN}\database\hf-factorysetup\XMLS folder, ensure that appropriate XML file exists.

2. In the {RUNTIME.EN}\Foundation\database\hf-factorysetup folder, delete all the .restart files. Also ensure that the installer XML files exist in this folder.

3. In the folder where the HF zip file was extracted, an InstallableComps.properties file can be found. In this file, change the SSCAP_INSTALLED_HF to 0 (if it isn't already).

4. Re-run the data migration step of the HF installation and ensure that the data has indeed been inserted into the YFS_USER_EXIT table.

5. Rebuild the EAR and re-deploy.

[{"Product":{"code":"SS6PEW","label":"IBM Sterling Order Management"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"Not Applicable","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5;8.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SS6PEW","label":"IBM Sterling Order Management"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.2;9.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Historical Number

TRB2835

Document Information

Modified date:
10 May 2022

UID

swg21561688

Page Feedback