Set_Prepare_To_Receive_Type (CPI-C)

La chiamata Set_Prepare_To_Receive_Type ( nome funzione cmsptr) specifica la modalità di esecuzione delle chiamate Prepare_To_Receive successive. Esegue l'override dell'elaborazione di preparazione alla ricezione predefinita stabilita da Initialize_Conversation o Accept_Conversation. Per impostazione predefinita, l'elaborazione di preparazione alla ricezione si basa sul livello di sincronizzazione della conversazione.

Il tipo di preparazione alla ricezione influisce su tutte le chiamate Prepare_To_Receive successive. Può essere modificato riemettendo Set_Prepare_To_Receive_Type.

Sintassi

  
CM_ENTRY Set_Prepare_To_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *prepare_to_receive_type,    
  CM_INT32 FAR *return_code              
);  

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.

prepare_to_receive_type
Parametro fornito. Specifica la modalità di esecuzione delle chiamate Prepare_To_Receive successive. I valori possibili sono:

CM_PREP_TO_RECEIVE_CONFIRM
Usato per inviare al programma partner il contenuto del buffer di invio dell'unità logica (LU) e una richiesta di conferma. Al momento della ricezione della conferma, la conversazione cambia in stato RECEIVE.

CM_PREP_TO_RECEIVE_FLUSH
Usato per inviare il programma partner il contenuto del buffer di invio delle unità di archiviazione locali e modifica lo stato della conversazione in RECEIVE.

CM_PREP_TO_RECEIVE_SYNC_LEVEL
Utilizzato dal livello di sincronizzazione delle conversazioni per determinare l'elaborazione di preparazione alla ricezione. Un livello di sincronizzazione predefinito viene stabilito da Initialize_Conversation e può essere sottoposto a override da Set_Sync_Level.

Se il livello di sincronizzazione della conversazione è CM_NONE, il contenuto del buffer di invio delle UNITÀ locali viene inviato al programma partner e la conversazione cambia nello stato RECEIVE. Se il livello di sincronizzazione della conversazione è CM_CONFIRM, il contenuto del buffer di invio delle UNITÀ locali e una richiesta di conferma vengono inviati al programma partner. La conversazione passa allo stato RECEIVE quando il programma partner rilascia Confermato, rispondendo alla richiesta di conferma.

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.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

• Il valore specificato da prepare_to_receive_type o conversation_ID non è valido.

• Il parametro prepare_to_receive_type è impostato su CM_PREP_TO_RECEIVE_CONFIRM, ma il livello di sincronizzazione delle conversazioni è impostato su CM_NONE.

  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, ad eccezione di RESET.

Non esiste alcuna modifica dello stato.