Configuration de la base de données

Découvrez les paramètres de configuration de base de données pour Oracle GoldenGate for Db2 z/OS. Les paramètres de base de données sont requis pour Oracle GoldenGate.

Installation des composants Extract sur Db2 z/OS

L'extraction Db2 z/OS d'Oracle GoldenGate utilise des objets SQL pour accéder au journal Db2 et le lire. Ces objets Oracle GoldenGate Db2 z/OS nécessitent une plate-forme matérielle minimale de zEC12, une version de système d'exploitation minimale de 2.4 et une version de Db2 minimale de 12.1. Les composants sont constitués de modules de chargement exécutables, de procédures et de fonctions SQL stockées et de programmes externes appelés via les procédures stockées. Ces composants sont les suivants :

Les programmes externes autorisés sont les suivants :
1. oggib001 : programme d'initialisation et d'utilitaire
2. oggrb001 – Fonctionnalité du programme de lecture de journal
3. oggmt001 : programme autonome qui surveille la mémoire ECSA et 64 bits
4. oggjt001 – Programme de configuration pour le JCL de démarrage oggmt001 exécuté à partir du programme oggib001
5. oggfr001 : utilitaire à utiliser par un administrateur de base de données sous la direction du support technique Oracle
Les modèles de fonction et de procédure stockés SQL sont inclus dans le script SQL zOS_OGG_Setup_Template.sql avec OGGINITB et OGGREADB SQL.
Procédure JCL, oggtask.jcl

Remarque : les noms externes des valeurs de nom SQL et JCL sont les valeurs par défaut, que vous pouvez modifier et mettre à jour. Ce processus est abordé dans les sections suivantes.

La figure Replication Process for Db2 z/OS Extract illustre le processus de réplication de l'extraction Db2 z/OS et de ses composants mainframe.

Figure 1 : Processus de réplication pour l'extraction Db2 z/OS

La description de l'image suit

Le processus démarre et s'exécute comme indiqué dans la figure ci-dessus, en utilisant les nombres 1 à 9. Ces étapes sont répertoriées ci-dessous :

Le processus Extract lit les paramètres, y compris les paramètres JCL, à partir du fichier de paramètres créé lors de l'installation.
Le processus Extract signale les informations de démarrage et se prépare à écrire les fichiers trace.
ODBC est utilisé pour collecter des informations à partir de la base de données Db2 et démarrer la réplication.
La procédure stockée SQL OGGINITB commence à préparer la mémoire partagée et à collecter les autres données nécessaires à la réplication.
Le programme externe OGGIB001 appelé par la procédure stockée SQL démarre la tâche de surveillance de la mémoire à l'aide du programme de configuration de travail OGGJT001.
La tâche de surveillance de la mémoire OGGMT001 démarre la surveillance de la mémoire partagée ECSA et 64 bits.
La fonction SQL OGGREADB appelle le programme externe OGGRB001.
Le programme externe OGGRB001 appelle de façon répétée le programme de lecture de journal Db2 pour créer un ensemble de résultats qui renvoie 1 à plusieurs tampons d'enregistrement de journal au processus Extract.
Lorsqu'un ensemble de résultats d'enregistrement de journal est terminé, OGGRB001 se termine après l'envoi de l'ensemble de résultats à l'extraction.

Le processus Extract répète les étapes 7 à 9 jusqu'à ce qu'il soit arrêté ou interrompu de manière anormale. Si la tâche de mémoire ne démarre pas, le programme OGGIB001 renvoie un indicateur indiquant qu'il y a eu une erreur JCL ou un problème de configuration et que le processus Extract commence à gérer sa mémoire. Si la tâche de mémoire démarre correctement, elle teste les champs en constante évolution dans la mémoire partagée ECSA de 48 octets. Ces champs cessent de changer si l'extraction prend fin pour une raison quelconque. A ce stade, le gestionnaire de mémoire attend si le processus Extract ou le réseau est lent et libère la mémoire avant de s'arrêter après une limite de temps configurée.

Pour installer les composants nécessaires à Oracle GoldenGate pour l'extraction Db2 z/OS, procédez comme suit :

Assurez-vous qu'une bibliothèque (PDSE) existe sur le système Db2 z/OS et assurez-vous qu'une entrée correspondant à cette bibliothèque figure dans la liste des bibliothèques autorisées. Cette bibliothèque est l'emplacement où les objets de programme externe Oracle GoldenGate résideront.
Assurez-vous qu'une procédure WLM autorisée par APF référence le PDSE de l'étape précédente. Oracle recommande que la valeur NUMTCB pour l'environnement WLM soit comprise entre 10 et 40 pour les procédures stockées. La valeur NUMTCB dépend du nombre maximal d'extractions exécutées simultanément sur la base de données et du débit requis par chaque extraction. Si vous souhaitez plus de flexibilité dans la définition de NUMTCB, spécifiez-le dans le JCL de démarrage pour le WLM, mais pas dans le panneau de création.
Pour configurer la sécurité des environnements d'application WLM et créer des procédures stockées, procédez comme suit :
1. (Facultatif) Indiquez les espaces d'adressage définis par WLM qui peuvent exécuter des procédures stockées. Si vous n'effectuez pas cette étape, tout espace d'adressage établi par WLM peut exécuter des procédures stockées.
2. Autorisez les utilisateurs à créer des procédures dans des espaces d'adressage WLM spécifiques.
3. Accordez à l'utilisateur l'accès nécessaire pour créer des procédures dans des schémas spécifiques. Utilisez l'instruction GRANT avec l'option CREATIN pour le schéma approprié.
4. Accordez à l'utilisateur l'accès permettant de créer des packages pour des procédures dans des ensembles spécifiques. Utilisez l'instruction GRANT avec l'option CREATE pour la collection appropriée.
5. Accordez l'accès aux personnes appropriées pour actualiser les environnements WLM.
6. Ajoutez une autorité RACF supplémentaire aux personnes appropriées, ce qui permet aux procédures WLM de démarrer le travail du gestionnaire de mémoire.
Assurez-vous que l'ID utilisé pour exécuter la procédure JCL de démarrage WLM est autorisé à utiliser RRSAF. Chaque fois que l'un des espaces d'adressage WLM Db2 démarre, il utilise RRSAF pour l'attacher à Db2. Reportez-vous au document Db2 12 for z/OS Installation and Migration Guide.
Dans l'installation Linux ou UNIX d'Oracle GoldenGate pour Db2 z/OS, il existe un fichier ZIP situé dans le répertoire d'installation d'Oracle GoldenGate appelé zOSutils.zip, qui contient un fichier appelé zOSPrograms.zip. Décompressez zOSPrograms.zip vers zOSPrograms.tar et copiez zOSPrograms.tar en mode binaire vers votre système Db2 z/OS dans un répertoire HFS.
Sur votre système Db2 z/OS dans USS ou OMVS, accédez au répertoire contenant zOSPrograms.tar.
Restaurez les objets à l'aide de la commande tar -xovf zOSPrograms.tar.
Copiez les objets dans le PDSE autorisé. Utilisez cp -X ogg[irmj][abt][0-9]* "//'authorized_PDSE_name'", où authorized_PDSE_name est le nom du PDSE autorisé APF, destiné aux objets Oracle GoldenGate. Cette commande installe les objets avec les noms par défaut.

Remarque : dans cette commande, la cible de copie est un guillemet double, un guillemet simple, un guillemet simple, un guillemet simple, un nom PDSE autorisé à un guillemet simple. -X est une majuscule X pas une minuscule x.
L'installation de scripts portant des noms différents vous permet de vous conformer aux protocoles système ou d'exécuter plusieurs versions d'Oracle GoldenGate. Pour installer les scripts avec des noms différents, il est recommandé de créer un script shell qui renomme les programmes avant de les copier dans le PDSE. Un exemple de script shell est fourni dans le fragment de code suivant.
```
#!/bin/bash
# Copy new programs renaming them to version 21.12 names.
cp oggib001 oggi2112
cp oggrb001 oggr2112
cp oggmt001 oggm2112
cp oggjt001 oggj2112
cp -X oggi2112 "//'SYS4.WLMDSNA.AUTHLOAD'"
cp -X oggr2112 "//'SYS4.WLMDSNA.AUTHLOAD'"
cp -X oggm2112 "//'SYS4.WLMDSNA.AUTHLOAD'"
cp -X oggj2112 "//'SYS4.WLMDSNA.AUTHLOAD'"
```
Vous pouvez exécuter le script à l'aide de la commande chmod +x scriptname. Vous pouvez copier et réutiliser ce script pour les nouvelles versions.
Vous devez créer les procédures SQL à l'aide de l'outil SQL de votre choix afin qu'Oracle GoldenGate puisse appeler les objets Extract. Les procédures stockées Oracle GoldenGate doivent être autorisées uniquement pour les utilisateurs qui les utilisent pour la réplication.

Un exemple de modèle de script SQL dans le répertoire d'installation d'Oracle GoldenGate contient les instructions SQL permettant de configurer la procédure et la fonction stockées sur l'instance z/OS Db2. Le script SQL zOS_OGG_Setup_Template.sql contenu dans zOSutils.zip est pour Db2 v12.1 et versions ultérieures et peut être exécuté à partir de n'importe quel outil SQL sur n'importe quelle plate-forme pouvant se connecter à votre instance z/OS Db2. Ce script doit être exécuté sur l'instance Db2 que vous utilisez avec le processus Extract. Le script fourni dans le répertoire d'installation distant est au format ASCII.

Modifiez la ligne suivante avant d'exécuter les scripts :
- Modifiez la ligne WLM ENVIRONMENT afin d'utiliser le nom correct de l'environnement WLM que vous utiliserez pour Oracle GoldenGate.

Remarque : le nom de schéma oggifi0001 peut être configuré à l'aide du paramètre d'extraction TRANLOGOPTIONS REMOTESCHEMA schemaname. Les noms de procédure et de fonction, OGGINITB et OGGREADB, dans le modèle ne sont pas configurables. Vous pouvez renommer chaque nom externe dans les scripts et le PDSE si les noms de script et les noms d'objet PDSE correspondent. La modification de ces noms fait partie de la procédure qui permet la migration vers de nouvelles versions ou si des procédures de dénomination spécifiques doivent être respectées sur Db2 z/OS.

Le tableau suivant contient une liste de contrôle des composants que vous pouvez modifier et/ou mettre à jour :

Tableau 2 Liste des composants modifiables

Composant	De	Où
`oggib001`	fichier tar	PDSE autorisé
`oggrb001`	fichier tar	PDSE autorisé
`oggmt001`	fichier tar	bibliothèque PDSE & proc autorisée
`oggjt001`	fichier tar	paramètre PDSE et extraction autorisés
`oggpr001`	fichier tar	bibliothèque de procédures et paramètre Extract
proclib	MVS	ajouter le paramètre Extract si nécessaire
bibliothèques d'étapes	MVS	Bibliothèque de procédures WLM et `oggpr001`
remoteschema		`zOS_OGG_Setup_Template.sql` et paramètre Extract
Nom WLM	MVS	`zOS_OGG_Setup_Template.sql`
programme externe		`zOS_OGG_Setup_Template.sql`

Remarque : n'oubliez pas d'effectuer toutes ces étapes après chaque nouvelle installation de patch.

Utiliser le gestionnaire de mémoire partagée pour l'extraction

L'extraction Oracle GoldenGate démarre une tâche ou un travail distinct à partir de WLM pour surveiller l'utilisation de la mémoire partagée. Ce travail est une tâche minimale qui s'exécute dans MVS, mais il ne s'agit pas d'un WLM. Le nom d'utilisateur de ce script commence sous doit avoir les autorisations d'exécution à partir du WLM (généralement en utilisant quelque chose comme RACF). Cette mémoire partagée surveillée se compose d'une petite zone ECSA de 48 à 64 octets et d'une plus grande zone de 64 bits en fonction de la taille du tampon Extract.

Les champs spécifiques de la mémoire partagée sont mis à jour pour chaque lecture effectuée par le processus Extract. Ces champs sont mis à jour, que le script renvoie ou non des données. Le moniteur vérifie ces champs pour s'assurer que l'extraction n'est pas devenue inactive. Si le processus Extract est inactif, la mémoire partagée est libérée et le moniteur se termine. Vous pouvez contrôler le gestionnaire de mémoire à l'aide du paramètre remote_memory_options dans le fichier de paramètres du processus Extract.

Vous pouvez indiquer plusieurs sous-paramètres pour configurer la tâche de surveillance. Vous pouvez configurer l'intervalle d'attente et le temps d'inactivité utilisés par le moniteur en spécifiant des sous-paramètres des options de mémoire distante, comme indiqué dans l'exemple suivant :

remote_memory_options wait_interval 2000 inactive_time 01:00

L'intervalle d'attente est exprimé en centièmes de secondes dans l'exemple et fait attendre le moniteur 20 secondes entre chaque vérification de la mémoire. Si le moniteur a vérifié pendant 1 heure (format HH:MM) et que l'extraction est toujours inactive, le moniteur s'arrête après avoir libéré la mémoire partagée. Si le processus Extract revient à l'état actif pendant cette heure, le moniteur réinitialise son état et poursuit la surveillance.

La valeur wait_interval peut être comprise entre 100 et 6000, et la valeur par défaut est 1000. La valeur inactive_time peut être comprise entre 00:10 et 12:00 et la valeur par défaut est 00:30. Si le moniteur ne démarre pas correctement, le processus Extract affiche un message d'avertissement dans l'état Extract et le processus d'extraction continue. Le processus Extract tente de libérer de la mémoire ECSA lorsqu'il s'arrête.

Le paramètre de mémoire distante dispose de trois options pour faire fonctionner cette fonctionnalité. La syntaxe de ces paramètres est la suivante :

task_procedure proc name
task_library proc library
task_setup task setup program

Exemple :

remote_memory_options task_procedure OGGPR001
remote_memory_options task_library TEST.PROCLIB
remote_memory_options task_setup OGGJT001

Vous pouvez spécifier plusieurs options dans une seule commande, comme indiqué ci-dessous :

remote_memory_options task_procedure OGGPR001 task_library TEST.PROCLIB task_setup OGGJT001

Remarque : les valeurs du paramètre de mémoire distante ne tiennent pas compte de la casse.

Les valeurs par défaut sont le nom de procédure OGGPR001 et le programme de configuration de tâche OGGJT001. Il n'existe pas de bibliothèque de tâches par défaut car la procédure peut être installée dans l'une des bibliothèques de procédures par défaut du système MVS. Le paramètre de bibliothèque de tâches n'est nécessaire que si la procédure ne se trouve pas dans une bibliothèque système par défaut.

La tâche de mémoire commence par une simple carte JOB et un nom de procédure EXEC avec des paramètres transmis à partir de l'extraction. Certains systèmes z/OS peuvent nécessiter divers autres paramètres sur la carte de travail. Les paramètres JOB peuvent également être modifiés à l'aide du paramètre de mémoire distante, comme indiqué dans l'exemple ci-dessous.

remote_memory_options task_jobname [valid MVS job name (see below)]
remote_memory_options task_acct_info [valid MVS acct value (see below)]
remote_memory_options task_programmer [valid MVS programmer name, Can use single quotes]
remote_memory_options task_class [valid MVS job class A to Z or 0 to 9]
remote_memory_options task_msgclass [valid MVS msgclass A to Z or 0 to 9]
remote_memory_options task_msglevel [valid MVS message level n or (,n) or (n,n)  n=valid digit]
remote_memory_options task_priority [valid MVS priority 0-15]

Vous pouvez indiquer le nom JOB à l'aide de deux caractères valides et d'un astérisque, tel que AA*. Le nom JOB par défaut est GG*. L'astérisque est remplacé par six nombres aléatoires lorsqu'il est spécifié. Sinon, si vous indiquez un nom de caractère de un à huit octets, il doit s'agir d'un nom de travail MVS valide.

Spécifiez des valeurs de compte dans l'un des formats MVS valides suivants :

OTXI
'MY ACCT'
(ACCT,1234,ABC)

Pour les paramètres, tels que acct_info et programmer, qui autorisent les caractères spéciaux, placez-les entre apostrophes. En outre, les règles MVS relatives à l'utilisation de guillemets simples ou d'esperluettes entre guillemets continuent de s'appliquer. Le processus Extract effectue une validation minimale pour ces paramètres et laisse la validation complète au processus MVS. Le processus Extract acceptera le premier si vous indiquez des paramètres en double et ignorez les doublons.

Un exemple de fichier JCL de procédure sera inclus dans le fichier zOSPrograms.zip. Ce JCL ne remplace pas la procédure WLM. Le moniteur, créé dans le WLM, utilise le JCL pour s'exécuter dans MVS. Une procédure JCL offre plus de flexibilité si vous ajoutez des commandes ou des JCL qui prennent en charge l'archivage des résultats de travaux ou d'autres procédures.

Remarque : lors de l'installation et de la configuration du gestionnaire de mémoire, il peut être nécessaire de désactiver temporairement le gestionnaire de mémoire lorsque vous devez attendre les problèmes de configuration RACF, l'utilisation de l'initiateur, l'utilisation de la classe de travail ou d'autres problèmes similaires liés au gestionnaire de mémoire. Le processus Extract fonctionne en mode hérité dans cette instance et la version ECSA, ainsi que dans la mémoire partagée 64 bits. Le processus Extract affiche la libération de mémoire partagée à la fin du rapport Extract.

Oracle ne le recommande pas en tant que solution permanente. Lorsqu'il est utilisé, l'utilisateur est responsable de la surveillance de la libération de la mémoire ECSA et 64 bits. Le paramètre d'activation de cette fonctionnalité commence par un trait de soulignement pour rappeler à l'utilisateur que le système est en cours d'exécution dans ce mode. D'autres options de mémoire distante peuvent être laissées en place et utilisées en supprimant l'option de désactivation de la gestion de la mémoire. Par défaut, le paramètre de gestion de la mémoire distante est activé et il est spécifié comme suit :

remote_memory_options _remote_memory_on
remote_memory_options _remote_memory_off

Le JCL a le format suivant :

//*====================================================================
//* EXAMPLE JCL FOR RUNNING THE COMMON MEMORY MONITOR PROCEDURE
//* ADDRESS SPACE NEEDING AN AUTHORIZED LOAD LIBRARY
//* NOTE: THE PROGRAM OGGMT001 CAN BE RENAMED IN THE LIBRARY BUT THE
//*       NEW NAME MUST MATCH THE PROGRAM NAME IN THIS JCL
//*====================================================================
//OGGDSNNA PROC RGN=0K TR=,EX=,MEM=,LEN=,SEC=,DUR=,VER=
//OGGDSNNX EXEC PGM=OGGMT001,REGION=&RGN,TIME=NOLIMIT,
// PARM='&TR &EX &MEM &LEN &SEC &DUR &VER'
//*--------------------------------------------------------------------
//* REPLACE &PREFIX.**.AUTHLOAD LIBRARIES WITH SITE SPECIFIC FILE(S)
//* ALSO REPLACE THE CEE LIBRARY WITH SITE SPECIFIC FILE
//* DSNN COULD REPRESENT A DB2 SPECIFIC LOAD LIBRARY IF ONE EXISTS
//*--------------------------------------------------------------------
//STEPLIB  DD DISP=SHR,DSN=&PREFIX..WLMDSNN.USER.AUTHLOAD
//         DD DISP=SHR,DSN=CEE.SCEERUN
//SYSPRINT DD SYSOUT=*
//SYSOUT   DD SYSOUT=*

Modifiez les bibliothèques marquées avec PREFIX pour qu'elles fonctionnent dans votre système. Si vous avez renommé le programme OGGMT001 que vous avez copié à partir du fichier zOSPrograms.tar, vous devez le modifier dans le JCL. Les paramètres NULL de l'instruction PROC sont présents à titre d'information. Le programme de configuration du travail OGGJT001 fournit ces valeurs à l'aide des informations transmises à partir de l'extraction. Vous pouvez également spécifier autant de noms de jeu de données de bibliothèque d'étapes que nécessaire. La procédure JCL fournie dans le fichier zOSPrograms.tar fournit un exemple utilisant plusieurs bibliothèques d'étapes.