MOVDOC

Déplacer un document

En bref

La commande MOVDOC (Déplacer un document) modifie le chemin que le système utilise pour rechercher un document.

MOVDOC se lit MOV (Déplacer) + DOC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

MOVDOC FROMDOC(…)

Paramètres

FROMDOC Document d'origine obligatoire
FROMFLR Dossier d'origine
TOFLR Dossier de destination
RENAME Rebaptiser
SYSOBJNAM Nom d'objet système

Astuce : dans une session 5250, tapez MOVDOC 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 MOVDOC (Déplacer un document) modifie le chemin que le système utilise pour rechercher un document. Le document n'est pas physiquement déplacé vers un autre emplacement de mémoire secondaire et aucun nouvel objet n'est créé.

Restrictions :

Vous devez être inscrit dans le répertoire du système et disposer du droit *ALL sur le document à déplacer et du droit *CHANGE (modification) sur les dossiers FROM et TO (s'il y a lieu).
Pour déplacer un document d'un ou vers un dossier, l'utilisateur doit disposer du droit *CHANGE sur le dossier.
Les documents ne peuvent pas être déplacés d'un dossier vers un autre si ces derniers se trouvent dans des pools de mémoire secondaire différents.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMDOC	Document d'origine	Valeur caractère, *SYSOBJNAM	Obligatoire, positionnel 1
FROMFLR	Dossier d'origine	Valeur caractère, *NONE	Facultatif, positionnel 2
TOFLR	Dossier de destination	Valeur caractère, *NONE	Facultatif, positionnel 3
RENAME	Rebaptiser	Valeur caractère, *SAME	Facultatif, positionnel 4
SYSOBJNAM	Nom d'objet système	Nom	Facultatif

Document d'origine (FROMDOC)

Nom du document à déplacer. Si un nom de document est précisé dans le paramètre FROMDOC, vous devez indiquer un nom de dossier dans le paramètre Dossier d'origine (FROMFLR). Si *SYSOBJNAM est précisé dans le paramètre FROMDOC, vous devez indiquer un nom d'objet système dans le paramètre Nom d'objet système (SYSOBJNAM).

Remarque :FROMFLR(nom) est obligatoire avec FROMDOC(nom). SYSOBJNAM(nom) et RENAME(nom) sont obligatoires avec If FROMDOC(*SYSOBJNAM).

Ce paramètre est obligatoire.

*SYSOBJNAM: Un nom d'objet système sert à identifier le document à déplacer. Ce paramètre doit être utilisé pour déplacer un document sans dossier et peut remplacer un nom de dossier ou de document lorsque le nom de l'objet système est connu.
nom: Indiquez le nom du document à déplacer.

Dossier d'origine (FROMFLR)

Nom du dossier d'où le document est déplacé. Ce nom est obligatoire si un nom de document est inscrit dans le paramètre Document d'origine (FROMDOC). FROMFLR(*NONE) n'est pas admis avec FROMDOC(nom).

*NONE: Le document à déplacer est indiqué par son nom d'objet système.
nom: Indiquez le nom du dossier contenant le document à déplacer.

Dossier de destination (TOFLR)

Nom du dossier dans lequel le document est déplacé. Ce nom est obligatoire si un nom de document est inscrit dans le paramètre Rebaptiser (RENAME).

*NONE: Le document devient un objet sans dossier auquel vous ne pourrez faire référence que par son nom d'objet système.
nom: Indiquez le nom du dossier devant contenir le document.

Rebaptiser (RENAME)

Nom identifiant le document déplacé dans le dossier TOFLR. Ce paramètre vous permet de baptiser un document n'appartenant pas à un dossier afin de le déplacer vers un dossier. Il vous permet également de rebaptiser un document à déplacer d'un dossier à un autre.

Si un document est déplacé vers un dossier, son nom doit être unique au sein du dossier de destination (TOFLR).

Si le nouveau nom est déjà attribué à un dossier ou à un document dans un dossier indiqué avec le paramètre TOFLR, vous devez choisir un autre nom pour le document cible ou rebaptiser le dossier ou le document portant le même nom.

Remarque :RENAME(nom) est obligatoire avec FROMDOC(*SYSOBJNAM).

*SAME: Le document ne change pas de nom lors de son déplacement d'un dossier à un autre, ou n'aura plus de nom lorsqu'il deviendra sans dossier.
nom: Indiquez le nom du document déplacé dans le dossier de destination (TOFLR).

Nom d'objet système (SYSOBJNAM)

Indique le nom d'objet système (SYSOBJNAM) du document à déplacer. Ce paramètre ne peut être indiqué que si FROMDOC(*SYSOBJNAM) est précisé.

nom: Indiquez le nom d'objet système.

Exemples

Exemple 1 : ajout d'un document non inclus dans un dossier

MOVDOC   FROMDOC(*SYSOBJNAM)  FROMFLR(*NONE)  TOFLR(FLR1)
         RENAME(DOC1)  SYSOBJNAM(CNTR192366)

Cette commande, dont le nom d'objet système est CNTR192366, ajoute un document non inclus dans un dossier à FLR1 et le nomme DOC1.

Exemple 2 : déplacement d'un document en conservant son nom

MOVDOC   FROMDOC(DOC1)  FROMFLR(FLR1)  TOFLR(FLR2)
         RENAME(*SAME)

Cette commande permet de déplacer DOC1 de FLR1 vers FLR2 en conservant le nom DOC1.

Exemple 3 : déplacement d'un document en changeant le nom

MOVDOC   FROMDOC(DOC1)  FROMFLR(FLR1)  TOFLR(FLR2)
         RENAME(DOC2)

Cette commande permet de déplacer DOC1 de FLR1 vers FLR2 en le renommant DOC2.

Exemple 4 : déplacement d'un document en en faisant un document non inclus dans un dossier

MOVDOC   FROMDOC(DOC1)  FROMFLR(FLR1)  TOFLR(*NONE)

Cette commande permet de déplacer DOC1 depuis FLR1 et de le changer en un document non inclus dans un dossier.

Messages d'erreur

Messages *ESCAPE

CPF8A13: Le document &2 du dossier &1 n'a pas été déplacé.