exchange_data (k, v, t)

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

Communications Manager 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 Communications Manager Core waits for the client to send its response back. After this time has elapsed without an answer, Communications Manager Core closes the connection and reports an error. The client can handle this error but is not able to communicate with the server. Communications Manager 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 Communications Manager 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 Communications Manager Core script. For more information, see SubmitEx in the Tungsten Communications Manager Core Developer's Guide.