Domäne:
UTILITIES
Erforderliche Berechtigung:
STD-PROCESSING
TSOS
Mit dem Kommando REQUEST-MAIL-ORDER-RESULT können Sie zu Mail-Sende-Aufträgen den zugehörigen Ausführungs-Status abfragen, den die Backend-Task nach Bearbeitung des Auftrags zurückliefert. Die Auftragsdaten werden dabei aus den internen ASTI-Tabellen gelöscht. Dabei wird auch die zugehörige SYS-Datei unter der Kennung des Mail-Senders entfernt.
Zu Aufträgen, die noch auf ihre Bearbeitung warten, liefert das Kommando REQUEST-MAIL-ORDER-RESULT keine Informationen. In diesem Fall können Sie sich mithilfe des Kommandos SHOW-MAIL-ORDER-STATUS über den Auftrag informieren (siehe "SHOW-MAIL-ORDER-STATUS - Informationen zur Mail abfragen"). Das Kommando REQUEST-MAIL-ORDER-RESULT unterstützt eine strukturierte Ausgabe in S-Variablen (siehe Handbuch „Kommandos, Band 6, S-Variable“).
REQUEST-MAIL-ORDER-RESULT |
ORDER-ID=* ANY / <x-text 1..16> ,WAIT-FOR-RESULT=* NO / *YES ,USER-OPTION-FILE= *STD / <filename 1..54 without-gen> |
Beschreibung der Operanden
ORDER-ID=*ANY / <x-text 1..16>
spezifiziert den Auftrag, dessen Ausführungs-Status abgefragt wird.
ORDER-ID=*ANY
Der Ausführungsstatus eines, vom Kommando-Aufrufer abgesendeten, abgeschlossenen Auftrags wird abgefragt. Liegen mehrere abgeschlossene Aufträge vor, dann ist nicht definiert, von welchem dieser Aufträge der Status abgefragt wird.
ORDER-ID=<x-text 1..16>
ASTI-Auftrags-ID des Auftrags, dessen Ausführungs-Status abgefragt wird.
WAIT-FOR-RESULT=*NO / *YES
legt fest, ob das Kommando wartet, bis die Bearbeitung des Auftrags abgeschlossen ist.
WAIT-FOR-RESULT=*NO
Das Kommando wartet nicht das Ende eines bisher nicht abgeschlossenen Auftrags ab. Den Ausführungs-Status des Auftrags können Sie zu einem späteren Zeitpunkt mit einem erneuten REQUEST-MAIL-ORDER-RESULT-Aufruf abfragen.
WAIT-FOR-RESULT=*YES
Das Kommando wartet, bis der Auftrag abgeschlossen ist.
Wenn ORDER-ID=*ANY angegeben ist, wird das Warten intern durch eine periodische Abfrage mit einem Intervall von 60 Sekunden realisiert, sodass durchschnittlich 30 Sekunden nach Auftragsende das Warten abgeschlossen ist.
USER-OPTION-FILE=*STD / <filename 1..54 without-gen>
spezifiziert eine Benutzer-Option-Datei, die Standard-Werte für verschiedene Operanden enthält. Eine detaillierte Beschreibung der Benutzer-Option-Datei finden Sie in Abschnitt „Konfigurationsdatei für das Mail-Sender Frontend (Benutzer-Option-Datei)“.
USER-OPTION-FILE=*STD
Die Standard-Benutzer-Options werden aus der Datei ermittelt, die in der Option-Datei SYSSSI mit der Option defaultOptionFileName spezifiziert ist (siehe „interNet Services, Administratorhandbuch“). Die Voreinstellung für diese Option ist SYSDAT.MAIL.nnn.USER.OPT.
USER-OPTION-FILE=<filename 1..54 without-gen>
Als Benutzer-Option-Datei wird die hier angegebene Datei verwendet.
Kommando-Returncodes
(SC2) | SC1 | Maincode | Bedeutung / garantierte Meldungen |
| 0 | CMD0001 | Kein Fehler. | |
| 32 | CMD0220 | Interner Fehler. | |
| 32 | CMD2009 | Fehler während der Erstellung der S-Variable. | |
| 64 | YML0120 | Subsystem ASTI nicht verfügbar. | |
| 32 | YML0176 | Unerwarteter ASTI-Fehler. | |
| 64 | YML0210 | Auftrag wurde nicht gefunden. | |
| 128 | YML0214 | Ressourcen sind erschöpft. | |
| 64 | YML0215 | Bei Auftragsstellung wurde kein Ergebnis angefordert. | |
| 64 | YML0216 | Auftrag wurde durch fremde Task ausgeführt. | |
128 | YML0222 | Auftrag nicht abgeschlossen. |
SC1/2=Subcode 1/2 in Dezimal-Darstellung
Beispiele
|
|
Ausgabe-Daten
Wenn ein Auftrag beendet ist, gibt das Kommando drei Zeilen mit Informationen zum Ausführungs-Status aus.
Die erste Zeile (ORDER-ID) gibt die ID des Auftrags an, für den die Daten ausgegeben werden. Dies ist vor allem relevant, wenn ORDER-ID=*ANY spezifiziert wurde.
Die zweite Zeile (RETURN CODE) gibt an, ob ein Fehler aufgetreten ist, und wenn ja, welcher. Mögliche Werte sind:
OK
Mail erfolgreich gesendet.
Error during SMTP protocol
Der Mail-Server hat einen Fehler an die Backend-Task gemeldet.
Error during S/MIME operation
Während der S/MIME-Verarbeitung ist ein Fehler aufgetreten, z.B. Zertifikatsprobleme.
Internal error
Bei allen anderen Fehlern.
Die dritte Zeile (RETURN MESSAGE) enthält folgende Informationen:
Im Fehlerfall:
Zusätzliche textuelle Informationen über den Fehler.Bei einem erfolgreich beendeten Auftrag:
Abschluss-Meldung des Mail-Servers. Diese Meldung enthält üblicherweise die (partielle) Message-ID, die der Mail vom Server zugewiesen wurde. Tritt im weiteren Mail-Transfer ein Fehler auf, dann kann der Administrator mithilfe dieser ID den Transfer der Mail über die Kette der Mail-Server zurückverfolgen lassen.
Die Daten können auch an eine S-Variable übergeben werden, die entsprechend der Ausgabe des Kommandos strukturiert ist.