User Buffer

The user buffer is an internal buffer created by VuGen to manage the data. One user buffer is generated for each existing socket. Do not free this buffer. It is recommended that you do not write to the buffer.

The user buffer is used by the following functions:

• lrs_ascii_to_ebcdic

• lrs_ebcdic_to_ascii

• lrs_get_static_buffer

• lrs_get_received_buffer

Each call to one of the above functions overwrites the previous contents of the user buffer.

You can retrieve information about the user buffer using the following functions:

• lrs_get_user_buffer

• lrs_get_user_buffer_size

In all of the above user buffer functions, use lrs_get_user_buffer_size to determine the actual buffer size before printing the buffer contents. Do not retrieve the entire buffer using a -1 as the length argument, and then try to print its contents. The reason for this is that VuGen may misinterpret the NULL characters within the buffer as a terminating string. Print functions include all the Message Functions such as lr_output_message.