Job Messenger des Agenten

Alle Betriebssystemagenten besitzen einen Job Messenger, mit dessen Hilfe sie Jobs durchführen und überwachen. Er wird im HEADER und im TRAILER von Include-Objekten aufgerufen. Diese spezifischen Include-Objekte sind im System-Mandanten 0000 verfügbar. Weitere Informationen finden Sie unter Include-Objekte in Headern und Trailern.

Beispielauszug aus dem Include-Objekt HEADER.MVS:

//JMLDS EXEC PGM=&UC_JOBMD,
// PARM='JNR=&UC_REALNR MNR=&UC_CLIENT PNR=&UC_IP_PORT IPA=&UC_IP_ADR
//             TYP=S TXT="        Job started" 2>&1'

Beispielauszug aus dem Include-Objekt TRAILER.MVS:

//JMLDE    EXEC PGM=&UC_JOBMD,COND=EVEN,
// PARM='JNR=&UC_REALNR MNR=&UC_CLIENT PNR=&UC_IP_PORT IPA=&UC_IP_ADR
//             TYP=E STP=&UC_REPORT_STEPS RET=&RETCODE 2>&1'

Hinweis: Beachten Sie, dass die PARM-Anweisung maximal 100 Zeichen umfassen darf.

Allgemeine Startparameter

Der Job Messenger besitzt eine Reihe von Startparametern, die ihm übergeben werden können. Die folgende Tabelle enthält jene, die für alle Job Messenger gelten.

• IPA

  IP-Adresse

• JNR

  Job-RunID

• MNR

  Mandant

• PNR

  Portnummer

• RET

  Rückgabewert

• TYP

  Typ:

  • S: Job Messenger starten

  • E: Job-Messenger beenden

  • V: eine Variable registrieren

• TXT

  Text, der am Beginn des Job-Reports und im Detailfenster des Statustexts angezeigt wird.

  Der Parameter ist auf 32 Zeichen beschränkt. Die Automation Engine benötigt zudem die ersten 8 Zeichen. Tragen Sie daher für die ersten 8 Stellen immer Leerzeichen ein. Die restlichen Stellen stehen für Ihren Text zur Verfügung.

Zusätzlich besitzen einige Job Messenger spezielle Startparameter:

• z/OS

  • Parameter: STP

    Beschreibung: Logging der Rückgabewerte der Steps

    Zulässige Werte:

    • 0 (Standard): Es wird kein Logging durchgeführt

    • 1: Der Job Messenger zeichnet die Rückgabewerte auf.

  • Parameter: RETRY

    Beschreibung: Anzahl der Verbindungsversuche

    Standardwert: 4

  • Parameter: WAIT

    Beschreibung: Zeitintervall zwischen den Verbindungsversuchen

    Standardwert: 30 Sekunden

• OS/400

  • Parameter: OUT

    Beschreibung: Logging der Meldungen des Job Messengers

    Zulässige Werte:

    • 0 (Standard): Es wird kein Logging durchgeführt

    • 1: Der Job-Report enthält auch die Meldungen des Job Messengers.

• UNIX und VMS

  • Parameter: RETRY

    Beschreibung: Anzahl der Verbindungsversuche

    Standardwert: 3

  • Parameter: TIMEOUT

    Beschreibung: Zeitspanne in Sekunden, nach denen ein Timeout für die Verbindung zwischen Agent und Job Messenger auftritt

    Standardwert: 60 Sekunden

  • Parameter: WAIT

    Beschreibung: Zeitintervall zwischen den Verbindungsversuchen

    Standardwert: 120 Sekunden

• UNIX und Windows

  • Parameter: CMD

    Beschreibung: Befehl, der auf dem Rechner des Agenten verarbeitet werden soll.

    Für diesen Befehl können Sie auch Passwörter verwenden, die mit Hilfe eines PromptSet-Objekts verschlüsselt wurden: Geben Sie die PromptSet-Variable an, die den Wert des verschlüsselten PromptSet-Textfelds enthält. Die Passwörter werden vom Job Messenger automatisch identifiziert und entsprechend entschlüsselt. Weitere Informationen finden Sie unter PromptSets (PRPT).

    Hinweis: Passwörter, die via UCYBCRYP.EXE verschlüsselt wurden, werden NICHT durch den Job Messenger entschlüsselt. Weitere Informationen finden Sie unter Passwörter verschlüsseln.

    Verwenden Sie den Meldungsaufruf auf der Seite Prozess der Jobs.

    Beispiel (Windows)

    &UC_JOBMD CMD="ping localhost"

Siehe auch:

Include-Objekte in Headern und Trailern