Der DataQueue Adapter erlaubt die Kommunikation mit dem Server über eine AS/400 (iSeries) DataQueue. Dazu verwendet der Adapter das DLE Simple Message Protocol (DSMP), das entsprechende Clients implementieren müssen. Derzeit existiert seitens Vision-Flow nur eine Java API. Bei der Kommunikation eines Java Clients zu dem DLE Server wird aus Performancegründen eine Socket Kommunikation empfohlen. Die API wird deshalb hier nicht beschrieben, sie ist (bis auf die Exceptions) zudem analog zur Java API implementiert.
Um einen DataQueue Adapter zu konfigurieren, ist in der Serverkonfiguration ein entsprechender <Adapter> Block zu definieren. Dabei kann ein beliebiger, eindeutiger Adaptername vergeben werden. Als Implementierungsklasse ist beim Attribut class als Klassenname at.visionflow.dle.server.DLEDataQueueAdapter anzugeben.
Der Adapter verwendet für die As/400 (iSeries) Konnektivität die AS/400 Java Toolbox von IBM. Diese ist seit kurzer Zeit als ein Open Source Projekt von IBM ausgegliedert worden. Neueste Versionen können über das Web via jt400.sourceforge.net heruntergeladen werden.
Der Adapter muß durch folgende Parameter konfiguriert werden:
| Name | Beschreibung |
|---|---|
| hostName | Der Hostname des AS/400 oder iSeries Servers, der die DataQueues verwaltet. |
| user | Der Benutzername, der zum Verbindungsaufbau verwendet wird. Bei dem Wert *CURRENT wird der aktuelle verwendet. |
| password | Das Kennwort, das zum Verbindungsaufbau verwendet wird. Bei dem Wert *CURRENT wird das aktuelle verwendet. |
| library | Die AS/400 Library, in der die DataQueues liegen. |
| inQueue | Der Name der DataQueue, auf der Nachrichten zum Adapter gesandt werden. Existiert diese Queue noch nicht, wird diese durch den Adapter automatisch neu erstellt. |
| outQueue | Der Name der DataQueue, in die der Adapter Nachrichten (Antworten) an den Client sendet. Existiert diese Queue noch nicht, wird diese durch den Adapter automatisch neu erstellt. |
| maxEntryLength | Maximale Nachrichtengröße der DataQueue in Bytes. Nachrichten die größer sind als die maximale Größe, werden in mehreren Teilen übertragen. |
| deleteQueueOnExit | Ist dieser Parameter auf True gesetzt, werden die DataQueues beim Stop eines Adapters automatisch gelöscht. Sonst bleiben sie erhalten. |
| readTimeout | Timeout in Sekunden. Erfolgt innerhalb dieser Zeit kein Login eines Nutzers über die API, verbindet sich der Adapter mit der AS 400 neu. Default ist -1, was keinen Timeout bedeutet. |