Convert_Incoming (CPI-C)

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

Sintassi

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

Parametri

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

• Maiuscole A-Z

• Minuscolo a-z

• Numeri da 0 a 9

• Periodo (.)

• Spaziatura

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

  string_length caratteri di questa stringa verranno sostituiti da equivalenti ASCII.

  string_length
  Parametro fornito. Specifica il numero di caratteri da convertire (1-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 ASCII convertita.

CM_OPERATION_NOT_ACCEPTED
Codice restituito primario; il parametro string_length 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ò essere 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 2 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'operazione, perché in questo modo i valori dei campi di lunghezza non sono validi.