Cancel_Conversation (CPI-C)

L’appel Cancel_Conversation (nom de fonction cmcanc) annule toute opération en attente sur une conversation (une opération retournée avec CM_OPERATION_INCOMPLETE) et la conversation elle-même.

Syntaxe

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

Paramètres

conversation_ID
Paramètre retourné. Spécifie l’identificateur de la conversation. La valeur de ce paramètre a été retournée par Initialize_Conversation ou Accept_Conversation.

return_code
Code retourné à partir de cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
Code de retour principal ; l’appel a été exécuté avec succès.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; la valeur spécifiée par conversation_ID n’est pas valide.

CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.

Modifications d’état

La conversation doit être dans n’importe quel état, à l’exception de RESET.

Lorsque le code de retour est CM_OK, l’état de la conversation devient RESET.

Remarques

Cancel_Conversation pouvez être appelée alors qu’une autre opération est active pour la conversation_ID spécifiée. Cela permet à une application de mettre fin à toute action de CPI-C, mais met fin à la conversation. Cet appel peut être émis quel que soit le mode de traitement de l’application actuel. Toutes les opérations en attente retournent avec CM_DEALLOCATED_ABEND en tant que code de retour.

La conversation est arrêtée par une désallouée avec deallocate_type définie sur ABEND_SVC . Aucune log_data n’est envoyée. Le système peut être incapable de le faire immédiatement, mais tout délai est transparent pour le programme.