CPYFRMARCF

Copier depuis fichier archive

En bref

La commande CPYFRMARCF (Copier depuis fichier archive) permet de décompresser les fichiers et les répertoires d'un fichier archive.

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

Syntaxe minimale

CPYFRMARCF FROMARCF(…) TODIR(…)

Paramètres

FROMARCF Fichier archive source obligatoire
TODIR Répertoire de destination obligatoire
RPLDTA Remplacer les données Replace data

Astuce : dans une session 5250, tapez CPYFRMARCF 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 CPYFRMARCF (Copier depuis fichier archive) permet de décompresser les fichiers et les répertoires d'un fichier archive. Le fichier archive peut avoir été créé sur un système IBM i à l'aide de la commande CPYTOARCF (Copier dans fichier archive) ou sur un autre système d'exploitation à l'aide de n'importe quel outil de création de fichier archive.

Restrictions :

Vous devez disposer du droit de lecture (*R) sur le fichier archive à décompresser. Vous devez également disposer du droit de lecture (*R) sur chacun des répertoires du chemin qui précèdent le nom de fichier.
Vous devez disposer du droit d'écriture et d'exécution (*WX) sur le répertoire dans lequel les fichiers décompressés seront écrits.
Le fichier archive 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.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMARCF	Fichier archive source	Chemin d'accès	Obligatoire, positionnel 1
TODIR	Répertoire de destination	Chemin d'accès	Obligatoire, positionnel 2
RPLDTA	Replace data	NO, YES	Facultatif

Fichier archive source (FROMARCF)

Indique le fichier archive à décompresser.

Ce paramètre est obligatoire.

nom-chemin

Indiquez le nom de chemin du fichier archive à décompresser. 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).

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

Répertoire de destination (TODIR)

Indique le répertoire dans lequel les fichiers décompressés seront écrits.

Ce paramètre est obligatoire.

nom-chemin

Indiquez le chemin d'accès au répertoire dans lequel les fichiers décompressés seront écrits. Si les fichiers contenus dans les sous-répertoires ont été copiés lors de la création du fichier archive, ils seront à nouveau copiés dans les mêmes sous-répertoires. Les caractères génériques ne sont pas admis dans le nom de chemin. Le nom de répertoire peut être un nom absolu ou relatif (vers le répertoire de travail en cours).

Replace data (RPLDTA)

Permet d'indiquer si les données contenues dans les fichiers existants doivent être ou non remplacées lors de la décompression du fichier archive.

*NO: Si le fichier archive contient les données d'un fichier qui existe déjà sur le système, ces données ne sont pas remplacées.
*YES: Si le fichier archive contient les données d'un fichier qui existe déjà sur le système, ces données sont remplacées. La propriété et les droits relatifs au fichier existant restent inchangés.

Exemples

Exemple 1 : Décompression d'un fichier archive et remplacement des fichiers existants dans une bibliothèque

CPYFRMARCF   FROMARCF('/MYDIR/MyArchiveFile.zip')
             TODIR('/QSYS.LIB/MYLIB.LIB/')
             RPLDTA(*YES)

Cette commande permet de décompresser les fichiers du fichier archive MyArchiveFile.zip contenu dans le répertoire MYDIR et de remplacer les données des fichiers existants dans la bibliothèque MYLIB. Si un fichier contenu dans le fichier archive n'existe pas dans la bibliothèque MYLIB, un fichier physique base de données est créé, et l'utilisateur qui effectue la décompression devient le propriétaire de ce fichier.

Exemple 2 : Décompression d'un fichier archive dans un répertoire sans remplacer les fichiers existants

CPYFRMARCF   FROMARCF('/MYDIR/dir2archive.jar')
             TODIR('/dir1/dir2/')
             RPLDTA(*NO)

Cette commande permet de décompresser les fichiers du fichier archive dir2archive.jar contenu dans le répertoire MYDIR et d'écrire les données dans des fichiers du répertoire dir2. Si un fichier contenu dans le fichier archive n'existe pas dans le répertoire dir2, il est créé, et l'utilisateur qui effectue la décompression obtient les droits de lecture, d'écriture et d'exécution (*RWX) sur ce fichier. Si un fichier contenu dans le fichier archive existe dans le répertoire dir2, il est ignoré et les données de fichier existantes ne sont pas remplacées.

Messages d'erreur

Messages *ESCAPE

CPFC807: Le paramètre transmis pour décompresser un fichier n'est pas admis (code raison &1).
CPFC808: La taille du fichier &1 est supérieure à 4 294,967,295 octets et ne peut pas être décompressée.
CPFC809: Le fichier &1 est endommagé et ne peut pas être décompressé.
CPFC810: Le fichier &1 détecté ne convient pas pour une opération de décompression. La décompression ne peut pas être exécutée.
CPFC812: Fichier archive non décompressé.