exchange_data (k, v, t)

The exchange_data(k, v, t) function is used to exchange data between a KCM Core server and a client.

KCM Core sends the value v to the client and waits for the client to send a response back.

Identifier k can be used by the client to identify the data.

Identifier t is the amount of time that KCM Core waits for the client to send its response back. After this time has elapsed without an answer, KCM Core closes the connection and reports an error. The client can handle this error but is not able to communicate with the server. KCM Core does not time out if this parameter is set to 0.

The following applies to this function:

• The function requires a synchronous connection.
• The function returns the response from the client.
• If the function causes an error, the return value is unspecified.
• If this function is used and the client does not respond within the timeout period, the Document Processor handling the job disconnects from the KCM Core Processor Manager and reconnects after the job has finished. This disconnect is necessary to resynchronize communication.

You can also use the function exchange_data in combination with the web services interface to allow for communication between the caller and the KCM Core script. For more information, see SubmitEx in the Kofax Communications Manager Core Developer's Guide.