| Nachrichtentyp | 01 |
| Richtung | C->S |
| Antwort(en) | LOGIN_ACK |
Die Anforderung zum Login. Keine anderen Kommandos können ohne erfolgreiche Anmeldung vom Client an den Server gesendet werden. Der Server wird mit einer LOGIN_ACK Nachricht antworten um eine erfolgreiche oder nicht erfolgreiche Anmeldung zu signalisieren.
Die Clientkennung muß leer sein, eine leere Kennung wird aus dem Zeichen „0“ (optional mit 19 folgenden Leerzeichen) aufgebaut.
Ist die Clientkennung leer, wird eine neue Session aufgebaut. Wird eine Clientkennung übergeben, wird versucht, eine vorher beendetet Session (siehe LOGOUT_REQ) wiederzuverwenden.
Im Datenteil der Nachricht folgen mehrere Werteblöcke, die die Anmeldeparameter enthalten. Dabei sind einige Parameter Pflicht, andere sind optional.
| Parameter | Pflicht | Beschreibung |
|---|---|---|
| USERNAME | J | Die Benutzerkennung zum Anmelden. |
| LOCALE | N | Die Sprachzone mit der der Client arbeitet, im Format Sprache_Land. Sprache im ISO-639 2-Zeichen Code, Land im ISO-3166 2-Zeichen Code. Zum Beispiel: de_DE en_US it_IT |
| BUSINESS_CLIENT | N | Die Mandantenkennung |
| CONFIGURATION | N | Optional kann die Konfiguration mit der der Client arbeiten will angegeben werden. Es ist der Dateiname einer gültigen DLE Konfiguration anzugeben. |
| SESSION_ID | N | Ist die SESSION_ID nicht angegeben, wird eine neue Session aufgebaut. Wird eine ID übergeben, wird versucht, eine vorher beendetet Session (siehe LOGOUT_REQ) wiederzuverwenden. |
| RESPONSE_KEY_LOGIN_ACK | N | Wird nur für die AS/400 DataQueue Kommunikation verwendet. Es kann ein 20 Bytes langer Schlüssel übergeben werden. Dieser wird dann vom Server für das Senden der LOGIN_ACK als Key verwendet. Damit wird sichergestellt, daß der LOGIN_ACK auch den richtigen Client erreicht. Alle weiteren Nachrichten werden mit der Session ID als Key vom Server an den Client gesendet. |