Convert_Outgoing (CPI-C)

  • Articolo

La chiamata Convert_Outgoing (nome funzione cmcnvo) converte una stringa di caratteri ASCII in EBCDIC. Si noti che la conversione restituita può essere eseguita usando Convert_Incoming.

Sintassi

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

Parametri

string
Parametro fornito. Specifica la stringa ASCII da convertire. La stringa può contenere uno dei caratteri seguenti:

  • A-Z maiuscolo

  • Minuscola a-z

  • Numeri da 0 a 9

  • Punto (.)

  • Spaziatura caratteri

  • I caratteri <> speciali + - ( ) & * ; : , ' ? / _= ".

    string_length caratteri di questa stringa verranno sostituiti da equivalenti EBCDIC.

    string_length
    Parametro fornito. Specifica il numero di caratteri da convertire (da 1 a 32767).

    return_code
    Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente e il parametro stringa contiene ora la stringa EBCDIC convertita.

CM_OPERATION_NOT_ACCEPTED
Codice restituito primario; il parametro string_length ha specificato un valore non valido.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione può trovarsi in qualsiasi stato.

Non esiste alcuna modifica dello stato.

Commenti

Quando i dati vengono ricevuti in formato buffer in una conversazione di base, il buffer di dati può contenere più record logici, ognuno costituito da un campo di lunghezza a due byte (NN) seguito dai dati. L'applicazione deve estrarre e convertire separatamente ogni stringa di dati (escluso il valore del campo di lunghezza). Le applicazioni non devono tentare di convertire l'intero buffer in un'unica operazione, perché in questo modo i valori dei campi di lunghezza non sono validi.