Mit diesem Makro können Sie Mails löschen, die bisher nicht vom Mail-Sender-Backend gesendet wurden.
Entry-Namen oder SVC-Nummer(n)
SVC 20 (dezimal)
UNIT=940, FUNCTION=22, VERSION=1 | 2
Makro-Auffrufformat und Operandenbeschreibung
YMLDML |
FL=*TU / *TPR ,VERSION=1 / 2 ,ORDER=*ALL / *SINGLE ,ORDERID=<var: char:16> ,OWNER=*OWN / *ALL / *OTHER ,USERID=<var: char:8> ,OPTFILE=*NONE / <var: char:54> |
FL=
Funktionsbereich
*TU
SVC-Schnittstelle wird generiert.
*TPR
CALL-Schnittstelle wird generiert.
VERSION=
Wählt die Schnittstellenversion aus.
1
Es wird die alte Schnittstellenversion ausgewählt.
2
Es wird die neue Schnittstellenversion ausgewählt, die den Operanden OPTFILE und einen zusätzlichen Returncode anbietet.
ORDER=
Legt fest welcher Mail-Auftrag gelöscht werden soll.
*ALL
Alle noch nicht gesendeten Mails des Benutzers werden gelöscht.
*SINGLE
Die im Parameter ORDERID spezifizierte Mail wird gelöscht.
ORDERID=
Wenn ORDER=*SINGLE angegeben ist, bestimmt dieser Parameter die ID des zu löschenden Mail-Auftrags.
IDENTIFIER
Variable, in der die Auftrags-ID gespeichert ist, oder Register, das die Adresse einer Variablen enthält, in der die Auftrags-ID gespeichert ist.
OWNER=
Bestimmt den Benutzer, dessen Mail-Aufträge gelöscht werden.
*OWN
Nur Mail-Aufträge des Aufrufers löschen.
*ALL
Mail-Aufträge aller Benutzer löschen. Aufrufer ohne TSOS-Berechtigung erhalten hier das gleiche Ergebnis wie bei *OWN.
*OTHER
Mail-Aufträge des Benutzers löschen, der im Parameter USERID spezifiziert ist (nur für Aufrufer mit TSOS-Berechtigung erlaubt).
USERID
Bestimmt die Benutzerkennung, deren Mail-Aufträge gelöscht werden.
IDENTIFIER
Variable, in der die Benutzerkennung gespeichert ist, oder Register, das die Adresse einer Variablen enthält, in der die Benutzerkennung gespeichert ist.
OPTFILE=
Mit diesem Operanden kann eine Benutzer-Optionsdatei angegeben werden. Der Operand ist nur mit VERSION=2 verfügbar. Im Augenblick gibt es keine Benutzer-Option, die das Verhalten von YMLDML beeinflussen würde. Da sich dies aber in Zukunft ändern kann, empfiehlt es sich, schon jetzt beim YMLDML-Aufruf den OPTFILE-Operanden mit dem gleichen Wert wie bei den YMLSML- und YMLCML-Aufrufen zu versorgen.
*NONE
Keine Datei definiert.
IDENTIFIER
Variable, in der der Name der Optionsdatei gespeichert ist, oder Register, das die Adresse des Namens der Optionsdatei enthält.
Returncode
SRC2 | SRC1 | MRC | MRC-Name | Bedeutung |
|
|
|
| Es wurde kein Fehler festgestellt. |
|
|
|
| Parameterfehler. |
|
|
|
| Interner Fehler. |
|
|
|
| Auftrag nicht gefunden. |
|
|
|
| Berechtigung nicht ausreichend. |
|
|
|
| Auftrag gehört nicht dem spezifizierten Eigentümer. |
|
|
|
| Auftrag durch fremde Task abgeschickt. |
|
|
|
| Subsystem ASTI nicht verfügbar. |
|
|
|
| Unerwarteter ASTI-Fehler. |
|
|
|
| Service MAILCLNT nicht verfügbar. |
SRC1/2=Sub Returncode 1/2 in Sedezimal-Darstellung;
MRC=Main Returncode in Sedezimal-Darstellung
Makroaufruf-Parameter
Die Datenstruktur für die Makroaufruf-Parameter von YMLDML ist wie folgt aufgebaut:
VERSION=1
Distanz | Identifier | Wert | Bedeutung |
| Parameter Area | ||
000 |
| Function Header | |
008 |
| Eingabeparameter | |
008 |
| ID des zu löschenden Auftrags, falls | |
018 |
| Spezifiziert, welche Aufträge gelöscht werden sollen. | |
| 1 | Alle bisher nicht gesendeten Aufträge werden gelöscht. | |
| 2 | Der unter | |
019 |
| Spezifiziert den Benutzer, dessen Aufträge gelöscht werden sollen. | |
| 1 | Es werden nur Mail-Aufträge des Aufrufers gelöscht. | |
| 2 | Alle bislang nicht gesendeten Aufträge werden gelöscht. | |
| 3 | Aufträge des unter | |
01A |
| Reservierter Bereich | |
01C |
| Benutzerkennung, deren Aufträge gelöscht werden sollen. | |
024 |
| Ausgabeparameter | |
024 |
| Wenn der |
VERSION=2:
Distanz | Identifier | Wert | Bedeutung |
| Parameter Area | ||
000 |
| Function Header | |
008 |
| Eingabeparameter | |
008 |
| ID des zu löschenden Auftrags, falls | |
018 |
| Spezifiziert, welche Aufträge gelöscht werden sollen. | |
| 1 | Alle bisher nicht gesendeten Aufträge werden gelöscht. | |
| 2 | Der unter | |
019 |
| Spezifiziert den Benutzer, dessen Aufträge gelöscht werden sollen. | |
| 1 | Es werden nur Mail-Aufträge des Aufrufers gelöscht. | |
| 2 | Alle noch nicht gesendeten Aufträge werden gelöscht. | |
| 3 | Aufträge des unter | |
01A |
| Benutzerkennung, deren Aufträge gelöscht werden sollen. | |
022 |
| Benutzer-Optionsdatei | |
058 |
| Ausgabeparameter | |
058 |
| Wenn der | |
05C |
| Meldungs-ID | |
063 |
| Reservierter Bereich |
Ergänzende Erläuterungen zu den Ausgabeparametern:
YMLDMID
Dieses Feld enthält einen YML-Meldungsschlüssel für eine Meldung, die den aufgetretenen Fehler beschreibt. Das ist normalerweise die gleiche Meldung, die ein vergleichbarer DELETE-MAIL-ORDER-Kommandoaufruf liefern würde.
Auflistung der Expansion der Datenstruktur für die Makroaufruf-Parameter
Expansion:
XPAND= PARAM
YMLSML MF=D,XPAND=PARA
YMLDML MF=D
1 MFTST MF=D,PREFIX=Y,MACID=MLD,ALIGN=F,
1 DMACID=MLD,SUPPORT=(E,D,C,M,L),DNAME=MLDPARL
000000 2 YMLDPARL DSECT ,
1 * Parameter area
1 YMLDHDR FHDR MF=(C,YMLD),EQUATES=NO FHDR
1 * main return codes
00000000 1 YMLDSUCC EQU 0 No error detected
00000001 1 YMLDPARE EQU 1 Parameter error
00000002 1 YMLDINTE EQU 2 Internal error
00000003 1 YMLDONTF EQU 3 Order not found
00000004 1 YMLDIPRV EQU 4 Insufficient privileges
00000005 1 YMLDWROW EQU 5 Order not owned by specified
1 * owner
00000006 1 YMLDFTSK EQU 6 Order issued by foreign task
00000007 1 YMLDANAV EQU 7 Subsystem ASTI not available
00000008 1 YMLDASTI EQU 8 Unexpected ASTI error
1 *
1 *
000008 1 YMLDIND DS 0XL28 Input parameters
000008 1 YMLDOIDI DS CL16 Order Id
000018 1 YMLDORDS DS FL1 Order specification
1 * order
00000001 1 YMLDOALL EQU 1 ALL
00000002 1 YMLDOSNG EQU 2 SINGLE
1 *
000019 1 YMLDOWNS DS FL1 Owner specification
1 * owner
00000001 1 YMLDWOWN EQU 1 OWN
00000002 1 YMLDWALL EQU 2 ALL
00000003 1 YMLDWOTH EQU 3 OTHER
1 *
00001A 1 YMLDRSV1 DS CL2 Reserved
00001C 1 YMLDUSID DS CL8 User id of owner
1 *
1 *
000024 1 YMLDOUTD DS 0XL4 Output parameters
000024 1 YMLDARET DS F Return code from ASTI
1 *
00000028 1 YMLD# EQU *-YMLDHDR