CHGDIRSHD

Modifier syst en réplication

En bref

Cette commande permet de modifier le système défini pour la réplication.

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

Syntaxe minimale

CHGDIRSHD SYSNAME(…)

Paramètres

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

Astuce : dans une session 5250, tapez CHGDIRSHD 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

Cette commande permet de modifier le système défini pour la réplication.

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, clé, positionnel 1
NXTSHD	Réplication suivante	Valeurs uniques: CURRENT, SCD, SAME Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Date	Date
	Élément 2: Heure	Heure
SCD	Réplication planifiée	Valeurs uniques: CURRENT, SAME 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, *SAME	Facultatif
HOURS	Intervalles (en heures)	1-999, *SAME	Facultatif
SKIPDAY	Jours à sauter	Valeurs uniques: NONE, SAME Autres valeurs (jusqu'à 5 répétitions): SUN, MON, TUE, WED, THU, FRI, *SAT	Facultatif
MONTHWK	Semaine (du mois)	4, LAST, SAME	Facultatif
REINZ	Réinitialiser les données	Valeurs uniques: NONE, NONAPPC, SAME Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Méthode	*APPC
	Élément 2: Remplacer les données	NO, YES, *SAME
RMTLOCNAME	Nom lieu éloigné	Valeur caractère, SYSNAME, SAME	Facultatif
MODE	Mode	Valeur caractère, NETATR, SAME	Facultatif
RMTNETID	ID éloigné réseau	Valeur caractère, LOC, NETATR, NONE, SAME	Facultatif
LCLLOCNAME	Nom lieu local	Valeur caractère, LOC, NETATR, *SAME	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SYSNAME, SAME	Facultatif

Nom de système (SYSNAME)

Nom du système (jusqu'à 8 caractères) qui émet des données au système local et que vous modifiez. 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 suivante (NXTSHD)

Date et heure de la réplication suivante. Celles-ci sont identiques à la date de réplication planifiée, sauf si une nouvelle tentative a été effectuée ou si une date de prochaine réplication est ajoutée à la date de réplication planifiée.

*SAME: La valeur reste inchangée.
*CURRENT: La date et l'heure en cours sont utilisées.
*SCD: La date et l'heure planifiées sont utilisées.

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

date-réplication-suivante: Indiquez la date à laquelle le système débute la réplication suivante. Respectez le format de date du travail.

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

heure-réplication-suivante

Indiquez l'heure à laquelle le système débute la réplication suivante.

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.

Réplication planifiée (SCD)

Date et heure de la réplication planifiée.

*SAME: La valeur reste inchangée.
*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 la réplication des données dans 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 la réplication des données dans 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 modifié 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.

*SAME: La valeur reste inchangée.
*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é.

*SAME: La valeur reste inchangée.
nombre-heures: Indiquez le nombre d'heures s'écoulant entre chaque réplication.

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é.

*SAME: La valeur reste inchangée.
*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.

*SAME: La valeur reste inchangée.
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éinitialiser les données (REINZ)

Méthode utilisée en cas de répétition de la première réplication. Celle-ci porte sur la totalité des données du répertoire de distribution du système. Les réplications postérieures ne concernent que les données modifiées depuis la précédente réplication.

Les valeurs possibles de l'invite Méthodesont les suivantes :

*SAME: La valeur reste inchangée.
*NONE: Le répertoire dans lequel est effectuée la réplication n'est pas réinitialisé.
*NONAPPC: La commande CPYTODIR (Copier dans le répertoire) est utilisée pour réinitialiser le répertoire.
*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 monopoliser 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.

Lorsque la valeur *APPC est précisée à la zone Méthode, les valeurs possibles de Remplacer les données sont les suivantes :

*SAME: La valeur reste inchangée.
*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.

Nom lieu éloigné (RMTLOCNAME)

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

*SAME: La valeur reste inchangée.
*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.

*SAME: La valeur reste inchangée.

*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.

*SAME: La valeur reste inchangée.
*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é de réseau n'est utilisé.
ID-éloigné-réseau: Indiquez l'ID éloigné de réseau (jusqu'à 8 caractères).
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.

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 modifiez.

*SAME: La valeur reste inchangée.
*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).
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 comporter 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.

*SAME: La valeur reste inchangée.
*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 : modification de la date et de l'heure de la réplication suivante

CHGDIRSHD   SYSNAME(NYCITY)
            NXTSHD('93/05/01' '8:00:00')

Cette commande change l'occurrence suivante de la réplication pour le système NYCITY. Elle n'affecte pas la date et l'heure programmées. Une fois que la réplication de ce système est terminée, la date et l'heure de la réplication suivante est calculée à partir des date et heure programmées. Cette commande est utilisée pour les modifications ponctuelles des planifications de réplications.

Exemple 2 : modification de la date et de l'heure de réplication

CHGDIRSHD   SYSNAME(NEWYORK)
            SCD('93/06/01' '20:00:00')
            FRQ(*BIWEEKLY)

Cette commande change la date de réplication programmée pour le système NEWYORK et la remplace par le 1er juin 1993 à 20:00. La fréquence de la réplication est bi-hebdomadaire.

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.