Commande mqsichangeflowuserexits-systèmes Windows, Linuxet AIX

Certains paramètres ont d'autres noms ; par exemple, -e et --integration-server sont d'autres noms de paramètre du serveur d'intégration. Les noms longs et les noms abrégés disponibles sont répertoriés dans la section Paramètres.

integrationNodeName

Ce paramètre identifie le nom d'un noeud d'intégration spécifique. Pour vous connecter à un noeud d'intégration distant par son nom, vous devez également spécifier --admin-host et (facultativement) --admin-port.

-n integrationNodeFileName | --integration-node-file integrationNodeFileName

Ce paramètre identifie le nom d'un fichier .broker qui contient les détails de connexion d'un noeud d'intégration ou d'un serveur d'intégration indépendant. Incluez l'emplacement (chemin) et le nom de fichier lorsque vous spécifiez ce paramètre. Vous devez vous assurer que l'emplacement est accessible lorsque vous exécutez cette commande.

Le fichier peut être utilisé pour se connecter à un serveur d'intégration indépendant si:

• Les détails de la connexion n'incluent pas de nom de nœud (integrationNodeName )
• L'hôte et le port sont destinés à un serveur d'intégration indépendant.

Utilisez cette option si plusieurs utilisateurs souhaitent se connecter au même nœud d'intégration ou au même serveur d'intégration, ou si vous utilisez des paramètres de connexion avancés tels que SSL. Pour plus d'informations, voir Connexion à un nœud d'intégration par la création d'un fichier.broker.

Vous pouvez exécuter une commande utilisant SSL pour administrer un nœud d'intégration ou un serveur d'intégration distant via un canal sécurisé. Vous devez spécifier le mot de passe du magasin de clés et du magasin de clés de confiance pour la connexion qui utilise la variable d'environnement IBM_JAVA_OPTIONS. Pour plus d'informations, voir Résoudre les problèmes lors de l'exécution des commandes.

--admin-hostipAddress --admin-port port

Ces paramètres identifient un hôte et un port pour un noeud d'intégration ou un serveur d'intégration indépendant, pour les connexions qui ne nécessitent pas de paramètres de connexion avancés.

Pour vous connecter à un nœud d'intégration distant spécifique par son nom, vous pouvez ajouter le préfixe integrationNodeName. Vous ne pouvez pas utiliser-n integrationNodeFileName dans la même commande.

Pour un noeud d'intégration, tous les paramètres que vous omettez prennent les valeurs par défaut.

• --admin-hostadresse IP : Le nom d'hôte ou l'adresse IP de l'ordinateur sur lequel le nœud d'intégration ou le serveur est exécuté. Si vous ne spécifiez pas ce paramètre, une valeur représentant l'ordinateur local est utilisée.

  Pour vous connecter à un serveur d'intégration indépendant, la valeur est l'hôte que vous avez spécifié dans la propriété adminRestApiHost du fichier de configuration server.conf.yaml du serveur d'intégration.

  Si vous souhaitez vous connecter à un noeud d'intégration ou à un serveur sécurisé en tant qu'utilisateur spécifique, indiquez les données d'identification de sécurité en tant qu'URI au format suivant: tcp://user:password@hostname. Si votre mot de passe contient des caractères réservés à l'URI, vous devez convertir ces caractères au format codé en pourcentage. Pour plus d'informations, voir Une adresse URL et un mot de passe corrects renvoient l'erreur BIP1939 lorsque vous tentez de vous connecter à un nom d'hôte distant dans la section Résolution des problèmes lors de l'exécution des commandes.

• --admin-port port : Le port sur lequel l'interface utilisateur web HTTP connection listener est à l'écoute. Si vous n'indiquez pas ce paramètre, la valeur 4414 est utilisée.

  Pour vous connecter à un serveur d'intégration indépendant, la valeur est le port que vous avez défini pour la propriété adminRestApiPort dans le fichier de configuration server.conf.yaml . La valeur par défaut est 7600.

--https

(Facultatif) Spécifie que HTTPS sera utilisé pour la connexion au nœud d'intégration ou au serveur. Si ni --https ni --no-https ne sont spécifiés, la connexion est d'abord tentée avec HTTPS, puis sans HTTPS si la première tentative échoue.

--no-https

(Facultatif) Spécifie que HTTPS ne sera pas utilisé pour la connexion au nœud d'intégration ou au serveur. Si ni --https ni --no-https ne sont spécifiés, la connexion est d'abord tentée avec HTTPS, puis sans HTTPS si la première tentative échoue.

--cacert cacertFile

(Facultatif) Indique le chemin d'accès au fichier de certificat (au format PEM, P12 ou JKS) à utiliser pour vérifier le nœud d'intégration ou le serveur. Si aucun fichier cacert n'est spécifié et que l'option admin-ssl par défaut est activée, le fichier cacert est par défaut le fichier pem par défaut pour admin-ssl.

• Le paramètre --cacert n'est valable que si HTTPS est utilisé pour la connexion, il ne peut donc pas être défini en même temps que le paramètre --no-https . Vous pouvez définir --cacert cette option lorsque le --https paramètre a été défini ou lorsque ni le paramètre --https ni --no-https le paramètre n'ont été définis (auquel cas la valeur par défaut est « SSL »).
• Le paramètre --cacert ne peut être défini que si le paramètre --admin-host est spécifié sans URI ou si un URI commençant par ssl:// est spécifié.

--cacert-password cacertPassword

(Facultatif) Le mot de passe pour les fichiers cacert protégés par mot de passe.

• Le paramètre --cacert-password n'est valable que si HTTPS est utilisé pour la connexion et si le paramètre --cacert a été défini. Vous ne pouvez pas le régler en même temps que le paramètre --no-https .
• Le paramètre --cacert-password ne peut être défini que si le paramètre --admin-host est spécifié sans URI ou si un URI commençant par ssl:// est spécifié.

--insecure

(Facultatif) Spécifie que le certificat renvoyé par le nœud d'intégration ou le serveur ne sera pas vérifié.

• Le paramètre --insecure n'est valable que si HTTPS est utilisé pour la connexion, il ne peut donc pas être défini en même temps que le paramètre --no-https . Vous pouvez définir --insecure cette option lorsque le --https paramètre a été défini ou lorsque ni le paramètre --https ni --no-https le paramètre n'ont été définis (auquel cas la valeur par défaut est « SSL »).
• Le paramètre --insecure ne peut être défini que si le paramètre --admin-host est spécifié sans URI ou si un URI commençant par ssl:// est spécifié.

-a | --active-user-exit-list activeUserExitNames

(Facultatif) Liste des noms, séparés par deux points, des exits utilisateur actifs. Ces noms ont été enregistrés lors du chargement des exits utilisateur. Si l'un des exits utilisateur répertoriés n'est pas enregistré pour le noeud d'intégration cible ou le serveur d'intégration cible, la commande échoue avec une erreur BIP8858 . Ce paramètre ne peut être appliqué qu'à un noeud d'intégration ou à un serveur d'intégration. Vous pouvez effacer la liste des exits utilisateur actifs en fournissant une liste vide ("") comme valeur pour activeUserExitNames.

-e | --integration-server integrationServerName

(Requis pour un serveur d'intégration géré par un noeud d'intégration). Nom du serveur d'intégration.

-f | --flow MessageFlow

(Facultatif) Nom du flux de messages.

Lorsque vous définissez ce paramètre, vous devez également définir le paramètre -k (nom de l'application).

Si vous indiquez cette valeur, l'exit utilisateur est modifié pour ce flux de messages ; si ce n'est pas le cas, l'exit utilisateur est défini au niveau du serveur d'intégration.

-i | --inactive-user-exit-list inactiveUserExitNames

(Facultatif) Liste des noms, séparés par deux points, des exits utilisateur inactifs. Ces noms ont été enregistrés lors du chargement des exits utilisateur. Si l'un des exits utilisateur répertoriés n'est pas enregistré pour le noeud d'intégration cible ou le serveur d'intégration cible, la commande échoue avec une erreur BIP8858 . Ce paramètre ne peut être appliqué qu'à un noeud d'intégration ou à un serveur d'intégration. Vous pouvez effacer la liste des exits utilisateur inactifs en fournissant une liste vide ("") comme valeur pour inactiveUserExitNames.

-k | --application applicationName

(Facultatif) Ce paramètre indique le nom de l'application qui contient le flux de messages pour lequel l'exit utilisateur est modifié.

Lorsque vous définissez ce paramètre, vous devez également définir le paramètre -f (flux de messages). Pour modifier l'exit utilisateur d'un flux de messages nommé dans une application spécifique, définissez les paramètres -k et -f .

Vous pouvez utiliser ce paramètre avec le paramètre -y (nom de bibliothèque) pour indiquer que le flux de messages est contenu dans une bibliothèque référencée par l'application.

--non-persist

(Facultatif) Par défaut, les modifications sont conservées après le redémarrage du serveur. Ce paramètre garantit que les modifications ne seront pas conservées après un redémarrage du serveur. Il ne peut pas être utilisé pour les noeuds d'intégration et il ne peut pas être utilisé avec le paramètre --offline .

-o | --offline

(Facultatif) Ce paramètre permet à la commande de s'exécuter lorsque le noeud d'intégration est arrêté. Il ne peut pas être utilisé pour un serveur d'intégration indépendant ou un serveur d'intégration pris en charge par un noeud d'intégration.

-v | --trace traceFileName

(Facultatif) Envoie les informations de trace de débogage interne au fichier spécifié.

-x | --user-exit-path userExitPath

(Facultatif) Ce paramètre indique le nom de chemin complet du répertoire à partir duquel le noeud d'intégration recherche tous les exits utilisateur. Ce chemin est ajouté au chemin de recherche de la bibliothèque système (PATH, LIBPATH, LD_LIBRARY_PATH, SHLIBPATH) pour le processus de noeud d'intégration uniquement. Si vous utilisez ce paramètre, vous devez également spécifier le paramètre --offline . Ce paramètre ne peut pas être utilisé pour un serveur d'intégration pris en charge par un noeud d'intégration ou un serveur d'intégration indépendant.

Remarque: Vous devez définir le chemin d'exit utilisateur pour un serveur d'intégration indépendant en procédant comme suit:

1. Arrêtez le serveur d'intégration indépendant. Pour plus d'informations, voir Arrêter un serveur d'intégration.
2. Editez le fichier server.conf.yaml pour afficher le nom de chemin complet du répertoire à partir duquel le serveur d'intégration indépendant recherche tous les exits utilisateur:

   UserExits:
               userExitPath: 'C:\Program Files\IBM\ACE\11.0.0.x\server\sample\extensions\userexits\transport'

3. Démarrez le serveur d'intégration. Pour plus d'informations, voir Démarrer un serveur d'intégration.

-y | --library libraryName

(Facultatif) Ce paramètre indique le nom de la bibliothèque contenant le flux de messages pour lequel l'exit utilisateur est modifié.

Lorsque vous définissez ce paramètre, vous devez également définir les paramètres -k (nom de l'application) et -f (flux de messages). Pour définir les exits utilisateur actifs ou inactifs pour un flux de messages nommé dans une bibliothèque spécifique, définissez les paramètres -y, -ket -f .

mqsichangeflowuserexits INODE -x C:\UserExitDirectory --offline

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -a ""

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -a exit1:exit2

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -i exit3:exit4

mqsichangeflowuserexits INODE -e default -a exit1:exit3

mqsichangeflowuserexits INODE -e default -i exit2:exit4

mqsichangeflowuserexits INODE -e default -k myApplication -f myFlow -i exit1 -a exit2

mqsichangeflowuserexits --admin-host localhost --admin-port 7600 -k myApplication -f myFlow -a exit1:exit2

mqsichangeflowuserexits --admin-host localhost --admin-port 7600 -k myApplication -f myFlow -i exit3:exit4

mqsichangeflowuserexits --admin-host localhost --admin-port 7600 -a exit5:exit6 --trace C:\myTraceFile.txt --non-persist

Pour exécuter cet exemple, vous devez d'abord définir le chemin d'exit utilisateur pour le serveur d'intégration indépendant. Pour plus d'informations, voir les conseils dans la section Paramètres.