CPYTOARCF

Copier dans fichier archive

En bref

La commande CPYTOARCF (Copier dans fichier archive) permet de copier et compresser des données de fichier et des informations de répertoire dans un fichier archive.

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

Syntaxe minimale

CPYTOARCF FROMFILE(…) TOARCF(…)

Paramètres

FROMFILE Fichier ou répertoire source obligatoire
TOARCF Fichier archive cible obligatoire
SUBTREE Branche du répertoire
COMMENT Commentaire

Astuce : dans une session 5250, tapez CPYTOARCF 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 CPYTOARCF (Copier dans fichier archive) permet de copier et compresser des données de fichier et des informations de répertoire dans un fichier archive. Les informations contenues dans le fichier archive peuvent être décompressées et copiées à nouveau à l'aide de la commande CPYFRMARCF (Copier depuis fichier archive). Le fichier archive peut également être décompressé sur d'autres plateformes de système d'exploitation à l'aide de n'importe quel outil de décompression de fichier archive.

Restrictions :

Vous devez disposer au minimum du droit de lecture (*R) sur le fichier ou le répertoire à archiver. Vous devez également disposer au minimum du droit de lecture (*R) sur chacun des répertoires du chemin qui précèdent ce fichier ou ce répertoire.
Vous devez disposer au minimum du droit d'écriture (*W) sur le répertoire dans lequel le fichier archive compressé sera écrit.
Le fichier archive spécifié au paramètre Fichier archive cible (TOARCF) doit se trouver dans l'un des systèmes de fichiers suivants : QOpenSys, "root", ou dans un système de fichiers défini par l'utilisateur.
Si la valeur spécifiée au paramètre Fichier ou répertoire source (FROMFILE) correspond au nom de chemin d'une bibliothèque se trouvant dans le système de fichiers QSYS.LIB, tous les objets de cette bibliothèque doivent être des fichiers qui peuvent être lus à l'aide des procédures d'API de système de fichiers intégré. Sinon, le message d'erreur CPFC805 est envoyé et la commande échoue.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMFILE	Fichier ou répertoire source	Chemin d'accès	Obligatoire, positionnel 1
TOARCF	Fichier archive cible	Chemin d'accès	Obligatoire, positionnel 2
SUBTREE	Branche du répertoire	NONE, ALL	Facultatif
COMMENT	Commentaire	Valeur caractère, *BLANK	Facultatif

Fichier ou répertoire source (FROMFILE)

Indique le fichier ou le répertoire à archiver. Si le nom de chemin d'un fichier est spécifié, les données de fichier sont copiées et stockées au format compressé dans le fichier archive indiqué au paramètre Fichier archive cible (TOARCF). Si le nom de chemin d'un répertoire est spécifié, le fichier archive contiendra les informations de répertoire et une copie compressée des données de tous les fichiers du répertoire.

Ce paramètre est obligatoire.

nom-chemin

Indiquez le nom de chemin du fichier ou du répertoire à archiver. Les caractères génériques ne sont pas admis dans le nom de chemin. Le nom de fichier ou de répertoire peut être un nom de chemin absolu ou relatif (vers le répertoire de travail en cours).

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Fichier archive cible (TOARCF)

Indique le fichier archive dans lequel les données compressées seront archivées. Le fichier spécifié doit déjà exister. Sinon, le message d'erreur CPFC806 est envoyé et la commande échoue.

Ce paramètre est obligatoire.

nom-chemin

Indiquez le nom de chemin du fichier archive qui sera créé pour stocker les données compressées. Les caractères génériques ne sont pas admis dans le nom de chemin. Le nom de fichier peut être un nom absolu ou relatif (vers le répertoire de travail en cours).

Branche du répertoire (SUBTREE)

Permet d'indiquer si les fichiers doivent être archivés dans n'importe quels sous-répertoires, si un répertoire est spécifié au paramètre FROMFILE.

*NONE: Si le répertoire spécifié comporte des sous-répertoires, les fichiers contenus dans ces sous-répertoires ne seront pas archivés.
*ALL: Si le répertoire spécifié comporte des sous-répertoires, les fichiers contenus dans tous ces sous-répertoires seront archivés.

Commentaire (COMMENT)

Indique le texte à inclure dans le fichier archive.

*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Indiquez un commentaire destiné à être stocké dans le fichier archive. Vous ne devez pas taper plus de 512 caractères.

Exemples

Exemple 1 : Archivage d'un fichier volumineux

CPYTOARCF   FROMFILE('/QSYS.LIB/MYLIB.LIB/BIGSAVF.FILE')
            TOARCF('/MYDIR/MyArchiveFile.zip')
            COMMENT('Archive of my large save file')

Cette commande permet de copier les données du fichier BIGSAVF qui se trouve dans la bibliothèque MYLIB, et de stocker ces données au format compressé dans le fichier archive MyArchiveFile.zip qui sera créé dans le répertoire MYDIR. Le fichier archive contiendra également le commentaire 'Archive of my large save file'.

Exemple 2 : Archivage d'un répertoire

CPYTOARCF   FROMFILE('/DIR1/DIR2')
            TOARCF('/MYDIR/dir2archive.zip')
            SUBTREE(*NONE)

Cette commande permet de copier les informations du répertoire DIR2, y compris tous les fichiers que ce répertoire contient, et de stocker ces informations dans le fichier archive dir2Archive.zip qui sera créé dans le répertoire MYDIR. Si le répertoire DIR2 comporte des sous-répertoires, aucun des fichiers contenus dans ces sous-répertoires ne sera inclus dans le fichier archive.

Exemple 3 : Archivage d'un répertoire et de sa branche

CPYTOARCF   FROMFILE('/DIR1/DIR3')
            TOARCF('/MYDIR/dir3archive.zip')
            SUBTREE(*ALL)

Cette commande permet de copier les informations du répertoire DIR3, y compris tous les fichiers que ce répertoire contient, et de stocker ces informations dans le fichier archive dir3Archive.zip qui sera créé dans le répertoire MYDIR. Si le répertoire DIR3 comporte des sous-répertoires, tous les fichiers contenus dans ces sous-répertoires seront inclus dans le fichier archive.

Messages d'erreur

Messages *ESCAPE

CPFC801: Le paramètre transmis pour les fichiers à archiver n'est pas admis (code raison &1).
CPFC802: La taille du fichier &1 est supérieure à 4 294 967 295 octets et ne peut pas être compressée.
CPFC803: La valeur spécifiée pour le paramètre de nom d'archive correspond à un répertoire.
CPFC804: LA taille compressée du fichier est supérieure à 4 294,967,295 octets. La compression ne peut pas être exécutée.
CPFC805: Un fichier qui ne convient pas pour une opération de compression a été détecté. La compression ne peut pas être exécutée.
CPFC806: Le nom d'archive &1 existe sur le système.
CPFC811: Fichier archive non créé.