Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > setNetBufferLimits |  |

setNetBufferLimits

Syntax

    gMultiuserInstance.setNetBufferLimits(tcpipReadSize, maxMessageSize, maxIncomingUnreadMessages)

Description

Multiuser Server Lingo command; sets the size of internal buffers and sets limits on the number of messages that the Xtra can queue in memory. The command is not normally needed, but it can be used to fine-tune memory management. If a movie sends or receives particularly large messages, such as picture data, these values should be set to accommodate them. Specify all the values in bytes.

In order to take effect, this command must be issued immediately after a Multiuser Xtra instance is created. It will not take effect once a server connection has been established.

tcpipReadSize controls the maximum amount of data read each time the Xtra takes data from the low-level TCP/IP data stream. This may be altered to tweak performance, particularly when receiving large messages. The default is 16K bytes.

maxMessageSize controls the buffers used to store parts of messages sent and received from another system. The default value is 16K bytes. This must be larger than the largest message sent or received.

maxIncomingUnreadMsgs sets a limit on the number of unread incoming messages that can be accumulated. The default is 100.

Example

This statement sets the maxMessageSize to 350K bytes to accommodate sending image data back and forth:

    errCode = gMultiuserInstance.setNetBufferLimits(16 * 1024, 350 * 1024, 100)