CPYOPT

La commande CPYOPT permet de copier un fichier particulier, tous les fichiers ou les fichiers nouveaux ou modifiés d'un répertoire indiqué dans un autre répertoire ou dans un autre volume optique. Cette commande permet également d'effectuer les opérations suivantes :

• Création d'un répertoire dans lequel les fichiers doivent être copiés.
• Copie de tous les sous-répertoires et des fichiers correspondants à partir d'un répertoire indiqué.
• Remplacement d'un fichier existant par un fichier du même nom.

Si le volume d'origine ou le volume cible est un volume optique de sauvegarde, les noms des répertoires, des sous-répertoires et des fichiers ne changent pas lors de la copie tout comme les dates et heures de création et de modification d'un répertoire, d'un sous-répertoire ou d'un fichier.

Restriction :

• Pour utiliser cette commande, vous devez disposer du droit *USE sur la liste d'autorisation applicable au volume en cours de copie (FROMVOL) et du droit *CHANGE sur la liste d'autorisation applicable au nouveau volume (TOVOL).
• Seul un utilisateur disposant du droit spécial de sauvegarde du système (*SAVSYS) peut utiliser cette commande.

Paramètres

ID volume d'origine (FROMVOL)

Indique l'identificateur et le type du volume optique qui contient les répertoires et les fichiers en cours de copie.

Elément 1 : Volume

Identificateur-de-volume

Indiquez l'identificateur du volume qui contient les répertoires et les fichiers en cours de copie.

Elément 2 : Type de volume

*PRIMARY

Indique un volume optique principal.

*BACKUP

Indique un volume optique de sauvegarde.

Chemin d'origine (FROMPATH)

Indique le chemin du répertoire ou du fichier en cours de copie à partir du volume d'origine. Dans le cas d'un répertoire, tous les fichiers de celui-ci sont copiés. Dans le cas d'un fichier, seul celui-ci est copié.

ID volume de destination (TOVOL)

Indique l'identificateur et le type du volume optique dans lequel les répertoires et les fichiers sont copiés.

Elément 1 : Volume

*FROMVOL

L'identificateur est identique à celui du volume optique à partir duquel les objets sont copiés.

Identificateur-de-volume

Indiquez le nom du volume optique dans lequel les objets sont copiés.

Elément 2 : Type de volume

*PRIMARY

Indique un volume optique principal.

*BACKUP

Indique un volume optique de sauvegarde. Vous pouvez utiliser un nouveau volume de sauvegarde ou un volume de sauvegarde déjà utilisé lors de la copie des objets. Pour plus de détails sur les volumes de sauvegarde, reportez-vous au manuel Optical Support, SC41-4310.

Chemin de destination (TOPATH)

Indique le chemin du fichier à écrire ou celui du répertoire devant recevoir le nouveau fichier sur le volume cible commençant par le répertoire root du volume.

*FROMPATH

Le chemin est identique à celui des fichiers ou des répertoires en cours de copie à partir du volume d'origine.

'nom-chemin'

Indiquez le chemin du répertoire devant recevoir les fichiers copiés ou celui du fichier à écrire.

Fichiers à copier (SLTFILE)

Indique le mode de sélection des fichiers ou des répertoires pour la copie. Si les fichiers ne sont pas copiés à partir de la valeur SLTFILE indiquée, il ne s'agit pas d'un cas d'erreur. Dans le message d'achèvement, les fichiers sont considérés comme ne pouvant pas être copiés mais la commande se poursuit sans erreurs.

*CHANGED

Le fichier est copié si la date et l'heure correspondant à la dernière modification du fichier du volume d'origine sont postérieures à celles du fichier du volume cible. Deux ensembles de date et d'heure déterminent si un fichier a été modifié : la date et l'heure de la dernière modification du fichier ou la date et l'heure de la dernière modification des attributs de fichier. Vous pouvez afficher ces dates et heures en indiquant DATA(*FILATR) dans la commande DSPOPT (Afficher un volume optique).

*ALL

Tous les fichiers sont copiés. Les fichiers existant sur le volume cible sont remplacés même si les dates sont identiques.

*NEW

Les fichiers ne sont copiés que s'ils n'existent pas sur le volume cible.

Copier les sous-répertoires (CPYSUBDIR)

Indique si les fichiers des sous-répertoires doivent être copiés.

*NO

Les sous-répertoires et fichiers de sous-répertoires ne sont pas copiés.

*YES

Les fichiers des sous-répertoires sont copiés. Les sous-répertoires sont créés sur le volume cible s'ils n'existent pas. Le nom des nouveaux sous-répertoires est identique à celui qu'ils portaient sur le volume cible, même si le nom de répertoire parent peut être différent.

Un contrôle est effectué avant la copie pour vérifier que le nouveau nom de chemin ne dépasse pas le nombre maximal de caractères admis. Un autre contrôle est effectué pour vérifier qu'aucune tentative de copie de tous les sous-répertoires d'un répertoire dans un sous-répertoire de ce répertoire sur le même volume n'est en cours.

Créer le répertoire (CRTDIR)

Indique si le dernier répertoire du chemin de destination est créé ou non s'il n'existe pas sur le volume cible. La présence de tous les éléments du chemin de destination à l'exception du dernier est vérifiée avant le lancement de la demande CPYOPT.

Remarque :Si le volume cible ou le volume d'origine est initialisé comme un volume optique de type sauvegarde, ce paramètre n'est pas pris en compte.

*NO

Le dernier répertoire du chemin de destination n'est pas créé s'il n'existe pas sur le volume cible.

*YES

Le dernier répertoire du chemin de destination est créé s'il n'existe pas sur le volume cible. Ce paramètre ne désigne que le répertoire dans lequel les fichiers ou les répertoires sont copiés et ne s'applique pas aux sous-répertoires du répertoire. Le paramètre CPYSUBDIR permet de vérifier si les sous-répertoires sont créés.

Copie permise sur autre face (ALWCPYOPP)

Indique si la copie des fichiers ou des répertoires d'un volume depuis une face de la cartouche optique sur l'autre face est admise.

Remarque :La copie de grandes quantités de données sur l'autre face d'une cartouche optique affecte la performance du système.

*NO

La copie n'est pas effectuée si le volume cible se trouve sur l'autre face du volume d'origine. Vous pouvez utiliser cette valeur pour éviter de copier par inadvertance des données sur l'autre face d'une cartouche optique.

*YES

La copie est effectuée si le volume cible se trouve sur l'autre face du volume d'origine.

Remarque :Cette valeur n'est pas admise si la cartouche optique du volume d'origine ou du volume cible a été initialisée comme un volume optique de type sauvegarde.

Option de copie (COPYTYPE)

Indique le type de traitement à utiliser pour la demande de copie.

*IOP

Le processeur d'entrée-sortie copie les données d'un volume sur l'autre en déplaçant un minimum de données. Si deux volumes sont requis, deux unités de la bibliothèque optique sont allouées tout au long de la copie.

Remarque :Le fait d'indiquer COPYTYPE(*IOP) permet de tirer le meilleur parti de la demande de copie ; cependant, cette valeur peut affecter les performances interactives des demandes au niveau des autres volumes de la bibliothèque optique car deux unités optiques de cette dernière sont allouées tout au long de la copie.

*SYSTEM

Le système copie les données à l'aide des ressources disponibles. Ce type de traitement est automatiquement utilisé lorsque :

• une seule unité est opérationnelle
• les deux volumes sont dans des bibliothèques optiques distinctes
• les deux volumes sont sur des faces opposées de la même cartouche optique
• le format de support d'un des volumes est UDF (Universal Disk Format)
• les jeux de caractères codés des volumes sont différents

Cette valeur est recommandée lorsque des demandes interactives sont lancées sur des volumes de la bibliothèque optique lors de la copie.

Date et heure de début (FROMTIME)

Indique une date et une heure de début permettant de vérifier si un fichier ou un répertoire est sélectionné pour la copie. Tous les fichiers et répertoires qui ont été créés ou modifiés ou dont les attributs ont été modifiés à la date et à l'heure de début ou après celles-ci sont sélectionnés pour la copie. Ce paramètre n'est pas pris en compte en cas de copie d'un seul fichier ou de copie d'un volume de sauvegarde vers un volume principal.

Vous pouvez déterminer la date de création ou de dernière modification d'un fichier en procédant comme suit :

1. Indiquez DATA(*FILATR) dans la commande DSPOPT (Afficher un volume optique).
2. Utilisez le programme QHFRTVA des API HFS. L'attribut standard QWRTDTTM désigne la date et l'heure de dernière modification du fichier. L'attribut étendu OPT.CHGATDTTM désigne la date et l'heure de dernière modification des attributs.

Elément 1 : Date de début

*BEGIN

Toutes les dates trouvées sont utilisées. Tous les fichiers et répertoires sont sélectionnés pour la copie.

date-début

Indiquez une date de début. Tous les fichiers créés ou modifiés à cette date ou après celle-ci sont sélectionnés.

La date doit être entrée au format indiqué par QDATFMT et, en cas d'utilisation de séparateurs, par QDATSEP.

Elément 2 : Heure de début

*AVAIL

Toutes les heures disponibles pour la date de début sont utilisées.

heure-début

Indiquez une heure qui sera utilisée comme heure de début ou date de début. Le séparateur d'heure est défini par la valeur système QTIMSEP comme suit :

• Si vous utilisez des séparateurs, entrez une chaîne de 5 ou 8 chiffres, où le séparateur indiqué pour votre travail délimite les heures, les minutes et les secondes. Si vous exécutez cette commande à partir de la ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un autre séparateur que celui indiqué pour votre travail, la commande échoue.
• Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), hh représentant les heures, mm les minutes et ss les secondes. Les valeurs admises pour hh sont comprises entre 00 et 23. Pour mm et ss, les valeurs admises sont comprises entre 00 et 59.

Exemples

Exemple 1 : Copie de tous les fichiers de tous les répertoires

CPYOPT   FROMVOL(VOL01)  FROMPATH('/')  TOVOL(VOL02)
         CPYSUBDIR(*YES)  SLTFILE(*ALL)  CRTDIR(*YES)

Cette commande copie tous les fichiers de tous les répertoires et sous-répertoires du volume optique VOL01 au volume optique VOL02. S'ils n'existent pas, les répertoires sont créés sur le volume VOL02. Les fichiers déjà existant sur le volume VOL02 sont remplacés.

Exemple 2 : Copie des fichiers modifiés

CPYOPT   FROMVOL(VOL01)  FROMPATH('/DIR1/DIR2')  TOVOL(VOL02)

Cette commande copie tous les fichiers modifiés dans le répertoire /DIR1/DIR2 vers les fichiers portant le même nom sur le volume optique VOL02.

Exemple 3 : Copie de fichiers depuis une sauvegarde sur un volume principal

CPYOPT   FROMVOL(VOL01BACKUP *BACKUP)  FROMPATH('/DIR1')
         TOVOL(VOL02)  CPYSUBDIR(*YES)

Cette commande copie tous les fichiers et sous-répertoires du répertoire /DIR1 du volume optique de sauvegarde VOL01BACKUP vers les fichiers portant le même nom sur le volume optique principal VOL02.

Messages d'erreur

*ESCAPE Messages

CPF222E

Le droit spécial &1 est requis.

OPT0147

Valeur de SLTFILE non admise pour l'opération.

OPT0149

CPYSUBDIR(*YES) incompatible avec la valeur de FROMPATH.

OPT0152

Heure de début incompatible avec FROMTIME(*BEGIN).

OPT1105

Fichier en lecture seule.

OPT1115

Fichier non trouvé.

OPT1120

Ce fichier existe déjà.

OPT1125

Fichier en cours d'utilisation.

OPT1129

Opération non admise sur fichier ouvert pour opération d'E-S avec extension de mémoire tampon.

OPT1130

Le nom de fichier indiqué est un nom de fichier réservé.

OPT1135

Echec de la demande : nombre maximal de fichiers ouverts atteint.

OPT1140

Erreur inattendue lors du traitement du fichier.

OPT1185

Impossible d'accéder au fichier optique suspendu.

OPT1205

Répertoire non trouvé.

OPT1212

Répertoire en cours d'utilisation.

OPT1220

Nom de fichier ou de répertoire déjà existant.

OPT1224

Longueur du nom de chemin supérieure à 256 octets.

OPT1255

Fichier altéré.

OPT1261

Fichier actif détecté sur le volume &1.

OPT1305

Volume optique &1 en lecture seule.

OPT1315

Le volume optique &1 est protégé contre l'écriture.

OPT1317

Nom de répertoire trop long.

OPT1320

Volume optique &1 en cours d'utilisation.

OPT1325

Format de volume optique non reconnu.

OPT1330

Volume optique non trouvé ou inutilisable.

OPT1331

Volume optique &1 non trouvé.

OPT1340

Volume optique &1 non initialisé.

OPT1344

Nom de fichier optique incorrect.

OPT1345

Aucun espace disponible sur le support.

OPT1346

Opération non admise pour un volume situé sur un lecteur de disque optique éloigné.

OPT1350

Echec de l'opération d'écriture sur le volume optique &1.

OPT1360

Répertoire de support endommagé sur le volume optique &1.

OPT1460

Le volume optique &1 ne se trouve pas dans un lecteur de disque optique.

OPT1462

Opération non exécutée : le volume optique n'est pas un volume de sauvegarde.

OPT1463

Opération non exécutée : le volume optique n'est pas un volume principal.

OPT1530

&1 n'est pas un lecteur de disque optique correct.

OPT1555

Lecteur de disque optique &1 en cours d'utilisation.

OPT1605

Erreur de support ou d'unité.

OPT1640

Erreur lors de la lecture de fichiers ou de répertoires.

OPT1790

Opération non admise ou incompatible avec une autre demande.

OPT1795

Erreur lors de l'accès à des attributs de répertoire.

OPT1805

Erreur lors de l'accès au fichier d'index des volumes optiques.

OPT1810

Erreur lors de l'accès au fichier d'index des répertoires optiques.

OPT1813

Une erreur inattendue s'est produite.

OPT1815

Erreur de programme interne.

OPT1820

Une erreur interne s'est produite sur le lecteur de disque optique &1.

OPT1821

Une erreur s'est produite sur le lecteur de disque optique &1.

OPT1825

Index optiques incorrects pour le lecteur de disque optique &1.

OPT1860

L'opération sur le lecteur de disque optique &1 n'a pas abouti.

OPT1861

Aucune description d'unité n'est configurée pour la ressource &1.

OPT1862

Aucune description d'unité active ne correspond à la ressource &1.

OPT1863

Les bibliothèques optiques doivent être récupérées.

OPT1872

Dépassement de délai ou annulation suite à une demande sur un lecteur de disque optique.

OPT2001

&1 fichiers copiés ; &2 fichiers ou répertoires non copiés ; copie de &8 fichiers impossible.

OPT2004

Fin anormale de la copie. &1 fichiers copiés.

OPT2005

Aucun fichier n'a été trouvé dans le répertoire.

OPT2006

Chemin du répertoire trop long.

OPT2007

TOVOL est sur la face opposée de FROMVOL.

OPT2008

Demande de copie non admise.

OPT2009

Copie non admise à partir d'un volume de sauvegarde.

OPT2010

Copie non admise vers un volume de sauvegarde.

OPT2015

Fichier non copié.

OPT2028

Copie sur un volume de sauvegarde non admise pour les volumes optiques indiqués.

OPT2029

TOVOL est sur la face opposée de FROMVOL.

OPT2040

Erreur lors de l'accès au fichier de contrôle de sauvegarde.

OPT2301

Objet système interne en cours d'utilisation.

OPT2420

Accès au volume optique &2 refusé.

OPT2422

Non autorisé sur ce fichier ou ce répertoire.

OPT7740

Utilisateur non autorisé pour l'objet &2, bibliothèque &3, de type &4.