Der Aufruf Specify_Local_Tsel (CMSLT) setzt den Wert für die Characteristic T-SEL der lokalen Anwendung. Der Aufruf überschreibt den Wert, der beim Enable_UTM_UPIC-Aufruf zugewiesen wurde. Er darf nach dem Initialize_Conversation-Aufruf 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 Specify_Local_Tsel wird bei der Anbindung über UPIC-L nicht unterstützt.
CMSLT (transport_selector, transport_selector_length, return_code)
Parameter
--> transport_selector | Transport-Selektor der lokalen Anwendung, der dem Kommunikationssystem übergeben wird |
--> transport_selector_length | Länge des Transport-Selektors in Byte. Minimum: 0, Maximum: 8 Wird die Länge des Transport-Selektors mit 0 angegeben, so wird der Name der lokalen Anwendung selbst 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 T-SEL vergeben werden kann, da UPIC-L diese Information auf Grund des darunterliegenden Kommunikationssystems nicht benötigt.
CM_PROGRAM_STATE_CHECK
Die Conversation ist nicht im Zustand "Reset".
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
CM_PROGRAM_PARAMETER_CHECK
Der Wert von transport_selector_length ist ungültig.
Zustandsänderung
Der Aufruf ändert den Zustand der Conversation nicht.
Verhalten im Fehlerfall
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_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_ENTRY Specify_Local_Tsel (unsigned char CM_PTR transport_selector,
CM_INT32 CM_PTR transport_selector_length,
CM_RETURN_CODE CM_PTR return_code )