Convert_Outgoing (CPI-C)

Artikel
02/13/2024

Der Convert_Outgoing-Aufruf (Funktionsname cmcnvo) konvertiert eine Zeichenfolge von ASCII-Zeichen in EBCDIC. 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   
);

Parameter

string
Angegebener Parameter. Gibt die zu konvertierende ASCII-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 EBCDIC-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 EBCDIC-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 zwei Bytelänge (NN) gefolgt von den Daten bestehen. 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 Werte des Längenfelds ungültig werden.

Freigeben über