Convert_Incoming(CPI-C)

Convert_Incoming调用(函数名称 cmcnvi)将 EBCDIC 字符字符串转换为 ASCII。 请注意,可以使用 Convert_Outgoing执行返回转换。

语法

  
CM_ENTRY Convert_Incoming(   
  unsigned char FAR *string,    
  CM_INT32 FAR *string_length,  
  CM_INT32 FAR *return_code   
);  

参数

字符串
提供的参数。 指定要转换的 EBCDIC 字符串。 该字符串可能包含以下任一字符:

  • 大写 A–Z

  • 小写 a–z

  • 数字 0–9

  • 句点 (.)

  • 空格字符

  • 特殊字符 <> + - ( ) & * ; : , ' ? / _= ".

    此字符串string_length 字符将被 ASCII 等效项替换。

    string_length
    提供的参数。 指定要转换的字符数(1–32767)。

    return_code
    从此调用返回的代码。 本主题后面列出了有效的返回代码。

返回代码

CM_OK
主要返回代码,调用成功执行后,字符串 参数现在包含转换后的 ASCII 字符串。

CM_OPERATION_NOT_ACCEPTED
主要返回代码; string_length 参数指定了无效值。

产品特定错误
主要返回代码;发生了特定于产品的错误,并且已记录在产品错误日志中。

状态更改

对话可以处于任何状态。

没有状态更改。

注解

当在基本会话中以缓冲区格式接收数据时,数据缓冲区可能包含多个逻辑记录,每个记录包括一个由2字节长度字段(NN)开头的数据。 应用程序必须单独提取和转换每个数据字符串(不包括长度字段值)。 应用程序不得尝试在一个作中转换整个缓冲区,因为这会使长度字段值无效。