:GENERATE

Verwenden Sie :GENERATE-Anweisungen, um zu steuern, wie Script-Zeilen während der Ausführung behandelt werden. Mit dieser Anweisung können Sie festlegen, welche Script-Zeilen verarbeitet werden, wenn Sie Wiederanlaufpunkte definiert haben, oder ob Datenzeilen in Groß- oder Kleinbuchstaben geschrieben werden sollen.

Neustart von aktivierbaren Objekten

Der Generierungsmodus in einer :GENERATE-Anweisung steuert, wie Script-Zeilen während der Script-Ausführung behandelt werden, wenn ein ausführbares Objekt neu gestartet wird. Der von Ihnen definierte Generierungsmodus ist gültig, bis eine der folgenden Anweisungen ausgeführt wird:

• die nächste :GENERATE-Anweisung, die einen der drei Generierungsmodi enthält
• der nächste :RESTART-Anweisung

Wenn Sie ein Objekt neu starten, ohne eine :GENERATE-Anweisung zu verwenden, dann werden alle Script-Zeilen bis zur ersten :RESTART-Anweisung verarbeitet, sowie alle Zeilen, die sich nach dem angegebenen Neustartpunkt befinden.

Groß- und Kleinschreibung

Mit Ausnahme von Script-Variablen wird Text in Datenzeilen in der Regel unberührt gelassen und unverändert an das Zielsystem übergeben. Variablen werden mit Werten (in modifizierter Form) bei der Aktivierung eines Objekts, das ein solches Script enthält, versorgt. Weitere Informationen finden Sie unter Datenzeilen und Job Control Language.

Einige Zielsysteme erfordern, dass Datenleitungen auf eine bestimmte Weise formatiert werden. So verarbeitet das BS2000-Betriebssystem beispielsweise nur Job Control Language (JCL)-Anweisungen, die in Großbuchstaben geschrieben werden. Befehle für dieses Zielsystem müssen in der Datei Automation Engine formatiert werden. Verwenden Sie die :GENERATE-Anweisung und ihre Generierungsmodi, um die Einschränkungen bestimmter Zielsysteme beim Schreiben von Scripts zu berücksichtigen.

Syntax

: GEN[ERATE] Generierungsmodus

Parameter

• :GENERATE
  Legt fest, wie Script-Zeilen während der Ausführung verarbeitet werden

• Generierungsmodus
  Parameter für die Verarbeitung von Script-Zeilen
  Zulässige Werte für Neustarts:

  • ON_RESTART_ALWAYS
    Script-Zeilen werden immer verarbeitet, unabhängig vom Neustartpunkt
  • ON_RESTART_CHECK
    Script-Zeilen werden nicht verarbeitet, wenn sie sich vor dem Neustartpunkt befinden
  • ON_RESTART_NEVER
    Script-Zeilen werden nie verarbeitet, unabhängig vom Neustartpunkt
  Zulässige Werte für Datenleitungen:
  • UPPER_CASE
    Konvertiert den Text in allen DATA-Zeilen in Großbuchstaben
  • LOWER_CASE
    Konvertiert den Text in allen DATA-Zeilen in Kleinbuchstaben
  • CASE_UNCHANGED
    Stellt den Ausgangszustand des Textes wieder her (Groß- und Kleinbuchstaben)

Beispiele

Im folgenden Beispiel definieren :RESTART-Anweisungen 3 Neustartpunkte. :GENERATE-Anweisungen mit unterschiedlichen Generierungsmodi definieren, welche Script-Zeilen beim Neustart des Objekts verarbeitet werden:

: PRINT  "Script start"

: RESTART R1
: PRINT  "Point R1"

: GENERATE ON_RESTART_ALWAYS
: PRINT  "ON_RESTART_ALWAYS"

: GENERATE ON_RESTART_CHECK
: RESTART R2
: PRINT  "Point R2"
: RESTART R3
: PRINT  "Point R3"

: GENERATE ON_RESTART_NEVER
: PRINT  "Script end"

Wenn das Objekt am Neustartpunkt R1 neu startet, werden im Aktivierungsreport die folgenden Zeilen ausgegeben:

2005-01-31 12:17:05 - U0020408 Script startet
2005-01-31 12:17:05 - U0020408 Punkt R1
2005-01-31 12:17:05 - U0020408 ON_RESTART_ALWAYS
2005-01-31 12:17:05 - U0020408 Punkt R2
2005-01-31 12:17:05 - U0020408 Punkt R3

Wenn das Objekt am Neustartpunkt R2 neu gestartet wird, werden im Aktivierungsreport die folgenden Zeilen ausgegeben:

2005-01-31 12:17:23 - U0020408 Script startet
2005-01-31 12:17:23 - U0020408 ON_RESTART_ALWAYS
2005-01-31 12:17:23 - U0020408 Punkt R2
2005-01-31 12:17:23 - U0020408 Punkt R3

Wenn das Objekt am Neustartpunkt R3 neu startet, werden im Aktivierungsreport die folgenden Zeilen ausgegeben:

2005-01-31 12:17:48 - U0020408 Script startet
2005-01-31 12:17:48 - U0020408 ON_RESTART_ALWAYS
2005-01-31 12:17:48 - U0020408 Punkt R3

Im folgenden Beispiel konvertiert die :GENERATE-Anweisung Text in einer Datenzeile in Großbuchstaben:

: GEN UPPER_CASE
fs $AE.

Siehe auch: