Describes all functions available in X10LDLL.DLL and how to use them.
Note: This DLL is used to setup a named pipe to communicate with the Comm Engine. The functions listed in this section need to be used only if you want to write your own REXX client program to control the Comm Engine. See the section on Comm Engine Function Description for information on how to control the CP290 interface once the pipe is setup.
Description of pipe operation.
The Comm Engine uses a named pipe for interprocess communications. This pipe allows two programs to exchange data between each other. These two programs may be on the same computer or they may be on different computers connected through a LAN or peer-to-peer network.
To establish connection, the Comm Engine will first create a pipe with the fixed name \PIPE\HOUSE290 and place it into a listening mode. The client program (H290MAIN.EXE or any other custom program) will then have to open the same pipe and peek to check if it connected. From that point on, data can be placed on the pipe by either program. All commands are buffered in the pipe and the client program must check the pipe for available data and read it to prevent buffer overrun and data loss. The buffer size is 4096 bytes in size and if full will not accept any additional data. Currently no error is reported if the buffer is full.
If two programs are communicating through a pipe, they have exclusive access to the pipe. A third program can not connect to the same pipe. To free up the pipe, the client program must close the pipe so the Comm Engine can make it available to other programs. If a pipe is closed, all data in the buffer is flushed.
For more details on pipe operation and communication to the Comm Engine, see the included sample REXX programs.
X10LLoadFuncs
X10LDropFuncs
CLReadPipe
CLWritePipe
CLPeekPipe
CLOpenPipe
CLClosePipe