CPYTOPCD

Copier dans un document PC

En bref

La commande CPYTOPCD (Copier dans un document PC) permet de reproduire un membre provenant d'un fichier base de données du système sur un document PC contenu dans un dossier.

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

Syntaxe minimale

CPYTOPCD FROMFILE(…) TOFLR(…)

Paramètres

FROMFILE Depuis le fichier obligatoire
TOFLR Dans le dossier obligatoire
FROMMBR Depuis le membre
TODOC Dans le document
REPLACE Remplacer le document
TRNTBL Table de conversion
TRNFMT Format de données PC
TRNIGC DBCS code page
RCDFMT Format d'enregistrement

Astuce : dans une session 5250, tapez CPYTOPCD 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 QIWS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande CPYTOPCD (Copier dans un document PC) permet de reproduire un membre provenant d'un fichier base de données du système sur un document PC contenu dans un dossier.

Remarque :Ne faites pas précéder vos données d'un astérisque, à moins que ce ne soient des valeurs spéciales comportant déjà ce caractère (à l'écran même ou dans le texte d'aide).

Messages d'erreur CPYTOPCD

Messages *ESCAPE

IWS1612: Le membre &1 n'a pas été copié dans le document PC.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMFILE	Depuis le fichier	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Depuis le fichier	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
TOFLR	Dans le dossier	Valeur caractère	Obligatoire, positionnel 2
FROMMBR	Depuis le membre	Nom, *FIRST	Facultatif, positionnel 3
TODOC	Dans le document	Valeur caractère, *FROMMBR	Facultatif, positionnel 4
REPLACE	Remplacer le document	NO, YES	Facultatif, positionnel 5
TRNTBL	Table de conversion	Valeurs uniques: DFT, NONE Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: Table de conversion	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
TRNFMT	Format de données PC	TEXT, NOTEXT	Facultatif
TRNIGC	DBCS code page	DFT, JPN, CHT, BG5, CHS, KOR, KSC, SCGS, *NONE	Facultatif
RCDFMT	Format d'enregistrement	Nom, *ALL	Facultatif

Depuis le fichier (FROMFILE)

Indique le nom et la bibliothèque du fichier base de données à partir duquel vous effectuerez la copie. Ce peut être un fichier physique ou logique.

Ce paramètre est obligatoire.

Pour définir le nom de la bibliothèque, choisissez l'une des valeurs suivantes :

*LIBL: Indique la liste des bibliothèques utilisée pour rechercher le fichier base de données.
*CURLIB: Indique la bibliothèque en cours utilisée par le travail pour retrouver votre fichier base de données. Si ce nom n'existe pas dans la liste des bibliothèques, il est remplacé par QGPL.
Nom de la bibliothèque: Précise le nom de la bibliothèque contenant le fichier base de données.

S'il s'agit d'un fichier source dont les enregistrements doivent être convertis d'EBCDIC en ASCII, le numéro de ligne et la date seront supprimés lors de l'écriture des enregistrements dans le document PC.

Dans le dossier (TOFLR)

Indique le nom du dossier contenant le document PC dans lequel s'effectuera la copie.

Ce peut être un nom de chemin d'accès, entièrement défini et respectant la syntaxe :

dossier1/dossier2/dossier3/.../dossiern

Le nom du chemin d'accès est limité à 63 caractères. Tous les dossiers précisés doivent exister.

Ce paramètre est obligatoire.

Depuis le membre (FROMMBR)

Indique le nom du membre à copier.

*FIRST: Indique le premier membre du fichier à copier.
Nom du membre: Indique le nom du membre à copier.

Dans le document (TODOC)

Indique dans quel document PC du dossier copier les données du membre du fichier base de données. Si ce document n'existe pas, il sera automatiquement créé.

*FROMMBR

Le nom du document PC sera celui du membre.

Nom du document

Le nom du document devra respecter la syntaxe suivante :

nomfich.suffixe

Le nom du fichier est limité à 8 caractères, son suffixe à 3.

Remplacer le document (REPLACE)

Indique si un document existant sera remplacé lors de la copie.

*NO: Si un document de ce nom existe déjà dans le dossier indiqué dans l'invite Dans le dossier (paramètre TOFLR), la copie ne sera pas effectuée.
*YES: Si un document de même nom existe déjà dans le dossier indiqué en regard de l'invite Dans le dossier (paramètre TOFLR), il sera remplacé par les données du fichier base de données copié.

Table de conversion (TRNTBL)

Indique si la conversion doit avoir lieu et, au besoin, le nom de la table de conversion d'EBCDIC en ASCII à utiliser.

Remarque :Dans un contexte DBCS, ce paramètre inique aussi si la conversion a été effectuée et, le cas échéant, avec quelle table de conversion.

Le format des enregistrements du document PC est défini dans l'invite Format de données PC (paramètre TRNFMT).

*DFT

Correspond à la table de conversion par défaut.

Nom de la table de conversion

Indique le nom et la bibliothèque de la table de conversion.

Pour définir le nom de la bibliothèque, choisissez l'une des valeurs suivantes :

*LIBL: Indique la liste des bibliothèques utilisée pour rechercher la table de conversion.
*CURLIB: Indique la bibliothèque en cours, utilisée par le travail pour retrouver la table de conversion. Si ce nom n'existe pas dans la liste des bibliothèques, il est remplacé par QGPL.
Nom de la bibliothèque: Indique la bibliothèque contenant la table de conversion.

*NONE

Les enregistrements ne seront pas convertis d'EBCDIC en ASCII et seront considérés, lors de leur copie sur le document PC, comme des enregistrements de longueur fixe. Les caractères ASCII de retour à la ligne, d'avance ligne ou de fin de fichier ne seront pas ajoutés au document PC. La longueur fixe de ces enregistrements est égale à celle de ceux contenus dans le fichier base de données.

Format de données PC (TRNFMT)

Indique le format des enregistrements que devra avoir votre document PC.

Ce paramètre ne peut être utilisé si vous avez répondu *NONE à l'invite Table de conversion (paramètre TRNTBL).

*TEXT: Les enregistrements seront écrits dans le format DOS-ASCII standard de longueur variable. Les caractères ASCII de retour à la ligne, d'avance ligne ou de fin de fichier seront insérés ou ajoutés, selon le cas, après chaque enregistrement ou à la fin du document PC.
*NOTEXT: Les enregistrements du document PC seront en format fixe. La longueur utilisée dans le document PC est celle des enregistrements du fichier base de données.

DBCS code page (TRNIGC)

Indique le jeu de caractères double octet utilisé pour la conversion. Sauf s'il est remplacé par l'invite Table de conversion (paramètre TRNTBL), ce paramètre indique également la table de conversion à un octet. Specifies the double-byte character set used for translation. Unless overridden by the Table de conversion prompt (TRNTBL parameter), this parameter also specifies the single-byte translation table.

*DFT: Jeu de caractères double octet du pays ou de la région par défaut. The default country or region's double-byte character set.
*JPN: IBM Japanese.
*CHT: IBM Traditional Chinese.
*BG5: Taiwan Industry standard (BIG-5).
*CHS: IBM Simplified Chinese.
*KOR: IBM Korean (KS).
*KSC: Korean Industry standard.
*SCGS: Norme nationale de la République populaire de Chine (GB). The People's Republic of China National standard (GB).
*NONE: Aucune conversion double octet n'est effectuée. No double-byte translation is performed.

Format d'enregistrement (RCDFMT)

Indique le ou les format(s) d'enregistrement à copier. Voici les différentes valeurs possibles :

*ALL: Tous les enregistrements définis dans le fichier base de données devront être copiés, quel que soit leur format.
Nom du format d'enregistrement: Si vous ne voulez copier que les enregistrements correspondant à un format donné, précisez ce nom.

Exemples

None

Messages d'erreur

Messages *ESCAPE

IWS1612: Le membre &1 n'a pas été copié dans le document PC.