Include-Objekte in Headern und Trailern

Mandant 0 enthält vordefinierte Job-Header und -Trailer für Betriebssysteme, Plattformen und Anwendungen, die in die Automation Engine integriert werden. Dieser Header und Trailer werden in Form von Includes (JOBI) bereitgestellt. Die Includes werden in den Ordnern HEADER und TRAILERgespeichert, die standardmäßig in der Process Assembly-Perspektive zur Verfügung stehen. Verwenden Sie diese Includes, um Aktionen zu definieren, die immer in den Jobs der entsprechenden Betriebssysteme, Plattformen oder Anwendungen ausgeführt werden sollen. Eine der Aktionen der Header ist der Aufruf des Job Messenger des Agenten (JOBMD), um Jobs auszuführen und zu überwachen. Das Script des Trailers wird verarbeitet, wenn der Job abgeschlossen ist. Es enthält Informationen zum Status des Jobs und ermöglicht es Ihnen, Aktionen für die Nachbearbeitung anzugeben.

In den Code der Header- und Trailer-Includes sind andere Includes (Benutzer-Includes) eingebettet. Allerdings werden Benutzer-Includes nicht standardmäßig mit der Automation Engine bereitgestellt. Wenn Sie sie verwenden möchten, müssen Sie sie zuerst erstellen. Wenn Sie sie nicht verwenden möchten, stellt der Parameter nofound=ignore, der standardmäßig auf sie angewendet wird, sicher, dass sie ignoriert werden.

Als Entwickler und Objektdesigner erstellen Sie die Benutzer-Includes, um die Verarbeitung von Jobs an Ihre Infrastruktur anzupassen.

Hinweise:

  • Sie benötigen Rechte für Include-Objekte (JOBI), um Jobs ausführen zu können.
  • Sie können die Header-und Trailer-Includes von Mandant 0 auf einen anderen Mandanten kopieren. Wenn Sie dies tun, werden die Mandanten-Includes angewendet. Wenn der Mandant nicht über Header- und Trailer-Includes verfügt, werden diejenigen von Mandant 0 angewendet.
  • Wenn Sie aus Leistungsgründen nicht mit Benutzer-Includes in Headern und Trailern arbeiten, kann Ihr Systemadministrator diese Funktion deaktivieren. Weitere Informationen finden Sie unter DISABLE_USER_HEADER in UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen.

Beispiel für einen Windows-Header JOBI

Die folgende Grafik veranschaulicht die Struktur eines Windows-Headers und -Trailers. Gibt an, in welchen Phasen des Jobs die verschiedenen Elemente des Headers angewendet werden:

Windows-Header:

:set &UC_WIN_TYP = get_att(WIN_TYP)

:IF &UC_WIN_TYP = "BAT"

:   set &UC_REM_PRF = 'REM '

:else

:   set &UC_REM_PRF = "' "

:endif

:INC HEADER.WINDOWS.USER.PRE ,nofound=ignore

:INC_SCRIPT(1)

:INC HEADER.WINDOWS.USER.HEAD ,nofound=ignore

:INC ATTRDIA.WINDOWS

:set &UC_REALNR  = SYS_ACT_RESTART_ME_NR

:set &UC_NAME    = SYS_ACT_JOBNAME

:set &UC_MANDANT = SYS_ACT_CLIENT

:IF &UC_WIN_TYP = "BAT"

:set &UC_JOBMD   = get_var(UC_EX_JOB_MD)

:set &UC_IP_PORT = get_var(UC_EX_IP_PORT)

:set &UC_IP_ADR  = get_var(UC_EX_IP_ADDR)

:if str_find(&UC_JOBMD, ' ') GT 0

:  set &UC_JOBMD = '"&UC_JOBMD"'

:endif

@echo on

&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=S TXT="        Job started"

:DATA @set retcodemsg=%errorlevel%

:DATA @set retcode=0

:DATA @if NOT %retcodemsg% == 0 GOTO :MSGABORT

:ENDIF

:INC HEADER.WINDOWS.USER.START ,nofound=ignore

Windows-Trailer:

:INC TRAILER.WINDOWS.USER.END ,nofound=ignore

:IF &UC_WIN_TYP = "BAT"

&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=E RET=00000000 TXT="        Job ended"

:DATA @set retcodemsg=%errorlevel%

:DATA @set retcode=0

GOTO JOBENDE

:DATA :RETCODE

&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=E RET=%retcode% TXT="        Job ended with retcode"

:DATA @set retcodemsg=%errorlevel%

GOTO JOBENDE

:DATA :ABEND

:ENDIF

:INC TRAILER.WINDOWS.USER.ABEND ,nofound=ignore

:IF &UC_WIN_TYP = "BAT"

&UC_JOBMD JNR=&UC_REALNR MNR=&UC_MANDANT PNR=&UC_IP_PORT IPA=&UC_IP_ADR TYP=E RET=00000100 TXT="        controlled job cancel"

:DATA @set retcodemsg=%errorlevel%

:DATA @set retcode=100

:DATA :JOBENDE

:DATA @if NOT %retcodemsg% == 0 GOTO :MSGABORT

:DATA @exit %retcode%

:ENDIF

:IF &UC_WIN_TYP = "BAT"

:DATA :MSGABORT

! Weil der UC4: Job-Messenger nicht mit dem UC4: Agent kommunizieren konnte,

! wird der Job wird mit dem Beendigungscode des UC4: Job-Messengers beendet

:DATA @echo ATTENTION - UC4:JOBMESSENGER Fehler

:DATA @echo JOB beendet RETCODE %retcode%

DATA @Echo JOBMSG mit RETCODE% retcodemsg% beendet

:DATA @echo JOB bricht ab mit RETCODE aus JOBMSG-Schritt

:DATA @exit %retcodemsg%

Liste der Header- und Trailer-Includes mit Benutzer-Includes

BS2000

  • Header-Include

    HEADER.BS2000

  • Trailer-Include

    TRAILER.BS2000

  • Benutzer-Includes

    HEADER.BS2000.USER.PRE

    HEADER.BS2000.USER.HEAD

    HEADER.BS2000.USER.START

    TRAILER.BS2000.USER.END

    TRAILER.BS2000.USER.ABEND

JMX

  • Header-Include

    HEADER.JMX

  • Trailer-Include

    TRAILER.JMX

  • Benutzer-Includes

    HEADER.JMX.USER.PRE

    HEADER.JMX.USER.HEAD

    HEADER.JMX.USER.START

    TRAILER.JMX.USER.END

NSK

  • Header-Include

    HEADER.NSK

  • Trailer-Include

    TRAILER.NSK

  • Benutzer-Includes

    HEADER.NSK.USER.PRE

    HEADER.NSK.USER.HEAD

    HEADER.NSK.USER.START

    TRAILER.NSK.USER.END

z/OS

  • Header-Include

    HEADER.MVS

  • Trailer-Include

    TRAILER.MVS

  • Benutzer-Includes

    HEADER.MVS.USER.PRE

    HEADER.MVS.USER.HEAD

    HEADER.MVS.USER.START

    TRAILER.MVS.USER.END

OS/400

  • Header-Include

    HEADER.OS400

  • Trailer-Include

    TRAILER.OS400

  • Benutzer-Includes

    HEADER.OS400.USER.PRE

    HEADER.OS400.USER.HEAD

    TRAILER.OS400.USER.END

PeopleSoft

  • Header-Include

    HEADER.PS

  • Trailer-Include

    TRAILER.PS

  • Benutzer-Includes

    HEADER.PS.USER.PRE

    HEADER.PS.USER.HEAD

    HEADER.PS.USER.START

    TRAILER.PS.USER.END

RA

  • Header-Include

    HEADER.CIT

  • Trailer-Include

    TRAILER.CIT

  • Benutzer-Includes

    HEADER.CIT.USER.PRE

    HEADER.CIT.USER.HEAD

    HEADER.CIT.USER.START

    TRAILER.CIT.USER.END

SAP

  • Header-Include

    HEADER.SAP

  • Trailer-Include

    TRAILER.SAP

  • Benutzer-Includes

    HEADER.SAP.USER.PRE

    HEADER.SAP.USER.HEAD

    HEADER.SAP.USER.START

    TRAILER.SAP.USER.END

SAP BW

  • Header-Include

    HEADER.SAPBW

  • Trailer-Include

    TRAILER.SAPBW

  • Benutzer-Includes

    HEADER.SAPBW.USER.PRE

    HEADER.SAPBW.USER.HEAD

    HEADER.SAPBW.USER.START

    TRAILER.SAPBW.USER.END

SQL

  • Header-Include

    HEADER.SQL

  • Trailer-Include

    TRAILER.SQL

  • Benutzer-Includes

    HEADER.SQL.USER.PRE

    HEADER.SQL.USER.HEAD

    HEADER.SQL.USER.START

    TRAILER.SQL.USER.END

UNIX

  • Header-Include

    HEADER.UNIX

  • Trailer-Include

    TRAILER.UNIX

  • Benutzer-Includes

    HEADER.UNIX.USER.PRE

    HEADER.UNIX.USER.HEAD

    HEADER.UNIX.USER.START

    TRAILER.UNIX.USER.END

VMS

  • Header-Include

    HEADER.VMS

  • Trailer-Include

    TRAILER.VMS

  • Benutzer-Includes

    HEADER.VMS.USER.PRE

    HEADER.VMS.USER.HEAD

    TRAILER.VMS.USER.END

Windows

  • Header-Include

    HEADER.WINDOWS

  • Trailer-Include

    TRAILER.WINDOWS

  • Benutzer-Includes

    HEADER.WINDOWS.USER.PRE

    HEADER.WINDOWS.USER.HEAD

    HEADER.WINDOWS.USER.START

    TRAILER.WINDOWS.USER.END

    TRAILER.WINDOWS.USER.ABEND

Siehe auch: