(UNIX only) Provide program access to the UNIX file descriptor used by a DBPROCESS to write data to the server.
int DBIOWDESC(dbproc) DBPROCESS *dbproc;
A pointer to the DBPROCESS structure that provides the connection for a particular front-end/server process. It contains all the information that DB-Library uses to manage communications and data between the front end and server.
An integer file descriptor used by the specified DBPROCESS to write data to the server.
This routine provides a way for an application to effectively utilize multiple input and output streams. Depending on the nature of your application, the time interval between the initiation of an attempt to write information to the server (usually made using a call to dbsqlsend) and the completion of that attempt may be significant. You may use this time to service other parts of your application. The DBIOWDESC routine provides a way to obtain the I/O descriptor that a DBPROCESS uses to write the data stream to the server. This information may then be used with various operating system facilities (such as the UNIX select function) to allow the application to effectively utilize multiple input and output streams.
The file descriptor returned by this routine may only be used with operating system facilities that do not write data to the outgoing data stream. If data is written to this stream by any means other than through a DB-Library routine, communications between the front-end and the server will become hopelessly scrambled.
A companion routine, DBIORDESC, provides access to the file descriptor used to read data coming from the server. For some applications, another routine, dbpoll may be preferable to DBIORDESC.
dbcmd, DBIORDESC, dbnextrow, dbpoll, dbresults, dbsqlok, dbsqlsend
