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
    bool ProcessDataComm {get; set;}

    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