The information in this article applies to:
Product: MIM and PM4Data
Version: 8.1.7 - 8.1.8 SR 4
Platform: All
Issue
Large file transfer requests should always use the immediate transfer option. Immediate transfers enable a Transfer Request to be processed synchronously between the Sender and Receiver rather than the normal asynchronous mode.
When this option is used, the File Transfer Service Receiver begins to process the Transfer Request as soon as the first data message arrives on its queue instead of waiting for all of the data to be written to the queue by the Sender. Because the Receiver processes the data messages as they arrive, the queue storage required to transfer a large amount of data is significantly reduced. Normal Transfer Requests require that the Receiver have all related data messages before writing the data to the disk. For example, to process a 1 gigabyte file, the receiving node requires 1 gigabyte for queue storage during the transfer and 1 gigabyte to store the file on disk.
In order to prevent excessive and potentially critical Websphere MQ resource consumption, a feature was added to the product to check the size of the source file. If the size of the file exceeds a specified threshold, then the transfer is automatically changed to an immediate mode transfer. This feature is known as Immediate Threshold. The threshold parameters are generally set in the Registry in the File Transfer Service policy definition, which is found in Service/Config/XMOFTS.xml:
50000000
.
.
.
Note: If the file size threshold is not specified in the File Transfer Service policy, then there is a 50 MB default.
Immediate is not designed to work with destination lists. This becomes problematic when Directory Monitor is used to submit transfer requests. Dirmon initiates the request, but it is the File Transfer Service that actually submits the request. Therefore, if the immediate threshold is exceeded, an invalid transfer message will be generated.
Resolution
To disable the immediate threshold feature for specific requests, the following procedure can be used. Note that this procedure must be completed for each transfer request. Locate the file transfer request in the registry and bypass the threshold check by adding this tag to the request: true
For example:
$XMDM\_SRC\_QMGR\_NAME$::$XMDM\_ORIGINAL\_PATH$ TRUE $XMDM\_SRC\_QMGR\_NAME$ $XMDM\_SRC\_QMGR\_NAME$ LAPXP1 LAPXP1 AMY true $XMDM\_PATH$ c:\\dest\\$XMDM\_ORIGINAL\_NAME$ true 5 1 admin
- NOTE: It is highly recommended that you know the size of the file to be transferred. If an Immediate transfer is required, be sure to do this. All large file transfers should use immediate mode.
