CPYTODIR

Copier dans le répertoire

En bref

La commande CPYTODIR (Copier dans le répertoire) permet de copier des données du répertoire de distribution du système à partir d'une bande ou d'une disquette vers le système local.

CPYTODIR se lit CPY (Copier) + TODIR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CPYTODIR LABEL(…) DEV(…)

Paramètres

LABEL Label du fichier obligatoire
DEV Unité obligatoire
AUTOINZ Initialisation automatique
RPLDTA Remplacer les données
VOL Identificateur de volume
SEQNBR Numéro de séquence
ENDOPT Option fin de bande

Astuce : dans une session 5250, tapez CPYTODIR 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 CPYTODIR (Copier dans le répertoire) permet de copier des données du répertoire de distribution du système à partir d'une bande ou d'une disquette vers le système local. Les données copiées sont créées à l'aide de la commande CPYFRMDIR sur un système éloigné. Une relation de réplication peut alors s'établir, le système local effectuant une réplication sur les modifications apportées aux données de répertoire en provenance du système éloigné.

Attention : N'utilisez pas cette commande comme un utilitaire de sauvegarde permettant de restaurer les données à des fins de reprise. Les procédures de sauvegarde et de reprise sont décrites dans la brochure Reprise du système, SC41-5304.

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
LABEL	Label du fichier	Valeur caractère	Obligatoire, positionnel 1
DEV	Unité	Values (jusqu'à 4 répétitions): Nom	Obligatoire, positionnel 2
AUTOINZ	Initialisation automatique	YES, NO	Facultatif
RPLDTA	Remplacer les données	YES, NO	Facultatif
VOL	Identificateur de volume	Valeurs uniques: NONE Autres valeurs (jusqu'à 50 répétitions): Valeur caractère*	Facultatif
SEQNBR	Numéro de séquence	1-9999, *NEXT	Facultatif
ENDOPT	Option fin de bande	REWIND, LEAVE, *UNLOAD	Facultatif

Label du fichier (LABEL)

Nom du fichier sur l'unité de bande ou de disquette utilisée pour la copie. Les nombres maximaux de caractères admis pour une unité de bande et une unité de disquette sont respectivement 17 et 8.

Ce paramètre est obligatoire.

Unité (DEV)

Noms des unités de bande ou de disquette utilisées pour la copie. Une description doit avoir été attribuée préalablement à chacune de ces unités.

nom-unité-bande: Indiquez le nom d'une ou de plusieurs unités de bande utilisée(s) pour la copie. Si vous avez recours à plusieurs unités de bande, indiquez-les dans l'ordre de leur utilisation. Si vous utilisez plusieurs volumes de bande, vous pouvez avoir recours à plusieurs unités afin de rembobiner ou de décharger un volume pendant qu'une autre unité traite le volume suivant.
nom-unité-disquette: Indiquez le nom de l'unité de disquette utilisée pour la copie.

Ce paramètre est obligatoire.

Initialisation automatique (AUTOINZ)

Permet d'indiquer si les informations copiées sur ce système doivent être automatiquement répercutées dans d'autres systèmes récepteurs par réplication de répertoire.

*YES: Les postes de répertoire copiés sont automatiquement transmis aux autres systèmes récepteurs.
*NO: Les postes de répertoire copiés ne sont pas transmis aux autres systèmes récepteurs déjà initialisés.

Remplacer les données (RPLDTA)

Permet d'indiquer si vous souhaitez remplacer un poste du répertoire sur le système local par les données de répertoire copiées à partir d'une bande ou d'une disquette.

*NO: Les données copiées à partir d'une bande ou d'une disquette ne viennent pas se substituer aux postes de répertoire existant déjà sur le système.
*YES: Toutes les données de répertoire copiées à partir d'une bande ou d'une disquette viennent se substituer aux postes existant déjà sur le système pour un utilisateur.

Identificateur de volume (VOL)

Indique un ou plusieurs identificateurs de volume utilisés par le fichier.

*NONE: Aucun identificateur de volume n'est indiqué pour le fichier. Il n'y a pas de vérification d'identificateur de volume.
identificateur-volume: Indiquez les identificateurs de volume d'un ou plusieurs volumes en respectant l'ordre dans lequel ils sont placés dans l'unité, ainsi que l'ordre dans lequel ils sont utilisés pour la copie.

Numéro de séquence (SEQNBR)

Numéro de séquence à quatre positions du fichier de données sur la bande en cours de traitement. La lecture de ce numéro s'effectue à partir du premier label de début du fichier de données.

*NEXT: La copie débute sur le fichier suivant indiqué sur le volume de bande. Si la bande est positionnée avant le premier fichier, ce dernier est traité.
numéro-séquence-fichier: Indiquez le numéro de séquence du fichier utilisé. Les valeurs admises sont comprises entre 1 et 9999.

Option fin de bande (ENDOPT)

Indique l'opération qui doit automatiquement faire suite à une opération donnée sur le volume de bande. Si plusieurs volumes sont impliqués, ce paramètre ne s'applique qu'au dernier volume utilisé, les volumes précédents étant tous rembobinés et déchargés en fin de bande.

*REWIND: A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE: La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

*UNLOAD: La bande est automatiquement rembobinée et déchargée à la fin de l'opération.

Exemples

CPYTODIR   DEV(DKT01)  AUTOINZ(*YES)  RPLDTA(*NO)

Cette commande copie toutes les données du répertoire de DKT01 vers le système local. Les données qui sont copiées sur le système local sont communiquées aux autres systèmes utilisant les communications afin de réaliser une initialisation de réplication de répertoires ou une réplication de répertoires classique. Les données du système local qui sont identifiées comme étant identiques aux données de la disquette ne sont pas remplacées.

Messages d'erreur

Messages *ESCAPE

CPF90A8: Droit spécial *SECADM exigé pour l'exécution de l'opération demandée.
CPF90FB: Les données de répertoire n'ont pas été copiées en raison d'erreurs.