fteStartAgent (start a WebSphere MQ File Transfer Edition agent)
The fteStartAgent command starts a WebSphere® MQ File Transfer Edition agent from the command line.
Purpose
Use the fteStartAgent command to start a WebSphere MQ File Transfer Edition agent. You must start an agent before you can use it to perform file transfers. The fteStartAgent command starts an agent on the system where you issue the command: you cannot start an agent on a remote system.If you have configured the agent to run as a Windows service by using the fteCreateAgent or fteModifyAgent command, running the fteStartAgent command starts the Windows service.
This command returns an error if the agent does not start or is already started. The agent communicates with its queue manager based on the values defined in the agent.properties file.
Specify the optional -p parameter for this command only if you want to use a set of configuration options different from your default set. See Properties files for WebSphere MQ File Transfer Edition for more information.
Syntax
fteStartAgent >>-fteStartAgent--+-----+--+------------------------------+-----> '- -F-' '- -p--(configuration_options)-' >--agent_name--------------------------------------------------><
Parameter
- -F
- Optional. This parameter runs the agent daemon as a foreground
process. The default is for the agent daemon to run in the background.
If you are running on Windows, and you have configured the agent to run as a Windows service by using the fteCreateAgent or fteModifyAgent commands, the -F parameter overrides this configuration.
- -p (configuration_options)
- Optional. This parameter determines the set of configuration options
that is used to issue the request to start an agent. Use the name
of a non-default coordination queue manager as the input for this
parameter. The command then uses the set of properties files associated
with this non-default coordination queue manager.
If you do not specify this parameter, the set of configuration options based on the default coordination queue manager is used.
- agent_name
- Required. The name of the WebSphere MQ File Transfer Edition agent that you want to start.
- -? or -h
- Optional. Displays command syntax.
Example
fteStartAgent -F AGENT2
./fteStartAgent -p QM_SATURN AGENT2
<path>/fteStartAgent agentname
Return codes
- 0
- Command completed successfully.
- 1
- Command ended unsuccessfully.
Responses
- If you run the fteStartAgent command
and see the following error message, your environment probably has
additional library paths that conflict with WebSphere MQ
File Transfer Edition:
If the LD_LIBRARY_PATH or LIBPATH environment variable is set to reference a 64-bit version of the library before the 32-bit version when the agent is running with a 32-bit version of Java™ (as is currently the case for most platforms), this error occurs.BFGCL0001E: An internal error has occurred. The exception was: 'CC=2;RC=2495;AMQ8568: The native JNI library 'mqjbnd' was not found. [3=mqjbnd]
To resolve this issue, set the WebSphere MQ File Transfer Edition agent property javaLibraryPath to reference the correct location for the library. For example, for mqjbnd on AIX®, set to: /usr/mqm/java/lib. For mqjbnd on Linux, set to: /opt/mqm/java/lib