Propriétés d'IBM MQ

Les propriétés dIBM® MQ s'appliquent à l'ensemble de l'installation d'IBM MQ.

Les tableaux suivants répertorient les propriétés que vous pouvez définir pour IBM MQ :

Pour chaque propriété, une brève description indique dans quel cas vous pourriez avoir à la configurer. Les propriétés qui figurent dans la boîte de dialogue de propriétés IBM MQ concernent des strophes des fichiers de configuration.

Page Général

Le tableau suivant répertorie les propriétés que vous pouvez définir dans la page Général des propriétés de la boîte de dialogue IBM MQ.

Propriété Description Indicatif de strophe
Préfixe par défaut Pour modifier l'emplacement du répertoire contenant toutes les données des gestionnaires de files d'attente, entrez le chemin complet du nouveau répertoire. DefaultPrefix
Nom du gestionnaire de files d'attente par défaut Pour spécifier un nom par défaut pour les nouveaux gestionnaires de files d'attente, saisissez-le dans cette zone. Name

Page Etendu

Le tableau suivant répertorie les propriétés que vous pouvez définir dans la page Etendu des propriétés de la boîte de dialogue IBM MQ.

Propriété Description Indicatif de strophe
[Version 9.2.0 Juillet 2020]Préfixe éphémère par défaut Pour modifier l'emplacement du répertoire dans lequel sont stockées toutes les données de gestionnaire de files d'attente éphémères, entrez le chemin d'accès complet au nouveau répertoire. DefaultEphemeralPrefix
Conversion de la nouvelle ligne EBCDIC Les pages de codes EBCDIC contiennent un caractère NL (nouvelle ligne) qui n'est pas pris en charge par les pages de codes ASCII (bien que certaines variantes ISO du format ASCII contiennent un équivalent). Si des messages sont envoyés à partir d'un système qui utilise les pages de codes EBCDIC (par exemple, un système z/OS) à un système qui utilise la page de codes ASCII, vous pouvez définir la conversion du caractère de nouvelle ligne EBCDIC au format ASCII. La valeur par défaut est NL_TO_LF, ce qui signifie que le caractère NL EBCDIC NL (X'15') est converti en caractère LF (avance ligne) ASCII (X'0A') pour toutes les conversions EBCDIC en ASCII. Pour convertir le caractère NL EBCDIC en fonction des tables de conversion de votre système d'exploitation, cliquez sur TABLE. Notez que les résultats d'une conversion TABLE peuvent varier d'une plateforme à une autre et d'un langage à un autre ; sur une même plateforme, les résultats peuvent également varier si vous utilisez différents CCSID (identificateurs d'ensembles de caractères codés). Pour convertir les CCSID ISO à l'aide de la méthode TABLE et utiliser la méthode NL_TO_LF pour tous les autres CCSID, cliquez sur ISO. ConvEBCDICNewline
Mode de charge de travail de cluster L'exit de pondération de charge du cluster, CLWL, vous permet d'indiquer quelle est la file du cluster qui devra être ouverte en réponse à un appel MQI (par exemple, MQOPEN ou MQPUT). La valeur par défaut est SAFE, ce qui signifie que l'exit CLWL est exécuté dans un processus distinct sur le gestionnaire de files d'attente de sorte qu'en cas d'incident, l'intégrité du gestionnaire de files d'attente est préservée. Toutefois, l'exécution de l'exit CLWL sous forme de processus distinct peut avoir des répercussions négatives sur les performances. Pour améliorer les performances en exécutant l'exit CLWL dans le même processus que le gestionnaire de files d'attente, cliquez sur FAST. Utilisez le mode FAST uniquement après vous être assuré que l'exit CLWL est correct car si un incident se produit en mode FAST, l'exécution du gestionnaire de files d'attente échoue et son intégrité est menacée. Cette valeur peut être remplacée pour chaque gestionnaire de files d'attente à l'aide de la propriété de mode de charge de travail de cluster. Pour plus d'informations, voir Propriétés de gestionnaire de files d'attente. CLWLMode

Page Exits

Le tableau suivant répertorie les propriétés que vous pouvez définir dans la page Exits des propriétés de la boîte de dialogue IBM MQ. Pour configurer les exits communs à tous les gestionnaires de files d'attente de l'ordinateur, éditez les propriétés figurant dans la page Exits.

Propriété Description Indicatif de strophe
Chemin par défaut des exits Pour modifier l'emplacement des exits de canal pour les clients et des exits de canal et de conversion de données pour les serveurs, entrez le chemin du nouveau répertoire. ExitsDefaultPath
Exits API communs Pour configurer un nouvel exit d'API commun pour IBM MQ, cliquez sur Ajouter, puis tapez les informations de l'exit dans la boîte de dialogue Propriétés. Pour éditer un exit API commun affiché dans le tableau, cliquez sur Editer ; pour supprimer un exit API du tableau, cliquez sur Supprimer. ApiExitCommon
Exits API de modèle Pour configurer un nouvel exit d'API commun pour IBM MQ, cliquez sur Ajouter, puis tapez les informations de l'exit dans la boîte de dialogue Propriétés. Pour éditer un exit API de modèle affiché dans le tableau, cliquez sur Editer ; pour supprimer un exit API du tableau, cliquez sur Supprimer. ApiExitTemplate
Name Nom descriptif de l'exit API, transmis à l'exit API dans la zone ExitInfoName de la structure MQAXP. Ce nom doit être unique et contenir un maximum de 48 caractères, et uniquement ceux qui sont admis pour les noms d'objet IBM MQ, comme les noms de file d'attente. Name
Type Indique le type d'exit : Communs ou Modèle. (Il ne s'agit pas d'un indicatif de strophe séparé.)
Séquence Cette propriété est une valeur numérique non signée définissant l'ordre dans lequel cet exit API est appelé, par rapport aux autres exits API. Les exits API sont appelés par ordre croissant de numéro de séquence. L'ordre d'appel des exits API ayant le même numéro de séquence n'est pas défini. La succession de numéros de séquence des exits API d'un gestionnaire de files d'attente peut être non linéaire. Sequence
Module Indique le module contenant le code de l'exit API. Cette zone est utilisée telle quelle si elle contient le chemin d'accès complet au module. S'il ne contient que son nom, le module est localisé de la même façon que pour les exits de canal, c'est-à-dire, à l'aide de la valeur de la zone Chemin par défaut de l'exit de la page Exits, dans la boîte de dialogue de propriétés du gestionnaire de files d'attente. Module
Fonction Indique le nom du point d'entrée de la fonction dans le module contenant le code de l'exit API. Ce point d'entrée est la fonction MQ_INIT_EXIT. La longueur de cette zone est limitée à MQ_EXIT_NAME_LENGTH. Function
Données Si cette propriété est indiquée, les blancs de début et de fin sont supprimés, la chaîne restante est tronquée à 32 caractères et le résultat est transmis à l'exit dans la zone ExitData de la structure MQAXP. Si cette propriété n'est pas indiquée, la valeur par défaut de 32 blancs est transmise à l'exit dans la zone ExitData de la structure MQAXP. Data

Paramètres de journalisation par défaut

Le tableau suivant répertorie les propriétés que vous pouvez définir dans la page Paramètres de journal par défaut des propriétés de la boîte de dialogue IBM MQ. Pour modifier les paramètres de consignation par défaut, éditez les propriétés figurant dans la page Paramètres de journalisation par défaut. Ces paramètres s'appliquent à tous les nouveaux gestionnaires de files d'attente par défaut.

Propriété Description Indicatif de strophe
Type de journal Pour que la reprise du gestionnaire de files d'attente puisse être effectuée lors de son redémarrage, cliquez sur Circulaire. Si le gestionnaire de files d'attente utilise la consignation circulaire, lorsque le fichier journal est saturé, la consignation reprend au début du fichier, en remplaçant les données antérieures. Pour que la reprise du gestionnaire de files d'attente puisse être effectuée lors de son redémarrage et permettre les reprises liées au support et les reprises par mise à jour en aval, cliquez sur Linéaire. Si le gestionnaire de files d'attente utilise la consignation linéaire, lorsque le fichier journal est saturé, un nouveau fichier est démarré. LogType
Chemin du journal Pour modifier l'emplacement par défaut des journaux, entrez le chemin complet. Si vous ne spécifiez pas de chemin d'accès ici, le sous-répertoire Log indiqué par l'attribut DefaultPrefix est utilisé par défaut, où DefaultPrefix est le répertoire spécifié dans la propriété Préfixe par défaut de la page Général des propriétés de la boîte de dialogue IBM MQ. LogPath
Pages du fichier journal Entrez le nombre de pages, de 32 à 4095, de 4 ko contenues dans le fichier journal. Par exemple, si vous entrez 256, la taille du fichier est de 1 Mo. LogFilePages
Journaux principaux

Sous Windows, entrez le nombre, de 2 à 254, de journaux principaux. La valeur par défaut est 3. Le nombre total de journaux primaires et secondaires doit être compris entre 3 et 255.

Sous UNIX et Linux®, entrez le nombre, de 2 à 510, de journaux principaux. La valeur par défaut est 3. Le nombre total de journaux primaires et secondaires doit être compris entre 3 et 511.

LogPrimaryFiles
Fichiers secondaires

Sous Windows, entrez le nombre, de 1 à 253, de journaux secondaires. La valeur par défaut est 3. Le nombre total de journaux primaires et secondaires doit être compris entre 3 et 255.

Sous UNIX et Linux, entrez le nombre, de 1 à 509, de journaux secondaires. La valeur par défaut est 3. Le nombre total de journaux primaires et secondaires doit être compris entre 3 et 511.

LogSecondaryFiles
Pages du tampon de journalisation Entrez le nombre de pages, de 0 à 512, du journal tampon (4 ko). Si vous indiquez 0, le gestionnaire de files d'attente sélectionne le nombre.

Si vous indiquez un nombre compris entre 1 et 17, un minimum de 18 pages est utilisé. Si vous indiquez un nombre compris entre 18 et 512, ce nombre est utilisé. Si vous modifiez la valeur de cette propriété, redémarrez le gestionnaire de files d'attente afin qu'il détecte la modification.

LogBufferPages
Intégrité en écriture du journal Il s'agit de la méthode que le journal d'événements utilise pour créer des enregistrements de journaux fiables.

La valeur par défaut est TripleWrite. Sachez que vous pouvez sélectionner DoubleWrite mais ceci est interprété par le système comme étant TripleWrite.

Utilisez SingleWrite uniquement si le système de fichiers ou l'unité qui héberge le journal de reprise d'IBM MQ garantit explicitement l'atomicité des écritures 4 ko.

En cas d'échec de l'écriture d'une page de 4 ko, quelle qu'en soit la raison, les deux seuls états possibles sont l'image d'avant et l'image d'après. Aucun état intermédiaire n'est possible.

LogWriteIntegrity
Gestion des journaux Méthode que vous utilisez pour gérer vos journaux. Le paramètre LogManagement est valable uniquement lorsque le paramètre LogType a pour valeur LINEAR.

Si vous changez la valeur du paramètre LogManagement, la modification n'est appliquée qu'une fois le gestionnaire de files d'attente redémarré.

Trois options sont proposées :

Manuel : vous gérez les domaines réservés aux journaux manuellement. Si vous spécifiez cette option, le gestionnaire de files d'attente ne réutilise pas et ne supprime pas les domaines réservés aux journaux, même s'ils ne sont plus nécessaires pour la reprise.

Automatique : les domaines réservés aux journaux sont gérés automatiquement par le gestionnaire de files d'attente. Si vous spécifiez cette option, le gestionnaire de files d'attente peut réutiliser ou supprimer les domaines réservés aux journaux dès qu'ils ne sont plus nécessaires pour la reprise. L'archivage n'est pas proposé.

Archive : les domaines réservés aux journaux sont gérés par le gestionnaire de files d'attente, mais vous devez notifier le gestionnaire de files d'attente une fois que l'archivage de chaque domaine réservé aux journaux est terminé.

Si vous spécifiez cette option, le gestionnaire de files d'attente est libre de réutiliser ou de supprimer un domaine réservé aux journaux, dès qu'il a été averti qu'un domaine qui n'est plus nécessaire pour la reprise a été archivé.

La valeur par défaut est Manuel.

LogManagement

Page ACPI

Le tableau suivant répertorie les propriétés que vous pouvez définir dans la page ACPI des propriétés de la boîte de dialogue IBM MQ. ACPI (Advanced Configuration and PowerInterface) est une fonction du système d'exploitation qui permet à l'ordinateur de détecter certains états de l'activité et donc d'hiberner, à savoir passer en mode veille sans aucun programme en cours d'exécution, et ainsi de permettre un "réveil rapide".

Lorsque la fonction ACPI veut faire passer l'ordinateur en mode hibernation, elle envoie d'abord une demande d'interruption à toutes les applications. Pour contrôler la manière dont IBM MQ répond à cette demande, définissez la propriété Utilisation des boîtes de dialogue dans la page ACPI.

Propriété Description Indicatif de strophe
Utilisation des boîtes de dialogue La valeur par défaut est Oui, ce qui signifie qu'IBM MQ affiche un message demandant à l'utilisateur de confirmer la suspension des gestionnaires de files d'attente en cours d'exécution. Pour suspendre IBM MQ sans afficher le message, cliquez sur Non. DoDialog
Refus de la suspension Si la propriété Utilisation des boîtes de dialogue n'est pas définie ou qu'elle l'est, mais que la boîte de dialogue ne peut pas s'afficher (par exemple si le capot d'un ordinateur portable est fermé), la propriété Refus de la suspension contrôle la réponse. La valeur par défaut est Non, ce qui implique qu'IBM MQ est suspendu, même si la boîte de dialogue ne peut pas être affichée. Pour empêcher la suspension d'IBM MQ lorsque la boîte de dialogue ne peut pas être affichée, cliquez sur Oui. Cette propriété peut être remplacée par la propriété Vérification des canaux en cours de fonctionnement. DenySuspend
Vérification des canaux en cours de fonctionnement La valeur par défaut est Non, ce qui implique qu'IBM MQ ne vérifie pas que des canaux sont actifs et répond conformément aux propriétés Utilisation des boîtes de dialogue et Refus de la suspension. Pour vérifier si des canaux sont en cours d'exécution, cliquez sur Oui. Si aucun canal n'est actif, IBM MQ ignore les propriétés Utilisation des boîtes de dialogue et Refus de la suspension. Si des canaux sont actifs, IBM MQ répond conformément aux propriétés Utilisation des boîtes de dialogue et Refus de la suspension. CheckChannelsRunning
[Windows]

Page Moniteur d'alertes

Le moniteur d'alertes est disponible uniquement sous Windows.

Le tableau suivant répertorie les propriétés que vous pouvez définir dans la page Moniteur d'alertes des propriétés de la boîte de dialogue IBM MQ. Le moniteur d'alertes s'avère utile pour l'identification des incidents. Ces alertes sont générées par les services lorsqu'un incident survient : par exemple si un initiateur de canal ne peut être lancé en raison de la suppression d'une file d'attente requise. Pour configurer le moniteur d'alertes, éditez les propriétés figurant dans la page Moniteur d'alertes.

Propriété Description Indicatif de strophe
Notification de l'utilisateur par le moniteur d'alertes La valeur par défaut est Non, ce qui signifie qu'IBM MQ n'envoie pas d'alertes à l'utilisateur en cas de problème. Pour configurer IBM MQ pour qu'il envoie des alertes, cliquez sur Oui. Enable
Utilisateur du moniteur d'alertes Entrez le nom de l'ordinateur ou de l'utilisateur auquel IBM MQ doit envoyer les alertes. Recipient
Ajout de l'icône du moniteur d'alertes à la barre de tâches La valeur par défaut est Non, ce qui signifie que l'icône du moniteur d'alertes ne s'affiche pas dans la barre de tâches du système Windows. Pour afficher l'icône Moniteur d'alertes dans la barre d'état système de Windows, cliquez sur Oui. TaskBar

Page Informations de configuration

Le tableau ci-dessous répertorie les propriétés qui s'affichent dans la page Informations de configuration de la boîte de dialogue IBM MQ. Les propriétés de la page Informations de configuration sont accessibles en lecture seule.

Propriété Description
Type d'installation Lecture seule. Cette propriété indique si vous avez installé la version Serveur ou Client d'IBM MQ sur l'ordinateur.
mqjbnd05 chargé Lecture seule. Il s'agit de la bibliothèque requise pour la connexion aux gestionnaires de files d'attente locaux.
Version MQ Lecture seule. Il s'agit de la version d'IBM MQ qui est installée sur l'ordinateur.
Niveau de version Lecture seule. Il s'agit du numéro de compilation du produit IBM MQ installé sur l'ordinateur.
Type de version Lecture seule. Il s'agit du type de compilation du produit IBM MQ installé sur l'ordinateur.