Convert_Outgoing调用(函数名称 cmcnvo)将 ASCII 字符字符串转换为 EBCDIC。 请注意,可以使用 Convert_Incoming执行返回转换。
语法
CM_ENTRY Convert_Outgoing(
unsigned char FAR *string,
CM_INT32 FAR *string_length,
CM_INT32 FAR *return_code
);
参数
字符串
提供的参数。 指定要转换的 ASCII 字符串。 该字符串可能包含以下任一字符:
大写 A–Z
小写 a–z
数字 0–9
句点 (.)
空格字符
特殊字符 <> + - ( ) & * ; : , ' ? / _= ".
此字符串的string_length 字符将被 EBCDIC 等效项替换。
string_length
提供的参数。 指定要转换的字符数(1–32767)。return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。
返回代码
CM_OK
主要返回代码;成功执行的调用, 字符串 参数现在包含转换后的 EBCDIC 字符串。
CM_OPERATION_NOT_ACCEPTED
主要返回代码; string_length 参数指定了无效值。
产品特定错误
主要返回代码;发生了特定于产品的错误,并且已记录在产品错误日志中。
状态更改
对话可以处于任何状态。
没有状态更改。
注解
在基本会话中以缓冲区格式接收数据时,数据缓冲区可能包含多个逻辑记录,每个逻辑记录由一个两字节长度字段(NN)和随后跟随的数据组成。 应用程序必须单独提取和转换每个数据字符串(不包括长度字段值)。 应用程序不得尝试在一个作中转换整个缓冲区,因为这会使长度字段值无效。