Modification des informations IBM MQ de configuration dans les fichiers.ini sur plusieurs plateformes

Vous pouvez modifier le comportement de IBM® MQ ou d'un gestionnaire de file d'attente individuel afin de l'adapter aux besoins de votre installation en modifiant les informations contenues dans les fichiers de configuration (.ini). Vous pouvez également modifier les options de configuration pour IBM MQ MQI clients.

A propos de cette tâche

Vous pouvez modifier les informations IBM MQ de configuration au niveau du nœud ou du gestionnaire de file d'attente en modifiant les valeurs associées à un ensemble d'attributs (ou de paramètres) de configuration qui régissent IBM MQ.

Un fichier de configuration (ou fichier de strophes) contient une ou plusieurs strophes, qui sont des groupes de lignes dans le .ini fichier ayant une fonction commune ou définissant une partie d'un système, comme les fonctions de journalisation, les fonctions de canal et les services installables. Vous pouvez modifier les IBM MQ attributs de configuration dans les fichiers de configuration suivants :

IBM MQ fichier de configuration, mqs.ini: Ce mqs.ini fichier applique des modifications à l'ensemble du nœud.; Étant donné que le fichier IBM MQ de configuration sert à localiser les données associées aux gestionnaires de files d'attente, un fichier de configuration inexistant ou incorrect peut entraîner l'échec de certaines ou de toutes les commandes MQSC. De plus, les applications ne peuvent pas se connecter à un gestionnaire de file d'attente qui n'est pas défini dans le fichier IBM MQ de configuration.
Fichier de configuration de l'installation, mqinst.ini: Sur AIX® and Linux® les systèmes, le fichier de configuration d'installation, mqinst.ini, contient des informations sur toutes les IBM MQ installations. Ce mqinst.ini fichier ne doit pas être modifié ni utilisé directement, car son format n'est pas défini et est susceptible d'évoluer. Vous devez plutôt le modifier à l'aide de commandes.
Fichier de configuration du gestionnaire de file d'attente, qm.ini: Ce qm.ini fichier applique des modifications à certains gestionnaires de file d'attente. Il existe un qm.ini fichier pour chaque gestionnaire de file d'attente sur le nœud.
IBM MQ MQI client fichier de configuration, mqclient.ini: Les options de configuration pour IBM MQ MQI clients sont stockées séparément, dans le fichier de configuration du client, qui porte généralement le nom de mqclient.ini.
Fichier de configuration de la trace d'activité, mqat.ini: Ce mqat.ini fichier sert à configurer le comportement de la traçabilité des activités.

Vous devrez peut-être modifier un fichier de configuration si, par exemple :

Vous perdez un fichier de configuration. (Récupérez-le à partir de la sauvegarde si vous le pouvez.)
Vous devez déplacer un ou plusieurs gestionnaires de file d'attente vers un nouveau répertoire.
Vous devez modifier votre gestionnaire de file d'attente par défaut. Cela pourrait se produire si vous supprimiez accidentellement le gestionnaire de file d'attente existant.
Le IBM service d'assistance vous recommande de procéder ainsi.

Remarque importante : les modifications que vous apportez à un fichier de configuration ne prennent généralement effet qu'au prochain démarrage du gestionnaire de file d'attente.

Points à retenir concernant la modification des fichiers de configuration :

Les valeurs des attributs d'un fichier de configuration sont définies selon les priorités suivantes :
- Les paramètres saisis en ligne de commande ont priorité sur les valeurs définies dans les fichiers de configuration.
- Les valeurs définies dans les qm.ini fichiers ont priorité sur celles définies dans le mqs.ini fichier.
Une fois l'installation terminée, vous pouvez modifier les valeurs par défaut dans les fichiers IBM MQ de configuration.
Lorsque vous sauvegardez un gestionnaire de file d'attente, pensez à inclure à la fois son fichier de configuration (qm.ini) et le fichier de configuration IBM MQ central (mqs.ini).
Si vous attribuez une valeur incorrecte à un attribut d'un fichier de configuration, cela revient à ne pas définir cet attribut du tout. La valeur est ignorée et un message d'opérateur est émis pour signaler le problème.
Dans le système de IBM i fichiers IFS, les .ini fichiers sont des fichiers en flux.
Il existe plusieurs règles syntaxiques concernant le format du mqat.ini fichier. Pour plus d'informations, consultez la section « Suivi de l'activité des applications » : « Configuration du comportement du suivi de l'activité à l'aide de mqat.ini».

Procédure

Avant de modifier un fichier de configuration, sauvegardez-le afin de disposer d'une copie à laquelle vous pourrez revenir si nécessaire.

Remarque :
La sauvegarde ne doit pas être enregistrée <existing file>.ini.bak dans le même répertoire, car celui-ci est réservé à un usage interne.
Modifiez le fichier .ini de configuration de l'une des manières suivantes :
- Manuellement, à l'aide d'un éditeur de texte standard. Pour insérer des commentaires dans les fichiers de configuration, il suffit d'ajouter le #; caractère ou devant le texte du commentaire. Si vous souhaitez utiliser le #; caractère ou sans qu'il ne serve de commentaire, vous pouvez le faire précéder du \ caractère. Ce caractère est ensuite utilisé dans les données de configuration.
- Automatiquement, à l'aide de commandes qui modifient la configuration des gestionnaires de files d'attente sur le nœud. Pour plus d'informations, consultez la référence des commandes.
  Par exemple, la commande Windows spécifique amqmdain mettra automatiquement à jour un sous-ensemble des qm.ini propriétés. Pour plus d'informations, consultez amqmdain.
- Sur Linux ( x86 et x86-64 ) et Windows, vous pouvez mettre à jour un sous-ensemble des qm.ini propriétés à l'aide de IBM MQ Explorer. Pour plus d'informations, consultez la section « Configuration d' IBM MQ s à l'aide d' MQ Explorer ».
  Remarque : étant donné que la modification des services installables et de leurs composants a des implications importantes, ces services sont en lecture seule dans le fichier IBM MQ Explorer. Vous devez donc apporter toute modification aux services installables en modifiant le qm.ini fichier. Pour plus d'informations, consultez la section « Service » du fichier « qm.ini ».