Specify_Local_Tsel_Format - TSEL-Format der lokalen Anwendung setzen

Der Aufruf Specify_Local_Tsel_Format (CMSLTF) setzt den Wert für die Characteristic T-SEL-FORMAT 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_Format() wird bei der Anbindung über UPIC-L nicht unterstützt.

Syntax

CMSLTF (tsel_format, return_code)

Parameter

--> tsel_format

legt fest, welcher Zeichensatz für den Transport Selektor (TSEL) verwendet wird. Folgende Werte können Sie angeben: CM_TRANSDATA _FORMAT Der Transport-Selektor wird im TRANSDATA-Format an das Kommunikationssystem übergeben. CM_EBCDIC_FORMAT Der Transport-Selektor wird im EBCDIC Format an das Kommunikationssystem übergeben. CM_ASCII_FORMAT Der Transport-Selektor wird im ASCII-Format an das Kommunikationssystem übergeben.

<-- 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 Format für den Transport-Selektor 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 tsel_format ist ungültig.

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ürUPIC-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.

Funktionsdeklaration: Specify_Local_Tsel_Format

CM_ENTRY Specify_Local_Tsel_Format ( CM_TSEL_FORMAT CM_PTR tsel_format,
                                     CM_RETURN_CODE CM_PTR return_code )