CPYDOC

Copier un document

En bref

La commande CPYDOC (Copier un document) permet de copier un document dans un dossier, que ce document provienne d'un dossier ou non.

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

Syntaxe minimale

CPYDOC FROMDOC(…)

Paramètres

FROMDOC Document d'origine obligatoire
FROMFLR Dossier d'origine
TODOC Document de destination
TOFLR Dossier de destination
REPLACE Remplacer document
SYSOBJNAM Nom d'objet système

Astuce : dans une session 5250, tapez CPYDOC 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 CPYDOC (Copier un document) permet de copier un document dans un dossier, que ce document provienne d'un dossier ou non.

Restrictions :

Si vous remplacez un document dans un dossier, vous devez disposer du droit *CHANGE (modification) sur ce document.
Si vous créez un document dans un dossier, vous devez disposer du droit *CHANGE sur ce dossier. Les droits s'appliquant au nouveau document sont identiques à ceux du document à partir duquel il est copié.
Vous devez disposer du droit *USE (utilisation) sur le document copié.

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
TODOC	Document de destination	Valeur caractère, *FROMDOC	Facultatif, positionnel 3
TOFLR	Dossier de destination	Valeur caractère, *FROMFLR	Facultatif, positionnel 4
REPLACE	Remplacer document	NO, YES	Facultatif
SYSOBJNAM	Nom d'objet système	Nom	Facultatif

Document d'origine (FROMDOC)

Nom du document à copier.

Ce paramètre est obligatoire.

nom: Indiquez le nom du document que vous copiez.
Si FROMDOC(nom) est indiqué, vous devez préciser un nom de dossier à l'aide de FROMFLR.
*SYSOBJNAM: Le document copié est identifié par un nom d'objet système.
SYSOBJNAM(nom), TODOC(nom) et TOFLR(nom) sont obligatoires avec FROMDOC(*SYSOBJNAM).

Dossier d'origine (FROMFLR)

Nom du dossier contenant le document copié.

*NONE: Aucun dossier n'est identifié pour le document. FROMFLR(*NONE) doit être indiqué si le document ne se trouve pas dans un dossier. FROMFLR(*NONE) n'est pas admis avec FROMDOC(nom).
nom: Indiquez le nom du dossier contenant le document que vous copiez.

Document de destination (TODOC)

Nom du document de sortie.

*FROMDOC: Le document de sortie prend le nom indiqué dans le paramètre Document d'origine (FROMDOC).
TOFLR(*FROMFLR) n'est pas admis avec TODOC(*FROMDOC).
nom: Indiquez le nom du document de sortie.
TODOC(nom) est obligatoire avec FROMDOC(*SYSOBJNAME).

Dossier de destination (TOFLR)

Nom du dossier dans lequel le document de sortie est copié.

*FROMFLR: Le dossier prend le nom indiqué dans le paramètre Dossier d'origine (FROMFLR) ; le document est copié dans le même dossier.
nom: Indiquez le nom du dossier dans lequel le document est copié.
TOFLR(nom) est obligatoire avec FROMDOC(*SYSOBJNAME).

Remplacer document (REPLACE)

Indique si le document précisé au paramètre TODOC peut être remplacé.

*NO: Le document de sortie est un nouveau document créé dans le dossier indiqué dans le paramètre Dossier de destination (TOFLR). Si un document du même nom existe déjà dans ce dossier, le document n'est pas créé.
*YES: Le document de sortie remplace un document du même nom figurant dans le dossier indiqué dans le paramètre TOFLR. Si aucun document de ce nom n'existe dans ce dossier, un nouveau document est créé.

Nom d'objet système (SYSOBJNAM)

Indique le nom d'objet système. Ce paramètre est correct uniquement si DLO (*SYSOBJNAM) est indiqué.

nom: Indiquez le nom d'objet système du document que vous copiez. Vous devez entrer 10 caractères.

Exemples

Exemple 1: copie d'un document

CPYDOC   FROMDOC(MYDOC)  FROMFLR(MYFLR)
         TODOC(MYDOC2)  TOFLR(MYFLR2)
         REPLACE(*YES)

Cette commande permet de copier le document MYDOC du dossier MYFLR vers le document MYDOC2 du dossier MYFLR2. Si le document MYDOC2 existe déjà dans MYFLR2, le système le remplace par une copie du document MYDOC ; sinon, MYDOC2 est créé dans MYFLR2 en tant que copie du document MYDOC dans MYFLR.

Exemple 2 : copie d'un document et conservation du nom du document source

CPYDOC   FROMDOC(*SYSOBJNAM)  SYSOBJNAM(AMBT133080)
         TODOC(MYDOC4)  TOFLR(MYFLR)

Cette commande permet de copier un document, identifié par le nom d'objet système, vers le document MYDOC4 situé dans le dossier MYFLR. Le nom du document est identique au nom du document source.

Exemple 3 : copie d'un document vers un document du même dossier

CPYDOC   FROMDOC(XYZ)  FROMFLR('MYFLR/TEST')  TODOC(NEW)

Cette commande permet de copier le document XYZ du dossier MYFLR/TEST vers un document NEW du même dossier. Si le document NEW existe déjà, un message d'erreur est émis.

Messages d'erreur

Messages *ESCAPE

CPF8A12: Le document &2 du dossier &1 n'a pas été copié.