Base de connaissances > Automation Engine et systèmes cibles > WebSphere MQ > AE Connect pour WebSphere MQ Queue Manager

Automation Engine Connecteur pour le Manager WebSphere MQ Queue

Le connecteur AE représente le lien entre le Manager WebSphere MQ Queue et Automation Engine.

Le connecteur AE lit une demande, un message au format XML, depuis la file d'attente de demandes (SIQ) et le transmet au Automation Engine pour traitement. Un format interne est utilisé pour cela. Le dispositif de connexion AE attend que le Automation Engine vérifie le traitement et le notifie de la fin du processus. Un format interne est utilisé pour cela. La réponse est assignée à la demande du connecteur AE et écrite au format XML dans la file d'attente des réponses (CIQ).

Message XML de la demande

Elément XML	Description
<apiscriptexec>	Début de la demande API. Cet élément XML doit exister.
<uc-env request="ID" release="1">	L'ID spécifié caractérise la demande. L'attribut "request=" doit être renseigné. Le dispositif de connexion AE fait référence à cet ID dans ses messages. Le message réponse comprend également l'ID. L'attribut "release=" n'est pas obligatoire. S'il est entré, seul "1" est autorisé à l'heure actuelle. L'attribut sert à l'avenir à spécifier la version. Cet élément XML doit exister.
<requestname name="any name">	Nom de la demande. L'attribut "name=" n'est pas obligatoire. Cet élément XML doit exister.
<control>	Cet élément XML doit exister.
<timeout unit="sec">10</timeout>	Limitation de l'exécution d'une demande. Le temps d'exécution commence avant l'établissement de la connexion avec le Automation Engine, et se termine quand l'AE accepte l'exécution ou si une erreur irrécupérable se produit. L'attribut "unit=" indique l'unité de l'exécution. Valeurs autorisées : "1" – "31999" Défaut : "10" Cet élément XML est facultatif.
<control unit="sec">20</control>	N'est pas encore pris en charge dans la nouvelle version. Cet élément XML est facultatif.
</control>	Fin de l'élément <control> Cet élément XML est facultatif.
<login>	Début de l'élément pour les informations Login. Cet élément XML doit exister.
<system>Automation Engine nom</system>	Nom du Automation Engine. Le nom est utilisé pour vérifier la connexion au Automation Engine. Le contenu correspond au paramètre name= dans le fichier INI du Automation Engine auquel le dispositif de connexion AE s'est connecté. Cet élément XML doit exister.
<client>client number</client>	Nombre de Clients pour la connexion au Automation Engine. Cet élément XML doit exister.
<name>user name</name>	Nom de l'utilisateur pour la connexion au Automation Engine. Cet élément XML doit exister.
<department>département de l'utilisateur</department>	Désignation du département de l'utilisateur pour la connexion à Automation Engine. Cet élément XML doit exister.
<passw>password</passw>	Mot de passe de l'utilisateur pour la connexion à Automation Engine. Cet élément XML est facultatif.
<language>E/D/F</language>	Sélection de la langue dans laquelle les messages doivent être générés. Si aucune langue n'est indiquée, les messages sont écrits conformément aux paramètres précisés dans le fichier INI du dispositif de connexion AE. Cet élément XML est facultatif.
<clienttype>C</clienttype>	Type de Client. Si le type est spécifié, seul "C" est autorisé à l'heure actuelle. Cet élément XML est facultatif.
<clientvers>client version</clientvers	Version du dispositif de connexion AE. Valeurs autorisées : Version actuelle Cet élément XML est facultatif.
</login>	Fin de l'élément XML <login>. Cet élément XML doit exister.
<script><![CDATA[Script content]]></script>	Instructions de script à exécuter dans AE. Cet élément XML doit exister.
</request>	Fin de l'élément XML <request>. Cet élément XML doit exister.
</uc-env>	Fin de l'élément XML <uc-env>. Cet élément XML doit exister.
</apiscriptexec>	Fin de l'élément XML <apiscriptexec>. Cet élément XML doit exister.

Exemple d'une demande

<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>

Message XML de la réponse

Elément XML	Description
<apiscriptexec>	Cadre extérieur du message. Cet élément XML existe toujours.
<uc-env request="ID" release="1">	L'ID indiqué est supprimé de la demande associée. L'attribut "request=" est toujours affiché. Cet élément XML existe toujours.
<result name="Reply">	Cet élément XML existe toujours.
<status>reason</status>	Raison de cette réponse à la demande. A l'heure actuelle, la raison est toujours "completed". Cet élément XML existe toujours.
<complcode>code</complcode>	Code complet fourni par le dispositif de connexion AE pour la demande exécutée. Les codes possibles sont décrits dans le manuel des messages. Cet élément XML existe toujours.
<compltext>![CDATA[completion text]]</compltext>	Texte descriptif du code de terminaison. Cet élément XML existe toujours.
<returnvalue>value</returnvalue>	Code retour pour les composants qui étaient présents pendant le traitement (Automation Engine, parseur XML, etc.). Cet élément XML existe toujours.
<returntext>![CDATA[return text]]</returntext>	Description accompagnant le code retour. Cet élément XML existe toujours.
</result>	Fin de l'élément XML <result>. Cet élément XML existe toujours.
</uc-env>	Fin de l'élément XML <uc-env>. Cet élément XML existe toujours.
</apiscriptexec>	Fin de l'élément XML <apiscriptexec>. Cet élément XML existe toujours.