Préparation de l'environnement pour les nœuds d' IBM MQ, édition File Transfer

Préparez le système de fichiers et les gestionnaires de files d'attente et déterminez le nom de l'agent de noeud d'intégration.

A propos de cette tâche

Les informations relatives aux transferts de fichiers sont conservées dans des files d'attente de stockage gérées par IBM® MQ. Vous devez donc installer IBM MQ sur le même ordinateur que votre nœud d'intégration si vous souhaitez utiliser les fonctionnalités offertes par les nœuds FTEInput et FTEOutput. Pour plus d'informations sur l'installation et l'utilisation d' IBM MQ avec IBM App Connect Enterprise, consultez la section « Installation d' IBM MQ ».

Préparation du système de fichiers

IBM App Connect Enterprise utilise un emplacement dans son chemin de travail pour stocker les transferts vers les agents distants. Il utilise un autre emplacement comme répertoire par défaut pour les fichiers reçus. Le chemin de répertoire de haut niveau pour les deux emplacements est:
  • workpath/common/FTE
Assurez-vous qu'il y a suffisamment d'espace disponible ici pour les fichiers que vous transférerez vers et depuis le nœud d'intégration via IBM MQ File Transfer Edition.

Préparation du gestionnaire de files d'attente

Les files d'attente de stockage qui stockent les informations de transfert de fichiers appartiennent au gestionnaire de files d'attente spécifié sur le noeud d'intégration et vous spécifiez ce gestionnaire de files d'attente à l'aide de la propriété -q de la commande mqsicreatebroker ; voir Création d'un noeud d'intégration et Commande mqsicreatebroker.

Vous devez également créer les files d'attente système requises par les nœuds FTEInput et FTEOutput; voir Création des files d'attente système par défaut sur un gestionnaire de files d'attente d' IBM MQ. Un ensemble de commandes du script d' IBM MQ (MQSC) est également fourni pour vous permettre de créer les artefacts requis par l'agent et le gestionnaire de coordination; pour plus d'informations, consultez la section « Scripts permettant de créer les artefacts requis pour l' IBM MQ, édition File Transfer ».

Définition du gestionnaire de files d'attente de coordination

Lorsqu'un flux de messages contenant un nœud « IBM MQ File Transfer Edition » est déployé sur un serveur d'intégration, un agent est automatiquement créé et lancé sur ce serveur. Par défaut, l'agent utilise le gestionnaire de files d'attente spécifié sur le noeud d'intégration comme gestionnaire de files d'attente de coordination.
  • Si le gestionnaire de files d'attente spécifié sur le noeud d'intégration est utilisé en tant que gestionnaire de files d'attente de coordination, le noeud d'intégration le configure en tant que gestionnaire de files d'attente de coordination.
  • Si vous utilisez un gestionnaire de files d'attente différent comme gestionnaire de files d'attente de coordination, reportez-vous à la documentation du produitWebSphere® File Transfer Edition pour savoir comment le configurer en tant que gestionnaire de files d'attente de coordination.
Sauf si vous avez précédemment défini le gestionnaire de file d'attente de coordination, l'agent est temporaire ; il est supprimé lorsque le déploiement du flux est annulé ou que le noeud d'intégration est arrêté. Ce comportement est acceptable dans un environnement de test. Toutefois, pour la production, l'administrateur doit spécifier le gestionnaire de file d'attente de coordination pour le serveur d'intégration. La spécification d'un gestionnaire de files d'attente de coordination a les effets suivants:
  • S'assure que le gestionnaire de files d'attente approprié est utilisé lors de la création de l'agent.
  • Rend l'agent permanent. Si un gestionnaire de files d'attente de coordination a été défini, l'agent est supprimé uniquement après l'annulation de la définition du gestionnaire de files d'attente de coordination (par exemple, en le définissant sur une chaîne vide) et le redémarrage du serveur d'intégration.
Un avertissement est consigné dans le journal si la valeur par défaut du gestionnaire de file d'attente de coordination n'est pas modifiée.
Le diagramme d'état suivant montre comment la présence de noeuds et d'un gestionnaire de files d'attente de coordination défini affecte l'état de l'agent.
Diagramme de machine d'état montrant comment la présence de noeuds et d'un gestionnaire de files d'attente de coordination défini affecte l'état de l'agent. Ce diagramme récapitule les informations du paragraphe précédent.

A propos de cette tâche

Utilisez l'une des méthodes suivantes pour définir le gestionnaire de file d'attente de coordination.

Attribution de noms aux serveurs d'intégration

A propos de cette tâche

Le nom du serveur d'intégration sert à définir le nom des files d'attente dans la version « File Transfer Edition » d' IBM MQ. Par conséquent, les noms de vos serveurs d'intégration doivent respecter les règles de dénomination des objets d' IBM MQ. Vous ne pouvez pas déployer un flux contenant un nœud « IBM MQ File Transfer Edition » si cette condition n'est pas remplie. Les caractères autorisés sont les suivants:
  • Majuscules A-Z
  • Minuscules a-z (mais il existe des restrictions sur l'utilisation des lettres minuscules pour la prise en charge de la console z/OS® )

    Sur les systèmes utilisant EBCDIC Katakana, vous ne pouvez pas utiliser de caractères minuscules.

  • les chiffres 0 à 9
  • Point (.)
  • Barre oblique (/)
  • Trait de soulignement (_)
  • Symbole du pourcentage (%)
Consultez la documentation en ligne du produit « IBM MQ » pour obtenir tous les détails concernant les exigences en matière de nommage.

Détermination du nom de l'agent

A propos de cette tâche

Pour envoyer un fichier à un serveur d'intégration donné, les utilisateurs doivent connaître le nom de l'agent créé par le noeud d'intégration. Le nom de l'agent est dérivé de Nœud d'intégration. Serveur d'intégration, et n'est pas configurable. La longueur totale du nom est limitée à 28 caractères, avec un maximum de 12 caractères pour le nom du noeud d'intégration et de 15 caractères pour le serveur d'intégration. Les noms de noeud d'intégration et de serveur d'intégration dont la longueur est supérieure à ces limites sont tronqués pour former le nom de l'agent. Le nom doit être un format valide pour générer MQ Nom de la file d'attente de série. Veillez à ce que :
  • Le nom du noeud d'intégration est inférieur ou égal à 12 caractères (ou au moins unique dans les 12 premiers caractères).
  • Les noms de serveur d'intégration sont composés de 15 caractères ou moins (ou au moins uniques dans les 15 premiers caractères).
  • Le noeud d'intégration et les serveurs d'intégration ne contiennent pas de caractères non valides pour les noms de file d'attente.
  • Les tuples integrationnode.integrationserver sont tous uniques, même si la casse est ignorée.
La valeur utilisée est écrite dans le journal des événements dans le message BIP3358. Utilisez l'une des méthodes suivantes pour déterminer le nom de l'agent.

Procédure

Facultatif: Utilisez la commande mqsireportproperties .
Par exemple, pour afficher le nom de l'agent FTE pour le serveur d'intégration FTESAMPLE dans le noeud d'intégration INODE:
mqsireportproperties INODE -e FTESAMPLE -o FTEAgent -n agentName
Si l'agent a été créé, la commande renvoie le nom de l'agent. Si l'agent n'a pas été créé, la commande renvoie une chaîne vide.