Der Aufruf Set_Partner_Tsel (CMSPT) setzt den Wert für die Characteristic T-SEL der Partner-Anwendung der Conversation. Der Aufruf überschreibt den Wert, der beim Initialize_Conversation-Aufruf zugewiesen wurde. Er darf nach dem Aufruf Allocate nicht mehr aufgerufen werden.
Diese Funktion gehört zu den zusätzlichen Funktionen des Trägersystems UPIC; sie ist nicht Bestandteil der CPI-C-Schnittstelle.
UPIC-Local auf Unix-, Linux- und Windows-Systemen:
Der Aufruf Set_Partner_Tsel wird bei der Anbindung über UPIC-L nicht unterstützt.
CMSPT (conversation_ID, transport_selector, transport_selector_length, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation |
--> transport_selector | Transport-Selektor der Partner-Anwendung, der dem Kommunikationssystem übergeben wird. |
--> transport_selector_length | Länge des Transport-Selektors in Byte. Wird die Länge des Transport-Selektors mit 0 angegeben, so wird der erste Namensteil des partner_LU_name als Transport-Selektor verwendet. |
<-- return_code | Ergebnis des Funktionsaufrufs |
Ergebnis (return_code)
CM_OK
Aufruf ok
CM_CALL_NOT_SUPPORTED
Dieser Returncode gilt nur für Unix-, Linux- und Windows-Systeme.
Die Funktion wird nicht unterstützt. Dieser Returncode tritt nur bei UPIC-L auf. Er zeigt dem Programm an, dass kein TSEL vergeben werden kann, da UPIC-L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht benötigt.
CM_PROGRAM_PARAMETER_CHECK
Der Wert der conversation_ID oder der transport_selector_length ist ungültig.
CM_PROGRAM_STATE_CHECK
Die Conversation ist nicht im Zustand "Initialize".
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
Zustandsänderung
Der Aufruf ändert den Zustand der Conversation nicht.
Verhalten im Fehlerfall
CM_PROGRAM_PARAMETER_CHECK
Programm ändern.
CM_PROGRAM_STATE_CHECK
Programm ändern.
CM_PRODUCT_SPECIFIC_ERROR
Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf. Ihr System neu.
CM_CALL_NOT_SUPPORTED
Dieser Returncode gilt nur für Unix-, Linux- und Windows-Systeme.
Muss kein Fehler sein: Falls eine Anwendung sowohl für UPIC-L als auch für UPIC-R vorgesehen ist, bedeutet dieser Returncode lediglich, dass die Anwendung mit einer UPIC-L-Bibliothek gebunden ist. Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten.
CM_ENTRY Set_Partner_TSEL ( unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR transport_selector,
CM_INT32 CM_PTR transport_selector_length,
CM_RETURN_CODE CM_PTR return_code )