Convert_Incoming (CPI-C)

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

Syntax

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

Die Parameter

String
Angegebener Parameter. Gibt die zu konvertierende EBCDIC-Zeichenfolge an. 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 ASCII-Entsprechungen 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 ASCII-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 2-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.