ADDDIRSHD

Ajouter système en réplication

En bref

La commande ADDDIRSHD permet d'ajouter un système émetteur de données du répertoire de distribution à votre système par réplication de répertoire.

ADDDIRSHD se lit ADD (Ajouter) + DIRSHD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDDIRSHD SYSNAME(…)

Paramètres

SYSNAME Nom de système obligatoire
SCD Réplication planifiée
FRQ Fréquence de réplication
HOURS Intervalles (en heures)
SKIPDAY Jours à sauter
MONTHWK Semaine (du mois)
INZ Réplication initiale
RMTLOCNAME Nom lieu éloigné
MODE Mode
RMTNETID ID éloigné réseau
LCLLOCNAME Nom lieu local
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez ADDDIRSHD puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande ADDDIRSHD permet d'ajouter un système émetteur de données du répertoire de distribution à votre système par réplication de répertoire.

Restriction : Vous devez disposer du droit d'administrateur de la sécurité (*SECADM) pour utiliser cette commande.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SYSNAME	Nom de système	Valeur caractère	Obligatoire, positionnel 1
SCD	Réplication planifiée	Valeurs uniques: CURRENT Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Date	Date
	Élément 2: Heure	Heure
FRQ	Fréquence de réplication	DAILY, WEEKLY, BIWEEKLY, MONTHLY, MONTHLYREL, HOURS	Facultatif
HOURS	Intervalles (en heures)	1-999, 5	Facultatif
SKIPDAY	Jours à sauter	Valeurs uniques: NONE Autres valeurs (jusqu'à 5 répétitions): SUN, MON, TUE, WED, THU, FRI, SAT	Facultatif
MONTHWK	Semaine (du mois)	4, *LAST	Facultatif
INZ	Réplication initiale	Valeurs uniques: NONAPPC, COMPLETED Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Méthode	*APPC
	Élément 2: Remplacer les données	NO, YES
RMTLOCNAME	Nom lieu éloigné	Valeur caractère, *SYSNAME	Facultatif
MODE	Mode	Valeur caractère, *NETATR	Facultatif
RMTNETID	ID éloigné réseau	Valeur caractère, LOC, NETATR, *NONE	Facultatif
LCLLOCNAME	Nom lieu local	Valeur caractère, LOC, NETATR	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, *SYSNAME	Facultatif

Nom de système (SYSNAME)

Nom du système émetteur (jusqu'à 8 caractères) que vous ajoutez. Il peut être composé de lettres majuscules (A à Z), de chiffres (0 à 9), de caractères spéciaux (à, # et $) et de blancs imbriqués. Ces derniers doivent être placés entre apostrophes. Les blancs de gauche ne sont pas admis. L'utilisation des caractères spéciaux est déconseillée car ceux-ci ne font pas partie d'un jeu de caractères invariable et n'existent pas sur tous les claviers.

Ce paramètre est obligatoire.

Réplication planifiée (SCD)

Date et heure auxquelles le système ajouté débute l'émission de données vers votre système.

*CURRENT: Le système débute la réplication des données à la date et à l'heure en cours.

Les valeurs possibles pour la date de réplication sont les suivantes :

date-réplication-planifiée: Indiquez la date à laquelle le système débute l'émission des données vers votre système. Respectez le format de date du travail.

Les valeurs possibles pour l'heure de réplication sont les suivantes :

heure-réplication-planifiée

Indiquez l'heure à laquelle le système débute l'émission des données vers votre système.

Vous pouvez utiliser le format 24 heures avec ou sans séparateur :

Dans le premier cas, entrez une chaîne de 5 ou 8 chiffres en indiquant un séparateur entre les heures, les minutes, et les secondes. Si la commande est entrée en ligne de commande, la chaîne doit être placée entre apostrophes. Cette commande n'aboutit pas si un séparateur autre que celui que vous avez indiqué est utilisé.
Dans le deuxième cas, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss) où hh représente les heures, mm, les minutes et ss les secondes. Les valeurs admises pour hh sont comprises entre 00 et 23. Les valeurs admises pour mm et ss sont comprises entre 00 et 59.

Ce paramètre est obligatoire.

Fréquence de réplication (FRQ)

Fréquence à laquelle le système émetteur ajouté effectue les réplications de données dans votre système. Cette fréquence dépend de la valeur indiquée au paramètre SCD.

*WEEKLY: La réplication a lieu une fois par semaine.
*DAILY: La réplication a lieu une fois par jour.
*BIWEEKLY: La réplication a lieu une semaine sur deux.
*MONTHLY: La réplication a lieu une fois par mois, à la même date.
*MONTHLYREL: La réplication a lieu une fois par mois, le même jour de la même semaine (par exemple, le premier lundi du mois).
*HOURS: La réplication a lieu selon la périodicité indiquée au paramètre HOURS.

Intervalles (en heures) (HOURS)

Nombre d'heures s'écoulant entre chaque réplication du système émetteur. Ce paramètre est admis uniquement lorsque FRQ(*HOURS) est indiqué.

Jours à sauter (SKIPDAY)

Jours de la semaine au cours desquels aucune réplication n'est effectuée. Vous pouvez indiquer cinq valeurs différentes de *NONE au maximum.

Ce paramètre est admis uniquement lorsque FRQ(*DAILY) est indiqué.

*NONE: Réplication tous les jours.
*SUN: Pas de réplication le dimanche.
*MON: Pas de réplication le lundi.
*TUE: Pas de réplication le mardi.
*WED: Pas de réplication le mercredi.
*THU: Pas de réplication le jeudi.
*FRI: Pas de réplication le vendredi.
*SAT: Pas de réplication le samedi.

Semaine (du mois) (MONTHWK)

Permet d'indiquer si une réplication qui a lieu le même jour de chaque mois est planifiée pour être effectuée au cours de la quatrième semaine ou de la dernière semaine du mois.

Ce paramètre est admis uniquement lorsque FRQ(*MONTHLYREL) est indiqué et que la date affectée au paramètre SCD est le 22, le 23 ou le 24.

4: La réplication a lieu le même jour de la quatrième semaine du mois.
*LAST: La réplication a lieu le même jour de la dernière semaine du mois, quel que soit le nombre de semaines de ce dernier.

Réplication initiale (INZ)

Méthode utilisée pour la première réplication. Celle-ci porte sur la totalité des données locales ou répliquées du répertoire de distribution du système émetteur. Elle inclut, en option, les utilisateurs éloignés lorsque RMTSHD(*YES) est indiqué dans la commande CHGDIRA (Modifier les attributs du répertoire). Les réplications postérieures ne concernent que les données modifiées depuis la précédente réplication.

Les valeurs possibles pour la réplication automatique sont les suivantes :

*APPC: La première réplication a lieu lorsque cette commande est exécutée via APPC (communications évoluées de programme à programme). Si le répertoire du système ajouté est volumineux, indiquez *NONAPPC pour éviter de saturer les lignes de communication.
Si vous indiquez *APPC, vous pouvez utiliser l'Elément 2 pour que les données résultant de la réplication viennent se substituer au contenu des zones correspondant à un poste donné du répertoire de votre système chaque fois qu'un poste identique existe dans le répertoire du système émetteur.

Les valeurs possibles pour les données de remplacement sont les suivantes :

*NO: Les données contenues dans les zones des postes de répertoire de votre système ne sont pas remplacées par les données en provenance du système émetteur.
*YES: Toutes les données sont ajoutées au répertoire de distribution de votre système. En cas de postes de répertoire communs aux deux systèmes, les données du système émetteur se substituent à celles de votre système.
*NONAPPC: La commande CPYTODIR (Copier dans le répertoire) est utilisée pour la première réplication. Il est préférable d'exécuter cette commande avant de lancer la réplication à partir du système émetteur que vous ajoutez, afin d'éviter toute perte de données.
*COMPLETED: La réplication initiale a déjà été effectuée à l'aide de la commande CPYTODIR.

Nom lieu éloigné (RMTLOCNAME)

Nom du lieu éloigné du système émetteur que vous ajoutez.

*SYSNAME: La valeur indiquée au paramètre SYSNAME est utilisée pour le nom du lieu éloigné.
nom-lieu-éloigné: Indiquez le nom du lieu éloigné.
Vous pouvez entrer jusqu'à 8 caractères. Le nom doit commencer par une lettre majuscule (A à Z) ou un caractère spécial ($, # ou à). Il ne peut pas comprendre de blanc, signe plus (+), point (.)ou trait de soulignement (_). Pour plus d'informations, reportez-vous à la brochure APPC Programmer's Guide.

Mode (MODE)

Nom du mode qui définit les sessions sur l'unité utilisée lors de la réplication des données.

*NETATR: Le mode défini dans les attributs du réseau est utilisé.

nom-mode: Indiquez le nom du mode.
Vous pouvez entrer jusqu'à 8 caractères. Le nom doit commencer par une lettre majuscule (A à Z) ou un caractère spécial ($, # ou à). Il ne peut pas comprendre de blanc, signe plus (+), point (.)ou trait de soulignement (_). Pour plus d'informations, reportez-vous à la brochure APPC Programmer's Guide.

ID éloigné réseau (RMTNETID)

ID éloigné du réseau du système émetteur.

*LOC: L'ID éloigné de réseau associé au lieu éloigné est utilisé. S'il existe plusieurs ID éloignés de réseau associés au lieu éloigné, le système détermine lequel d'entre eux est utilisé.

*NETATR: L'ID éloigné du réseau figurant dans les attributs du réseau est utilisé.

*NONE: Aucun ID éloigné du réseau n'est utilisé.

ID-éloigné-réseau: Indiquez l'ID éloigné du réseau (jusqu'à 8 caractères).
Le nom doit commencer par une lettre majuscule (A à Z) ou un caractère spécial ($, # ou à). Il ne peut pas comprendre de blanc, signe plus (+), point (.)ou trait de soulignement (_). Pour plus d'informations, reportez-vous à la brochure APPC Programmer's Guide.

Nom lieu local (LCLLOCNAME)

Indique le nom du lieu local. Nom du lieu local qui identifie votre système auprès du système émetteur que vous ajoutez.

*LOC: Le nom du lieu local associé au lieu éloigné est utilisé.

*NETATR: La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.

nom-lieu-local: Indiquez le nom du lieu local (jusqu'à 8 caractères).
Le nom doit commencer par une lettre majuscule (A à Z) ou un caractère spécial ($, # ou à). Il ne peut pas comprendre de blanc, signe plus (+), point (.)ou trait de soulignement (_). Pour plus d'informations, reportez-vous à la brochure APPC Programmer's Guide.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SYSNAME: Le nom indiqué au paramètre SYSNAME est utilisé pour la description.
'description': Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

Exemple 1 : réplication hebdomadaire d'un système

ADDDIRSHD   SYSNAME(NYCITY)
            SCD( '92/05/01' '17:00:00' )
            FRQ(*WEEKLY)  TEXT('Réplication du système de New York')

Cette commande ajoute le système fournisseur NYCITY, qui commence à répliquer les données de répertoire vers le système local le 1er mai 1992 à 17:00. La fréquence de réplication est hebdomadaire (WEEKLY). La description du système de réplication est 'Réplication du système de New York'.

Exemple 2 : réplication horaire d'un système éloigné

ADDDIRSHD   SYSNAME(CHICAGO)
            SCD('92/04/01' '20:00:00')
            FRQ(*HOURS)  HOURS(12)  RMTLOCNAME(CHIC01)
            LCLLOCNAME(CHICAGO1)  TEXT('Réplication sys Chicago')

Cette commande ajoute le système CHICAGO, qui commence à répliquer les données de répertoire vers le système local le 1er avril 1992 à 20:00. Fréquence de réplication : toutes les 12 heures. La description du système de réplication est 'Réplication du système de Chicago'. Le nom de lieu éloigné du système de CHICAGO est CHIC01 et le nom de lieu local, CHICAGO1.

Messages d'erreur

Messages *ESCAPE

CPF90A8: Droit spécial *SECADM exigé pour l'exécution de l'opération demandée.
CPF90FE: Echec d'ajout ou de modification d'émetteur de réplication &1.
CPF905C: Erreur lors de la recherche d'une table de conversion.
CPF9838: Limite mémoire du profil utilisateur dépassée.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.