MOV

Déplacer un objet

En bref

La commande Déplacer un objet (MOV) déplace un objet d'un répertoire vers un autre.

Syntaxe minimale

MOV OBJ(…)

Paramètres

OBJ Objet obligatoire
TODIR Répertoire de destination
TOOBJ Objet de destination
FROMCCSID CCSID d'origine
TOCCSID CCSID de destination
DTAFMT Format de données
FROMCODPAG Page de codes d'origine
TOCODEPAGE Page de codes de destination

Astuce : dans une session 5250, tapez MOV 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 Déplacer un objet (MOV) déplace un objet d'un répertoire vers un autre.

Si le paramètre Répertoire de destination (TODIR) est utilisé, l'objet change de répertoire mais pas de nom. Avec le paramètre Objet de destination (TOOBJ), l'objet est également rebaptisé.

Si l'objet d'origine est un fichier en lecture seulement (un fichier dont le repère de l'attribut lecture seulement du PC est en fonction), la commande de déplacement fonctionne comme suit :

Si le fichier d'origine peut être supprimé (son bit de lecture seulement pouvant être mis hors fonction), le déplacement aboutit et l'attribut lecture seulement du fichier est maintenu.
Si le fichier d'origine ne peut pas être supprimé (par exemple, un fichier de CD-ROM), l'opération échoue et un message est généré pour indiquer que l'objet source est en lecture seulement.

Lorsqu'un fichier est déplacé dans un système de fichiers, la date et l'heure de dernier accès, de modification de données et de modification d'attributs sont conservées dans le nouveau fichier. Lorsque le fichier est déplacé hors du système de fichiers d'origine vers les systèmes de fichiers "racine" (/), QOpenSys, QDLS ou UDFS, la date et l'heure de modification des attributs sont mises à jour en fonction de l'heure en cours. Dans le cas d'un déplacement vers un membre fichier base de données (*MBR) d'un système de fichiers QSYS.LIB ou QSYS.LIB d'ASP indépendant, la zone Date/heure modification données est mise à jour également.

Cette commande est équivalente à la commande suivante :

MOVE

Pour plus d'informations sur les commandes du système de fichiers intégré, reportez-vous aux Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Le répertoire de destination ne doit pas déjà contenir le nom indiqué au paramètre TOOBJ (ou, lorsque TODIR est utilisé, le nom indiqué au paramètre OBJ).
Seuls les objets de type fichier STREAM peuvent être déplacés depuis un système de fichiers vers un autre.
Un répertoire ne peut pas être déplacé dans un sous-répertoire.
Les membres d'un fichier base de données ne peuvent pas être déplacés.
Dans QDLS, aucun objet ne peut être déplacé d'un ASP vers l'autre.
Dans QSYS.LIB d'ASP indépendant, aucune bibliothèque ne peut être déplacée vers des pools de mémoire secondaire de base (ASP). Cependant, des bibliothèques de QSYS.LIB d'ASP indépendant peuvent être déplacées vers l'ASP système ou d'autres ASP indépendants.
La commande de déplacement ne copie pas les droits privés des objets lorsqu'ils sont déplacés d'un système de fichiers à un autre.

Remarque :Les droits requis pour cette commande sont complexes concernant les systèmes de fichiers, les types d'objet, les opérations demandées, etc. Pour toute information sur les droits requis pour cette commande, consultez le manuel IBM i Security Reference, SC41-5302

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Chemin d'accès	Obligatoire, positionnel 1
TODIR	Répertoire de destination	Chemin d'accès, '.'	Facultatif, positionnel 2
TOOBJ	Objet de destination	Chemin d'accès	Facultatif
FROMCCSID	CCSID d'origine	1-65533, OBJ, PCASCII, *JOBCCSID	Facultatif
TOCCSID	CCSID de destination	1-65533, OBJ, CALC, STDASCII, PCASCII, *JOBCCSID	Facultatif
DTAFMT	Format de données	BINARY, TEXT	Facultatif
FROMCODPAG	Page de codes d'origine	1-32767, OBJ, PCASCII	Facultatif
TOCODEPAGE	Page de codes de destination	1-32767, OBJ, CALC, STDASCII, PCASCII	Facultatif

Objet (OBJ)

Indique le nom de chemin du ou des objets à déplacer.

Il peut s'agir d'un nom simple ou d'un nom qualifié indiquant le nom du répertoire contenant l'objet. Vous pouvez indiquer un masque pour la dernière partie du nom. Un astérisque (*) correspond à un nombre quelconque de caractères, alors qu'un point d'interrogation (?) correspond à un caractère unique. Si le nom est qualifié ou contient un masque, il doit être placé entre apostrophes (').

Remarque :Il n'est possible d'utiliser un masque pour déplacer plusieurs objets que lorsque le paramètre Répertoire de destination (TODIR) est précisé.

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 nom de chemin du répertoire dans lequel l'objet doit être déplacé. Le nouvel objet prend le nom indiqué au paramètre Objet (OBJ).

.: L'objet est déplacé dans le répertoire en cours.
nom-répertoire: Indiquez le nom du répertoire dans lequel l'objet doit être déplacé.
Remarque :Les paramètres TODIR et Objet de destination (TOOBJ) sont incompatibles.

Objet de destination (TOOBJ)

Indique le nom de chemin du répertoire dans lequel l'objet doit être déplacé et le nouveau nom de ce dernier.

Remarque :Les paramètres Répertoire de destination (TODIR) et TOOBJ sont incompatibles.

CCSID d'origine (FROMCCSID)

Méthode permettant d'obtenir l'ID codé de jeu de caractères (CCSID) pour l'objet source de l'opération de déplacement. Ce CCSID sera utilisé pour la conversion de données, si nécessaire. Ce paramètre est ignoré si l'objet indiqué au paramètre Objet (OBJ) n'est pas un fichier standard (c'est-à-dire qui prend en charge les opérations d'entrée-sortie (E-S) du système de fichiers intégré : ouverture, lecture et écriture).

*OBJ: Utilisez le CCSID de données de l'objet à déplacer.
*PCASCII: Le CCSID de données de l'objet à déplacer est utilisé pour calculer un CCSID dans le schéma de codage Microsoft Windows (x4105) (Microsoft, Windows, Windows NT et le logo Windows 95 sont des marques de Microsoft Corporation). Il s'agit du CCSID à partir duquel les données seront converties lorsque DTAFMT(*TEXT) est indiqué. Cette option permet une conversion correcte des données des PC, si celles-ci ont été créées à l'aide de Microsoft Windows.
*JOBCCSID: Permet d'utiliser l'ID codé de jeu de caractères (CCSID) du CCSID du travail par défaut
1 à 65533: Indiquez une valeur de CCSID.

CCSID de destination (TOCCSID)

Permet d'indiquer l'ID codé de jeu de caractères (CCSID) pour l'objet cible de l'opération de déplacement. Ce paramètre est ignoré si l'objet indiqué au paramètre Objet (OBJ) n'est pas un fichier standard (c'est-à-dire qui prend en charge les opérations d'entrée-sortie (E-S) du système de fichiers intégré : ouverture, lecture et écriture).

*OBJ: Utilisez le CCSID de données de l'objet à déplacer. Si cette page de codes ne peut pas être utilisée par le système de fichiers vers lequel l'objet doit être déplacé, l'opération de déplacement échoue.
*CALC: Utilisez le CCSID de données de l'objet à déplacer. Si celui-ci ne peut pas être utilisé par le système de fichiers dans lequel l'objet doit être déplacé, laissez le système de fichiers déterminer un autre CCSID permettant d'effectuer l'opération.
*STDASCII: Un CCSID est calculé dans le schéma de codage de données PC IBM (x2100), en fonction du CCSID du fichier source. Associez ce CCSID à l'objet cible de l'opération de déplacement et, si DTAFMT(*TEXT) est indiqué, utilisez-le également pour la conversion de données. Si ce CCSID ne peut pas être utilisé par le système de fichiers dans lequel l'objet doit être copié, l'opération de déplacement échouera.
*PCASCII: Calculez un CCSID dans le schéma de codage Microsoft Windows (x4105), en fonction du CCSID du fichier source. Associez ce CCSID à l'objet cible de l'opération de déplacement et, si DTAFMT(*TEXT) est indiqué, utilisez-le également pour la conversion de données. Cette option permet aux applications Microsoft Windows d'utiliser les données résultantes. Si cette page de codes ne peut pas être utilisée par le système de fichiers vers lequel l'objet doit être déplacé, l'opération de déplacement échoue.
*JOBCCSID: Permet d'utiliser l'ID codé de jeu de caractères (CCSID) du CCSID du travail par défaut
1 à 65533: Indiquez une valeur de CCSID. Si ce CCSID ne peut pas être utilisé par le système de fichiers vers lequel l'objet est déplacé, l'opération de déplacement échoue.

Format de données (DTAFMT)

Indique le format des données contenues dans le fichier à déplacer.

*BINARY

Le fichier contient des données au format binaire (par exemple, un fichier exécutable). Les données ne sont pas converties lors du déplacement. Cependant, si le CCSID de l'objet à déplacer est différent de celui de l'objet source, tous les attributs étendus sont convertis dans le CCSID du nouvel objet avant d'être définis.

*TEXT

Le fichier contient des données au format texte. Lors du déplacement, les données sont converties dans le CCSID du nouvel objet. Les données sont alors traitées comme du texte.

Si un membre de base de données doit être déplacé vers un fichier STREAM, tous les caractères de formatage de ligne (retour chariot, tabulation, fin de fichier, etc.) sont convertis d'un CCSID à l'autre.

Si un déplacement est effectué dans le sens inverse, le fichier STREAM doit contenir des caractères de fin de ligne ; sinon l'opération échoue. Si ce fichier contient des caractères de fin de ligne, les actions ci-après sont exécutées au cours de l'opération de déplacement.

Les caractères de fin de ligne sont supprimés.
Les enregistrements sont complétés par des blancs (s'il s'agit d'un membre de fichier physique source) ou des caractères nuls (s'il s'agit d'un membre de fichier physique de données).
Les caractères de tabulation sont remplacés par le nombre approprié de blancs (permettant d'atteindre la position de tabulation suivante).

Page de codes d'origine (FROMCODPAG)

Méthode permettant d'obtenir la page de codes pour l'objet source de l'opération de déplacement. Cette page de codes sera utilisée pour la conversion de données, si nécessaire. Ce paramètre est ignoré si l'objet indiqué au paramètre Objet (OBJ) n'est pas un fichier standard (c'est-à-dire qui prend en charge les opérations d'entrée-sortie (E-S) du système de fichiers intégré : ouverture, lecture et écriture).

Remarque :Ce paramètre est remplacé par le paramètre CCSID d'origine (FROMCCSID), mais le paramètre FROMCODPAG peut néanmoins être utilisé. Cependant, il est préférable d'utiliser autant que possible le paramètre FROMCCSID, car CODEPAGE risque d'être supprimé dans une édition ultérieure.

*OBJ: La page de codes de données de l'objet à déplacer est utilisée.
*PCASCII: La page de codes de données de l'objet à déplacer est utilisée pour calculer une page de codes dans le schéma de codage Microsoft Windows (x4105) (Microsoft, Windows, Windows NT et le logo Windows 95 sont des marques de Microsoft Corporation). Il s'agit de la page de codes à partir de laquelle les données seront converties lorsque DTAFMT(*TEXT) est indiqué. Cette option permet une conversion correcte des données des PC, si celles-ci ont été créées à l'aide de Microsoft Windows.
1 à 32767: Indiquez une valeur de page de codes.

Page de codes de destination (TOCODEPAGE)

Indique la page de codes de données pour l'objet cible de l'opération de déplacement. Ce paramètre est ignoré si l'objet indiqué au paramètre Objet (OBJ) n'est pas un fichier standard (c'est-à-dire qui prend en charge les opérations d'entrée-sortie (E-S) du système de fichiers intégré : ouverture, lecture et écriture).

Remarque :Ce paramètre est remplacé par CCSID de destination (TOCCSID), mais le paramètre TOCODEPAGE peut néanmoins être utilisé. Cependant, il est préférable d'utiliser autant que possible le paramètre TOCCSID, car CODEPAGE risque d'être supprimé dans une édition ultérieure.

*OBJ: La page de codes de données de l'objet à déplacer est utilisée. Si cette page de codes ne peut pas être utilisée par le système de fichiers vers lequel l'objet doit être déplacé, l'opération de déplacement échoue.
*CALC: La page de codes de données de l'objet à déplacer est utilisée. Si celle-ci ne peut pas être utilisée par le système de fichiers dans lequel l'objet doit être déplacé, laissez le système de fichiers déterminer une autre page de codes permettant d'effectuer l'opération.
*STDASCII: Une page de codes est calculée dans le schéma de codage de données PC IBM (x2100), en fonction de la page de codes du fichier source. Associez cette page à l'objet cible de l'opération de déplacement et, si DTAFMT(*TEXT) est indiqué, utilisez-la également pour la conversion de données. Si cette page de codes ne peut pas être utilisée par le système de fichiers vers lequel l'objet doit être déplacé, l'opération de déplacement échoue.
*PCASCII: Une page de code est calculée dans le schéma de codage de Microsoft Windows (x4105), en fonction de la page de codes du fichier source. Associez cette page à l'objet cible de l'opération de déplacement et, si DTAFMT(*TEXT) est indiqué, utilisez-la également pour la conversion de données. Cette option permet aux applications Microsoft Windows d'utiliser les données résultantes. Si cette page de codes ne peut pas être utilisée par le système de fichiers vers lequel l'objet doit être déplacé, l'opération de déplacement échoue.
1 à 32767: Indiquez une valeur de page de codes. Si cette page de codes ne peut pas être utilisée par le système de fichiers vers lequel l'objet doit être déplacé, l'opération de déplacement échoue.

Exemples

Exemple 1 : Déplacement d'un objet

MOV   OBJ('/EN_COURS/FICHIER-PAIE-MENSUELLE_DECEMBRE-1994')
      TODIR('/ARCHIVE')

Cette commande déplace un fichier appelé FICHIER-PAIE-MENSUELLE_DECEMBRE-1994 depuis le répertoire EN_COURS vers le répertoire ARCHIVE.

Exemple 2 : Déplacement avec conversion

MOV   OBJ('/FICHB')
      TOOBJ('/QSYS.LIB/APP1.LIB/DATA.FILE/FICHB.MBR')
      TOCODEPAGE(*CALC)  DTAFMT(*TEXT)  TOCCSID(*CALC)

Le fichier STREAM FICHB est déplacé dans le fichier base de données FICHB.MBR. Avec TOCCSID(*CALC), le système de fichiers cible du déplacement (QSYS.LIB dans ce cas) tente de créer le nouveau membre dans le même CCSID que /FICHB. Si cela échoue (dans notre cas, si DATA.FILE n'est pas dans le même CCSID que FICHB, le système de fichiers est autorisé à sélectionner un CCSID approprié et à terminer le déplacement. Avec DTAFMT(*TEXT), les données de FICHB sont traitées en tant que texte et sont converties dans le CCSID choisi pour le nouveau fichier FICHB.MBR.

Messages d'erreur

Messages *ESCAPE

CPFA085: Répertoire initial de l'utilisateur &1 introuvable.
CPFA08E: Plusieurs noms correspondent au masque.
CPFA093: Aucun nom ne correspond au masque indiqué.
CPFA09C: Aucun droit sur l'objet. L'objet est &1.
CPFA09E: L'objet est en cours d'utilisation. L'objet est &1.
CPFA0A1: Erreur d'entrée ou de sortie.
CPFA0A7: Le nom de chemin est trop long.
CPFA0A9: Objet introuvable. L'objet est &1.
CPFA0B0: La demande ne fonctionne pas d'un système de fichiers à l'autre.
CPFA0B1: Opération demandée non admise. Incident d'accès.
CPFA0B2: Aucun objet ne correspond à la demande.
CPFA0B8: &3 objets déplacés. &4 objets en échec.
CPFA0C4: L'objet n'est pas un fichier. L'objet est &1.