Section LogDefaults du fichier mqs.ini

Utilisez la section LogDefaults du fichier mqs.ini pour spécifier des informations sur les valeurs par défaut de journal pour tous les gestionnaires de files d'attente.

Sinon, sur Linux® ( x86 et x86-64 ) et Windows, utilisez la page de propriétés IBM® MQ Explorer Default log settings IBM MQ .

Si vous avez besoin d'une valeur autre que la valeur par défaut, vous devez spécifier explicitement cette valeur dans la section LogDefaults .

Si la section LogDefaults n'existe pas, les valeurs par défaut IBM MQ sont utilisées. Les attributs de journal sont utilisés comme valeurs par défaut lorsque vous créez un gestionnaire de files d'attente, mais ils peuvent être remplacés si vous spécifiez les attributs de journal dans la commande crtmqm . Pour plus d'informations sur cette commande, voir crtmqm.

Une fois qu'un gestionnaire de file d'attente a été créé, les attributs du journal pour ce gestionnaire de file d'attente proviennent des paramètres décrits dans la strophe Log du fichier qm.ini.

Le préfixe par défaut, spécifié dans la stropheAllQueueManagers du fichier mqs.ini, et le chemin d'accès au journal spécifié pour le gestionnaire de file d'attente particulier, spécifié dans la strophe Log du fichier qm.ini, permettent au gestionnaire de file d'attente et à son journal de se trouver sur des lecteurs physiques différents. Il s'agit de la méthode recommandée, bien que par défaut ils se trouvent sur la même unité.

Pour plus d'informations sur le calcul de la taille des journaux, voir Calculer la taille du journal.

LogPrimaryFiles = 3 (par défaut) |2-254Windows)|2-510AIX® and Linux

Fichiers journaux alloués lors de la création du gestionnaire de files d'attente.

Le nombre minimal de fichiers journaux principaux que vous pouvez avoir est 2 et le nombre maximal est 254 sous Windowsou 510 sous AIX and Linux. La valeur par défaut est 3.

Le nombre total de fichiers journaux primaires et secondaires ne doit pas dépasser 255 sous Windowsou 511 sous AIX and Linuxet ne doit pas être inférieur à 3.

La valeur est examinée lorsque le gestionnaire de files d'attente est créé ou démarré. Vous pouvez le modifier après la création du gestionnaire de files d'attente. Toutefois, une modification de la valeur n'est pas effective tant que le gestionnaire de files d'attente n'est pas redémarré et que l'effet n'est pas immédiat.

LogSecondaryFiles = 2 (par défaut) |1-253Windows)|1-509AIX and Linux

Fichiers journaux alloués lorsque les fichiers principaux sont épuisés.

Le nombre minimal de fichiers journaux secondaires est 1 et le nombre maximal est 253 sous Windowsou 509 sous AIX and Linux. Le nombre par défaut est 2.

Le nombre total de fichiers journaux primaires et secondaires ne doit pas dépasser 255 sous Windowsou 511 sous AIX and Linuxet ne doit pas être inférieur à 3.

La valeur est examinée lorsque le gestionnaire de files d'attente est démarré. Vous pouvez modifier cette valeur, mais les modifications ne prennent effet que lorsque le gestionnaire de files d'attente est redémarré, et même dans ce cas, l'effet peut ne pas être immédiat.

LogFilePages= nombre

Les données de journal sont consignées dans une série de fichiers appelée fichiers journaux. La taille de ces fichiers est définie en unité de pages de 4 ko.

Le nombre de pages par défaut d'un fichier journal est égal à 4 096, ce qui signifie que la taille du fichier journal est égale à 16 Mo.

Sous AIX and Linux, le nombre minimal de pages de fichier journal est de 64 et sous Windows, le nombre minimal de pages de fichier journal est de 32 ; dans les deux cas, le nombre maximal est de 65 535.

Remarque: La taille des fichiers journaux spécifiés lors de la création du gestionnaire de files d'attente ne peut pas être modifiée pour un gestionnaire de files d'attente.

LogType = CIRCULAIRE (par défaut) | LINEAR

Type de journal à utiliser. La valeur par défaut est CIRCULAIRE.

REUTILISATION

Démarrez la reprise par redémarrage à l'aide du journal pour annuler les transactions qui étaient en cours lorsque le système s'est arrêté.

Voir Types de journalisation pour une explication plus complète de la journalisation circulaire.

LINEAIRE

Pour la reprise par redémarrage et la reprise sur support ou la reprise en aval (création de données perdues ou endommagées en rélisant le contenu du journal).

Voir Types d'enregistrement pour une explication plus complète de l'enregistrement linéaire.

Si vous souhaitez modifier la valeur par défaut, vous pouvez éditer l'attribut LogType ou spécifier la journalisation linéaire à l'aide de la commande crtmqm .

Vous pouvez modifier la méthode de consignation après la création d'un gestionnaire de files d'attente. Pour plus d'informations, voir migmqlog.

LogBufferPages=0 (valeur par défaut) |0-4096

Quantité de mémoire allouée aux enregistrements de mémoire tampon pour l'écriture, en spécifiant la taille des mémoires tampon en unités de pages de 4 Ko.

Le nombre minimal de pages tampon est 18 et le nombre maximal est 4096. Les mémoires tampon de taille plus importante améliorent le rendement, en particulier pour les messages plus grands.

Si vous indiquez 0 (valeur par défaut), le gestionnaire de files d'attente sélectionne la taille 512 (2048 Ko).

Si vous indiquez un nombre compris entre 1 et 17, la valeur par défaut du gestionnaire de files d'attente est 18 (72 Ko). Si vous indiquez un nombre compris entre 18 et 4096, le gestionnaire de files d'attente utilise le nombre spécifié pour définir la mémoire allouée.

LogDefaultPath= nom_du_répertoire

Répertoire dans lequel résident les fichiers journaux d'un gestionnaire de files d'attente. Le répertoire se trouve sur une unité locale sur laquelle le gestionnaire de files d'attente peut écrire et, de préférence, sur une unité différente des files d'attente de messages. La spécification d'une autre unité offre une protection supplémentaire en cas de défaillance du système.

La valeur par défaut est la suivante :

• DefaultPrefix\log pour IBM MQ for Windows où DefaultPrefix est la valeur spécifiée dans l'attribut DefaultPrefix de la page de propriétés All Queue Managers IBM MQ . Cette valeur est définie lors de l'installation.
• /var/mqm/log pour les systèmes AIX and Linux .

Vous pouvez également spécifier le nom d'un répertoire dans la commande crtmqm à l'aide de l'indicateur -ld . Lorsqu'un gestionnaire de files d'attente est créé, un répertoire est également créé sous le répertoire du gestionnaire de files d'attente, qui est utilisé pour stocker les fichiers journaux. Le nom de ce répertoire est basé sur le nom du gestionnaire de files d'attente. Cela permet de s'assurer que le chemin d'accès au fichier journal est unique et qu'il respecte toutes les limitations relatives à la longueur des noms de répertoire.

Si vous n'indiquez pas -ld dans la commande crtmqm , la valeur de l'attribut LogDefaultPath dans le fichier mqs.ini est utilisée.

Le nom du gestionnaire de files d'attente est ajouté au nom de répertoire pour garantir que plusieurs gestionnaires de files d'attente utilisent des répertoires de journaux différents.

Lorsque le gestionnaire de files d'attente est créé, une valeur LogPath est créée dans les attributs de journal des informations de configuration, en indiquant le nom de répertoire complet du journal du gestionnaire de files d'attente. Cette valeur permet de localiser le journal lorsque le gestionnaire de files d'attente est démarré ou supprimé.

LogWriteIntegrity=SingleWrite|DoubleWrite|TripleWrite (par défaut)

Méthode utilisée par le consignateur pour écrire des enregistrements de journal de manière fiable.

TripleWrite (par défaut)

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

SingleWrite

Vous ne devez utiliser SingleWrite que si le système de fichiers et le périphérique hébergeant le IBM MQ journal des récupérations garantissent explicitement l'atomicité des écritures de 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.

Remarque: S'il existe suffisamment d'accès concurrents dans votre charge de travail persistante, la définition d'une valeur autre que la valeur par défaut, TripleWrite, présente un bénéfice potentiel minimal.

Pour plus d'informations, voir LogWriteIntegrity - using SingleWrite or TripleWrite.