Konvertiere_Ausgehend (CPI-C)

Der Convert_Outgoing Aufruf (Funktionsname cmcnvo) wandelt eine Zeichenfolge von ASCII-Zeichen in EBCDIC um. Beachten Sie, dass die Rückgabekonvertierung mit Convert_Incoming ausgeführt werden kann.

Syntax

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

Die Parameter

String
Angegebener Parameter. Gibt die ASCII-Zeichenfolge an, die konvertiert werden soll. Die Zeichenfolge kann eines der folgenden Zeichen enthalten:

• Großbuchstaben A–Z

• Kleinbuchstaben a–z

• Zahlen 0–9

• Der Punkt (.)

• Leerzeichen

• Die Sonderzeichen <> + - ( ) & * ; : , ' ? / _= ".

  string_length Zeichen dieser Zeichenfolge werden durch EBCDIC-Äquivalente ersetzt.

  string_length
  Angegebener Parameter. Gibt die Anzahl der zu konvertierenden Zeichen an (1–32767).

  return_code
  Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt, und der Zeichenfolgenparameter enthält nun die konvertierte EBCDIC-Zeichenfolge.

CM_OPERATION_NICHT_AKZEPTIERT
Primärer Rückgabecode; der string_length Parameter hat einen ungültigen Wert angegeben.

CM_PRODUKT_SPEZIFISCHER_FEHLER
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand befinden.

Es gibt keine Zustandsänderung.

Bemerkungen

Wenn Daten im Pufferformat in einer einfachen Unterhaltung empfangen werden, kann der Datenpuffer mehrere logische Datensätze enthalten, die jeweils aus einem Zwei-Byte-Längenfeld (NN) bestehen, gefolgt von den Daten. Die Anwendung muss jede Datenzeichenfolge separat extrahieren und konvertieren (mit Ausnahme des Längenfeldwerts). Die Anwendungen dürfen nicht versuchen, den gesamten Puffer in einem Vorgang zu konvertieren, da dadurch die Längenfeldwerte ungültig werden.