Platform

Win32

Purpose

To set the communication port to echo back to the sending device.

Syntax

INTEGER (KIND=3) SETECHOONREADCOMM@(PORTNUM,STATE)
INTEGER (KIND=3) PORTNUM,STATE

Description

When communicating with a serial device such as a terminal, it is often necessary to return the data to the sender. In the case of a terminal the data will be transmitted from its keyboard to the host computer. SETECHOONREADCOMM@ is used to enable (STATE = 1) or disable (STATE = 0) the echoing of data. Data that is echoed back to a terminal will be displayed on its VDU. PORTNUM is a valid port number in the range 1 to 4.

Return value

SETECHOONREADCOMM@ returns a positive value if successful or -1 if an error has occurred.

Notes

To access this routine you need to provide a definition by, for example, including the file clearwin.ins or by using the MSWIN module.