Set up the agent

How you prepare a file transfer agent MFT4AGT1, including MQSC scripts that we must run.


Before starting

We should have set up the command queue manager. See Configure the commands queue manager for more information.


This task prepares the Windows file transfer agent, MFT4AGT1.


Procedure

  1. Issue the following command:
    fteCreateAgent -agentName MFT4AGT1 -agentQMgr MFT4

    After creating the agent with the fteCreateAgent command, the agents directory, and a subdirectory for the agent, MFT4AGT1, are added to the MFT5 directory.

    In the data\MFT5\agents\MFT4AGT1 directory you find the:

    • agent.properties file
    • MFT4AGT1_create.mqsc file, which containsIBM MQ definitions required by the agent.

  2. Change to the data\MFT5\agents\MFT4AGT1 directory, and create the required agent queue manager definitions by issuing the following command:
    runmqsc MFT4 < MFT4AGT1_create.mqsc > mft4.txt
  3. Open the mft4.txt results file with your preferred editor and ensure that the definitions have been created successfully.
  4. Start the agent by typing the following command: fteStartAgent MFT4AGT1.
  5. Display the agent by typing the following command: fteListAgents. We should see output similar to the following:
    5655-MFT, 5724-H72 Copyright IBM Corp. 2008, 2020.  ALL RIGHTS RESERVED
    BFGPR0127W: No credentials file has been specified to connect to IBM MQ. 
    Therefore, the assumption is that IBM MQ authentication has been disabled.
    Agent Name:     Queue Manager Name:     Status:
    MFT4AGT1        MFT4                    READY
    
    Note: if you have not enabled connection authentication in your Managed File Transfer environment, we can ignore the BFGPR0127W message.

    If we issue the ftelistAgents command and receive the following message, BFGCL0014W: No agents exist that match the current selection criteria., see What to do if your MFT agent is not listed by the fteListAgents command.


What to do next

Set up the logger.

Parent topic: Configure the base server