Convert_Incoming (CPI-C)

Artikel
02/14/2024

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

Syntax

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

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 erfolgreich ausgeführt wurde, und der Zeichenfolgenparameter enthält nun die konvertierte ASCII-Zeichenfolge.

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

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand befinden.

Es gibt keine Zustandsänderung.

Hinweise

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

Freigeben über