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.
Diese Seite beinhaltet Folgendes:
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 Jobreports 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ätzliche Startparameter
Zusätzlich besitzen einige Job Messenger spezielle Startparameter:
z/OS
-
Parameter: STP
Beschreibung: Logging der Rückgabewerte der Steps
Erlaubte 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
Erlaubte 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 codieren.
Verwenden Sie den Meldungsaufruf auf der Seite Prozess der Jobs.
Beispiel (Windows)
&UC_JOBMD CMD="ping localhost"
Windows
-
Parameter: LOCAL
Beschreibung: Der Windows Messenger verwendet eine sichere oder eine nicht sichere Verbindung, um eine Verbindung zum Agenten einzurichten
Mit Hilfe dieses Parameters können Sie definieren, ob Sie eine sichere TLS/SSL-Verbindung zu dem Agenten verwenden wollen. Eine nicht gesicherte Verbindung kann nur für die lokale Kommunikation genutzt werden.
Erlaubte Werte:
-
0: Der Messenger verwendet eine TLS/SSL-Verbindung zum Windows-Agenten
-
1 (Standard): Der Messenger verwendet eine nicht sichere Verbindung zum Windows-Agenten nur über localhost (127.0.0.1)
-
Siehe auch: