SendFile

The command SendFile can be used to upload binary data from ITP/Server to the client. This feature requires a synchronous TCP/IP connection or an MQSeries interface.

For MQSeries, this command will read the contents of the file Src and send it in a message to the queue Dest. It will set the correlation id of the message to the message id of the request. For a detailed explanation refer to the description of the MQSeries protocol in the ITP/Server Manual. If the script specifies *REPLYQ as the Dest queue the MQSeries client will put the message on the queue specified in the attributes ReplyQ/ReplyQMgr of the request message.

Syntax

SendFile
   Src(<text>)
   Dest(<text>)
   TimeOut(<number>);

Parameters

Src: Required.
File on the ITP/Server side.

Dest: Required.
For TCP/IP, a client side file identification. For MQSeries, the name of a queue.

Timeout: Optional.
The maximum amount of time in seconds the command SendFile will wait for the upload to complete. If this time is exceeded the upload is aborted and an error is reported.
If this parameter is omitted ITP/Server will use the default time out interval as configured in the ITP/Server Administrator. If this parameter is set to 0 the upload will not time out.

Remarks

The command SendFile will not perform code page translations. For more information, refer to the command ConvertCodepage.

If the command SendFile is terminated due to a time out the connection to the ITP/Server process will be reset to ensure that data in transit is discarded and processes resynchronize correctly. This forced reset can result in additional network-related errors in the log for this job. Any further communication from this job between the ITP/Document Processor and the client will fail. The client will be informed that the ITP/Document Processor disconnected.