Creating a IBM WebSphere MQ File Transfer Edition (FTE) bridge agent to a mainframe - Middleware News
This article shows you how to create an IBM® WebSphere® MQ FTE bridge
agent, a special FTE agent that can be used to communicate with a
mainframe,
and explains the special parameters used by the bridge agent.
The
You can get all of the possible values by typing
You will need to confirm the parameter
Prerequisites
- Basic knowledge of WebSphere MQ FTE
- WebSphere MQ FTE V7.0.4.1 or later installed on each end. (Bridge agent functionality is not available in earlier versions of WebSphere MQ FTE).
Step 1. Creating the bridge agent
The command to create a bridge agent is fairly standard, but adds certain parameters that are not commonly used on distributed systems. Pay particular attention to the parameters shown in bold:fteCreateBridgeAgent -agentName-agentQMgr -agentQMgrHost -agentQMgrPort -agentQMgrChannel -bt -bh -bm -bsl -bfe -btz
Example
This command creates a bridge agent onagthost.ibm.com
to talk to mainframe.ibm.com
:fteCreateBridgeAgent -agentName FTPAGENT -agentQMgr AGTFTE -agentQMgrHost agthost.ibm.com -agentQMgrPort 1426 -agentQMgrChannel SYSTEM.DEF.SVRCONN -bt FTP -bh mainframe.ibm.com -bm UNIX -bsl en_US -bfe IBM1047 -btz US\Eastern
bfe
parameter is what you will need to confirm with the mainframe team. This example transfers to z/OS using a format of IBM1047
.
Here is the definition that you get for bfe
when using -h on fteCreateBridgeAgent
:Required. Defines the file-encoding format of the file stored on the protocol file server. For example: UTF-8.
fteCreateBridgeAgent -hcs
.Step 2. Import MQSC file
The next step, as for any agent you create, is to import the definitions in the mqsc file after the create bridge command is successful. Using the example above:runmqsc AGTFTE < FTPAGENT_create.mqsc
Step 3. Edit the ProtocolBridgeCredentials.xml file
Edit the resultantProtocolBridgeCredentials.xml
file. Open the file in your editor and find the following string:user name
- userid that will run the createtransfer command
serverUserId
- logon id for the mainframe
serverPassword
- password for this userid
Step 4. Start the bridge agent
You can now start the bridge agent in the same way as on distributed FTE servers. Using the example above:fteStartAgent FTPAGENT
Step 5. Test a file transfer
Test the bridge agent by transferring a text file. The source agent in this example isAGTAGENT
(which has already been created).
The target is the bridge agent you just created: FTPAGENT
. A most important parameter is dce
.fteCreateTransfer -sa AGTAGENT -da FTPAGENT -t text -dce ibm1047 -df
ibm1047
with the z/OS team, and then verify that the source file was transferred to the mainframe.
Comments
Post a Comment