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 WebSphere MQ File Transfer Edition has now expired.
- Severity
- 20 : Error
- Explanation
- The trial version of WebSphere MQ File Transfer Edition has expired and no longer works.
- Response
- Consider upgrading to the production version of WebSphere MQ File Transfer Edition.
- 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.
- 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.