Application de mises à jour du niveau de maintenance sous IBM i

Vous appliquez des mises à jour du niveau de maintenance sur la dernière édition en arrêtant IBM® MQ et en utilisant la procédure de maintenance standard IBM i .

Avant de commencer

Pour savoir quelle version est actuellement installée, utilisez les commandes suivantes :

Tableau 1. IBM MQ commandes permettant d'afficher les versions installées
Produit IBM MQ	Commande de version
IBM MQServeur	`DSPMQMVER`
IBM MQ Java	IBM MQ classes for Java: `java com.ibm.mq.MQJavaLevel` Remarque: pour que cette commande fonctionne, vous devrez peut-être définir le chemin d'accès aux classes de votre environnement pour inclure: `/QIBM/ProdData/mqm/java/lib/com.ibm.mq.jar` IBM MQ classes for Java Service de messagerie: `java com.ibm.mq.jms.MQJMSLevel` Remarque: pour que cette commande fonctionne, vous devrez peut-être définir le chemin d'accès aux classes de votre environnement pour inclure: /QIBM/ProdData/mqm/java/lib/com.ibm.mq.jakarta.client.jar (Jakarta Messaging 3.0) ou /QIBM/ProdData/mqm/java/lib/com.ibm.mq.allclient.jar (JMS 2.0) Voir Variables d'environnement relatives à IBM MQ classes for Java et Variables d'environnement relatives aux classes IBM MQ pour JMS.
IBM MQ Client	`DSPMQMVER`

A propos de cette tâche

Les mises à jour de maintenance pour IBM i sont fournies sous forme de PTF (Program Temporary Fixes). Celles-ci peuvent être téléchargées sur le Web sous forme de fichiers de sauvegarde, normalement stockés dans la bibliothèque QGPL. Les PTF IBM i sont disponibles dans Fix Central.

Procédure

Préparation de la mise au repos des gestionnaires de files d'attente:

Lisez attentivement la lettre d'accompagnement pour savoir si vous devez prendre des mesures particulières.
Connectez-vous à une nouvelle session IBM i interactive en vous assurant que vous n'accédez à aucun objet IBM MQ .
Vérifiez que vous disposez des droits suivants:
- du droit d'accès *ALLOBJ, ou du droit de gestion des objets dans les bibliothèques QMQM ;
- des droits permettant d'exécuter la commande ENDSBS.
Avertissez tous les utilisateurs que vous allez arrêter IBM MQ.
Arrêtez le serveur mqweb avec la commande suivante :
```
ENDMQWEB
```

Mise au repos de tous les gestionnaires de files d'attente:

Exécutez la commande ENDMQM:
```
ENDMQM MQMNAME(*ALL) OPTION(*CNTRLD) ENDCCTJOB(*YES) RCDMQMIMG(*YES)
TIMEOUT( 15 )
```
Où 15 correspond au délai d'attente, en secondes.
Si la commande ENDMQM n'aboutit pas dans un délai raisonnable (au moins 10 minutes), utilisez la commande WRKMQM. Cette commande permet d'identifier les gestionnaires de files d'attente qui sont toujours en cours d'arrêt. Ensuite, forcez chacun d'eux à s'arrêter en exécutant la commande suivante:
```
ENDMQM MQMNAME( QMGRNAME ) OPTION(*IMMED)
```
Où QMGRNAME est le nom du gestionnaire de files d'attente.
Terminez le rangement de la mémoire partagée en exécutant la commande suivante:
```
ENDMQM MQMNAME(*ALL) OPTION(*IMMED) ENDCCTJOB(*YES) RCDMQMIMG(*NO)
TIMEOUT( 15 )
```

Si les commandes de l'étape précédente ne sont pas terminées, arrêtez immédiatement le sous-système:

Exécutez la commande suivante :
```
ENDSBS SBS(QMQM) OPTION(*IMMED)
```

Si la commande de l'étape précédente n'est pas terminée, utilisez la commande ENDJOB du système d'exploitation pour arrêter tous les travaux du sous-système QMQM:

Remarque: N'utilisez pas ENDJOBABN tant que vous n'avez pas l'intention d'effectuer un IPL sur la machine avant de démarrer IBM MQ. L'arrêt des travaux IBM MQ à l'aide de ENDJOBABN peut entraîner des sémaphores endommagés, ce qui peut à son tour empêcher le démarrage de votre gestionnaire de files d'attente.

Si un QMGR doit être arrêté manuellement, arrêtez les travaux (ENDJOB) dans l'ordre suivant. Patientez quelques minutes pendant le nettoyage des travaux AMQA* ou AMQZ*.
1. RUNMQLSR - Programme d'écoute TCP (plusieurs unités d'exécution)
2. AMQCLMAA - Programme d'écoute TCP (une seule unité d'exécution)
3. AMQRMPPA - Travail de regroupement du processus de canal
4. RUNMQCHI - Initiateur de canal
5. AMQCRSTA - Travaux MCA récepteurs
6. RUNMQCHL - Travaux MCA émetteur
7. AMQCRS6B - Canal récepteur LU62
8. AMQPCSEA - Serveur de commandes
9. RUNMQTRM - Moniteur de déclenchement d'application
10. RUNMQDLQ - Gestionnaire de files d'attente de rebut
11. AMQFCXBA -Travail de l'agent IBM Integration Bus
12. AMQFQPUB - Démon de publication/abonnement en file d'attente
13. RUNMQBRK -Travail de contrôle IBM Integration Bus
14. AMQZMUC0 ('0' est le chiffre zéro) - Gestionnaire d'utilitaire
15. AMQZMUF0 ('0' est le chiffre zéro) - Gestionnaire d'utilitaire
16. AMQZMUR0 ('0' est le chiffre zéro) - Gestionnaire d'utilitaire
17. AMQZMGR0 ('0' est le chiffre zéro) - Contrôleur de processus
18. AMQRRMFA - Gestionnaire de référentiel de clusters
19. AMQZDMAA - Gestionnaire des messages différés
20. AMQZFUMA - Gestionnaire des droits d'accès aux objets
21. AMQZLSA0 ('0' est le chiffre zéro) - Agents LQM
22. AMQZLAA0 ('0' est le chiffre zéro) - Agents LQM
23. AMQZXMA0 ('0' est le chiffre zéro) - Contrôleur d'exécution

Exécutez la commande suivante :

ENDMQM MQMNAME( QMGRNAME ) OPTION(*IMMED)

Exécutez la commande suivante :

ENDMQM MQMNAME(*ALL) OPTION(*CNTRLD) ENDCCTJOB(*YES) RCDMQMIMG(*NO)
TIMEOUT( 05 )

Où 05 correspond au délai d'attente, en secondes.

Nettoyez manuellement la mémoire partagée.
Exécutez ensuite la commande suivante :
```
EDTF '/QIBM/UserData/mqm/qmgrs'
```
puis :
1. Sélectionnez l'option 5 pour &SYSTEM et vérifiez que les répertoires suivants sont vides : isem, esem, msem, ssem, et shmem.
2. Sélectionnez l'option 5 pour QMGRNAME et vérifiez que les répertoires suivants sont vides :- isem, esem, msem, ssem, et shmem.
3. Sélectionnez l'option 5 pour &ipcc dans le répertoire QMGRNAME et vérifiez que les répertoires suivants sont vides :- isem, esem, msem, ssem, et shmem.
4. Sélectionnez l'option 5 pour &qmpersist dans le répertoire QMGRNAME et vérifiez que les répertoires suivants sont vides :- isem, esem, msem, ssem, et shmem.
5. Sélectionnez l'option 5 pour &app et vérifiez que les répertoires suivants sont vides : isem, esem, msem, ssem, et shmem.

Application d'une PTF:

Chargez et appliquez une PTF.