Using the IBM MQ Explorer to test a file transfer

This task gives an example of how you use IBM® IBM MQ Explorer with Managed File Transfer, to test a file transfer, after you have set up the IBM MQ Explorer as described in the previous topic.

Before you begin

Ensure that you have a working system, that the agents are READY and IBM MQ Explorer is working. See Setting up the IBM MQ Explorer with MFT for more information.

About this task

Determine the file to use to test the transfer, and a directory to copy it to. For this example, it is assumed that file test-file.txt out of directory C:\temp\mft is used.

C:\temp\mft> dir *
Date stamp 61 test-file.txt
1 File(s) 61 bytes

Procedure

  1. Start the IBM MQ Explorer in Windows
  2. In the left Navigator panel, expand the folder: Managed File Transfer.
    You see the entry for the Coordination queue manager: MFT5
  3. Right click on MFT5 and select Connect.
  4. Once connected, right click on MFT5 and select New Transfer
    1. Use the pull down menu to select MFT4AGT1 for the Source agent and CSMAGT1 for the Destination agent.
    2. Click Next.
    3. Click Add on the next window.
      A wide dialog appears. The left side is for Source and the right side for Destination.
  5. On the Source panel:
    1. Select Text transfer as the file is text.
    2. Select Browse to locate the file.
      In this case, the file is C:\temp\mft\test-file.txt.
      Attention: Do not click OK as you need to complete the Destination panel.
  6. On the Destination panel:
    1. Enter the name that you are giving the file at the destination, for example, test-file.txt.
      The use of relative paths is supported. The top portion of the full path is the home directory of the user ID who starts the destination agent.
    2. Select Overwrite files if present if you require this option.
    3. Click OK.
      The file you selected appears in the New Transfers panel.
  7. If the MFT5 configuration menu is closed, and shows +MFT5, expand the menu by clicking the + sign.
  8. Stay at the MFT configuration selected.
    Next, you check the status of the transfer by carrying out the following procedure.
  9. Click Transfer Log under the coordination queue manager MFT5.
  10. Look at the status in Managed File Transfer - Current Transfer progress panel, immediately below the Transfer Log top panel and wait for the transfer to complete.
    If the transfer shows successful and with a green background, you have successfully completed the test of your configuration.
    If the transfer failed with a red background, an error occurred.

    In most cases, you can use the scroll bar below the top Transfer Log panel and view a summary of the reasons for failure.

    1. If you cannot determine why the transfer failed, double-click the entry for the transfer in the top Transfer Log panel.
    2. Select XML in the left pane of the pop-up panel that appears.
    3. Scroll through the information to determine the cause of the error.
    4. Make the corrections needed and test the transfer again.