Derzeit ist der GET_NAMED_MEMORY_RETAIN-Baustein analog zum GET_NAMED_MEMORY-Baustein, wobei GET_NAMED_MEMORY_RETAIN die Referenz auf einen anderen Speicherbereich als GET_NAMED_MEMORY liefert (siehe " Beispiel mit Referenz auf anderen Speicherbereich ").

Beachten Sie: Der GET_NAMED_MEMORY_RETAIN-Baustein liefert die →Referenz auf einen →gepufferten Speicherbereich, dessen Namen Sie am Eingang NAME eingeben . Mit Hilfe des SAVE_ALL_NAMED_MEMORY_RETAIN-Bausteins oder SAVE_NAMED_MEMORY_RETAIN-Bausteins ist es möglich, alle gepufferten Speicherbereiche oder nur einen in den permanenten Speicher zu speichern.
Standardmäßig wird die entsprechende Datei im Unterverzeichnis PLC des logi.RTS-Installationsverzeichnisses abgelegt. Falls Sie die Ablage in einem anderem Verzeichnis bevorzugen, kontaktieren Sie Ihren Systemintegrator und bitten Sie darum, die Konfiguration des Systemdiensts zu ändern.

Kurz-Information

Name	`GET_NAMED_MEMORY_RETAIN`
→POE-Typ	→Funktion
Kategorie	IEC-Baustein, MemoryEnh, Baustein mit interner Fehlerdiagnose
Konform zur →IEC-Norm	nicht in IEC-Norm vorgesehen
Grafische Schnittstelle
Verfügbar ab	Version 1.53.0 (für logi.CAD 3) und Version 3.0.8 bzw. 2.3.1801 von logi.RTS Dieser Baustein wird nur für die integrierte SPS unterstützt. Version 1.109.0 (für logi.CAD 3) und Version 3.19.0 von logi.RTS: liefert die Referenz auf gleichen Speicherbereich wie `GET_NAMED_MEMORY` Dieser Baustein wird nur für die integrierte SPS und die Plattformen `WindowsX86` und `LinuxX86` unterstützt. Version 3.2.2 (für Bibliothek `Standard`) – Erweiterung: breitere Schnittstelle; liefert die Referenz auf anderen Speicherbereich als `GET_NAMED_MEMORY`

Beispiel mit Referenz auf anderen Speicherbereich

Das folgende Beispiel enthält 2 Programminstanzen: eine schreibt einen Konfigurationswert in einen gepufferten Speicherbereich mit einem Namen, die andere liest ihn aus:

CONFIGURATION LocalConfiguration
  RESOURCE local ON BuiltInPlc { ON_CHANNEL := LocalChannel }
    TASK DefaultTask(INTERVAL := TIME#500ms, PRIORITY := 38229);
    PROGRAM ProgramInstance1 WITH DefaultTask :
      Program1;
    PROGRAM ProgramInstance2 WITH DefaultTask :
      Program2;
  END_RESOURCE
END_CONFIGURATION

Da der Programmtyp Program2 fälschlicherweise GET_NAMED_MEMORY() verwendet, um den benannten Speicherbereich anzufordern. wird eine andere Referenz als erwartet geliefert:

PROGRAM Program1
  VAR
    ReferenceToInteger : REF_TO INT;
  END_VAR
 
  ReferenceToInteger := GET_NAMED_MEMORY_RETAIN('IntegerBlock');
  IF ReferenceToInteger <> NULL THEN
    ReferenceToInteger^ := 42;
  END_IF;
END_PROGRAM
 
PROGRAM Program2
  VAR
    ReferenceToInteger : REF_TO INT;
  END_VAR
	
  ReferenceToInteger := GET_NAMED_MEMORY('IntegerBlock');
  IF ReferenceToInteger <> NULL THEN
    /* The following assertion will fail since 'Program2' erroneously requested
     * a named memory block that is NOT retained, thus gets a different block
     * than 'Program1'. For this reason, the value stored in the block is not '42' as
     * expected, but the initial value of zero...
    */
  Assert(ReferenceToInteger^ = 42);
  END_IF;
END_PROGRAM

Um das Problem zu beheben, müssen Sie den Aufruf GET_NAMED_MEMORY() durch den Aufruf GET_NAMED_MEMORY_RETAIN() ersetzen.