Programming with Reflection

image\rwnprg32.gif ProcessDatacomm property

 

Syntax

object.ProcessDatacomm
object.ProcessDatacomm = Value

Works with

image\r124.gif

Data type

Boolean

 

Description

Returns (first syntax line) or specifies (second syntax line) whether Reflection should process incoming characters between calls to Reflection methods. If this property is set to False, Reflection only processes incoming datacomm characters during an explicit call to a method that reads datacomm (such as ReadChars, ReadLine, or WaitForString). (See the note below for more information.)

Do not use this property unless you are controlling Reflection from an external application using Automation. When this property is False, an external program has exclusive access to the incoming datastream, ensuring that no incoming characters are lost. If the controlling program is doing a login, for example, it is important that Reflection does not process the incoming data after a Transmit method but before the subsequent WaitForString method. So the controlling program must set ProcessDataComm to False to assure the login works correctly. However, if the controlling program wants the user to interact directly with a host application, it must set ProcessDataComm to True to allow that user interaction.

Values

The default value is True.

Notes

· When ProcessDataComm is True (the default), Reflection processes incoming data just as a terminal would.

· When ProcessDataComm is False, Reflection does not process incoming unless it is instructed to do so. The data will sit in a queue until one of the Reflection methods that explicitly processes this data (such as WaitForString) is executed.

· Regardless of the current value of ProcessDataComm, when Reflection is running a macro (or script), data from the host is processed only if the macro includes methods (such as WaitForString) that explicity handle incoming data. Data not handled explicitly in the macro is not processed until the macro terminates.

 

image\jump.gif Example

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this property