Configuration des adaptateurs Batch, TSO et RRS

Mettez les adaptateurs à disposition des applications en ajoutant des bibliothèques aux concaténations STEPLIB appropriées. Pour prendre en charge les vidages SNAP émis par un adaptateur, allouez un nom symbolique CSQSNAP. Envisagez d'utiliser CSQBDEFV pour améliorer la portabilité de vos programmes d'application

Répétez cette tâche pour chaque gestionnaire de files d'attente IBM® MQ , selon les besoins.
Vous devrez peut-être effectuer cette tâche lors de la migration à partir d'une version précédente.

Pour rendre les adaptateurs disponibles pour les applications par lots et les autres applications à l'aide de connexions par lots, ajoutez les bibliothèques IBM MQ suivantes à la concaténation STEPLIB de votre application par lots:

thlqual.SCSQANL X
thlqual.SCSQAUTH

où X est la lettre de langue de votre langue nationale :

C, pour le chinois
E, pour la casse mixte en anglais américain
F, pour le français
K, pour japonais
U, pour l'anglais américain en majuscule

Vous n'avez pas besoin de le faire si les bibliothèques se trouvent dans la LPA ou dans la liste de liens.

Pour les applications TSO, ajoutez les bibliothèques à la concaténation STEPLIB dans la procédure de connexion TSO ou activez-les à l'aide de la commande TSO TSOLIB.

Si l'adaptateur détecte une erreur IBM MQ inattendue, il émet un z/OS® cliché SNAP vers le nom symbolique CSQSNAP et émet le code anomalie MQRC_UNEXPECTED_ERROR à l'application. Si l'instruction de définition de données CSQSNAP ne figure pas dans le JCL de l'application ou que CSQSNAP n'est pas alloué à un fichier sous TSO, aucun vidage n'est effectué. Dans ce cas, vous pouvez inclure l'instruction CSQSNAP DD dans le JCL de l'application ou allouer CSQSNAP à un fichier sous TSO et réexécuter l'application. Cependant, comme certains problèmes sont intermittents, il est recommandé d'inclure une instruction CSQSNAP dans le JCL de l'application ou d'allouer CSQSNAP à un fichier dans la procédure de connexion TSO afin de capturer la raison de l'échec au moment où il se produit.

Le programme fourni CSQBDEFV améliore la portabilité de vos programmes d'application. Dans CSQBDEFV, vous pouvez spécifier le nom d'un gestionnaire de files d'attente ou d'un groupe de partage de files d'attente auquel vous souhaitez vous connecter au lieu de le spécifier dans l'appel MQCONN ou MQCONNX d'un programme d'application. Vous pouvez créer une nouvelle version de CSQBDEFV pour chaque gestionnaire de files d'attente ou groupe de partage de files d'attente. Pour cela, procédez comme suit :

Copiez le programme assembleur IBM MQ CSQBDEFV de thlqual.SCSQASMS dans une bibliothèque utilisateur.
Le programme fourni contient le nom de sous-système par défaut CSQ1. Vous pouvez conserver ce nom pour les tests et la vérification de l'installation. Pour les sous-systèmes de production, vous pouvez remplacer NAME=CSQ1 par votre nom de sous-système de un à quatre caractères ou utiliser CSQ1.
Si vous utilisez des groupes de partage de files d'attente, vous pouvez spécifier un nom de groupe de partage de files d'attente à la place de CSQ1. Dans ce cas, le programme émet une demande de connexion à un gestionnaire de files d'attente actif au sein de ce groupe.
Assemblez et éditez les liens du programme pour produire le module de chargement CSQBDEFV. Pour l'assemblage, incluez la bibliothèque thlqual.SCSQMACS dans votre concaténation SYSLIB ; utilisez les paramètres d'édition de liens RENT,AMODE=31,RMODE=ANY. Ceci est illustré dans l'exemple de JCL dans thlqual.SCSQPROC(CSQ4DEFV). Incluez ensuite la bibliothèque de chargement dans z/OS Batch ou dans TSO STEPLIB, avant thlqual.SCSQAUTH.