Automation Engine Script-Leitfaden > Funktionelle Gliederung > Systemzustände und -bedienung > ILM

ILM

Script-Funktion: Steuert die ILM-Funktionalität.

Installation

Syntax

ILM (INSTALLIERT)

Syntax

Beschreibung/Format

INSTALLED Fragt ab, ob die Datenbank mit ILM partitioniert worden ist

Anmerkungen

Die Script-Funktion liefert die folgenden Rückgabewerte:

"Y" - Partitionierung mit ILM wurde installiert
"N" - Die Datenbank wurde nicht partitioniert

Beispiel

:SET &ILM# = ILM(INSTALLED)

 


Status

Syntax

ILM (AKTIV)

Syntax

Beschreibung/Format

ACTIVE Fragt ab, ob ILM aktiv ist

Anmerkungen

Die Script-Funktion liefert die folgenden Rückgabewerte:

"Y" - ILM ist aktiv, d.h. neue Partitionen werden angelegt und es erfolgen Switch-Outs (letzteres betrifft nur den MS SQL Server).
"N" - ILM ist nicht aktiv, d.h. es erfolgt kein Partitionswechsel und keine Switch-Outs (letzteres betrifft nur den MS SQL Server).

Beispiel

:SET &ILM# = ILM(ACTIVE)

 


Start und Stop

Syntax

ILM (STARTEN)
ILM (STOPPEN)

Syntax

Beschreibung/Format

START Aktiviert ILM
STOP Deaktiviert ILM

Anmerkungen

Ist ILM aktiv, so werden neue Partitionen angelegt und es erfolgen Switch-Outs (letzteres betrifft nur den MS SQL Server).

Ist ILM nicht aktiv, so erfolgt kein Partitionswechsel und keine Switch-Outs (letzteres betrifft nur den MS SQL Server).

Die Script-Funktion liefert "0", wenn der Start bzw. der Stopp erfolgreich war oder die Nummer des Fehlers, der aufgetreten ist.

Beispiel

ILM wird deaktiviert.

:SET &ILM# = ILM(STOP)

 


Switch-Out

Syntax

ILM (SWITCHOUT [, Prüfung])

Syntax

Beschreibung/Format

SWITCHOUT Löst einen Switch-Out für die älteste Partition aus.
Check

Einstellung, ob vor dem Switch-Out eine Prüfung erfolgen soll

Erlaubte Werte: "CHECK" (Standardwert) und "NOCHECK"

"CHECK" - Vor dem Switch-Out wird geprüft, ob die betroffene Partition Datensätze von Aufgaben enthält, die noch aktiv sind. Der Switch-Out entfällt, wenn das der Fall ist.
"NOCHECK" - Der Switch-Out wird ohne vorherige Prüfung vorgenommen.

Anmerkungen

Switch-Outs gehören zum MS SQL Server. Dieser Funktionsaufruf ist daher für Oracle-Datenbanken nicht relevant.

Beachten Sie, dass die Script-Funktion zwar einen Switch-Out auslöst, aber nicht auf die Beendigung des Switch-Outs wartet!

Die Script-Funktion liefert "0", wenn der Switch-Out erfolgreich war oder die Nummer des Fehlers, der aufgetreten ist.

Beachten Sie, dass die Anzahl der Online-Partitionen, die der Administrator in der Variablen UC_ILM_SETTINGS mit dem Key ONLINE_PARTITIONS einstellt, nicht berücksichtigt wird!

Beispiel:

Es sind vier Partitionen online. Durch mehrmaliges Aufrufen der Script-Funktion können Sie erreichen, dass nur mehr 3, 2 oder 1 Partition online sind.

Der Switch-Out kann nicht für die gerade aktuelle Partition durchgeführt werden. Es muss immer zumindest eine Partition online sein.

Ein Switch-Out kann nur dann ohne Datenverlust vorgenommen werden, wenn die Partition keine Datensätze von Aufgaben enthält, die noch aktiv sind.

Beachten Sie, dass ein erzwungener Switch-Out trotz aktiver Aufgaben nur nach Absprache mit dem Automic Support vorgenommen werden sollte!

Beispiel

Vor dem Switchout erfolgt eine Prüfung, da der Standardwert für den zweiten Parameter "CHECK" ist.

:SET &ILM# = ILM(SWITCHOUT)

 


Prüfung

ILM (CHECK, Partition number)

Syntax

Beschreibung/Format

CHECK

Prüft, ob aktive Objekte in der angegebenen Partition vorhanden sind.

Partitionsnummer Nummer der Partition.
Format: Script-Literal oder Script-Variable

Anmerkungen

Die Script-Funktion liefert "0", wenn keine aktive Objekte in der angegebenen Partition vorhanden sind.

Beispiel

Die Partition "25" wird geprüft.

:SET &ILM# = ILM(CHECK, "25")

 


Löschen einer Partition

Syntax

ILM (DROP, Partition [, Prüfung])

Syntax

Beschreibung/Format

DROP Löscht die angegebene Partition
Partition

Name oder Nummer der Partition.
Format: Script-Literal oder Script-Variable

Wenn Sie den Namen einer einzelnen Staging-Tabelle (MS SQL Server) angeben, erfolgt der Löschvorgang nicht mit den ILM-Datenbank-Benutzer. Stattdessen wird der Datenbank-Benutzer verwendet, den Sie in der INI-Datei der Automation Engine in der Sektion [ODBC] hinterlegt haben. Dieser muss über die erforderlichen Rechte verfügen!

Check

Einstellung, ob vor dem Löschen eine Prüfung erfolgen soll (nur für Oracle-Datenbanken relevant)

Erlaubte Werte: "CHECK" (Standardwert) und "NOCHECK"

"CHECK" - Vor dem Löschen wird geprüft, ob die betroffene Partition Datensätze von Aufgaben enthält, die noch aktiv sind. Der Löschvorgang entfällt, wenn das der Fall ist.
"NOCHECK" - Der Löschvorgang wird ohne vorherige Prüfung vorgenommen.

Anmerkungen

Der Parameter Prüfung ist beim MS SQL Server nicht relevant, da dort nur Staging-Tabellen gelöscht werden können. Die Prüfung für diese Tabellen erfolgte bereits beim Switch-Out.

Ein Drop kann nur dann ohne Datenverlust vorgenommen werden, wenn die Partition keine Datensätze von Aufgaben enthält, die noch aktiv sind.

Die Script-Funktion liefert "0", wenn die angegebene Partition erfolgreich gelöscht werden konnte.

Beispiel

Die Partition "25" wird gelöscht.

:SET &ILM# = ILM(DROP, "25")

 

Siehe auch:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH