:SWITCH ... :CASE ... :OTHER ... :ENDSWITCH

Verwenden Sie die Script-Anweisung :SWITCH , um verschiedene Script-Zeilen basierend auf dem Wert einer Variablen auszuführen. Die Variable repräsentiert eine Bedingung, und der :SWITCH-Block enthält eine oder mehrere :CASE-Anweisungen. Der Case bestimmt, welche Anweisungen ausgeführt werden sollen, wenn die Variable einen bestimmten Wert hat. Definieren Sie für jeden Wert der Variablen Cases, für die verschiedene Anweisungen verarbeitet werden sollen.

Tipp: Verwenden Sie :IF... :ELSE... :ENDIF-Anweisungen, um Ausdrücke auszuwerten, wenn Sie eine einzige Bedingung haben.

Syntax

: SWITCH Variable
:CASE Wert1
[Anweisungen]
[:CASE Wert2
[Anweisungen]
...
]
[ : OTHER
[Anweisungen]
...
]
: ENDSWITCH

Parameter

• :SWITCH
  Definiert einen Block mit Anweisungen, die in verschiedenen Fällen ausgeführt werden

• Variable
  Name der Variablen, die überprüft werden soll, um zu ermitteln, welcher Fall zutrifft
  Format:Script-Literal, Script-Variable oder Script-Funktion

• Anweisungen
  (Optional) Eine oder mehrere Anweisungen, die verarbeitet werden sollen, wenn der Fall zutrifft
  Format: Script-Anweisung

• :CASE
  Startet den Block mit den Anweisungen, die ausgeführt werden sollen, wenn die Variable den für den Fall definierten Wert hat
  Hinweis: Wenn Sie komplexe Ausdrücke verwenden und mehrere :CASE-Anweisungen mit einem OR-Operator verbinden möchten, schreiben Sie die :CASE-Anweisungen in der richtigen Reihenfolge, ohne :OTHER-Anweisungen dazwischen.

• Wert1, Wert2
  Bedingungen oder Werte der Variablen, die bestimmen, welcher Fall zutrifft
  Format: Script-Literal, Script-Variable oder komplexer Ausdruck

• :OTHER
  (Optional) Startet einen Block mit Anweisungen, die ausgeführt werden, wenn keiner der definierten Fälle zutrifft

  Hinweise

  • Verwenden Sie die Anweisung :OTHER einmal nach allen :CASE-Anweisungen.
  • :OTHER kann nicht direkt in der Zeile nach einer :CASE-Zeile verwendet werden. Sie müssen zwischendurch eine leere Zeile einfügen.

• :ENDSWITCH
  Beendet den :SWITCH-Block

Hinweise:

• Der Wert für :CASE kann ein arithmetischer Ausdruck sein.

  Beispiel

  :SWITCH &NUM#
  :CASE 3*(5-2)
  : PRINT "&NUM# = 9"
  :ENDSWITCH

• Um Operatoren (<, >, <>, <=, >=, =) und zwischen zu verwenden, um komplexe Ausdrücke und Wertebereiche für :CASE zu definieren, geben Sie anstelle des Variablennamens den String "Y" an.

  Beispiel

  :SET &STATUS# = GET_STATISTIC_DETAIL(&RUNID#,STATUS)
  :SWITCH "Y"
  :CASE &STATUS# zwischen 1300 und 1599
  :CASE &STATUS# zwischen 1700 und 1799
  : PRINT "Die Aufgabe &RUNID# ist aktiv."
  :CASE &STATUS# zwischen 1600 und 1699
  : PRINT "Die Aufgabe &RUNID# befindet sich in einem Wartezustand."
  :CASE &STATUS# zwischen 1800 und 1899
  : PRINT "Die Aufgabe &RUNID# wurde abgebrochen."
  :CASE &STATUS# >= 1900
  : PRINT "Die Aufgabe &RUNID# wurde erfolgreich beendet."
  :ENDSWITCH

Wichtig! Mit dieser Script-Anweisung können Sie die vordefinierte Variable &$PLATFORM# verwenden. Wenn Sie diese vordefinierte Variable in einem generischen Job-Objekt verwenden, müssen Sie auch die Variable &AGENT# in Ihrem Script definieren. Das generische Job-Objekt hat beim Erstellen keinen definierten Host, sodass das Script einen Fehler zurückgibt, wenn Sie den Host nicht angeben. Weitere Informationen finden Sie unter Vordefinierte Variablen.

Beispiele

Folgendes Beispiel ermittelt den aktuellen Wochentag als Zahl. Das Script verwendet die Nummer des Wochentages, um einen bestimmten Job nur montags und freitags zu starten.

:SET &DATE# = SYS_DATE_PHYSICAL("DD.MM. YYYY" )
: SET &WEEKDAY# = WEEKDAY_NR("DD.MM.YYYY:&DATE#")

:SWITCH &WEEKDAY#
:CASE 1
: SET &ACT# = ACTIVATE_UC_OBJECT(JOBS.MONDAY, WAIT)
:CASE 5
: SET &ACT# = ACTIVATE_UC_OBJECT(JOBS.FRIDAY, WAIT)
:OTHER
: PRINT "Keine Verarbeitung."
:ENDSWITCH

Das folgende Script in einem generischen Auftragsobjekt definiert Bedingungen basierend auf der Plattform, auf der der Auftrag ausgeführt wird:

: SWITCH &$PLATFORM#
:CASE "WINDOWS"
! fügen Sie diese Zeilen in Ihr Script ein, um festzustellen, ob ein Fehler aufgetreten ist
! @set retcode=%errorlevel%
! @if NOT %ERRORLEVEL% == 0 goto :retcode
!
:CASE "UNIX"

: OTHER
: ENDSWITCH

Siehe auch: