Confirm (CPI-C)

La chiamata Conferma (nome funzione cmcfm) invia il contenuto del buffer di invio dell'unità logica locale (LU) e una richiesta di conferma al programma partner e attende la conferma. Per Microsoft Windows, eseguire un thread in background per tutte le comunicazioni CPI-C e mantenere il thread in primo piano solo per l'interfaccia utente.

Sintassi

  
CM_ENTRY Confirm(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *request_to_send_received,    
  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.

request_to_send_received
Parametro restituito. Fornisce l'indicatore request-to-send-received. I valori possibili sono:

CM_REQ_TO_SEND_RECEIVED
Il programma partner ha rilasciato Request_To_Send, che richiede al programma locale di modificare lo stato di ricezione della conversazione.

CM_REQ_TO_SEND_NOT_RECEIVED
Il programma partner non ha eseguito Request_To_Send. Questo valore non è rilevante se return_code è impostato su CM_PROGRAM_PARAMETER_CHECK o CM_PROGRAM_STATE_CHECK.

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. Il programma partner ha rilasciato la chiamata confermata .

CM_OPERATION_NOT_ACCEPTED
Codice restituito primario; un'operazione precedente in questa conversazione è incompleta.

CM_OPERATION_INCOMPLETE
Codice restituito primario; l'operazione non è stata completata (la modalità di elaborazione non è bloccata solo) ed è ancora in corso. Il programma può eseguire Wait_For_Conversation per attendere il completamento dell'operazione o Cancel_Conversation per annullare l'operazione e la conversazione. Se Specify_Windows_Handle è stato chiamato, l'applicazione deve attendere la notifica da un messaggio di Windows e non chiamare Wait_For_Conversation.

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

• Il valore specificato da conversation_ID non è valido.

• Il programma locale ha tentato di usare Conferma in una conversazione con un livello di sincronizzazione di CM_NONE. Il livello di sincronizzazione deve essere CM_CONFIRM.

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

• La conversazione non era in stato SEND o SEND_PENDING.

• La conversazione di base per il programma locale era in stato SEND e il programma locale non ha completato l'invio di un record logico.

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

  CM_CONVERSATION_TYPE_MISMATCH
  Codice restituito primario; l'lu o il programma partner non supporta il tipo di conversazione (basic o mappato) specificato nella richiesta di allocazione.

  CM_PIP_NOT_SPECIFIED_CORRECTLY
  Codice restituito primario; la richiesta di allocazione è stata rifiutata da un programma di transazione NON CPI-C LU 6.2 (TP). Il programma partner richiede una o più variabili di dati PIP, che non sono supportate da CPI-C.

  CM_SECURITY_NOT_VALID
  Codice restituito primario; l'identificatore utente o la password specificati nella richiesta di allocazione non viene accettato dall'LU partner.

  CM_SYNC LEVEL_NOT_SUPPORTED_PGM
  Codice restituito primario; il programma partner non supporta il livello di sincronizzazione specificato nella richiesta di allocazione.

  CM_TPN_NOT_RECOGNIZED
  Codice restituito primario; l'lu partner non riconosce il nome del programma specificato nella richiesta di allocazione.

  CM_TP_NOT_AVAILABLE_NO_RETRY
  Codice restituito primario; il lu partner non può avviare il programma specificato nella richiesta di allocazione a causa di una condizione permanente. Il motivo dell'errore può essere connesso al nodo remoto. Non ripetere l'allocazione finché l'errore non è stato corretto.

  CM_TP_NOT_AVAILABLE_RETRY
  Codice restituito primario; il lu partner non può avviare il programma specificato nella richiesta di allocazione a causa di una condizione temporanea. Il motivo dell'errore può essere connesso al nodo remoto. Riprovare l'allocazione.

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

• Durante lo stato RECEIVE o CONFIRM, il programma partner ha rilasciato Send_Error. I dati inviati ma non ancora ricevuti vengono eliminati.

• Mentre in SEND_PENDING stato con la direzione degli errori impostata su CM_RECEIVE_ERROR, il programma partner ha rilasciato Send_Error. I dati non sono stati eliminati.

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

• La conversazione è stata terminata prematuramente a causa di una condizione permanente. Non riprovare finché l'errore non è stato corretto.

• Il programma partner non ha deallocato la conversazione prima di terminare normalmente.

  CM_RESOURCE_FAILURE_RETRY
  Codice restituito primario; la conversazione è stata terminata prematuramente a causa di una condizione temporanea, ad esempio l'errore del modem. Riprovare la conversazione.

  CM_DEALLOCATED_ABEND
  Codice restituito primario; la conversazione è stata deallocata per uno dei motivi seguenti:

• Il programma remoto rilasciato Deallocate con il parametro di tipo impostato su CM_DEALLOCATE_ABEND. Se la conversazione per il programma remoto era in stato RECEIVE quando la chiamata è stata rilasciata, le informazioni inviate dal programma locale e non ancora ricevute dal programma remoto vengono rimosse.

• Il programma partner è terminato normalmente, ma non ha deallocato la conversazione prima di terminare.

  CM_DEALLOCATED_ABEND_SVC
  Codice restituito primario; la conversazione è stata deallocata per uno dei motivi seguenti:

• Il programma partner ha rilasciato Deallocate con il parametro di tipo impostato su ABEND_SVC.

• Il programma partner non ha deallocato la conversazione prima di terminare.

  Se la conversazione è in stato RECEIVE per il programma partner quando questa chiamata viene rilasciata dal programma locale, i dati inviati dal programma locale e non ancora ricevuti dal programma partner vengono eliminati.

  CM_DEALLOCATED_ABEND_TIMER
  Codice restituito primario; la conversazione è stata deallocata perché il programma partner ha rilasciato Deallocate con il parametro di tipo impostato su ABEND_TIMER. Se la conversazione è in stato RECEIVE per il programma partner quando questa chiamata viene rilasciata dal programma locale, i dati inviati dal programma locale e non ancora ricevuti dal programma partner vengono eliminati.

  CM_SVC_ERROR_PURGING
  Codice restituito primario; mentre nello stato SEND, il programma partner o l'lu partner ha rilasciato Send_Error con il parametro di tipo impostato su SVC. I dati inviati al programma partner potrebbero essere stati eliminati.

  Modifiche dello stato

  La conversazione può trovarsi nello stato SEND o SEND_PENDING quando viene emesso Conferma .

  Le modifiche allo stato, riepilogate nella tabella seguente, sono basate sul valore del parametro return_code .

return_code	Nuovo stato
CM_OK	Nessuna modifica
La chiamata è stata emessa nello stato SEND	Nessuna modifica
La chiamata è stata emessa nello stato di SEND_PENDING	SEND
CM_PROGRAM_ERROR_PURGING	RECEIVE
CM_SVC_ERROR_PURGING	RECEIVE
CM_CONVERSATION_TYPE_MISMATCH	RESET
CM_PIP_NOT_SPECIFIED_CORRECTLY	RESET
CM_SECURITY_NOT_VALID	RESET
CM_SYNC_LEVEL_NOT_SUPPORTED_PGM	RESET
CM_TPN_NOT_RECOGNIZED	RESET
CM_TP_NOT_AVAILABLE_NO_RETRY	RESET
CM_TP_NOT_AVAILABLE_RETRY	RESET
CM_RESOURCE_FAILURE_NO_RETRY	RESET
CM_RESOURCE_FAILURE_RETRY	RESET
CM_DEALLOCATED_ABEND	RESET
CM_DEALLOCATED_ABEND_SVC	RESET
CM_DEALLOCATED_ABEND_TIMER	RESET
Tutti gli altri	Nessuna modifica

Commenti

In risposta a Conferma, il programma partner normalmente genera problemi Conferma per confermare che i dati sono stati ricevuti senza errori. Se il programma partner rileva un errore, genera Send_Error o usa Deallocate per deallocare in modo anomalo la conversazione.

Il programma può emettere Conferma solo se il livello di sincronizzazione delle conversazioni è CM_CONFIRM.

Confermare le attese per una risposta dal programma partner. Una risposta viene generata da una delle chiamate CPI-C seguenti nel programma partner:

• Confermato

• Send_Error

• 5Deallocate con il tipo deallocate conversazioni impostato su CM_DEALLOCATE_ABEND