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

Syntax diagram format

           

Read syntax diagramSkip visual syntax diagram
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

In this example, AGENT2 is started and runs in the foreground.
fteStartAgent -F AGENT2 
In the following example (for UNIX and Linux systems), AGENT2 is started with a non-default coordination queue manager, QM_SATURN:
./fteStartAgent -p QM_SATURN AGENT2 
You can also run the command by specifying the path to fteStartAgent as follows:
<path>/fteStartAgent agentname

Return codes

0
Command completed successfully.
1
Command ended unsuccessfully.

Responses

In some circumstances, you might see error messages after running the fteStartAgent command:
  • 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:
    BFGCL0001E: An internal error has occurred. The exception was: 'CC=2;RC=2495;AMQ8568: The native JNI library 'mqjbnd' was not found. [3=mqjbnd]
    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.

    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


Reference Reference

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/start_agent_cmd.htm