Specify which Connect:Direct® process to start
as part of a WebSphere® MQ
File Transfer Edition transfer. WebSphere MQ
File Transfer Edition provides an XML file
that you can edit to specify process definitions.
About this task
The fteCreateCDAgent command
creates the file ConnectDirectProcessDefinitions.xml in
the agent configuration directory configuration_directory/coordination_queue_manager/agents/cd_bridge_agent_name.
Before you can call user-defined Connect:Direct processes from
the Connect:Direct bridge
agent, you must set up process definitions by editing this file.
For
each process that you want to specify to call as part of a transfer
through the Connect:Direct bridge,
perform the following steps:
Procedure
- Define the Connect:Direct process
that you want the Connect:Direct bridge
agent to call as part of the transfer and save the process template
in a file.
- Open the configuration_directory/coordination_queue_manager/agents/cd_bridge_agent_name/ConnectDirectProcessDefinitions.xml file
in a text editor.
- Create a <processSet> element.
- Inside the <processSet> element, create
a <condition> element.
- Inside the <condition> element, create
one or more elements that define a condition that the transfer request
must match to call the Connect:Direct process
you defined in Step 1. These elements can be either <match> elements
or <defined> elements.
- Use a <match> element to specify that
the value of a variable must match a pattern. Create the <match> element
with the following attributes:
- variable - the name of the variable whose value
is compared. The variable is an intrinsic symbol. For more information,
see Substitution variables for use with user-defined Connect:Direct processes.
- value - the pattern to compare to the value of
the specified variable.
- Optional: pattern - the
type of pattern used by the value of the value attribute.
This pattern type can be wildcard or regex.
This attribute is optional and the default is wildcard.
- Use a <defined> element to specify that
a variable must have a value defined. Create the <defined> element
with the following attribute:
The conditions specified within the <condition> element
are combined with a logical AND. All conditions must be met for the Connect:Direct bridge agent to
call the process specified by this <processSet> element.
If you do not specify a <condition> element, the
process set matches all transfers.
- Inside the <processSet> element, create
a <process> element.
- Inside the <process> element, create
a <transfer> element. The transfer
element specifies the Connect:Direct process
that the Connect:Direct bridge
agent calls as part of the transfer. Create the <transfer> element
with the following attribute:
- process- - the location of the Connect:Direct process that you
defined in step 1. The location of this file is specified with an
absolute path or relative to the configuration_directory/coordination_queue_manager/agents/cd_bridge_agent_name directory.
Results
When searching for a condition match, the
Connect:Direct bridge agent searches
from the top to the bottom of the file. The first match that is found
is the one that is used.