Reflection .NET API
Attachmate.Reflection.Emulation.OpenSystems Assembly / Attachmate.Reflection.Emulation.OpenSystems Namespace / ITerminal Interface / ProcessDataComm Property


In This Topic
ProcessDataComm Property
In This Topic
Gets or sets a value indicating whether Reflection processes incoming characters between calls to Reflection methods.
Syntax
'Declaration
 
Property ProcessDataComm As Boolean
 
'Usage
 
Dim instance As ITerminal
Dim value As Boolean
 
instance.ProcessDataComm = value
 
value = instance.ProcessDataComm

Property Value

The default value is true.

Regardless of the current value of ProcessDataComm, when Reflection runs 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.

Remarks
Do not use this property unless you are controlling Reflection from an external application using Automation.

When 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). 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.

In addition, an external program has exclusive access to the incoming datastream, ensuring that no incoming characters are lost. For example, if the controlling program is logging on, 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 that the logon 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.

When this property is set to true (the default), Reflection processes incoming data just as a terminal would.

See Also