Contrôle du processus CDC

Data Movement gateway utilise des structures de mémoire ECSA (appelées services R4Z CDC) qui sont créées au cours du traitement CDC. Chaque LPAR z/OS peut contenir plusieurs services R4Z CDC de ce type. Pour créer les services R4Z CDC, un programme utilitaire spécial, R4ZCTL, est fourni.

Ce programme peut également être utilisé pour gérer l'état du traitement CDC, ainsi que le niveau de trafic du côté z/OS.

Le programme de contrôle R4Z (R4ZCTL ) est obligatoire pour effectuer les opérations suivantes : vérifier le traitement CDC et signaler l'état du service CDC, mettre en pause le traitement CDC, reprendre un traitement CDC en pause et mettre fin au processus CDC, que ce soit de manière normale ou forcée.

Les paramètres de commande disponibles lors de l'exécution du programme R4ZCTL sont les suivants :

Si vous exécutez la commande sans aucun paramètre, elle renvoie l'état actuel du service CDC.

CHECKCONFIG - Vérifie que les paramètres de configuration sont valides.
PAUSE_TASK - Arrête le service d'une tâche CDC spécifique.
PAUSE_CDC - Arrête l'activité entière d'un service CDC.
RESUME_TASK - Permet à une tâche en pause de continuer.
RESUME_CDC - Permet à une tâche en pause de continuer.
TERMINATE - Arrête le service CDC et, une fois arrêté, libère ses ressources.
FORCE - Comme TERMINATE, lorsque la tâche qui détient les ressources « s'arrête ».

Comme le programme R4ZCTL nécessite une autorisation APF, toutes les bibliothèques de la STEPLIB doivent être autorisées en APF.

Lorsque vous exécutez R4ZCTL sans paramètre, son code d'achèvement est défini en fonction du fait que l'environnement a été initialisé (CC=0) ou non initialisé (CC=1).

Syntaxe d'appel du programme de contrôle

Le programme R4ZCTL est appelé en tant qu'étape de travail, comme EXEC PGM=R4ZCTL, et accepte des instructions à partir du paramètre d'appel de l'étape de travail.

Le paramètre d'appel R4ZCTL est une chaîne qui peut contenir des sous-paramètres facultatifs, séparés par une virgule comme suit :

[SERVICE=CDC-service-qualifier,][MSGLVL={0 | 1},][action]

L'ordre des sous-paramètres dans la chaîne n'est pas important.

Où :

SERVICE=CDC-service-qualifier désigne l'étendue logique de l'activité Data Movement gateway sur laquelle le programme de contrôle doit agir.

MSGLVL={0 | 1 | 2} désigne le niveau des notifications à afficher dans le fichier de messages pendant le fonctionnement du programme de contrôle.

0 = Aucune notification
1 = Modéré
2 = Maximum

action-verb peut être au choix :

PAUSE_TASK(*|ALL|task-qualifier)

Suspend la récupération du CDC pour la ou les tâches désignées entre parenthèses.
PAUSE_CDC

Suspend la récupération du CDC pour l'ensemble du service CDC. Les tâches de Replication suspendues pendant plus d'un certain temps sont arrêtées et tenteront de se rétablir plusieurs fois. Aucune nouvelle tâche ne sera servie.
RESUME_TASK(*|ALL|task-qualifier)

Reprend la récupération de CDC pour la tâche désignée par task-qualifier.
RESUME_CDC

Reprend la récupération de CDC pour toutes les instances correspondant au qualificatif session-limits.
DUMP_TASK(*|ALL|task-qualifier)

Demande le vidage formaté des informations de contrôle dans les structures de la mémoire résidente. ALL désigne toutes les sessions ; SUMMARYONLY désigne uniquement l'ancre.
TERMINATE

Libère toutes les structures de mémoire résidentes de R4Z, met fin à toutes les instances actives et supprime les ressources associées. À partir de ce moment, toutes les demandes CDC renverront l'état inactif jusqu'à ce que le service CDC soit auto-activé par un appel entrant à l'UDF du lecteur CDC.

Référence des éléments de syntaxe

Les éléments utilisés dans les descriptions syntaxiques ci-dessus sont les suivants :

CDC-service-qualifier

Un nom à 4 caractères (premier caractère alphabétique, le reste alphanumérique), qui désigne un service CDC.

Le « service CDC » fait référence à un groupe de ressources - structures de mémoire, une fonction de table définie par l'utilisateur (UDTF) définie dans DB2 et un environnement d'application (APPLENV) défini dans la politique WLM. R4Z vous permet de spécifier des propriétés - limites de mémoire et seuils de traitement - pour chaque service CDC. Il peut être nécessaire de gérer plusieurs services CDC également pour une autre raison : à savoir, pour pouvoir utiliser plusieurs versions de Data Movement gateway dans une seule partition LPAR, chacune gérant ses structures de mémoire indépendamment des autres.
task-qualifier

Un identifiant à 4 chiffres est attribué lors de l'initiation de la tâche. Cet identifiant est principalement destiné à contrôler et à suivre le trafic CDC d'une tâche spécifique. Il constitue le CORRID (Correlation-ID) du fil DB2 du service CDC - il y occupe les octets 9 à 12.

Codes d'achèvement du programme de contrôle

0 – Achèvement normal
1 – L'environnement ne quitte pas le qualificatif session-limits (lorsqu'aucune action n'est spécifiée)
4 – Avertissement
8 – Erreur

Exemples de travaux (dans la bibliothèque INSTALL)

IV1CHECK – Vérifie la configuration de tous les services CDC

XMDUMP – Vide toutes les sessions

XMPAUSE – Met en pause une session

XMRESUME – Reprend une session

XMTERMIN – Met fin à toutes les sessions

Activation du processus CDC (activation automatique)

Pour permettre à la fonction UDTF du lecteur CDC de fonctionner, cette fonction doit être capable d'allouer et de préformater les structures de mémoire dans ECSA lorsque l'UDTF est appelée et la première fois après le démarrage du système z/OS ; elle doit également accéder aux configurations définies pour le service CDC que l'UDTF dessert (ou aux configurations « par défaut , pour les valeurs non spécifiées au niveau du service CDC).

Pour tenir compte de cela, le processus d'installation s'assure des éléments suivants :

Une UDTF spéciale est créée pour servir le service CDC. Le nom de l'UDTF créée est suffixé par un double tiret (« __ ») suivi de CDC-service-qualifier, formant ainsi un nom : <schema>.R4Z_UDTF__<CDC-service-qualifier>.
Un APPLENV WLM est créé pour exécuter les appels de l'UDTF ci-dessus. Le nom de l'APPLENV créé peut également être suffixé par le qualificatif du service CDC, afin de garantir l'unicité du nom de l'APPLENV, ce qui est recommandé ; toutefois, plusieurs UDTF peuvent utiliser un seul APPLENV.
Une procédure JCL est créée pour « héberger » les exécutions de l'APPLENV WLM. Cette procédure JCL diffère des procédures STC WLM habituelles car un DDNAME spécial, R4ZCNFG, doit être spécifié, son DSN faisant référence à la bibliothèque CONFIG du produit R4Z. Dans cette bibliothèque, il DOIT y avoir un membre existant nommé « CDCS », spécifiant les configurations par défaut du service CDC. Il PEUT aussi exister un membre nommé « CDCS<CDC-service-qualifier> » avec les valeurs de configuration que vous voulez appliquer pour ce service CDC.

Le contenu de chacun des membres CDCS* de la bibliothèque CONFIG est une liste d'instructions d'affectation, une par carte, au format « mot-clé=valeur ». L'instruction peut suivre des espaces, et est terminée par des espaces ; aucun espace n'est autorisé avec l'instruction. Les cartes commençant par un trait d'union (-) sont traitées comme des cartes de commentaires ; et le contenu qui suit l'espace de terminaison est également traité comme un commentaire.

Mots-clés, valeurs max, valeurs min, et valeurs par défaut
Mot-clé	Description	Minimale	Maximale	Par défaut
MAXSESSIONS	Le nombre maximal de sessions CDC.	1	128	32
SESSIONTIMEOUTSECS	Le nombre de secondes après lequel la session est interrompue.	300	7200	900
MAXIFIBUFKBYTES	La taille maximale du tampon autorisée pour les lectures IFI, en Koctets.	64	1024	256
MAXRESULTSETMBYTES	La taille maximale en Moctets que l'ensemble de résultats accumulés doit atteindre ; lorsqu'elle est atteinte, l'ensemble de résultats est renvoyé.	1	2048	4
MAXRESULTSETSECS	L'intervalle de temps maximum, en secondes, pour accumuler l'ensemble de résultats ; lorsqu'il est atteint, l'ensemble de résultats est renvoyé.	1	120	30

Création de services R4Z CDC

Décider des services CDC : En fonction de la prévision de la nécessité de processus de réplication indépendants (pour permettre différentes versions, pour garantir une mémoire ECSA suffisante, pour tenir compte des différentes latences autorisées, etc.), déterminez les services R4Z CDC qui doivent exister dans chaque LPAR. Pour chaque service, choisissez les qualificatifs de service CDC (4 caractères). Vous devez également décider si chaque service CDC doit avoir son propre APPLENV (environnement d'application) WLM, ou un APPLENV unique pour servir tous les services CDC.

Vous devez définir la variable DEFWLMAE (DEFine WLM Applic. Env.) dans un membre DFSYMLST sur PER (première option) ou ONE (deuxième option). Une fois cette variable définie, vous devez poursuivre l'installation :

Si vous sélectionnez ONE pour DEFWLMAE, les travaux DO2* et DO3SRVTF doivent être exécutés une seule fois ; si vous sélectionnez PER , ces travaux doivent être exécutés pour chaque service CDC, après que la variable JCL SET CDCSRV a été définie sur le qualificatif du service CDC.

Le travail DO3SRVDF crée une bibliothèque CONFIG, et place un membre nommé « CDCS », qui sert de fichier de configuration par défaut. Après avoir exécuté le travail DO3SRVTF, la bibliothèque contiendra la configuration de tous les services CDC, ce qui permettra de les éditer et de modifier les configurations d'un service CDC spécifique.

Si ONE est utilisé pour DEFWLMAE, les valeurs par défaut du produit sont utilisées à la place des membres de la bibliothèque CONFIG.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici