Using CS_NULLTERM with Open Client and Open Server routines

When passed to a Client-Library, Server-Library, or CS-Library routine as a buffer’s length, CS_NULLTERM indicates that the value contained in the buffer is null-terminated (terminated with a single byte with value 0).

Some character sets do not support unambiguous null-terminated strings. Do not use CS_NULLTERM if your application needs to support these types of character sets.

Table 3-10 lists CS-Library, Client-Library, and Server-Library routines that allow the use of CS_NULLTERM:

**Table 3-10: Open Client and Open Server routines that use CS_NULLTERM**
Library	Routine	Description
CS-Library	cs_objects	Save, retrieve, or clear objects and data associated with them.
	cs_strbuild	Construct native language message strings for character sets without NULL bytes.
	cs_strcmp	Compare two strings using a specified sort order.
Client-Library	ct_connect	Connect to a server.
	ct_cursor	Initiate a cursor command.
	ct_debug	Manage debug library operations.
	ct_dyndesc	Perform operations on a dynamic SQL descriptor area.
	ct_labels	Define a security label or clear security labels.
	ct_options	Set or retrieve the values of server options.
	ct_remote_pwd	Define or clear passwords to be used for server-to-server connections.
Server-Library	srv_config	Set server configuration parameters.
	srv_convert	Convert data from one datatype to another.
	srv_createmsgq	Create a message queue.
	srv_createmutex	Create a mutual exclusion semaphore.
	srv_define_event	Define a user event.
	srv_deletemsgq	Delete a message queue.
	srv_deletemutex	Delete a mutex created by srv_createmutex.
	srv_describe	Describe a result row column and its data source.
	srv_envchange	Notify the client of an environment change.
	srv_getobjid	Look up the object ID for a message queue or mutex with a specified name.
	srv_getobjname	Get the name of a message queue or mutex with an identifier.
	srv_init	Initialize an Open Server.
	srv_log	Write a message to the Open Server log file.
	srv_options	Send option information to a client or receive option information from a client.
	srv_paramnumber	Return the position number of a parameter for the current remote procedure call.
	srv_regdefine	Initiate the process of registering a procedure.
	srv_regdrop	Unregister a procedure.
	srv_reginit	Begin executing a registered procedure.
	srv_regnowatch	Remove a client thread from the notification list for a registered procedure.
	srv_regparam	Describe a parameter for a registered procedure being defined, or supply data for the execution of a registered procedure.
	srv_regwatch	Add a client thread to the notification list for a specified procedure.
	srv_returnval	Define a return value for a non-remote procedure call.
	srv_sendmsg	Send a message to the client.
	srv_setustate	Set the user state field in the thread structure. The registered procedures sp_ps and sp_who display this field.
	srv_tabname	Provide the name of the table(s) associated with a set of browse mode results.