Placement de modules globaux IBM MQ dans la zone permanente de programme (LPA)

Lorsqu'un gestionnaire de files d'attente IBM® MQ for z/OS® démarre, il charge certains de ses modules de chargement (modules globaux) dans la zone de service commune étendue (ECSA). A l'arrêt du gestionnaire de files d'attente, la zone de mémoire commune étendue est libérée.

Il existe 19 modules globaux, qui dans IBM MQ 9.3, ont consommé environ 1.2 Mo d'ECSA pour chaque gestionnaire de files d'attente en cours d'exécution.

Remarque: Bien que CSQ7GPLM soit un module global, il ne doit pas être ajouté à la zone permanente de programme.

Dans les environnements qui exécutent plusieurs gestionnaires de files d'attente pour chaque partition logique et qui nécessitent une réduction de la consommation de la zone ECSA en raison d'une zone ECSA ou de contraintes privées élevées, il est possible de placer les modules globaux dans la zone LPA. Placer les modules globaux de IBM MQ dans la zone permanente de programme (LPA) est un processus manuel qui nécessite des précautions. Vous ne devez donc effectuer cette procédure que s'il existe un besoin important de traiter les contraintes ECSA ou les contraintes privées élevées.

Si le gestionnaire de files d'attente ne trouve pas de module global dans STEPLIB et détecte que le module se trouve dans la zone permanente de programme (LPA), il utilise directement la copie LPA au lieu de charger une copie du module dans ECSA. Sinon, si le code des gestionnaires de files d'attente est normalement chargé à partir de la liste de liens, tous les modules globaux de la zone permanente de programme sont chargés de préférence à tous les modules globaux de la liste de liens.

Lez/OS fonction commune de suivi du stockage (voir Utilisation de la fonction commune de suivi du stockage ) suit le stockage sous l'espace d'adressage MSTR de chaque gestionnaire de files d'attente et peut être utilisé pour détecter la quantité d'espace utilisée par les modules globaux.

Par défaut, les modules globaux se trouvent dans la bibliothèque de chargement SCSQAUTH. Si l'espace adresse MSTR d'un gestionnaire de files d'attente localise SCSQAUTH via la concaténation STEPLIB, les modules globaux de ce dernier sont utilisés de préférence à ceux de la zone permanente de programme et sont chargés dans ECSA.

Les modules globaux sont les suivants:

CSQ0GPLM CSQ3AMGP,,,, CSQGGPLM, CSQMCGLM, CSQMGPLM,,, CSQVGEPL, CSQVSRX,,, CSQWVZSA,, CSQWVZPS, CSQWVGTM, CSQZTDDM CSQ3SSGP CSQ9PREP
CSQ9SCNB CSQRGLM1
CSQSLD1 CSQWDLD2 CSQWDLD3
CSQWZDG0

Important :

Le nom des modules globaux pour IBM MQ reste constant dans les différentes versions de IBM MQ . Par conséquent, si vous chargez des modules globaux dans la zone permanente de programme (LPA), ils doivent provenir d'une seule version de IBM MQ et ne doivent être utilisés que par les gestionnaires de files d'attente s'exécutant avec la même version de IBM MQ .
Si plusieurs versions de IBM MQ sont exécutées sur la même partition logique, un seul d'entre eux peut avoir ses modules globaux dans la zone permanente de programme à un moment donné.
Si la maintenance est appliquée à une installation IBM MQ pour laquelle des modules globaux sont chargés dans la zone permanente de programme (LPA) et que cette maintenance met à jour l'un des modules globaux, vous devez exécuter à nouveau la procédure décrite dans le texte suivant.

Procédure

Pour placer les modules globaux d'une version de IBM MQ dans la zone permanente de programme (LPA), procédez comme suit:

Créez une copie de la bibliothèque de chargement thlqual.SCSQAUTH et de son contenu, par exemple: thlqual.LOCAL.SCSQAUTH. Assurez-vous que cette bibliothèque de chargement est protégée contre tout accès non autorisé à l'aide de votre gestionnaire de sécurité externe (ESM).
L'APF autorise lethlqual.LOCAL.SCSQAUTH charger la bibliothèque ; voir L'APF autorise leIBMMQ charger des bibliothèques .
Créez une nouvelle bibliothèque de chargementhlqual.GLOBAL.SCSQAUTH avec les mêmes attributs que thlqual.LOCAL.SCSQAUTH.
Remarque: Cette bibliothèque de chargement n'a pas besoin d'être autorisée par APF. Assurez-vous que cette bibliothèque de chargement est protégée contre tout accès non autorisé à l'aide de votre gestionnaire ESM.
Copiez les 19 modules globaux de thlqual.LOCAL.SCSQAUTH dans thlqual.GLOBAL.SCSQAUTH.
Supprimez les 19 modules globaux de thlqual.LOCAL.SCSQAUTH.
Placez les 19 modules globaux de thlqual.GLOBAL.SCSQAUTH dans la zone permanente de programme, en procédant comme suit:
1. a. Ajout de thlqual.GLOBAL.SCSQAUTH à un membre LPALSTxx de SYS1.PARMLIB. Vous devez ensuite effectuer un IPL du système avec l'option CLPA pour vous assurer que le contenu de la bibliothèque est chargé dans PLPA.
2. b. Ajoutez dynamiquement les modules à la zone permanente de programme à l'aide de la commande suivante:
```
SETPROG 
LPA,ADD,MODNAME=(CSQ0GPLM,CSQ3AMGP,CSQ3SSGP,CSQ9PREP,CSQ9SCNB,CSQGGPLM,
CSQMCGLM,CSQMGPLM,CSQRGLM1,CSQSLD1,CSQVGEPL,CSQVSRX,CSQWDLD2,CSQWDLD3,
CSQWVZSA,CSQWZDG0,CSQWVZPS,CSQWVGTM,CSQZTDDM),DSNAME= thlqual.GLOBAL.SCSQAUTH
```
  Remarque: LPALSTxx est la méthode à long terme préférée pour placer des modules dans LPA.
Vérifiez que les modules se trouvent dans la zone permanente de programme (LPA) en exécutant la commande suivante:
```
D PROG,LPA,MODNAME=CSQMCGLM
```

La sortie de la commande doit indiquer les points d'entrée et de chargement du module s'il a été correctement chargé dans la zone permanente de programme.

Pour chaque gestionnaire de files d'attente qui doit utiliser les modules globaux de la zone permanente de programme, si vous placez normalement:

thlqual.SCSQAUTH dans la liste de liens, arrêtez et démarrez simplement votre gestionnaire de files d'attente. Les modules globaux sont chargés à partir de la zone permanente de programme (LPA) et les modules locaux à partir de la liste de liens.
thlqual.SCSQAUTHdans le MSTR JCL STEPLIB, modifiez le JCL pour que le STEPLIB utilisethlqual.LOCAL.SCSQAUTH au lieu dethlqual.SCSQAUTH . Arrêtez et démarrez le gestionnaire de files d'attente ; les modules globaux sont chargés à partir de la zone permanente de programme (LPA) et les modules locaux à partir de la bibliothèque STEPLIB.

Le JCL CHIN et AMSM peut continuer à utiliser thlqual.SCSQAUTH comme n'importe quelle application IBM MQ .

Pour rétablir le gestionnaire de files d'attente lors du chargement des modules globaux dans ECSA, procédez comme suit:

Arrêter les gestionnaires de files d'attente
Retirez les modules globaux de la zone permanente de programme (LPA), soit lors du prochain démarrage du système (IPL) en supprimant les définitions LPALSTxx , soit à l'aide de la commande suivante:
```
SETPROG LPA,DELETE,MODNAME=(xxx) FORCE=YES
```
Si thlqual.LOCAL.SCSQAUTH se trouve dans la bibliothèque STEPLIB du gestionnaire de files d'attente, remplacez-la par thlqual.SCSQAUTH.
Redémarrez les gestionnaires de files d'attente.