Convert_Outgoing (CPI-C)

  • Article

L’appel Convert_Outgoing (nom de la fonction cmcnvo) convertit une chaîne de caractères ASCII en EBCDIC. Notez que la conversion de retour peut être effectuée à l’aide de Convert_Incoming.

Syntaxe

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

Paramètres

string
Paramètre fourni. Spécifie la chaîne ASCII à convertir. La chaîne peut contenir l’un des caractères suivants :

  • Majuscules A à Z

  • Minuscules de a à z

  • Nombres 0 à 9

  • Le point (.)

  • Espaces

  • Les caractères <> spéciaux + - ( ) & * ; : , ' ? / _= ".

    string_length caractères de cette chaîne seront remplacés par des équivalents EBCDIC.

    string_length
    Paramètre fourni. Spécifie le nombre de caractères à convertir (1 à 32767).

    return_code
    Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
Code de retour principal ; l’appel a été exécuté avec succès et le paramètre string contient désormais la chaîne EBCDIC convertie.

CM_OPERATION_NOT_ACCEPTED
Code de retour principal ; le paramètre string_length a spécifié une valeur non valide.

CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.

Changements d'état

La conversation peut être dans n’importe quel état.

Il n’y a aucun changement d’état.

Remarques

Lorsque des données sont reçues au format de mémoire tampon dans une conversation de base, la mémoire tampon de données peut contenir plusieurs enregistrements logiques, chacun constitué d’un champ de longueur de deux octets (NN) suivi des données. L’application doit extraire et convertir chaque chaîne de données séparément (à l’exception de la valeur du champ de longueur). Les applications ne doivent pas essayer de convertir l’intégralité de la mémoire tampon en une seule opération, car cela rend les valeurs de champ de longueur non valides.