Automation Engine Script-Leitfaden > AE JCL für Anwendungen > SAP > R3_IMPORT_JOBS

R3_IMPORT_JOBS

Importiert Jobs von SAP in das Automation Engine System.

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=...]

Innerhalb der Werte mancher Parameter können spezielle Platzhalter eingetragen werden, die mit dem Zeichen % eingeleitet und abgeschlossen werden (zum Beispiel: %SID%). Am Standardwert der Parameter sehen Sie, ob und welche Platzhalter verwendet werden können. Eine Liste mit Erklärung der Platzhalter finden Sie unterhalb der Syntax-Tabelle.

Syntax

Beschreibung/Format

SINGLE_JOBS= 

Verhalten, ob für jeden Jobstep ein Job-Objekt erstellt werden soll.
Format: Script-Literal oder AE-Name

Erlaubte Werte: "YES" (Standardwert) oder "NO"
"YES" - Für jede R3_* Funktion ein eigenes Job-Objekt anlegen.
"NO" - Die erstellten Job-Objekte können auch mehrere R3_* Funktionen enthalten.

WORKFLOWS= 

Workflows für die importierten Jobs erstellen
Format: Script-Literal oder AE-Name

Erlaubte Werte: "" (Standardwert), "1" oder "2"
"" - Keine Workflow-Objekte erstellen
"1" - Workflows für alle importieren Jobs erstellen
"2" - Es werden nur Workflows für Jobs angelegt, die mehrere Steps besitzen.

JOB_NAME= 

Namensschema für die erstellten Job-Objekte
Format: Script-Literal oder AE-Name

Standardwert: JOBS.%SID%.%CLIENT%@%JOBNAME%

LOGINS=

Login-Objekte erstellen

Erlaubte Werte: "" (Standardwert), "1" oder "2"
"" - Keine Login-Objekte generieren.
"1" - Login-Objekte anlegen. Im Objekt wird der Name des Agenten eingetragen.
"2" - Login-Objekte anlegen. Im Objekt wird "*" anstelle des Agentennamens eingetragen.

LOGIN_NAME= 

Namensschema für die importierten Login-Objekte
Format: Script-Literal oder AE-Name

Standardwert:
LOGIN.%SID%.%CLIENT%@%USER% 

WORKFLOW_NAME=

Namensschema für die erstellten Workflow-Objekte
Format: Script-Literal oder AE-Name

Standardwert: JOBP.%SID%.%CLIENT%@%JOBNAME%

EXTENSION=

Erweiterung für den Objektnamen von Jobs, die pro Step erstellt werden.
Format: Script-Literal oder AE-Name

Dieser Parameter ist nur relevant, wenn SINGLE_JOBS auf den Wert YES gesetzt ist.

Standardwert: %STEP%

HOST=

Host-Attribut der angelegten Jobs
Format: Script-Literal oder AE-Name

Standardwert:
%SID%

QUEUE=

Queue-Attribut der angelegten Jobs
Format: Script-Literal oder AE-Name

Standardwert: CLIENT_QUEUE

DEPENDENCY_STATE=

Erwarteter Status, der im Workflow in den Eigenschaften des Jobs (Abhängigkeiten) eingetragen werden soll.
Format: Script-Literal oder Automic-Name

Nur relevant, wenn Workflows erstellt werden.

Standardwert: ANY_OK

DEPENDENCY_ELSE_ACTION=

Sonst-Anweisung für die Abhängigkeiten des Jobs im Workflow (Aufgaben-Eigenschaften)
Format: Script-Literal oder AE-Name

Nur relevant, wenn Workflows erstellt werden.

Erlaubte Werte: "" (Standardwert), "ABORT", "BLOCK", "BLOCK_ABORT" oder "SKIP"
"" - Wert des Workflow-Templates
"ABORT" - Aufgabe und Workflow abbrechen
"BLOCK" - Der Workflow blockiert bei der entsprechenden Aufgabe
"BLOCK_ABORT" - Workflow blockiert bei der Aufgabe und sendet ein Abbruchsignal zu einem übergeordneten Workflow (wenn vorhanden)
"SKIP" - Aufgabe überspringen

DEPENDENCY_ELSE_ALARM=

Name eines Objektes, welches ausgeführt werden soll, wenn die Abhängigkeiten des Jobs im Workflow nicht erfüllt werden (Aufgaben-Eigenschaften)
Format: Script-Literal oder AE-Name

Nur relevant, wenn Workflows erstellt werden.

EXT_COMMAND=

Externe Kommando-Steps miteinbeziehen
Format: Script-Literal oder AE-Name

Erlaubte Werte: "YES" (einbeziehen) oder "NO" (nicht einbeziehen, Standardwert)

EXT_PROGRAM=

Externe Programm-Steps miteinbeziehen
Format: Script-Literal oder AE-Name

Erlaubte Werte: "YES" (einbeziehen) oder "NO" (nicht einbeziehen, Standardwert)

LOGIN_FOLDER=

Pfad des Ordners im Mandanten, in welchem die erstellten Login-Objekte abgelegt werden
Format: Script-Literal oder AE-Name

Standardwert:
<Kein Ordner>

JOB_FOLDER=

Pfad des Ordners im Mandanten, in welchem die erstellten Job-Objekte abgelegt werden
Format: Script-Literal oder AE-Name

Standardwert: <Kein Ordner>

WORKFLOW_FOLDER=

Pfad des Ordners im Mandanten, in welchem die erstellten Workflow-Objekte abgelegt werden
Format: Script-Literal oder AE-Name

Standardwert: <Kein Ordner>

OVERRIDE=

Existierende Objekte überschreiben
Format: Script-Literal oder AE-Name

Erlaubte Werte: "YES" (Standardwert) oder "NO"
"YES" - Objekte überschreiben
"NO" - Objekte mit dem selben Namen werden nicht ersetzt.

JOB_TEMPLATE=

Name eines SAP Job-Objektes, welches als Basis für die Joberstellung verwendet werden soll.
Format: Script-Literal oder AE-Name

Standardwert: "JOBS.SAP"

WORKFLOW_TEMPLATE=

Name eines Workflow-Objektes (Standard-Workflow), welches als Basis für die Workflow-Erstellung verwendet werden soll.
Format: Script-Literal oder AE-Name

Standardwert: "JOBP"

Platzhalter für Parameter-Werte:

Es spielt keine Rolle ob die Parameter in Groß- und / oder Kleinschreibung angegeben werden.

Kommentare

Das Sprachmittel ermöglicht es, Jobs aus SAP in Form von Job-Objekten in das Automation Engine System zu übernehmen. Dabei wird das SAP-System und der SAP-Mandant verwendet, an welchem der jeweilige SAP-Agent angemeldet ist, auf welchem das Sprachmittel R3_IMPORT_JOBS ausgeführt wird.

Vor der Funktion R3_IMPORT_JOBS ist eine Selektion der zu importierenden Jobs mit dem Sprachmittel R3_GET_JOBS erforderlich. Alle SAP-Jobs, die mit R3_GET_JOBS ausgewählt wurden, werden als Job-Objekte in das Automation Engine System geladen. Wird keine Selektion vor dem Aufruf von R3_IMPORT_JOBS durchgeführt, so kommt es zum Abbruch.

Weiters besteht die Möglichkeit, Workflow- und Login-Objekte für die Jobs zu erstellen. Dieses Verhalten ist mit den Parametern LOGIN* und WORKFLOW* steuerbar (siehe oben).

Die Jobs werden in die erstellten Workflows eingefügt und anschließend die Abhängigkeiten in den Workflow-Eigenschaften entsprechend gesetzt (Parameter DEPENDENCY*=). Workflows können entweder für alle Jobs oder für Jobs mit mehreren Steps erstellt werden.

Beispiele

In folgendem Beispiel werden alle Jobs in SAP deren Name mit "TEST" beginnt selektiert und in das Automation Engine System übernommen.

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

 

Siehe auch:

 


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

Copyright © 2016 Automic Software GmbH