Knowledge Base > Automation Engine und Zielsysteme > Micro Focus JES > Jobs im Micro Focus JES

Jobs im Micro Focus JES

Eine Komponente des Micro Focus Enterprise Servers (MF ES) ist die Mainframe Transaction Option (MTO). Mit dieser JES-Engine lassen sich z/OS-Jobs (JES-Jobs) unverändert unter Windows und Unix durchführen.

Automation Engine bietet eine Möglichkeit, um Jobs in Micro Focus JES zu starten und so JCL-Dateien auszuführen. Diese sind im Dateisystem des Servers gespeichert. Der Jobstart erfolgt mit Hilfe des CLI-Programmes CASSUB.

Ein AE.Agent für Windows führt die Jobs in MF JES aus.

Anlegen eines Jobs

  1. Klicken Sie auf die Schaltfläche  in der Symbolleiste. Es öffnet sich ein Fenster in dem alle verfügbaren Objekttypen aufgelistet sind. Darunter befinden sich auch die Objekte für die einzelnen Plattformen. Wählen Sie JOBS.WIN.

  2. Vergeben Sie für das Job-Objekt einen geeigneten Namen und öffnen es anschließend. Wechseln Sie jetzt auf die Registerkarte Benachrichtigung.

  3. Für die Ausführung des Jobs ist ein Windows-Agent zuständig. Wählen Sie bei "Host" jenen Agenten aus, der auf dem Rechner läuft auf dem sich MF ES befindet.

  4. Der Agent benötigt für die Durchführung des Jobs Anmeldeinformationen. Diese sind in Form von Login-Objekten gespeichert. Wählen Sie das passende bei "Login" aus.

  5. Wechseln Sie nun auf die Registerkarte "Windows". Der erzeugte Jobreport kann sowohl in der Datenbank als auch als eigene Datei gespeichert werden. Verwenden Sie die Optionen in der linken oberen Ecke der Registerkarte, um die Behandlung des Jobreports festzulegen.

  6. Stellen Sie anschließend beim Typ unbedingt KDO ein.

  7. Als Kommando ist zunächst der Pfad zum Programm CASSUB einzutragen. Mit den Startparametern -r und -j geben Sie die JCL-Server-Umgebung und den kompletten Pfad zur JCL-Datei an. Der JCL-Server-Region-Name ist die Bezeichnung des MF MTO Services. Diesen Wert erfahren Sie in der MF Enterprise Server Administration.

  8. Speichern und schließen Sie das Job-Objekt, sobald Sie mit der Konfiguration fertig sind. Das Job-Objekt kann nun in Ihre Verarbeitung eingebunden werden.

Architektur

Der Jobstart mittels CASSUB führt dazu, dass der Job im Micro Focus Enterprise Server gestartet wird. Beim Starten und während der Durchführung wird ein Exit aufgerufen, der die Synchronisationsdateien für den Agenten schreibt (*.log-, *.inf- und *.can-Dateien).

Agenten-Variablen im Micro Focus JES

Folgende Umgebungs-Variablen stehen in der Benutzer-Umgebung unter dem der JES-Server gestartet wird zur Verfügung:

Umgebungs-Variable

Beschreibung

UC4_MF_JES_OUTPUT=

Pfad in dem der Exit die Steuerungsdateien für den Agenten schreiben soll bzw. mit dem Agenten kommuniziert (*.log, *.inf, *.can)

Es ist darauf zu achten, dass die Variable UC4_MF_JES_OUTPUT nur einen einzigen Pfad enthält und dieser mit abschließendem Backslash "\" definiert wird. Ansonsten funktioniert die Kommunikation zwischen Agent und Exit nicht. 

Beispiele:

Richtig: UC_MF_JES_OUTPUT = c:\AUTOMIC\Agent\Microfocus\temp\
Falsch: UC_MF_JES_OUTPUT = c:\AUTOMIC\Agent\Microfocus\temp
Falsch: UC_MF_JES_OUTPUT = c:\AUTOMIC\temp\;c:\temp

UC4_MF_TRACE=

Trace, den der Exit in das in der UC4_MF_TRACE_FILE angegebene Tracefile mit Open Extend schreibt

Mögliche Werte:
Y  = Der Exit schreibt einen Trace.
N = Der Exit schreibt keinen Trace.

UC4_MF_TRACE_FILE=

Vollständiger Dateiname des Tracefiles

UC4_MF_DELAY=

Delay in Sekunden, welches der EXIT wartet, wenn die *.INF Datei nicht gefunden werden kann.

Beachten Sie, dass der Standardwert 500 ms beträgt!

Es ist wichtig, diesen Parameter so klein wie möglich einzustellen, weil er sich auf ALLE JES-Jobs auswirkt und nicht nur auf jene, die mit AE gestartet wurden. Falls es in der AE Jobs gibt, die nicht enden, war der Exit so schnell, dass der Agent nach dem Jobstart keine Zeit mehr hatte, die *.INF-Datei anzulegen. Diese kann jedoch nach dem Jobstart  angelegt werden, weil sich erst aus dem Jobstart die JobID ergibt. Wir empfehlen, den Wert auf 100 zu setzen.

Beispiel für ein JES-Exit Tracefile

2007.12.14/13:53:58.95->MFJUXIT EC = 01 Jobnum = 01406 Jobname = ????????
2007.12.14/13:53:58.95->MFJUXIT UC4_MF_JES_OUTPUT = C:\AUTOMIC\
2007.12.14/13:53:58.95->MFJUXIT UC4_MF_TRACE_FILE = c:\trc.txt
2007.12.14/13:53:58.95->MFJUXIT UC4_MF_DELAY = 5000
2007.12.14/13:53:58.95->MFJUXIT UC4_MF_DELAY (converted to number) = 000005000
2007.12.14/13:53:59.11->MFJUXIT EC = 25 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.17->MFJUXIT EC = 03 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.20->MFJUXIT EC = 08 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.20->MFJUXIT EC = 09 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.23->MFJUXIT EC = 10 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.23->MFJUXIT EC = 08 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.25->MFJUXIT EC = 09 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.26->MFJUXIT EC = 10 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.26->MFJUXIT EC = 08 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.26->MFJUXIT EC = 09 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.30->MFJUXIT EC = 10 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.31->MFJUXIT EC = 08 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.31->MFJUXIT EC = 09 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.33->MFJUXIT EC = 10 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.34->MFJUXIT EC = 05 Jobnum = 01406 Jobname = JCLTEST
2007.12.14/13:53:59.34->MFJUXIT inf-file not found waiting 000005000 ms
2007.12.14/13:54:05.26->MFJUXIT EC = 02 Jobnum = 01406 Jobname = JCLTEST

 

Der Micro Focus Enterprise Server dient der Verwaltung, die Jobs werden im Zielsystem JES gepflegt, gestartet und gestoppt.

 

Das folgende Beispiel zeigt den Start eines JES-Jobs im Batchmodus ohne Agent, das CASSUB wird manuell abgesetzt:

C:\Documents and Settings\Ni\My Documents\Micro Focus\Net Express 5.0\WORKAREA>cassub -lUC4 -jC:\es-jcldemo\jclbatch.jcl
JCLCM0901I JOB01407 ???????? Event-job-ready action is:  0 (Continue). 12:59:10
JCLCM0925I JOB01407 JCLTEST  Event-job-stmt-info action is:  0 (Continue). 12:59
:10
JCLCM0187I JOB01407 JCLTEST  JOB  SUBMITTED (JOBNAME=JCLTEST,JOBNUM=01407) 12:59
:10
JCLCM0180I JOB01407 JCLTEST  Job ready for execution. 12:59:10
Processed "C:\es-jcldemo\jclbatch.jcl"
C:\Documents and Settings\Ni\My Documents\Micro Focus\Net Express 5.0\WORKAREA>

Der Exit erzeugt die *.inf-Datei für den Agenten, dieser prüft sie und schreibt in die Log-Datei. Dies geschieht nicht, wenn ein Job im Batchmodus gestartet wird.

 

 

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

 Copyright © 2016 Automic Software GmbH