R3_IMPORT_JOBS

Verwenden Sie Script-Funktion R3_IMPORT_JOBS, um Jobs aus SAP in ein AE-System in Form von Jobobjekten zu importieren. Dabei werden das SAP-System und der SAP-Mandant verwendet, an dem sich der jeweilige SAP-Agent angemeldet hat und auf dem das Script-Element R3_IMPORT_JOBS läuft.

Wichtig!

  • Bevor Sie die Script-Funktion R3_IMPORT_JOBS verwenden können, müssen Sie die Jobs auswählen, die mit dem Script-Element R3_GET_JOBS importiert werden sollen. Alle ausgewählten SAP-Jobs werden dann in Form von Jobobjekten in das AE-System geladen. Werden vor dem Aufruf von R3_IMPORT_JOBS keine Jobs ausgewählt, so kommt es zum Abbruch. Weitere Informationen finden Sie unter R3_GET_JOBS.

  • Sie können Workflow-Objekte und Login-Objekte für die Jobs anlegen. Sie können dieses Verhalten mit den Parametern LOGIN* und WORKFLOW manipulieren. Die Jobs werden in die erstellten Workflows eingefügt und anschließend werden in den Workflow-Eigenschaften (DEPENDENCY*=) die Abhängigkeiten festgelegt. Workflows können entweder für alle Jobs oder für Jobs mit mehreren Steps erstellt werden.

Hinweise:

  • Innerhalb der Werte mancher Parameter können spezielle Platzhalter eingetragen werden, die mit dem Zeichen % eingeleitet und abgeschlossen werden (zum Beispiel: %SID%). Am Standardwert des Parameters sehen Sie, ob und welche Platzhalter verwendet werden können. Die folgenden Platzhalter sind für Parameterwerte verfügbar:

    • %SID% - Die ID des SAP-Systems, mit dem der Agent verbunden ist.
    • %CLIENT% - Die Nummer des SAP-Mandanten, an dem sich der CPIC-Benutzer angemeldet hat.
    • %JOBNAME% - Der Name des Jobs im SAP-System.
    • %USER% - Der Name des SAP-Benutzers.
    • %STEP% - Der Name des Job-Steps.
  • Es spielt keine Rolle, ob die Parameter in Groß- und/oder Kleinschreibung angegeben werden.

Schnittstelle: AE und Standard

Syntax

R3_IMPORT_JOBS

    [SINGLE_JOBS=...]
    [,WORKFLOWS=...]
    [,JOB_NAME=...]
    [,LOGIN_NAME=...]
    [,WORKFLOW_NAME=...]
    [,EXTENSION=...]
    [,LOGINS=...]
    [,HOST=...]
    [,QUEUE=...]
    [,DEPENDENCY_STATE=...]
    [,DEPENDENCY_ELSE_ACTION=...]
    [,DEPENDENCY_ELSE_ALARM=...]
    [,EXT_COMMAND=...]
    [,EXT_PROGRAM=...]
    [,LOGIN_FOLDER=...]
    [,JOB_FOLDER=...]
    [,WORKFLOW_FOLDER=...]
    [,OVERRIDE=...]
    [,JOB_TEMPLATE=...]
    [,WORKFLOW_TEMPLATE=...]

Parameter

  • R3_IMPORT_JOBS
    Importiert SAP-Jobs in ein AE-System

  • SINGLE_JOBS=
    (Optional) Definiert das Verhalten, das entscheidet, ob für jeden Job-Step ein Jobobjekt erstellt werden soll.
    Format: Script-Literal oder AE-Name
    Zulässige Werte:

    • YES (Standardwert)
      Für jede R3_*-Funktion wird ein eigenes Jobobjekt erstellt.

    • NO
      Die erstellten Jobobjekte können mehrere R3_*-Funktionen beinhalten.

  • WORKFLOWS=
    (Optional) Dieser Parameter erstellt Workflows für die importierten Jobs.
    Format: Script-Literal oder AE-Name
    Zulässige Werte:

    • "" (Standardwert)
      Es werden keine Workflow-Objekte erstellt
    • 1
      Es werden Workflows für alle importierten Jobs erstellt.
    • 2
      Es werden nur Workflows für Jobs erstellt, die mehrere Steps umfassen.

  • JOB_NAME=
    (Optional) Definiert die Namenskonvention für die erstellten Job-Objekte
    Format: Script-Literal oder AE-Name
    Standardwert: JOBS.%SID%.%CLIENT%@%JOBNAME%

  • LOGINS=
    (Optional) Erstellt Login-Objekte
    Zulässige Werte:

    • "" (Standard)
      Es werden keine Login-Objekte erstellt.
    • 1
      Login-Objekte werden erstellt. Im Objekt wird der Name des Agenten verwendet.
    • 2
      Erstellt Login-Objekte Das Platzhalterzeichen "*" wird im Objekt anstelle des Agentennamens verwendet.

  • LOGIN_NAME=
    (Optional) Definiert die Namenskonvention für die importierten Login-Objekte
    Format: Script-Literal oder AE-Name
    Standardwert: LOGIN.%SID%.%CLIENT%@%USER% 

  • WORKFLOW_NAME=
    (Optional) Definiert die Namenskonvention für die erstellten Workflow-Objekte
    Format: Script-Literal oder AE-Name
    Standardwert: JOBP.%SID%.%CLIENT%@%JOBNAME%

  • EXTENSION=
    (Optional) Definiert eine Erweiterung für den Objektnamen von Jobs, die pro Schritt erstellt werden
    Hinweis: Dieser Parameter ist nur relevant, wenn der Parameter SINGLE_JOBS YES gesetzt ist.
    Format: Script-Literal oder AE-Name
    Standardwert: %STEP%

  • HOST=
    (Optional) Definiert das Host-Attribut der erstellten Jobs
    Format: Script-Literal oder AE-Name
    Standardwert: %SID%

  • QUEUE=
    (Optional) Definiert das Queue-Attribut der erstellten Jobs
    Format: Script-Literal oder AE-Name
    Standardwert: CLIENT_QUEUE

  • DEPENDENCY_STATE=
    (Optional) Definiert den erwarteten Status, der innerhalb des Workflows in die Job-Eigenschaften (Abhängigkeiten) eingegeben werden soll.
    Hinweis: Dieser Parameter ist nur für die Erstellung von Workflows relevant.
    Format: Script-Literal oder AE-Name
    Standardwert: ANY_OK

  • DEPENDENCY_ELSE_ACTION=
    (Optional) Definiert eine Else-Aktion für die Abhängigkeiten des Jobs innerhalb des Workflows (Aufgaben-Eigenschaften)
    Hinweis: Parameter ist nur für die Erstellung von Workflows relevant.
    Format: Script-Literal oder AE-Name
    Zulässige Werte:

    • ""
      Der Wert der Workflow-Vorlage
    • ABORT
      Aufgabe und Workflow wird abgebrochen
    • BLOCK
      Der Workflow blockiert die relevante Aufgabe
    • BLOCK_ABORT
      er Workflow blockiert bei der Aufgabe und sendet ein Abbruchsignal zu einem übergeordneten Workflow (wenn vorhanden)
    • SKIP
      Die Aufgabe wird übersprungen.

  • DEPENDENCY_ELSE_ALARM=
    (Optional) Definiert den Namen eines Objekts, das ausgeführt werden soll, wenn die Abhängigkeiten des Jobs im Workflow nicht erfüllt sind (Aufgaben-Eigenschaften)
    Hinweis: Dieser Parameter ist nur für die Erstellung von Workflows relevant.
    Format: Script-Literal oder AE-Name

  • EXT_COMMAND=
    (Optional) Dieser Parameter schließt externe Befehlsschritte ein.
    Format: Script-Literal oder AE-Name
    Zulässige Werte:

    • NO (Standard)
      Nicht enthalten
    • YES
      Enthalten

  • EXT_PROGRAM=
    (Optional) Dieser Parameter schließt externe Programmschritte ein.
    Format: Script-Literal oder AE-Name
    Zulässige Werte:

    • NO (Standard)
      Nicht enthalten
    • YES
      Enthalten

  • LOGIN_FOLDER=
    (Optional) Definiert den Pfad des Ordners im AE-Mandanten, in dem Sie die erstellten Login-Objekte speichern wollen
    Format: Script-Literal oder AE-Name
    Standardwert: <Kein Ordner>

  • JOB_FOLDER=
    (Optional) Definiert den Pfad des Ordners im AE-Mandanten, in dem Sie die erstellten Job-Objekte speichern wollen
    Format: Script-Literal oder AE-Name
    Standardwert: <Kein Ordner>

  • WORKFLOW_FOLDER=
    (Optional) Definiert den Pfad des Ordners im AE-Mandanten, in dem Sie das erstellte Workflow-Objekt speichern wollen
    Format: Script-Literal oder AE-Name
    Standardwert: <Kein Ordner>

  • OVERRIDE=
    (Optional) Überschreibt vorhandene Objekte
    Format: Script-Literal oder AE-Name
    Zulässige Werte:

    • YES (Standard)
      Objekte werden überschrieben
    • NO
      Objekte desselben Namens werden nicht ersetzt

  • JOB_TEMPLATE=
    (Optional) Name eines SAP-Jobobjekts, das als Basis für die Joberstellung verwendet werden soll
    Format: Script-Literal oder AE-Name
    Standardwert: JOBS.SAP

  • WORKFLOW_TEMPLATE=
    (Optional) Name eines Workflow-Jobobjekts, das als Basis für die Workflow-Erstellung verwendet werden soll
    Format: Script-Literal oder AE-Name
    Standardwert: JOBP

Beispiele

In folgendem Beispiel werden alle Jobs in SAP, deren Name mit TEST beginnt, ausgewählt und in das AE-System übernommen.

R3_GET_JOBS NAME="TEST*",USER="MEIER"
R3_IMPORT_JOBS JOB_NAME='JOBS.UC4.%JOBNAME%.%STEP%'

Siehe auch:

seealso

SAP JCL