[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 COM_REMOTE()
 Determines the clear character for the receiving buffer
------------------------------------------------------------------------------
 Syntax

     COM_REMOTE(<nComPort>,[<nCharacter|cCharacter>])
        --> lActive

 Arguments

     <nComPort>  Designates the port (1 to 4) where an external line
     termination character is established.

     <nCharacter|cCharacter>  Designates a line termination character,
     which could be a numeric value or a character.  When it is not
     specified, the existing line termination character (if any) is canceled.
     The default character is the no line termination character.

 Returns

     COM_REMOTE() returns .F. if the specified port is invalid.

 Description

     When longer text is sent, the receiver should be able to break off the
     transmission session or to delete the sending buffer.  To do this, a
     character can be defined as an external line termination character.  If
     this character is received, it deletes the background buffer of the
     sending station, as if you had called COM_SFLUSH().  The sending
     CA-Clipper program no longer concerns itself with this session.

     COM_SMODE() can help you determine if the buffer of the remote station
     has been deleted.

 Note

     .  Before a binary file transfer, an existing line termination
        character should be canceled because the transmission could be
        terminated accidentally.

 Examples

     .  The remote station can terminate using Ctrl-X (Port 2):

        COM_REMOTE(2, 24)
        COM_SEND(2, cLongText)

        IF ISBIT(COM_SMODE(2), 4)
           ? "Sending buffer is deleted automatically by remote station!"
        ENDIF

     .  Eliminate the external line termination character:

        COM_REMOTE(2)


See Also: COM_SKEY() COM_SMODE() COM_SFLUSH()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson