SQL/MP Programming Manual for C

SQL/MP System Procedures
HP NonStop SQL/MP Programming Manual for C—429847-008
5-9
SQLCAGETINFOLIST
SQLCAGETINFOLIST
The SQLCAGETINFOLIST procedure returns error or warning information that
NonStop SQL/MP sets in the SQLCA structure. You specify a list of numbers, called
item codes (shown in Table 5-4 on page 5-11), to specify the error or warning
information, and SQLCAGETINFOLIST returns the information to a structure in your
program.
The information in the SQLCA structure 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
SQLCAGETINFOLIST returns zero after a successful operation or one of the error
codes shown in Table 5-3 on page 5-11 if an error occurs.
sqlca
is a pointer to the SQLCA structure. The C compiler automatically declares the
SQLCA structure if you specify the INCLUDE SQLCA directive.
Note. The SQLCAGETINFOLIST procedure returns error numbers as positive values and
warning numbers as negative values. A program might need to switch the sign before
processing the error or warning.
#include <cextdecs(SQLCAGETINFOLIST)>
short SQLCAGETINFOLIST (
short *sqlca, /* i */
short *item_list, /* i */
short number_items, /* i */
short *result, /* o */
short result_max, /* i */
[ short error_index, ] /* i */
[ short names_max, ] /* i */
[ short params_max, ] /* i */
[ short *result_len, ] /* o */
[ short *error_item ] /* o */
);