InfoConnect API Guide
Attachmate.Reflection.Emulation.OpenSystems Namespace / ITerminal Interface / ProcessDataComm Property


In This Topic
    ProcessDataComm Property
    In This Topic
    Gets or sets a value indicating whether InfoConnect processes incoming characters between calls to InfoConnect 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 InfoConnect 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 InfoConnect from an external application using Automation.

    When this property is set to false, InfoConnect only processes incoming datacomm characters during an explicit call to a method that reads datacomm (such as ReadChars, ReadLine, or WaitForString). InfoConnect does not process incoming unless it is instructed to do so. The data will sit in a queue until one of the InfoConnect 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 InfoConnect 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), InfoConnect processes incoming data just as a terminal would.

    See Also