SQL/MP Programming Manual for C

SQL/MP System Procedures
HP NonStop SQL/MP Programming Manual for C—429847-008
5-14
SQLCATOBUFFER
SQLCATOBUFFER
The SQLCATOBUFFER procedure writes to a buffer the error or warning messages
that NonStop SQL/MP returns to the program. This buffer is a structure declared in
variable declarations in the program.
The information returned to the buffer can originate from these subsystems or system
components:

NonStop SQL/MP

NonStop operating system

File system

Disk process (DP2)

FastSort program (SORTPROG process)

Sequential I/O (SIO) procedures
This procedure is similar to the SQLCADISPLAY procedure that writes error
information to a file or terminal.
sqlca
is a pointer to the SQLCA structure. The C compiler automatically declares the
SQLCA structure when you specify the INCLUDE SQLCA directive.
output_buffer
is the name of the buffer where SQLCATOBUFFER writes the error information.
#include <cextdecs(SQLCATOBUFFER)>
void SQLCATOBUFFER (
short *sqlca /* i */
char *output_buffer /* i:o */
short output_buffer_length /* i */
[ short first_record_number ] /* i */
[ short *output_records ] /* o */
[ short *more ] /* o */
[ short output_record_length ] /* i */
[ short *sql_msg_file_number ] /* i:o */
[ short errors ] /* i */
[ short warnings ] /* i */
[ short statistics ] /* i */
[ short caller_error_loc ] /* i */
[ short internal_error_loc ] /* i */
[ char *prefix ] /* i */
[ short prefix_length ] /* i */
[ char *suffix ] /* i */
[ short suffix_length ] /* i */
);