Triggering a file transfer
You can set certain trigger conditions on a file transfer that must be true before that transfer can take place. If the triggering conditions are not true, the file transfer does not take place and a log message is optionally submitted to record the fact the transfer did not happen. The file transfer request is then discarded. For example, you can set up a file transfer that takes place only if a named file on the system where the source agent is located is over a specified size, or if a particular named file exists on the system where the source agent is located. You can set up a triggered file transfer from either the IBM® WebSphere® MQ Explorer or from the command line.
About this task
You can monitor a resource continually for a trigger condition to be satisfied. For further information about resource monitoring see: Resource monitoring.
- If a particular file exists on the same system as the source agent
- If a particular file does not exist on the same system as the source agent
- If a particular file is over a certain size on the system where the source agent is located (the size can be expressed in bytes, KB, MB, or GB). These units of measurement use the 210 convention, for example 1 KB equals 1024 bytes and 1 MB equals 1024 KB.
- For a single condition, you can specify more than one file on the system where the source agent is located. This triggers the transfer if any one of the specified files meets the condition (Boolean operator OR).
- You can specify multiple conditions. This triggers the transfer only if all of the conditions are met (Boolean operator AND).
You can also combine a triggered transfer with a scheduled transfer. See Creating a scheduled file transfer for more information. In this case the trigger conditions are evaluated at the time the schedule is due to start, or for a repeating schedule every time the schedule is due to start.
Triggered transfers are not supported on protocol bridge agents.
To create a triggered file transfer by using the command line, use the -tr parameter on the fteCreateTransfer command.
To create a scheduled file transfer by using the Create New Managed File Transfer wizard in IBM WebSphere MQ Explorer, use the following steps: