SQL/MP Programming Manual for C

SQL/MP System Procedures
HP NonStop SQL/MP Programming Manual for C—429847-008
5-4
SQLCADISPLAY
sqlca
is a pointer to the SQLCA structure. The C compiler automatically declares the
SQLCA structure when you specify the INCLUDE SQLCA directive.
output_file_number
is the output file number. If you omit this value or set it to a negative value,
SQLCADISPLAY displays information at your home terminal. In this case,
SQLCADISPLAY opens your home terminal, displays the message, and then
closes your terminal. This parameter is ignored if detail_params specifies
sequential I/O (SIO).
output_record_length
is the length in bytes of records to be written to the output file. The length must be
an integer value from 60 through 600. The default length is 79 bytes.
sql_msg_file_number
is the file number of the SQL message file (SQLMSG is the default file). If you
specify -1 as the input value, the system opens the message file and returns the
resulting file number. If you specify a value other than -1, the system uses that
value as the file number of the message file.
To improve the performance of multiple calls to the SQLCADISPLAY (or the
SQLCATOBUFFER procedure), specify -1 on the first call and then use the
returned file number for subsequent calls. By using the file number, the system
opens the file only once and uses the file number for subsequent calls. Otherwise,
the system opens the file for each call.
#include <cextdecs(SQLCADISPLAY)>
void SQLCADISPLAY (
short *sqlca, /* i */
[ short output_file_number, ] /* i */
[ 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 */
[ short *detail_params ] /* i */
);