Convert_Outgoing (CPI-C)

  • Artículo

La llamada Convert_Outgoing (nombre de función cmcnvo) convierte una cadena de caracteres ASCII en EBCDIC. Tenga en cuenta que la conversión de devolución se puede realizar mediante Convert_Incoming.

Sintaxis

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

Parámetros

string
Parámetro proporcionado. Especifica la cadena ASCII que se va a convertir. La cadena puede contener cualquiera de los siguientes caracteres:

  • Mayúsculas A-Z

  • Minúscula a-z

  • Números de 0 a 9

  • El punto (.)

  • Caracteres de espacio

  • Los caracteres <> especiales + - ( ) & * ; : , ' ? / _= ".

    string_length caracteres de esta cadena se reemplazarán por equivalentes de EBCDIC.

    string_length
    Parámetro proporcionado. Especifica el número de caracteres que se van a convertir (1–32767).

    return_code
    Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente y el parámetro string contiene ahora la cadena EBCDIC convertida.

CM_OPERATION_NOT_ACCEPTED
Código de retorno principal; el parámetro string_length especificó un valor no válido.

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación puede estar en cualquier estado.

No hay ningún cambio de estado.

Comentarios

Cuando los datos se reciben en formato de búfer en una conversación básica, el búfer de datos puede contener varios registros lógicos, cada uno que consta de un campo de longitud de dos bytes (NN) seguido de los datos. La aplicación debe extraer y convertir cada cadena de datos por separado (excepto el valor del campo de longitud). Las aplicaciones no deben intentar convertir todo el búfer en una operación, ya que esto hará que los valores de campo de longitud no sean válidos.