BFGEA0001 - BFGEA9999

BFGEA0001E
The agent name of ''<insert_0>'' specified in the ''<insert_1>'' properties file must be given in the uppercase form in the agent properties file.
Severity
20 : Error
Explanation
The specified agent name in the properties file has lowercase characters. The agent name must be in uppercase. The agent has not been started.
Response
Modify the agent name in the specified properties file so that no lower case characters are used.

BFGEA0002E
The ''<insert_0>'' property is not specified in the ''<insert_1>'' properties file. This property must be present, otherwise the agent cannot be initialised.
Severity
20 : Error
Explanation
The specified property is missing from the specified properties file. The property must be present, otherwise the agent cannot be initialised with the initializeAgent() method.
Response
Add the specified property to the properties file. Call the initializeAgent() method again.

BFGEA0003E
The agent name of ''<insert_0>'' specified in the ''<insert_1>'' properties file does not match the agent name specified in the creation of the EmbeddedAgent object.
Severity
20 : Error
Explanation
The specified agent name does not match the agent name specified in the creation of the EmbeddedAgent object. The names must match for the agent to be successfully initialised with the initializeAgent() method;
Response
Modify the agent name in the specified properties file to match the agent name specified in the creation of the EmbeddedAgent object. Call the initializeAgent() method again.

BFGEA0004E
A Null or empty string has been passed as the 'agentName' parameter to the constructor of the EmbeddedAgent object.
Severity
20 : Error
Explanation
When creating an EmbeddedAgent it is mandatory to specify the agent's name
Response
Call the constructor again specifying a valid value for the 'agentName' parameter.

BFGEA0005E
A Null or empty string has been passed as the 'configDirectory' parameter and the 'diagnosticsDirectory' parameter to the constructor of the EmbeddedAgent object.
Severity
20 : Error
Explanation
When creating an EmbeddedAgent it is mandatory to specify either the name of the configuration directory or the diagnosticsDirectory.
Response
Call the constructor again specifying a valid value for the 'configDirectory' parameter or the 'diagnosticsDirectory' parameter.

BFGEA0006E
A Null or empty string has been passed as the 'agentQM' parameter to the constructor of the EmbeddedAgent object.
Severity
20 : Error
Explanation
When creating an EmbeddedAgent it is mandatory to specify the agent's queue manager name
Response
Call the constructor again specifying a valid value for the 'agentQM' parameter.

BFGEA0007E
A Null or empty string has been passed as the 'coordinationQM' parameter to the constructor of the EmbeddedAgent object.
Severity
20 : Error
Explanation
When creating an EmbeddedAgent it is mandatory to specify the coordination queue manager name
Response
Call the constructor again specifying a valid value for the 'coordinationQM' parameter.

BFGEA0008E
The initializeAgent method failed to initialize the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The initializeAgent method failed to initialize the embedded agent due to an IOException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0009E
The trace level value ''<insert_0>'' passed as the ''traceLevel'' parameter to the contstructor of the EmbeddedAgent object is invalid.
Severity
20 : Error
Explanation
The 'traceLevel' parameter must be one of the following values: 'all', 'flow', 'moderate', 'verbose' or 'off'.
Response
Call the constructor again specifying a valid value for the 'traceLevel' parameter.

BFGEA0010E
Could not open lock file ''<insert_0>''. The embedded agent could not be started because of: <insert_1>.
Severity
20 : Error
Explanation
The runAgent method could not open the specified file. The runAgent method requires that it is able to open this file. The embedded agent has not been started.
Response
Use the information in the message to investigate why the file could not be opened. If possible, resolve the problem and reissue the runAgent call to start the agent. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0011E
Another instance of agent ''<insert_0>'' is already running.
Severity
20 : Error
Explanation
Another instance of the agent is already running. Only a single instance of any given agent can run at one time. A second instance of the agent has not been started.
Response
No action required.

BFGEA0012E
The embedded agent ''<insert_0>'' has not been initialized.
Severity
20 : Error
Explanation
The initializeAgent method must be successfully executed before the runAgent method can be called.
Response
Check why the initializeAgent method has not been executed successfully. Correct any problem and then call the initializeAgent method followed by the runAgent method.

BFGEA0013E
Could not find the coordination properties file ''<insert_0>''.
Severity
20 : Error
Explanation
The initializeAgent method could not find the specified file. The initializeAgent method requires that it is able to open this file. The agent has not been initialized.
Response
Determine why the file is not present in the expected location. If possible, restore the file from a backup or re-create the agent configuration using the supplied tools.

BFGEA0014E
Could not find the agent properties file ''<insert_0>''.
Severity
20 : Error
Explanation
The initializeAgent method could not find the specified file. The initializeAgnet method requires that it is able to open this file. The agent has not been initialized.
Response
Determine why the file is not present in the expected location. If possible, restore the file from a backup or re-create the agent configuration using the supplied tools.

BFGEA0015E
Could not close lock file ''<insert_0>''. The embedded agent could not be started because of: <insert_1>.
Severity
20 : Error
Explanation
This exception is unexpected. The cause is not immediately known.
Response
If the problem persists, see problem determination information in the product documentation.

BFGEA0016E
An internal error has occurred. The exception was: ''<insert_0>''
Severity
20 : Error
Explanation
This exception is unexpected. The cause is not immediately known.
Response
If the problem persists, see problem determination information in the product documentation.

BFGEA0017E
The EmbeddedAgent object for agent ''<insert_0>'' cannot be created because an EmbeddedAgent already exists for agent ''<insert_1>''.
Severity
20 : Error
Explanation
Only one EmbeddedAgent object is allowed within a JVM.
Response
Configure the application to use the existing EmbeddedAgent object or create a new EmbeddedAgent object within another JVM.

BFGEA0018E
The initializeAgent method failed to initialize the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The initializeAgent method failed to initialize the embedded agent due to an InternalException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0019E
The initializeAgent method failed to initialize the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The initializeAgent method failed to initialize the embedded agent due to a ConfigurationException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0020E
The initializeAgent method failed to initialize the embedded agent ''<insert_0>'' while loading the SSL properties.
Severity
20 : Error
Explanation
The initializeAgent method failed to initialize the embedded agent due to a GeneralSecurityException while loading the SSL properties.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0021E
The embedded agent ''<insert_0>'' has not been initialized.
Severity
20 : Error
Explanation
The initializeAgent method must be successfully executed before the stopAgent method can be called.
Response
Check why the initializeAgent method has not been executed successfully.

BFGEA0022E
The stopAgent method failed to stop the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The stopAgent method failed to stop the embedded agent due to an ApiException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the stopAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0023E
The stopAgent method failed to stop the embedded agent ''<insert_0>''. The exit message is: ''<insert_1>'' and the return code: <insert_2>
Severity
20 : Error
Explanation
The stopAgent method failed to stop the embedded agent.
Response
Use the exit message and return code to investigate the problem. Resolve the problem, if possible, and reissue the stopAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0024E
The trial version of IBM MQ Managed File Transfer has now expired.
Severity
20 : Error
Explanation
The trial version of IBM MQ Managed File Transfer has expired and no longer works.
Response
Consider upgrading to the production version of IBM MQ Managed File Transfer.

BFGEA0025E
The initializeAgent method failed to initialize the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The initializeAgent method failed to initialize the embedded agent due to a TBBException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0026E
The agentQMgr property is not specified in the ''<insert_0>'' properties file. This property must be present, otherwise the agent cannot be started.
Severity
20 : Error
Explanation
The agentQMgr property is missing from the specified properties file. The property must be present to initialize the agent successfully with the initializeAgent() method.
Response
Add the agentQMgr property to the properties file.Call the initializeAgent() method again.

BFGEA0027E
The value ''<insert_0>'' of the agentQMgr property specified in the ''<insert_1>'' properties file does not match the value ''<insert_2>'' of the agentQM parameter in the call to initializeAgent().
Severity
20 : Error
Explanation
The specified agentQMgr property does not match the agentQM parameter in the call to initializeAgent(). The agentQM parameter and the agentQMgr property specified in the properties file must match. The agent has not been initialized.
Response
Modify the agentQMgr property in the specified properties file to match the agentQM property.

BFGEA0028E
The value ''<insert_0>'' of the connectionQMgr property specified in the ''<insert_1>'' properties file does not match the value ''<insert_2>'' of the agentQM parameter in the call to initializeAgent().
Severity
20 : Error
Explanation
The specified connectionQMgr property does not match the agentQM parameter in the call to initializeAgent(). The agentQM parameter and the connectionQMgr property specified in the properties file must match. The agent has not been initialized.
Response
Modify the connectionQMgr property in the specified properties file to match the agentQM property.

BFGEA0029E
The configuration directory ''<insert_0>'' given in the call to initializeAgent() does not currently exist and failed to be created during initialization.
Severity
20 : Error
Explanation
The specified configuration directory does not exist and failed to be created during initializeAgent(). The agent has not been initialized.
Response
Ensure the Embedded agent process has the necessary permissions to create the configuration directory, else manually create it with the correct permissions for the agent before calling initializeAgent().

BFGEA0030E
The coordination directory ''<insert_0>'' failed to be created during initialization.
Severity
20 : Error
Explanation
The coordination directory does not exist and failed to be created within the configDirectory during initializeAgent(). The agent has not been initialized.
Response
Ensure the Embedded agent process has the necessary permissions to create the coordination directory, else manually create it with the correct permissions for the agent before calling initializeAgent().

BFGEA0031E
The agent directory ''<insert_0>'' failed to be created during initialization for the given agentName parameter.
Severity
20 : Error
Explanation
The agent directory does not exist and failed to be created within the configDirectory during initializeAgent(). The agent has not been initialized.
Response
Ensure the Embedded agent process has the necessary permissions to create the agent directory, else manually create it with the correct permissions for the agent before calling initializeAgent().

BFGEA0032E
The embedded agent ''<insert_0>'' has not been initialized.
Severity
20 : Error
Explanation
The initializeAgent() method must be successfully executed before the deregisterAgent method can be called.
Response
Check why the initializeAgent() method has not been executed successfully.

BFGEA0033E
The embedded agent ''<insert_0>'' is running.
Severity
20 : Error
Explanation
The embedded agent must be stopped before the deregisterAgent() method can be called.
Response
Stop the agent with the stopAgent() method and then call the degegisterAgent() method again.

BFGEA0034E
The embedded agent ''<insert_0>'' is already running.
Severity
20 : Error
Explanation
The runAgent() method cannot be called if the agent is already running.
Response
No user action required.

BFGEA0035E
The stopAgent method failed to stop the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The stopAgent method failed to stop the embedded agent due to a CommandException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the stopAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0036E
The embedded agent ''<insert_0>'' is not running.
Severity
20 : Error
Explanation
The embedded agent must be running when the stopAgent() method is called.
Response
No user action required.

BFGEA0037E
The initializeAgent method failed to deregister the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The initializeAgent method failed to deregister the embedded agent due to a ConfigurationException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0038E
The initializeAgent method failed to deregister the embedded agent ''<insert_0>''
Severity
20 : Error
Explanation
The initializeAgent method failed to deregister the embedded agent due to an InternalException.
Response
Use the information in the underlying exception to investigate the problem. Resolve the problem, if possible, and reissue the initializeAgent call. If this does not resolve the problem, contact the IBM support center for assistance.

BFGEA0039E
The embedded agent ''<insert_0>'' is running.
Severity
20 : Error
Explanation
The embedded agent must be stopped before the initializeAgent() method can be called.
Response
Stop the agent with the stopAgent() method and then call the initializeAgent() method again.

BFGEA0040E
Unable to delete the configuration directory ''<insert_0>'' for embedded agent ''<insert_1>''.
Severity
20 : Error
Explanation
It was not possible to delete an existing configuration directory for the agent.
Response
Resolve the problem and then call the getEmbeddedAgent() method again.

BFGEA0041E
Unable to create the configuration directory ''<insert_0>'' for embedded agent ''<insert_1>''.
Severity
20 : Error
Explanation
It was not possible to create the configuration directory for the agent.
Response
Resolve the problem and then call the getEmbeddedAgent() method again.

BFGEA0042E
The embedded agent ''<insert_0>'' has not been initialized.
Severity
20 : Error
Explanation
The initializeAgent() method must be successfully executed before the setAgentTrace method can be called.
Response
Check why the initializeAgent() method has not been executed successfully.

BFGEA0043E
An internal error has occurred while stopping the embedded agent ''<insert_0>''. The exception was: ''<insert_1>''
Severity
20 : Error
Explanation
This exception is unexpected. The cause is not immediately known.
Response
If the problem persists, see problem determination information in the product documentation.

BFGEA0044E
The embedded agent ''<insert_0>'' ended abnormally.
Severity
20 : Error
Explanation
The embedded agent ended abnormally.
Response
Check the agent's event log for further information about why the agent ended.

BFGEA9999E
<insert_0>
Severity
20 : Error
Explanation
If this message does not give enough information, check the accompanying error messages for further information.
Response
For further information on resolving this error, see the problem determination information on the product Web site.