RESOLUTION
SNA Server 3.0
To resolve this problem, obtain the latest service pack for SNA Server version 3.0. For more information, click the following article number to view the article in the Microsoft Knowledge Base:
184307 How to obtain the latest SNA Server Version 3.0 service pack
SNA Server 4.0
To resolve this problem, obtain the latest service pack for SNA Server version 4.0. For more information, click the following article number to view the article in the Microsoft Knowledge Base:
215838 How to obtain SNA Server Version 4.0 U.S Service Pack 2
MORE INFORMATION
The function call definitions for CMCNVO and CMCNVI are listed
below.
Convert_Incoming()
The Convert_Incoming call (function name cmcnvi) converts a string
of
EBCDIC characters into ASCII.
Note The return conversion can be performed using
Convert_Outgoing.
CM_ENTRY Convert_Incoming(
unsigned char FAR *string,
CM_INT32 FAR *string_length,
CM_INT32 FAR *return_code
);
Parameters
string
Supplied parameter. Specifies the EBCDIC string to be converted.
It may
contain any of the following characters:
Uppercase A-Z, lowercase a-z, 0-9, the period (.) and space
characters, and the special characters < > + - ( ) &
* ; : , ' ? / _ = ".
string_length characters of this string will be replaced by ASCII equivalents.
string_length
Supplied parameter. Specifies the number of characters to be
converted (1
- 32767).
return_code
The code returned from this call. The valid return codes are
listed below.
Return Codes:
CM_OK
Primary return code; the call executed successfully, the string
parameter
now contains the converted ASCII string.
CM_PROGRAM_PARAMETER_CHECK
Primary return code; the string_length parameter specified an
invalid
value.
CM_PRODUCT_SPECIFIC_ERROR
Primary return code; a product-specific error occurred and has
been logged
in the product's error log.
State Changes:
The conversation can be in any state.
There is no state change.
Remarks:
When data is being received in buffer format in a basic
conversation the
data buffer may contain multiple logical records; each consisting
of a two-
byte length field (NN), followed by the data. The application must
extract
and convert each data string separately (not including the NN
bytes). It
must not attempt to convert the whole buffer in one operation,
because this
will make the NN values invalid.
Convert_Outgoing()
The Convert_Outgoing call (function name cmcnvo) converts a string
of ASCII
characters into EBCDIC.
NOTE: The return conversion can be performed using
Convert_Incoming.
CM_ENTRY Convert_Outgoing(
unsigned char FAR *string,
CM_INT32 FAR *string_length,
CM_INT32 FAR *return_code
);
Parameters:
string - Supplied parameter. Specifies the ASCII string to be
converted. It
may contain any of the following characters:
Uppercase A-Z, lowercase a-z, 0-9, the period (.) and space
characters, and the special characters < > + - ( ) & * ; : , ' ?
/ _= ".
string_length characters of this string will be replaced by EBCDIC
equivalents.
string_length - Supplied parameter. Specifies the number of
characters to
be converted (1 - 32767).
return_code - The code returned from this call. The valid return
codes are
listed below.
Return Codes:
CM_OK
Primary return code; the call executed successfully, the string
parameter
now contains the converted EBCDIC string.
CM_PROGRAM_PARAMETER_CHECK
Primary return code; the string_length parameter specified an
invalid
value.
CM_PRODUCT_SPECIFIC_ERROR
Primary return code; a product-specific error occurred and has
been logged
in the product's error log.
State Changes:
The conversation can be in any state.
There is no state change.
Remarks:
When data is being received in buffer format in a basic
conversation the
data buffer may contain multiple logical records; each consisting
of a two-
byte length field (NN), followed by the data. The application must
extract
and convert each data string separately (not including the NN
bytes). It
must not attempt to convert the whole buffer in one operation,
because this
will make the NN values invalid.