Initialize_Conversation (CPI-C)

Der Initialize_Conversation Aufruf (Funktionsname cminit) wird vom aufrufenden Programm ausgegeben, um einen 8-Byte-Unterhaltungsbezeichner abzurufen und die Anfangswerte für die Unterhaltungsmerkmale festzulegen.

Syntax

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

Die Parameter

conversation_ID
Zurückgegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Sie wird von nachfolgenden CPI-C Aufrufen verwendet.

sym_dest_name
Angegebener Parameter. Gibt den symbolischen Zielnamen an, der einem seitlichen Informationseintrag zugeordnet ist, der aus der Konfigurationsdatei geladen oder durch Set_CPIC_Side_Information Aufrufe definiert wird.

Dieser Parameter ist eine 8-Byte ASCII-Zeichenfolge. Die zulässigen Zeichen sind wie folgt:

• Großbuchstaben

• Ziffern von 0 bis 9

  Dieser Parameter kann auch auf acht Leerzeichen festgelegt werden. In diesem Fall muss das aufrufende Programm die folgenden Aufrufe ausstellen, bevor die Zuordnung ausgestellt wird:

• Set_Mode_Name

• Set_Partner_LU_Name

• Set_TP_Name

  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_PARAMETER_CHECK
Primärer Rückgabecode; Der durch sym_dest_name angegebene Wert stimmt nicht mit einem symbolischen Zielnamen in der Randinformationstabelle überein und ist kein Leerzeichen.

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

Statusänderungen

Die Unterhaltung befindet sich im ZUSTAND RESET.

Wenn die return_code CM_OK ist, ändert sich die Unterhaltung in den INITIALIZE-Zustand. Bei anderen Rückgabecodes bleibt der Unterhaltungsstatus unverändert.

Bemerkungen

Die Anfangswerte sind CPI-C Standardwerte oder werden von seitenseitigen Informationen abgeleitet, die dem symbolischen Zielnamen zugeordnet sind. Weitere Informationen zu anfangswerten und seitenseitigen Informationen finden Sie unter "Ursprüngliche Unterhaltungsmerkmale " und "Side Information" für CPI-C Programme.

Die Anfangswerte können durch die Set_ Aufrufe geändert werden.

Wenn die Seiteninformationen einen ungültigen Wert enthalten oder ein Set_ Aufruf ein Unterhaltungsmerkmal auf einen ungültigen Wert festlegt, wird der Fehler für den Zuweisungsaufruf zurückgegeben.

Wenn eine CPI-C Anwendung versucht, mehrere gleichzeitige Unterhaltungen aufzurufen, wird nur eine einzelne lokale logische APPC-Einheit (LU) von allen Unterhaltungen verwendet. Dadurch wird verhindert, dass gleichzeitige Unterhaltungen über zwei oder mehr abhängige LU 6.2-LUs hinweg ausgeführt werden, sodass nachfolgende Initialize_Conversation (CMALLC)-Aufrufe warten, bis die erste Unterhaltung abgeglichen wird.

Wenn die CPI-C Anwendung mehrere gleichzeitige Unterhaltungen aufrufen muss, muss unabhängig von LU 6.2 zwischen Hostintegrationsserver und Remotesystem verwendet werden.

Bei erfolgreicher Ausführung dieses Aufrufs generiert CPI-C einen Unterhaltungsbezeichner. Dieser Bezeichner ist ein erforderlicher Parameter für alle anderen CPI-C Aufrufe, die von dem aufrufenden Programm für diese Unterhaltung ausgegeben wurden.

Unter normalen Umständen kann eine CPI-C Anwendung nicht zwei gleichzeitige Unterhaltungen mit zwei verschiedenen lokalen APPC-LUs aufrufen. Ein Registrierungsschlüssel ist verfügbar, wenn festgelegt wird, dass CPI-C erzwingt, ein neues TP_STARTED Verb für jeden Initialize_Conversation (Cminit)-Aufruf auszustellen. Dies ist erforderlich, um den APPC-Ressourcenspeicherort für jeden Aufruf zu erzwingen. Der Registrierungsschlüssel, der definiert werden muss, um dieses Verhalten zu erzwingen, ist Folgendes:

\HKLM\CurrentControlSet\Services\SnaBase\Parameters\Client\GETNEWTPID