Initialize_Conversation (CPI-C)
Der Initialize_Conversation Aufruf (Funktionsname cminit) wird vom aufrufenden Programm ausgegeben, um einen 8-Byte-Konversationsbezeichner zu erhalten 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
);
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 Name, der einem seitenseitigen 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
Zahlen von 0 bis 9
Dieser Parameter kann auch auf acht Leerzeichen festgelegt werden. In diesem Fall muss das aufrufende Programm die folgenden Aufrufe ausgeben, bevor "Allocate" ausgegeben wird:
-
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 Seiteninformationstabelle überein und ist kein Leerzeichen.
CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.
Zustandsänderungen
Die Unterhaltung befindet sich im STATUS ZURÜCKSETZEN.
Wenn die return_code CM_OK ist, ändert sich die Unterhaltung in den INITIALIZE-Zustand. Bei anderen Rückgabecodes bleibt der Unterhaltungszustand unverändert.
Hinweise
Die Anfangswerte sind CPI-C-Standardwerte oder werden von Seiteninformationen abgeleitet, die dem symbolischen Zielnamen zugeordnet sind. Weitere Informationen zu anfangswerten und nebenseitigen Informationen finden Sie unter Anfängliche Konversationsmerkmale und Nebeninformationen für CPI-C-Programme.
Anfangswerte können durch die aufruften Set_ geändert werden.
Wenn die Seiteninformationen einen ungültigen Wert enthalten oder ein Set_ Aufruf ein Konversationsmerkmal auf einen ungültigen Wert festlegt, wird der Fehler beim Allocate-Aufruf zurückgegeben.
Wenn eine CPI-C-Anwendung versucht, mehrere gleichzeitige Unterhaltungen aufzurufen, wird nur eine einzelne lokale appc logische Einheit (LU) von allen Unterhaltungen verwendet. Dadurch wird verhindert, dass gleichzeitige Unterhaltungen über zwei oder mehr abhängige LU 6.2-LUs hinweg erfolgen, was dazu führt, dass nachfolgende CMALLC-Aufrufe (Initialize_Conversation) auf die Aufhebung der Zuordnung der ersten Unterhaltung warten.
Wenn die CPI-C-Anwendung mehrere gleichzeitige Konversationen aufrufen muss, muss eine unabhängige LU 6.2 zwischen Host Integration Server und dem Remotesystem verwendet werden.
Nach erfolgreicher Ausführung dieses Aufrufs generiert CPI-C einen Konversationsbezeichner. Dieser Bezeichner ist ein erforderlicher Parameter für alle anderen CPI-C-Aufrufe, die für diese Unterhaltung durch das aufrufende Programm ausgegeben werden.
Unter normalen Umständen kann eine CPI-C-Anwendung nicht zwei gleichzeitige Unterhaltungen mit zwei unterschiedlichen lokalen APPC-LUs aufrufen. Ein Registrierungsschlüssel ist verfügbar, der CPI-C erzwingt, bei jedem Initialize_Conversation -Aufruf (Cminit) ein neues TP_STARTED Verb ausgibt. Dies ist erforderlich, um den Standort der APPC-Ressource für jeden Aufruf zu erzwingen. Der Registrierungsschlüssel, der definiert werden muss, um dieses Verhalten zu erzwingen, lautet wie folgt:
\HKLM\CurrentControlSet\Services\SnaBase\Parameters\Client\GETNEWTPID