IBM MQpropriétés
Les propriétés IBM® MQ s'appliquent à l'ensemble de l'installation IBM MQ .
Les tableaux suivants répertorient les propriétés que vous pouvez définir pour IBM MQ:
- Général
- Etendu
- Exits
- Paramètres de journalisation par défaut
- ACPI
- Moniteur d'alertes
- Informations de configuration
Pour chaque propriété, une brève description indique dans quel cas vous pourriez avoir à la configurer. Les propriétés de la boîte de dialogue de propriétés IBM MQ se rapportent à des strophes des fichiers de configuration.
Page Général
Le tableau ci-dessous répertorie les propriétés que vous pouvez définir sur 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. | Nom |
Page Etendu
Le tableau ci-dessous répertorie les propriétés que vous pouvez définir sur la page Etendu des propriétés de la boîte de dialogue IBM MQ .
Propriété | Description | Indicatif de strophe |
---|---|---|
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 depuis un système qui utilise des pages de codes EBCDIC (par exemple, un système z/OS® ) vers un système qui utilise ASCII, vous pouvez contrôler la façon dont le caractère de retour à la ligne EBCDIC est converti 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 du gestionnaire de files d'attente. | CLWLMode |
Page Exits
Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Exits de la boîte de dialogue Propriétés de 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 API commun pour IBM MQ, cliquez sur Ajouter , puis dans la boîte de dialogue Propriétés , entrez les détails de l'exit. 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 API modèle pour IBM MQ, cliquez sur Ajouter , puis dans la boîte de dialogue Propriétés, entrez les détails de l'exit. 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 |
Nom | Nom descriptif de l'exit API, transmis à l'exit API dans la zone ExitInfoName de la structure MQAXP. Ce nom doit être unique et être limité à 48 caractères. Il ne doit contenir que les caractères admis pour le nom des objets IBM MQ , tels que les noms de file d'attente. | Nom |
Tapez | Indique le type de sortie : common outemplate . |
(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. | Séquence |
Module | Indique le module contenant le code de l'exit API. Ce champ est utilisé tel quel s'il contient le chemin d'accès complet au module. Si ce champ contient uniquement le nom du module, le module se trouve à l'aide de la même méthode que les exits de canal, c'est-à-dire en utilisant la valeur du champ Exit default path de la page Exits de la boîte de dialogue des 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. | Fonction |
Data | 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 ci-dessous 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 le chemin d'accès ici, la valeur par défaut est un sous-répertoire appelé connexion dans le DefaultPrefix, où DefaultPrefix est le répertoire spécifié dans la propriété Default prefix sur la page générale des propriétés pour 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 tapez256, la taille du fichier est 1MB. | LogFilePages |
Journaux principaux | Sous AIX® and Linux®, entrez le nombre, de 2 à 510, de fichiers journaux principaux. La valeur par défaut est 3. Le nombre total de fichiers journaux principaux et secondaires doit être compris entre 3 et 511. Sous Windows, entrez le nombre, compris entre 2 et 254, de fichiers journaux principaux. La valeur par défaut est 3. Le nombre total de fichiers journaux primaires et secondaires ne doit pas dépasser 255 et ne doit pas être inférieur à 3. |
LogPrimaryFiles |
Fichiers secondaires | Sous AIX and Linux, entrez le nombre, de 1 à 509, de fichiers journaux secondaires. La valeur par défaut est 3. Le nombre total de fichiers journaux principaux et secondaires doit être compris entre 3 et 511. Sous Windows, entrez le nombre, de 1 à 253, de fichiers journaux secondaires. La valeur par défaut est 3. Le nombre total de fichiers journaux primaires et secondaires ne doit pas dépasser 255 et ne doit pas être inférieur à 3. |
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. Vous ne devez utiliser SingleWriteque si le système de fichiers ou l'unité hébergeant le journal de reprise IBM MQ garantit explicitement l'atomicité des écritures 4KB . 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 de journal | Méthode que vous utilisez pour gérer vos journaux. LogManagement s'applique uniquement lorsque LogType est LINÉAIRE. Si vous modifiez la valeur LogManagement, la modification n'est pas prise en compte tant que le gestionnaire de files d'attente n'est pas 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 ci-dessous répertorie les propriétés que vous pouvez définir sur la page ACPI des propriétés de la boîte de dialogue IBM MQ . ACPI (Advanced Configuration and Power ® Interface) est une fonction du système d'exploitation qui permet à l'ordinateur de détecter certains états d'activité et par conséquent d'hiberner, c'est-à-dire de passer dans un mode de faible puissance sans programmes en cours d'exécution, et de manière à 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é Boîte de dialogue sur 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 que IBM MQ affiche un message demandant à l'utilisateur s'il doit suspendre les gestionnaires de files d'attente en cours d'exécution. Pour suspendre IBM MQ sans afficher ce message, cliquez sur Non. | DoDialog |
Refus de la suspension | Si la propriété Do dialog n'est pas définie, ou si elle est définie, mais que la boîte de dialogue ne peut pas être affichée (par exemple, si un ordinateur portable a son couvercle fermé), Deny suspend contrôle alors la réponse. La valeur par défaut est Non, ce qui signifie que IBM MQ est suspendu, même si la boîte de dialogue ne peut pas être affichée. Pour empêcher l'interruption de 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é Check channels running. | DenySuspend |
Vérification des canaux en cours de fonctionnement | La valeur par défaut est Non, ce qui signifie que IBM MQ ne vérifie pas s'il existe des canaux en cours d'exécution et répond comme indiqué par les propriétés Do dialog et Deny suspend. Pour vérifier si des canaux sont en cours d'exécution, cliquez sur Oui. S'il n'existe aucun canal en cours d'exécution, IBM MQ ignore les propriétés Do dialog et Deny suspend. S'il existe des canaux en cours d'exécution, IBM MQ répond comme indiqué par les propriétés Do dialog et Deny suspend. | CheckChannelsRunning |
![[Windows]](ngwin.gif)
Page Moniteur d'alertes
Le moniteur d'alertes est disponible uniquement sous Windows.
Le tableau ci-dessous répertorie les propriétés que vous pouvez définir sur la page Moniteur d'alertes de la boîte de dialogue Propriétés de 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 que IBM MQ n'envoie pas d'alertes à l'utilisateur en cas de problème. Pour configurer IBM MQ afin qu'il envoie des alertes en cas de problème, cliquez sur Oui. | Activer |
Utilisateur du moniteur d'alertes | Entrez le nom d'ordinateur ou le nom d'utilisateur auquel IBM MQ doit envoyer des 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 Moniteur d'alertes n'apparaît pas dans la barre des tâches de 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 Propriétés de 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 de IBM MQ sur cet 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 installée sur cet ordinateur. |
Niveau de version | Lecture seule. Il s'agit du numéro de version du produit IBM MQ installé sur cet ordinateur. |
Type de version | Lecture seule. Il s'agit du type de génération du produit IBM MQ installé sur cet ordinateur. |