CPYFRMDIR

Copier à partir du répertoire

En bref

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

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

Syntaxe minimale

CPYFRMDIR LABEL(…) DEV(…)

Paramètres

LABEL Label du fichier obligatoire
DEV Unité obligatoire
SYSNAME Nom de système
VOL Identificateur de volume
SEQNBR Numéro de séquence
ENDOPT Option fin de bande
EXPDATE Date d'expiration du fichier

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

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é (*SECDAM) 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
SYSNAME	Nom de système	Values (jusqu'à 50 répétitions): Valeur caractère	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, *END	Facultatif
ENDOPT	Option fin de bande	REWIND, LEAVE, *UNLOAD	Facultatif
EXPDATE	Date d'expiration du fichier	Date, *PERM	Facultatif

Label du fichier (LABEL)

Nom qui identifie le 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é-disquette: Indiquez le nom de l'unité de disquette utilisée pour la copie.
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.

Ce paramètre est obligatoire.

Nom de système (SYSNAME)

Noms des systèmes éloignés qui copient les données du répertoire de distribution du système à partir des bandes ou disquettes créées à l'aide de cette commande. Ces noms sont ajoutés à la liste des systèmes qui collectent les modifications de données de répertoire effectuées à partir du système local.

Remarque :Vous devez indiquer le nom de tous les systèmes éloignés qui utilisent les bandes ou les disquettes créées à l'aide de cette commande, afin de garantir que toutes les modifications apportées aux données du répertoire sont envoyées aux systèmes éloignés au cours d'une session normale de réplication.

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 d'un ou plusieurs volumes en respectant l'ordre dans lequel ils sont placés dans une unité.

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.

*END: La copie commence après le dernier numéro de séquence figurant sur le volume de bande.
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.

Date d'expiration du fichier (EXPDATE)

Indique la date de péremption. Les fichiers ne peuvent pas être écrasés avant cette date. La date de péremption doit être égale ou postérieure à la date en cours.

*PERM: Le fichier de données est protégé en permanence. Sa date de péremption est 999999.
date-péremption: Indiquez la date à partir de laquelle le fichier n'est plus protégé.

Exemples

CPYFRMDIR   DEV(TAP01)  SYSNAME(CHICAGO NEWYORK)

Cette commande copie toutes les données du répertoire du système local vers l'unité de bande TAP01. CHICAGO et NEWYORK sont ajoutés à la liste des systèmes qui collectent les modifications dans les données du répertoire à partir du système local.

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.