SET CHANNEL

Version 3

SET CHANNEL (Schnittstelle/Operation{; Parameter/Dokument})

Der Befehl SET CHANNEL öffnet eine serielle Schnittstelle oder ein Dokument. Sie können immer nur eine serielle Schnittstelle oder ein Dokument gleichzeitig öffnen. Um eine geöffnete serielle Schnittstelle zu schliessen, übergeben Sie SET CHANNEL (11).

Historischer Hinweis: SET CHANNEL war ursprünglich der erste Befehl zum Arbeiten mit seriellen Schnittstellen und Dokumenten auf Festplatten. Seither sind neue Befehle hinzugekommen. Heute verwenden Sie für Dokumente auf der Festplatte vorrangig die Befehle Open document, Create document und Append document. Damit können Sie mit Hilfe von SEND PACKET oder RECEIVE PACKET Zeichen in bzw. aus Dokumenten ein- bzw. auslesen (Diese Befehle arbeiten auch mit SET CHANNEL). Für die Befehle SEND VARIABLE, RECEIVE VARIABLE, SEND RECORD und RECEIVE RECORD können Sie dagegen nur über SET CHANNEL auf Dokumente auf der Festplatte zugreifen.

Die Beschreibung von SET CHANNEL gliedert sich in zwei Abschnitte:

• Arbeiten mit seriellen Schnittstellen

• Arbeiten mit Dokumenten

Die erste Syntax des Befehls SET CHANNEL öffnet eine serielle Schnittstelle und definiert das Protokoll sowie weitere Informationen der Schnittstelle. Sie können Daten senden mit SEND PACKET, SEND RECORD oder SEND VARIABLE, bzw. Daten empfangen mit RECEIVE BUFFER, RECEIVE PACKET, RECEIVE RECORD oder RECEIVE VARIABLE.

Schnittstelle wählt die serielle Schnittstelle und das zu benutzende Protokoll.

Sie können bis zu 99 serielle Schnittstellen ansprechen (eine zur gleichen Zeit pro Prozess). Folgende Liste zeigt die möglichen Werte für Schnittstelle:

Wichtig: Der in Schnittstelle übergebene Wert muß sich auf eine vorhandene COM Schnittstelle beziehen, die Ihr Betriebssystem erkennt. Wollen Sie zum Beispiel die Werte 101, 103 und 125 verwenden, müssen die Schnittstellen COM1, COM3 und COM25 richtig konfiguriert sein.

Tip: Die einzelnen hinzuzufügenden numerischen Werte, die in Schnittstelle und Parameter übergeben werden - davon ausgenommen sind die Werte für COM1...COM99 - stehen in der Designumgebung im Fenster Explorer unter Kommunikation als vordefinierte Konstanten zur Verfügung. Für COM1...COM99 müssen Sie die Werte selbst definieren.

Die Betriebssysteme erkennen standardmäßig zwei serielle Schnittstellen der Software: unter Windows die Schnittstellen COM1 und COM2, auf Macintosh die Modem- und die Druckerschnittstelle. Sie können natürlich mit Hilfe von zusätzlicher Hardware weitere serielle Schnittstellen hinzufügen. 4th Dimension hat ursprünglich nur die o.a. Standard-Schnittstellen unterstützt, nach und nach sind weitere serielle Schnittstellen hinzugekommen. Aus Kompatibilitätsgründen bleiben beide Systeme erhalten.

- Wollen Sie nur eine Standardschnittstelle zuweisen (COM2 /Drucker oder COM1/Modem), können Sie im Parameter den Wert 0, 1, 20, 21, 30 oder 31 übergeben (das entspricht der alten Funktionsweise von 4D) bzw. einen Wert > 100 (siehe oben).

- Wollen Sie erweiterte serielle Schnittstellen zuweisen, müssen Sie in Schnittstelle (Zuweisen der n-ten seriellen Schnittstelle) den Wert N+100 übergeben, und diesen noch um 100 oder 200 erhöhen, je nachdem, ob Sie ein Software- oder ein Hardware-Protokoll verwenden.

(1) Für COM2 bzw. die Druckerschnittstelle ohne Protokoll verwenden Sie die Syntax:

   SET CHANNEL (0;param)   

oder

   SET CHANNEL (102;param)

(2) Für COM1 bzw. die Modemschnittstelle mit dem Protokoll XON/XOFF verwenden Sie die Syntax:

   SET CHANNEL (21;param)   

oder

   SET CHANNEL (201;param)

(3) Für COM25 mit dem Protokoll RTS/CTS verwenden Sie ausschließlich die Syntax:

   SET CHANNEL (325;param)

Mit Parameter wählen Sie die Parameter der Kommunikation: Geschwindigkeit, Anzahl der Bits sowie der Stop-Bits und Parität. Sie legen den Wert für Parameter durch Hinzufügen der unten aufgeführten Werte fest. Wollen Sie z.B. setzen 1200 Baud, 8 Datenbits, 1 Stop-Bit und keine Parität, fügen Sie hinzu: 94 + 3072 + 16384 + 0 = 19550. In Parameter setzen Sie dann 19550 ein.

Die zweite Syntax des Befehls SET CHANNEL erstellt, öffnet und schließt ein Dokument. Sie können jedoch im Gegensatz zu den Befehlen im Kapitel Systemdokumente nur ein Dokument zur gleichen Zeit öffnen. Das Dokument kann aus- oder eingelesen werden.

Mit Operation legen Sie fest, was mit dem in Dokument festgelegten Dokument ausgeführt wird. Nachfolgende Tabelle zeigt die für Operation und Dokument zugelassenen Werte und die daraus resultierende Operation.

Wollen Sie z.B. ein Dialogfenster Datei öffnen anzeigen, um eine Textdatei zu öffnen, schreiben Sie folgende Programmierzeile:

   SET CHANNEL (13; "")

Alle hier aufgelisteten Operationen setzen bei Bedarf die Systemvariable Document. War die Operation erfolgreich, hat die Systemvariable OK den Wert 1, ansonsten den Wert 0.

Siehe Beispiele für die Befehle RECEIVE BUFFER, SET TIMEOUT und RECEIVE RECORD.

Append document, Create document, GET SERIAL PORT MAPPING, Open document, RECEIVE BUFFER, RECEIVE PACKET, RECEIVE RECORD, RECEIVE VARIABLE, SEND PACKET, SEND RECORD, SEND VARIABLE, SET TIMEOUT.

Anwendung des Befehls

Get Serial Port Mapping, Serieller Port

---