Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

Select a language:

  • Close [x]
  • Close [x]

Setting up a test scenario in WebSphere MQ File Transfer Edition

Leonardo Rodriguez (lrodrigu@ve.ibm.com), WebSphere IT Specialist, IBM
Leonardo Rodriguez is a Certified Level 1 WebSphere IT Specialist in IBM Application Integration and Middleware Solutions, assisting customers with administration, architecture, demonstrations, proof of concepts, and security issues in the Latin America region.

Summary:  This article shows you how to set up and configure a simple WebSphere MQ File Transfer Edition scenario that shows how its secure file transfer capabilities solve the security and reliability issues that many customers encounter with FTP. The scenario involves two Windows machines and demonstrates queues, queue managers, channels, agents, commands, and coordinators.

Date:  22 Dec 2010
Level:  Intermediate
Also available in:   Portuguese  Spanish

Activity:  5658 views
Comments:  

Introduction

IBM® WebSphere® MQ File Transfer Edition V7 (hereafter called WebSphere MQ FTE) delivers a reliable managed file transfer solution for moving files, regardless of their size, between IT systems without the need for programming.

For a basic description of WebSphere MQ FTE, including its functions, processes, and associated tools, see Welcome to WebSphere MQ FTE in the WebSphere MQ FTE information center.

For information about the basic topology of WebSphere MQ FTE, including the operation of the agent, agent queue manager, coordination queue manager, and command queue manager components, see WebSphere MQ FTE topology overview in the WebSphere MQ FTE information center, and Figure 1 below, from the information center:


Figure 1. WebSphere MQ FTE topology overview
WebSphere MQ FTE topology overview

Setting up the scenario

There are many different WebSphere MQ FTE scenarios that can demonstrate its capabilities -- this article uses a basic topology with two queue managers to keep things simple:


Figure 2. Basic topology with two queue managers
Basic topology with two queue managers

Here is a description of this topology:

  • The coordination queue manager can reside on either queue manager. The command queue manager and agent queue manager can reside on either queue manager.
  • Each server agent uses bindings mode to connect to its queue manager.
  • Either server agent can be a source or destination.
  • Files can be transferred by sender or receiver channels between the two server agents.

The WebSphere MQ FTE server agent is installed on each endpoint and connected to its agent queue manager, which also acts as a command queue manager. You can appoint either queue manager as the coordination queue manager, but this queue manager must be running on WebSphere MQ V7. In this topology, you can use the WebSphere MQ FTE plug-in for WebSphere MQ Explorer and remote tools.

As mentioned, WebSphere MQ FTE runs on top of WebSphere MQ, so the first step is to make sure WebSphere MQ V7.0.1.2 is installed on both machines, though on the source machine you can use WebSphere MQ V6.0 or later. You then set up WebSphere MQ.

1. Creating the CQM coordination queue manager

  1. Create a queue manager called CQM in the coordination machine, which is going to work as the coordination, command, and agent queue manager. Enter the following MQ commands:
    c:\>crtmqm CQM and c:\>strmqm CQM.
  2. Download this script at the bottom of the article, and execute it to create the listener and channels:
    c:\>runmqsc CQM < CQM_script.txt .

2. Creating the SQM queue manager

  1. Create a queue manager called SQM in the source machine, which is going to work as the command and agent queue manager. Enter the following MQ commands:
    c:\>crtmqm SQM and c:\>strmqm SQM
  2. Download this script at the bottom of the article, and execute it to create the listener and channels:
    c:\>runmqsc SQM < SQM_script.txt.
  3. After you have configured the WebSphere MQ environment, you are ready to begin the WebSphere MQ FTE Server installation on the coordination queue manager.

3. Installing WebSphere MQ FTE on the coordination machine

  1. Launch the WebSphere MQ FTE Server installer and select your preferred language.
  2. Click Next in the Introduction section.
  3. Accept the License Agreement and click Next.
  4. Change the product install folder to C:\IBM\WMQFTE and click Next.
  5. Change the configuration folder to C:\IBM\WMQFTE\config and click Next.
  6. For Coordination queue manager name, enter CQM. For Connect using the following transport mode, click Bindings:

    Figure 3. Define coordination queue manager on coordination machine
    Define coordination queue manager on coordination machine

  7. For Agent name, enter AgentC. For Agent description, enter Coordination Agent. For Agent queue manager name, enter CQM. For Connect using the following transport mode, click Bindings:

    Figure 4. Define coordination agent
    Define coordination agent

  8. For Command queue manager name, enter CQM. For Connect using the following transport mode, click Bindings:Transport Mode: Bindings:

    Figure 5. Define the command queue manager on coordination machine


  9. Review the Summary screen and click Install.
  10. During the installation process you will see a screen like this. Click Next:

    Figure 6. Run on coordination queue manager
    Run on coordination queue manager

  11. Also click Next in this screen. You will configure the previous step and this one later:

    Figure 7. Run on agent queue manager
    Run on agent queue manager

  12. Click Done.

To configure the previous steps, execute the following commands:

  1. Open a command prompt, go to the C:\IBM\WMQFTE\config\CQM folder and run: 
    C:\IBM\WMQFTE\config\CQM>runmqsc CQM < CQM.mqsc

    .
  2. To configure AgentC, go to the C:\IBM\WMQFTE\config\CQM\agents\AGENTC folder and run: 
    C:\IBM\WMQFTE\config\CQM\agents\AGENTC>runmqsc CQM < AGENTC_create.mqsc

    .
  3. Start AgentC and for ease of use add the folder C:\IBM\WMQFTE\bin in the PATH environment variable: 
    C:\IBM\WMQFTE\bin>fteStartAgent AgentC

    .
  4. Check the file output0.log in the agent logs folder C:\IBM\WMQFTE\config\CQM\agents\AGENTC\logs. You should see a message like this: 
    ************ Start Display Current Environment ************
Build level: V7.0.2 f702-GM5-20091117-1614
Java runtime version:
J2RE 1.5.0 IBM J9 2.3 Windows XP x86-32 j9vmwi3223ifx-20080811 (JIT
enabled)
J9VM - 20080809_21892_lHdSMr
JIT - 20080620_1845_r8
GC - 200806_19
ICU4J version: Unable to determine ICU4J version (ICU4J is disabled)
Properties:
agentDesc=Coordination Agent, agentName=AGENTC, agentQMgr=CQM,
coordinationQMgr=CQM
transferRoot=C:\Documents and Settings\Administrator
Install Locations:
com.ibm.wmqfte.product.root=C:\IBM\WMQFTE
com.ibm.wmqfte.product.config=C:\IBM\WMQFTE\config
************* End Display Current Environment *************
[16/08/2010 18:22:27:484 ACT] 00000001 Agent I BFGAG0115I: Relative path
transfer root directory: C:\Documents and Settings\Administrator
[16/08/2010 18:22:27:500 ACT] 00000001 AgentRuntime I BFGAG0058I: The
agent has successfully initialized.
[16/08/2010 18:22:29:218 ACT] 00000001 AgentRuntime I BFGAG0059I: The
agent has been successfully started.

  5. Ping the agent to determine if it is up and running: 
    C:\IBM\WMQFTE\bin>ftePingAgent AgentC

    .

You are done with the coordination queue manager.

4. Installing WebSphere MQ FTE on the source machine

  1. When you get to the Define coordination queue manager screen, for Coordination queue manager name, enter CQM. For Connect using the following transport mode, click Client:

    Figure 8. Define coordination queue manager on source machine
    Define coordination queue manager on source machine

  2. Configure the coordination queue manager. For Coordination queue manager hostname, enter coordination (your hostname or IP address). For Coordination queue manager port, enter 1818:

    Figure 9. Coordination queue manager details
    Coordination queue manager details

  3. Configure the source agent. For Agent name, enter AgentS. For Description, enter Source agent. For Agent queue manager name, enter SQM. For Connect using the following transport mode, click Bindings:

    Figure 10. Define source agent
    Define source agent

  4. On this screen, for Command queue manager name, enter SQM. For Connect using the following transport mode, click Bindings:

    Figure 11. Define command manager on source machine
    Define command manager on source machine

  5. Click Next and complete the installation process. Then open a command prompt and go to the C:\IBM\WMQFTE\config\CQM\agents\AGENTS folder. Remember to set up the PATH environment variable and run: 
    C:\IBM\WMQFTE\config\CQM\agents\AGENTS>runmqsc SQM < AGENTS_create.mqsc

    .
  6. Start the agent AgentS, check the logs, and ping the agent like you did above for AgentC.

You have installed and configured both the coordination machine and the source machine.

5. Installing WebSphere MQ FTE remote tools and documentation

  1. Close WebSphere MQ Explorer if it is open, launch the Installer, go to the screen Select set of features to install, and select Complete installation:

    Figure 12. WebSphere MQ FTE remote tools and documentation
    WebSphere MQ FTE remote tools and documentation

  2. Change the installation folders as you did before to C:\IBM\WMQFTE and C:\IBM\WMQFTE\config. Click Use existing:

    Figure 13
    Figure 13

  3. Click Install
  4. Repeat these steps on the source machine. After you finish, launch WebSphere MQ Explorer on both machines and you should see the Manage File Transfer tree in the MQ Explorer Navigator:

    Figure 14. Manage File Transfer plug-in
    Manage File Transfer plug-in

  5. Now you can use WebSphere MQ FTE to securely transfer a file from one machine to the other. Do a transfer from the source machine to the coordination machine: Right-click on the CQM queue manager in the source machine Manage File Transfer plug-in and select New Transfer:

    Figure 15
    Figure 15

  6. Complete the information as shown and click Finish:

    Figure 16. New transfer
    New transfer

  7. TestFile.txt is attached at the end. Go to the Transfer log folder and you should see a successful transfer:

    Figure 17. Transfer log
    Transfer log

  8. Check the C:\fte folder on the coordination machine:

    Figure 18
    Figure 18

  9. Open it with Notepad using the command: c:\fte>notepad TestFile.txt:

    Figure 19. TestFile.txt
    TestFile.txt

Conclusion

You have successfully transferred a file from one system to another using WebSphere MQ FTE. You can also explore other WebSphere MQ FTE capabilities, such as integrating with Apache Ant, using transfer monitors, using the Curl tool, and doing XML transfers, using the WebSphere MQ FTE Tools that you just installed. In addition, you can explore the WebSphere MQ FTE audit and security features.

WebSphere MQ FTE helps you to build a customized, scalable, and automated solution for enterprise file transfer, ensuring reliable and secure transfer to and from different systems running on various platforms. WebSphere MQ FTE can also help your enterprise lower business risk, increase IT productivity, and reduce costs.


Back to top

Download

DescriptionNameSizeDownload method
Code sampleattachments.zip1 KBHTTP

Information about download methods


Resources

About the author

Leonardo Rodriguez is a Certified Level 1 WebSphere IT Specialist in IBM Application Integration and Middleware Solutions, assisting customers with administration, architecture, demonstrations, proof of concepts, and security issues in the Latin America region.

Close [x]

Report abuse help

Report abuse

Thank you. This entry has been flagged for moderator attention.

Close [x]

Report abuse help

Report abuse

Report abuse submission failed. Please try again later.

Close [x]

developerWorks: Sign in


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

Close [x]

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 

All information submitted is secure.

Rate this article

Comments

Back to top

Close [x]

Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Close [x]

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=WebSphere
ArticleID=600015
ArticleTitle=Setting up a test scenario in WebSphere MQ File Transfer Edition
publish-date=12222010
author1-email=lrodrigu@ve.ibm.com
author1-email-cc=

Table of contents

Next steps from IBM

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

For articles in technology zones (such as Java technology, Linux, Open source, XML), Popular tags shows the top tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), Popular tags shows the top tags for just that product zone.

For articles in technology zones (such as Java technology, Linux, Open source, XML), My tags shows your tags for all technology zones. For articles in product zones (such as Info Mgmt, Rational, WebSphere), My tags shows your tags for just that product zone.

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

 

Dig deeper into WebSphere on developerWorks

Try IBM PureSystems. No charge.

IBM PureSystems on a kaleideoscope background

Experience today!

Get started with the cloud-based trial and pattern development kit.

Special offers

On demand demos: An easy way to watch and learn

Get recognized! W Author Program

Cloud Computing resources for IT professionals

Trial software offers

Share this page:

  • Close [x]

Follow developerWorks:

  • Close [x]