19. Modul SERIALIN - GeoShop Konfigurationsdateien lesen

19.1. Allgemeines

Mit dem Modul SERIALIN können GeoShop Konfigurationsdateien gelesen werden. Pro Konfigurationsdatei wird ein IN-Objekt geliefert.

SERIALIN wird mit:

|INCL \script\serialin.mod

in einer ICS RUN1-Konfiguration verfügbar gemacht.

19.2. Abhängigkeiten von anderen Modulen

Keine Abhängigkeiten vorhanden.

19.3. Parametermap SERIALIN_PARAM

Folgende Parameter können in der Map SERIALIN_PARAM gesetzt werden:

Parameterreq/optBeschreibung
STATISTICSrON oder OFF. Objektstatistik am Ende der .log Datei ausgeben.
TRACEoJedes gelesene Objekt in der .log Datei ausgeben.

19.4. Objektmodell

Der Modul SERIALIN liefert alle Komponenten gemäss der Struktur der gelesenen Konfigurationsdatei. Es werden keine allgemeinen Komponenten von SERIALIN geliefert.

19.5. Exportierte Prozeduren und Methoden

ProzedurSERIALIN_OPEN ! [s input_pattern][]
BeschreibungÖffnet alle Konfigurationsdateien <input_pattern>. Für <input_pattern> muss ein Pfad relativ zu GeoShop user_dir angegeben werden.
Beispiel
'\users\*.usr' SERIALIN_OPEN
ProzedurSERIALIN_READ_OBJECT ! [][b state]
Beschreibung

Liest die nächste Konfigurationsdatei. Das Objekt wird in der MAP IN zurückgegeben.

Beispiel
SERIALIN_READ_OBJECT [TRUE]
ProzedurSERIALIN_CLOSE ! [][]
BeschreibungSchliesst den Modul und gibt die durch den Modul belegten Ressourcen wieder frei. Die Prozedur wird von RUN1 automatisch aufgerufen.
Beispiel
SERIALIN_CLOSE

19.6. Skriptbeispiel

!=============================================================================
! Display all GeoShop user names.
!=============================================================================

!=============================================================================
! parameter maps for intput modules
!=============================================================================

MAP SERIALIN_PARAM
   TRACE        => OFF
   STATISTICS   => ON
END_MAP

!=============================================================================
! input sources
!=============================================================================

MAP INPUT_SOURCES
   I1 => SERIALIN,\users\*.usr
END_MAP

!=============================================================================
! classification
!=============================================================================

MAP INOUT
   I1 => DIN
END_MAP

!=============================================================================
! macros
!=============================================================================

MAP MACRO ! macros
   DIN  => DISPLAY_OBJECT1,IN.name
END_MAP

!=============================================================================
! includes
!=============================================================================

|INCL \script\util.lib
|INCL \script\serialin.mod
|INCL \script\run1.prg

!=============================================================================
! end of file
!=============================================================================