FC_AppendToWriteFile - Allgemeine Informationen
|
Typ |
Funktion |
|
Verfügbar ab |
SystemInterface_1.32.6.0 |
|
Versionen: |
Aktuelle Version |
Datei zum Anhängen von Daten öffnen. Die Datei wird mit Schreib- und Leserechten geöffnet.
HINWEIS: Das Betriebssystem auf der PacDrive-III-Steuerung ermöglicht das gleichzeitige, mehrfache Öffnen einer Datei. Beim Öffnen einer Datei wird der gesamte Inhalt der Datei in den Arbeitsspeicher geladen und über eine Datei-ID referenziert.
Über die Datei-ID kann der Inhalt bearbeitet und die Datei geschlossen werden.
Beim Schließen der Datei wird der (ggf. geänderte) Inhalt aus dem Arbeitsspeicher in die Datei auf dem Laufwerk übertragen.
HINWEIS: Wenn eine Datei mehrmals geöffnet und bearbeitet wird, wird der Inhalt der zuletzt geschlossenen Datei (letzte freigegebene Datei-ID) gespeichert, nachdem alle Dateiversionen gespeichert wurden. Alle Änderungen aus anderen geöffneten Versionen werden überschrieben.
|
HINWEIS |
|
DATENVERLUST |
|
Öffnen Sie eine Datei nicht mehrmals. |
|
Die Nichtbeachtung dieser Anweisungen kann Sachschäden zur Folge haben. |
Die Funktion öffnet eine Datei (i_sFilename) zum Anhängen von Daten. Der Schreib- bzw. Lesezeiger wird auf das Dateiende gesetzt.
Wenn die Datei nicht geöffnet werden konnte (erkannter Fehler), gibt die Funktion den Wert -1 zurück. Existiert die Datei nicht, wird sie neu angelegt.
Das Standardgerät ist "ide0:". i_sFilename kann ein kurzer Standardname oder ein komplexer Name sein. Ein Standardname besteht aus ein bis acht Zeichen (A bis Z, 0 bis 9). Der Gerätename "ide0:" und die Dateinamenserweiterung ".dat" werden intern angehängt. Ein komplexer Name besteht aus Gerätename, Dateiname und Dateinamenerweiterung.
HINWEIS: Die Abarbeitung dieser Funktion dauert einige 100 ms. Deshalb sollten die Zeiten für die Zyklusüberwachung der Task, in der diese Funktion ausgeführt wird, einmalig erhöht werden. Beispiel: FC_CycleCheckTimeSet(500, 2).
Wenn Sie versuchen, mit dieser Funktion eine nicht editierbare Systemdatei zu öffnen, erhalten Sie -5 als Rückgabewert (s. u.). Die Systemdatei wird nicht geöffnet.
|
Systemdatei |
Bedeutung |
Schutz |
|---|---|---|
|
ESYSTEM/SYSC3.SYS |
Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/SYSC3.CFG |
Firmware-Konfigurationsdatei |
Editierbar, aber nicht löschbar |
|
ESYSTEM/BOOTC3.SYS |
Bootloader |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/3S.DAT |
3S |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/CIFXRCX.NXF |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/COMXRCX.NXF |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/COM_XC1.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/COM_XC2.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/DPM_XC0.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/DPM_XC2.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/DPS_XC0.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/DPS_XC2.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/NETX100-BSL.BIN |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/NX100EIM.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/NX100EIS.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
ESYSTEM/FBUSFW/PNM.NXO |
Feldbus-Firmware |
Nicht editierbar und nicht löschbar |
|
Eingang |
Datentyp |
Beschreibung |
|---|---|---|
|
i_sFilename |
STRING[80] |
Name der Datei, an die Daten angehängt werden sollen. |
|
Datentyp |
Beschreibung |
|---|---|
|
DINT |
Datei-ID: Kennzeichnungsnummer der geöffneten Datei <1000000-1000009>. -1: Datei konnte nicht geöffnet werden (Fehler erkannt). -2: Zu viele Dateien geöffnet. -5: Sie versuchen, eine Systemdatei zu öffnen. |
