Typical U-codes and messages received in an Agent log

Document ID : KB000089309
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Typical U-codes and messages received in an Agent log
Resolution:
Detailed Description and Symptoms

U2000099 Transfer key could not be loaded (Ret='00000000', minor='000009XX').
U0003357 Transfer keys for Agent 'UNIX999' do not comply with each other. (UNIX)

(These are the typical U-codes and messages received in a UNIX Agent log)

NOTE: If the Agent is a PeopleSoft Agent on UNIX, you may also have a message in the logs similar to this:

U2000101 Access to key store '/home/uc4app/psoft/bin/UCXJPSX.KEYSTORE' not possible.


Investigation

An issue with the Agent "Transfer keys" appears on occasion.  It occurs when the original authentication data (Company Key) information in the database does not match the authentication (Company Key) information for the Agent.
This problem can be caused by any of the following scenarios:

A) An Agent is started with the wrong OM system name in the Agent's "ini" file
B) A newly installed Agent is started with the same name as another Agent in a different directory
C) From a newly installed Agent\bin directory - the Agent is started with a new name, and subsequently started with a different name.

Solution
Use these steps to correct this problem:

1) In Client 0000, edit the UC_AS_SETTINGS variable found in the DIV_VARIABLES folder
2) If it is not there already,  add the Validity Keyword 'AUTHENTICATION' with the value 'NO'
3) Restart your AutomationEngine (Server Processes) so that this change is recognized by the OM system
4) Go into Client 0000>System Overview>Agents, right-click the Agent, and choose "Renew transfer key" (this will reset the Agent information in the database)
5) Restart the Agent

If the steps above do not work, then the following steps may also resolve this issue:

1) In Client 0000, go to the HOST folder and delete the Agent object (this object will have the same name as the one you are attempting to start).  This will completely remove the Agent and reset any information in the database the Agent
2) Restart the Agent