ODBC Server Reference Manual

UNIX Notes
HP NonStop ODBC Server Reference Manual—429151-002
9-3
DBIOWDESC
•
An application can use the DB-LIBRARY DBRBUF() routine, in addition to the
UNIX select() function, to help determine whether any more data from SQL
Server is available for reading.
•
A companion routine, DBIOWDESC(), provides access to the file descriptor used to
write data to SQL Server.
Returns
DBIORDESC returns an integer file descriptor used by the specified DBPROCESS to
read data coming from SQL Server.
See Also
For further information, see DBIOWDESC or DBRBUF on page 9-4, or see dbcmd,
dbnextrow, dbresults, dbsqlok, or dbsqlsend in the Microsoft SQL Server
Programmer’s Reference.
DBIOWDESC
DBIOWDESC provides program access to the UNIX file descriptor used by a
DBPROCESS to write data to SQL Server. DBIOWDESC has the following syntax:
dbproc
a pointer to the DBPROCESS structure that provides the connection for a
particular front-end process or SQL Server process. It contains all the information
that DB-LIBRARY uses to manage communications and data between the front
end and SQL Server.
Comments
The following comments apply to DBIOWDESC:
•
This routine provides a way for an application to effectively use 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 SQL Server (usually
made using a call to dbsqlsend()) and the completion of that attempt can be
significant. You can 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 SQL Server. This information can
be used with various operating system facilities (such as the UNIX select()
function) to allow the application to effectively use multiple input and output
streams.
int DBIOWDESC(dbproc)
DBPROCESS *dbproc;