ODBC Server Reference Manual

Stored Procedures
HP NonStop ODBC Server Reference Manual—429151-002
5-46
Shell Routines Interface
An SPELIB environment object is not recognized.
The server class program should encode the SPELIB error and issue a REPLY.
•
SPELIB_INVALID_IPC_KEY
An SPELIB key value is not recognized.
This is an internal error. The server class program should encode the SPELIB error
and issue a REPLY.
•
SPELIB_INVALID_SEQ_NUM
The SPELIB sequence number is out of range.
This could be an internal error or a user error. The server class program should
encode the SPELIB error and issue a REPLY.
•
SPELIB_FATAL_ERROR
An unspecified fatal SPELIB internal error has occurred.
The server class program should encode the SPELIB error and issue a REPLY.
SPELIB Tracing
The NonStop ODBC Server supports SP_READ and SP_WRITE trace flags that
record I/O flows between the NonStop ODBC Server and the Pathway server class
program. Tracing is for the NonStop ODBC Server only, not for the Pathway server
class.
Shell Routines Interface
The following describes the entire suite of exported shell routines provided with the
NonStop ODBC Server product. Comments in each function explain its purpose.
Additional information on the ENCODE_xxx and GET_xxx functions can be found in
the descriptions of the related SPELIB functions, earlier in this subsection.
allocate_SQLDA
extern
/*_____________________________________________________________________
This function allocates an SQLDA struct. If requested, it will
include space for the Names Buffer.
num_entries: IN: number of entries in the new SQLDA struct
need_names_buffer: IN: column names buffer indicator
Returns: if successful -- pointer to SQLDA
else -- NULL
___________________________________________________________________*/
SP_READ Records a PATHSEND request to a server class program.
SP_WRITE Records the result set coming back from a server class program.