Accept_Conversation (CPI-C)

Artikel
10/14/2023

Der Accept_Conversation Aufruf (Funktionsname cmaccp) wird vom aufgerufenen Programm ausgegeben, um die eingehende Unterhaltung zu akzeptieren und bestimmte Konversationsmerkmale festzulegen. Eine Liste der anfänglichen Konversationseigenschaften finden Sie unter Merkmale der anfänglichen Unterhaltung.

Syntax

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

Parameter

conversation_ID
Zurückgegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Sie wird von nachfolgenden CPI-C-Aufrufen verwendet und zurückgegeben, wenn der Rückgabecode entweder CM_OK oder CM_OPERATION_INCOMPLETE ist. Wenn der Rückgabecode CM_OPERATION_INCOMPLETE ist, kann der conversation_ID-Parameter von der Anwendung verwendet werden, um die Konversation zu warten oder abzubrechen.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_STATE_CHECK
Primärer Rückgabecode; es gibt keine eingehende Unterhaltung (nur Blockiermodus), oder es wurde kein Name des lokalen Transaktionsprogramms (LOCAL Transaction Program, TP) eingerichtet.

CM_OPERATION_INCOMPLETE
Primärer Rückgabecode; Ein Nichtblockierungsvorgang wurde für die Unterhaltung gestartet, ist aber noch nicht abgeschlossen. Das Programm kann Wait_For_Conversation ausgeben, um zu warten, bis der Vorgang abgeschlossen ist, oder Cancel_Conversation , um den Vorgang und die Unterhaltung abzubrechen.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung muss sich im STATUS RESET befinden, wenn Accept_Conversation ausgegeben wird.

Wenn der Aufruf erfolgreich ist, wechselt die Unterhaltung in den RECEIVE-Status. Wenn der Aufruf fehlschlägt, bleibt der Zustand unverändert.

Hinweise

Nach erfolgreicher Ausführung dieses Aufrufs generiert CPI-C einen Konversationsbezeichner mit 8 Byte. Dieser Bezeichner ist ein erforderlicher Parameter für alle anderen CPI-C-Aufrufe, die vom aufgerufenen Programm für diese Unterhaltung ausgegeben werden.

Eingehende Unterhaltungen werden gemäß dem angegebenen Tp-Zielnamen akzeptiert, der mit den eingerichteten lokalen TP-Namen übereinstimmen muss. Lokale TP-Namen können durch implementierungsabhängige Methoden oder durch das Programm eingerichtet werden, das Specify_Local_TP_Name aufruft. Auf diese Weise kann ein Programm mehr als einen lokalen TP-Namen aufweisen. Das Programm kann Extract_TP_Name aufrufen, um den für die eingehende Unterhaltung angegebenen Namen zu ermitteln.

Der Vorgang wird im Nichtblockierungsmodus ausgeführt, wenn das Programm zuvor Specify_Local_TP_Name aufgerufen hat. andernfalls wird sie im Blockierungsmodus ausgeführt.

Freigeben über