HP NonStop SQL/MP Programming Manual page 109

SQL/MP System Procedures
output_buffer_length
is the length of output_buffer in bytes. This length must be:

An integer value from output_record_length through 600

A multiple of output_record_length
The minimum length recommended is 300 bytes.
first_record_number
is the ordinal number of the first error record (line) to be written to the output buffer.
The procedure discards any error records with a lower number.
The default is 1.
The count of lines begins with 1. To obtain more than one error record, increment
the value in first_record_number.
output_records
is the number of records (lines) written to output_buffer.
more
is a flag that indicates whether all desired lines fit into the output_buffer:
Y There were additional records; the buffer overflowed.
N There were no additional records.
output_record_length
defines the length of records to be written to the output_buffer. The length
must be an integer value from 60 through 600. The default is 79 bytes.
The procedure pads each line with spaces and adds suffix and prefix strings if the
call specifies them.
sql_msg_file_number
is the file number of the SQL message file (SQLMSG is the default file). If you
specify -1 as an 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 a program that makes multiple calls to the
SQLCATOBUFFER (or the SQLCADISPLAY 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.
The SQLMSG file contains text in English. You can specify a different SQL
message file with the =_SQL_MSG_node DEFINE. For more information, see
SQL Message File
HP NonStop SQL/MP Programming Manual for C—429847-008
on page 5-2.
5-15
SQLCATOBUFFER