Knowledge Base > Automation Engine und Zielsysteme > WebSphere MQ > AE Connector für WebSphere MQ Queue Manager

Automation Engine Connector für WebSphere MQ Queue Manager

Der AE-Connector ist das Bindeglied zwischen WebSphere MQ Queue Manager und der Automation Engine.

Der AE-Connector liest die Anforderung, eine Nachricht im XML-Format, aus der Anforderungswarteschlange (SIQ) aus und gibt sie zur Ausführung an die Automation Engine weiter. Dabei wird ein internes Format verwendet. Der AE-Connector wartet darauf, dass die Automation Engine die Ausführung bestätigt und das Ende der Ausführung meldet. Auch hierbei wird ein internes Format verwendet. Die Antwort wird vom AE-Connector der Anforderung zugeordnet und im XML-Format in die Antwortwarteschlange (CIQ) geschrieben.

XML-Nachricht der Anforderung

XML-Element	Beschreibung
<apiscriptexec>	Beginn der API-Anforderung. XML-Element muss vorhanden sein.
<uc-env request="ID" release="1">	Die angegebene ID kennzeichnet die Anforderung. Das Attribut "request=" muss angegeben werden. Der AE-Connector bezieht sich in seinen Meldungen auf diese ID. In der Antwortnachricht wird diese ID ebenfalls eingetragen. Das Attribut "release=" ist nicht erforderlich. Wird es jedoch eingetragen, so ist derzeit nur "1" zugelassen. Das Attribut dient in Zukunft der Angabe der Version. XML-Element muss vorhanden sein.
<requestname name="any name">	Name der Anforderung. Das Attribut "name=" ist nicht erforderlich. XML-Element muss vorhanden sein.
<control>	XML-Element muss vorhanden sein.
<timeout unit="sec">10</timeout>	Begrenzung der Laufzeit einer Anforderung. Die Laufzeit startet vor der Verbindungsaufnahme mit der AE und endet, wenn die Automation Engine die Durchführung angenommen hat, oder ein nicht behebbare Fehler auftritt. Das Attribut "unit=" gibt die Einheit für die Laufzeit an. Erlaubte Werte: "1" - "31999" Standardwert: "10" XML-Element kann entfallen.
<control unit="sec">20</control>	Wird in der aktuellen Version noch nicht unterstützt. XML-Element kann entfallen.
</control>	Abschluss für Element <control> XML-Element kann entfallen.
<login>	Beginn des Elements für die Login-Informationen. XML-Element muss vorhanden sein.
<system>Automation Enginename</system>	Name der Automation Engine. Der Name wird zur Prüfung der Verbindung zur Automation Engine verwendet. Der Inhalt entspricht dem Parameter name= in der INI-Datei der Automation Engine, zu dem AE-Connector Verbindung aufgenommen hat. XML-Element muss vorhanden sein.
<client>client number</client>	Mandantennummer für die Anmeldung an die Automation Engine. XML-Element muss vorhanden sein.
<name>user name</name>	Name des Benutzers für die Anmeldung an die Automation Engine. XML-Element muss vorhanden sein.
<department>Benutzerabteilung</department>	Abteilung des Benutzers für die Anmeldung an die Automation Engine. XML-Element muss vorhanden sein.
<passw>password</passw>	Passwort des Benutzers für die Anmeldung an die Automation Engine. XML-Element kann entfallen.
<language>E/D/F</language>	Auswahl der Sprache, in der Meldungen ausgegeben werden sollen. Wird die Sprache nicht angegeben, werden die Meldungen so ausgegeben, wie in der INI-Datei des AE-Connectors eingestellt. XML-Element kann entfallen.
<clienttype>C</clienttype>	Typ des Mandanten. Wenn der Typ angegeben wird, so ist derzeit nur "C" zugelassen. XML-Element kann entfallen.
<clientvers>client version</clientvers	Version des AE-Connectors. Erlaubte Werte: Aktuelle Version XML-Element kann entfallen.
</login>	Abschluss für XML-Element <login>. XML-Element muss vorhanden sein.
<script><![CDATA[Script content]]></script>	Script-Anweisungen, die in der AE ausgeführt werden sollen. XML-Element muss vorhanden sein.
</request>	Abschluss für XML-Element <request>. XML-Element muss vorhanden sein.
</uc-env>	Abschluss für XML-Element <uc-env>. XML-Element muss vorhanden sein.
</apiscriptexec>	Abschluss für XML-Element <apiscriptexec>. XML-Element muss vorhanden sein.

Beispiel für Anforderung

<apiscriptexec>
    <uc-env request="ID1" release="1">
        <request name="apiscriptexec">
            <control>
                <timeout unit="sec">10</timeout>
            </control>
            <login>
                <system>UC4</system>
                <client>97</client>
                <name>NAME01</name>
                <department>DEPARTMENT01</department>
                <passw></passw>
                <language>D</language>
                <clienttype>C</clienttype>
                <clientvers>11.0.0</clientvers>
            </login>
            <script><![CDATA[:SET &RUNNR = ACTIVATE_UC_OBJECT(JOBS,EXAMPLE1)]]></script>
        </request>
    </uc-env>
</apiscriptexec>

XML-Antwortnachricht

XML-Element	Beschreibung
<apiscriptexec>	Äußerer Rahmen der Nachricht. XML-Element ist immer vorhanden.
<uc-env request="ID" release="1">	Die angegebene ID wird der zugehörigen Anforderung entnommen. Das Attribut "request=" wird immer ausgegeben. XML-Element ist immer vorhanden.
<result name="Reply">	XML-Element ist immer vorhanden.
<status>reason</status>	Ursache für diese Antwort zur Anforderung. Derzeit ist die Ursache immer "completed". XML-Element ist immer vorhanden.
<complcode>code</complcode>	Ergebnis-Code, den der AE-Connector für die durchgeführte Anforderung liefert. Die möglichen Codes sind im Meldungshandbuch beschrieben. XML-Element ist immer vorhanden.
<compltext>![CDATA[completion text]]</compltext>	Beschreibender Text zum Ergebnis-Code. XML-Element ist immer vorhanden.
<returnvalue>value</returnvalue>	Rückgabewert von Komponenten, die bei der Durchführung beteiligt waren (Automation Engine, XML-Parser etc.). XML-Element ist immer vorhanden.
<returntext>![CDATA[return text]]</returntext>	Beschreibung zum Rückgabewert. XML-Element ist immer vorhanden.
</result>	Abschluss für XML-Element <result>. XML-Element ist immer vorhanden.
</uc-env>	Abschluss für XML-Element <uc-env>. XML-Element ist immer vorhanden.
</apiscriptexec>	Abschluss für XML-Element <apiscriptexec>. XML-Element ist immer vorhanden.

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support