Rückgabewerte von z/OS-Jobs

z/OS

Include MVS.JOBMD_DEFINITIONS

---

JCL Exit

Bei der Durchführung von z/OS-Jobs können Sie auf eigene JCL-Exits zurückgreifen. Dabei handelt es sich um ein Modul, das den generierten Job vor der Ausführung ändern kann.

Legen Sie die z/OS-Jobs wie gewohnt in der AE an. Beim Start wird der generierte Job an den Agenten geschickt. Dieser nimmt noch einige Ergänzungen vor und führt den Job im Zielsystem aus. Bei der Verwendung des JCL-Exits ruft der Agent vor der Ausführung noch das eingestellte Modul auf. Damit lässt sich nachträglich die JCL in z/OS ändern.  Sie können JCL-Zeilen hinzufügen, ändern oder auswerten und auf diesem Wege beispielsweise den Start von bestimmten Programmen verhindern.

Sie können das JCL-EXIT-Modul in Assembler-Code oder in der Programmiersprache C erstellen. Das Modul wird in der INI-Datei des Agenten in der Sektion (JCL-Exit) angegeben. Hierbei gibt es jedoch unterschiedliche INI-Parameter für den Assembler- oder den C-basierten JCL-Exit (siehe Konfiguration unten).
Der Agent lädt dabei nur ein JCL-Exit Modul. Primär wird der c-basierte JCL-Exit verwendet, falls angegeben.

Im Auslieferungsordner des z/OS-Agenten finden Sie ein Beispiel-Modul in der Datei namens uc4jcle.asm (Assembler), das Kommentarzeilen einfügt. Sie enthält auch eine Beschreibung wie das Modul anzuwenden ist.

Der JCL-Exit kann für jeden z/OS-Agenten einzeln aktiviert werden. Das Modul wird beim Start des Agenten geladen.

Konfiguration - C Modul

• Wird ein c-basiertes JCL-Exit Modul angegeben, so wird ausschließlich dieses vom Agenten verwendet.
• Tragen Sie in der INI-Datei des z/OS Agenten den Namen Ihres JCL-Exit Moduls und der unterschiedlichen Funktionen ein. Verwenden Sie dazu folgende INI-Parameter:

(JCL-Exit)
ExitModul=Module name
ExitFunction=ExitFunction name
InitFunction=InitFunction name (optional)
CloseFunction=CloseFunction name (optional)

• Starten Sie den Agenten erneut.

Konfiguration - Assembler Modul

• Wird verwendet, wenn kein c-basierter JCL-Exit angegeben wurde.
• Tragen Sie in der INI-Datei des z/OS Agenten den Namen Ihres JCL-Exit Moduls ein und legen Sie auch die Größe des Ausgabebereiches fest.

(JCL Exit)
name=Module name
maxJclRecords=1000

• Kopieren Sie es entweder in unsere Loadlibrary oder ergänzen Sie die STEPLIB Definition für den Agenten um die Library mit dem JCL-Exit.
• Starten Sie nach diesen Vorkehrungen den Agenten (neu).

Siehe auch:

INI-Datei