CPYFRMPCD

Copier à partir de document PC

En bref

La commande CPYFRMPCD (Copier depuis un document PC) permet de reproduire les données d'un document PC dans un fichier base de données du système.

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

Syntaxe minimale

CPYFRMPCD FROMFLR(…) TOFILE(…) FROMDOC(…)

Paramètres

FROMFLR Depuis le dossier obligatoire
TOFILE Dans le fichier obligatoire
FROMDOC Depuis le document obligatoire
TOMBR Dans le membre
MBROPT Remplacer ou ajouter enreg
TRNTBL Table de conversion
TRNFMT Format de données PC
TRNIGC DBCS code page
IGCSOSI Insert DBCS SO/SI

Astuce : dans une session 5250, tapez CPYFRMPCD 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 CPYFRMPCD (Copier depuis un document PC) permet de reproduire les données d'un document PC dans un fichier base de données du système.

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 CPYFRMPCD

Messages *ESCAPE

IWS1603: Document PC copié dans le fichier, avec &6 enregistrements tronqués.
IWS1611: Le document PC &1 n'a pas été copié.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMFLR	Depuis le dossier	Valeur caractère	Obligatoire, positionnel 1
TOFILE	Dans le fichier	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Dans le fichier	Nom
	Qualificatif 2: Bibliothèque	Nom, LIBL, CURLIB
FROMDOC	Depuis le document	Valeur caractère	Obligatoire, positionnel 3
TOMBR	Dans le membre	Nom, FIRST, FROMDOC	Facultatif, positionnel 4
MBROPT	Remplacer ou ajouter enreg	REPLACE, ADD	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
IGCSOSI	Insert DBCS SO/SI	YES, NO	Facultatif

Depuis le dossier (FROMFLR)

Indique le nom du dossier contenant le document PC à copier. Vous pouvez également en préciser le chemin d'accès ; la syntaxe devra être :

dossier1/dossier2/dossier3/.../dossiern

Le nom du chemin d'accès est limité à 63 caractères.

Ce paramètre est obligatoire.

Dans le fichier (TOFILE)

Indique le nom et la bibliothèque du fichier physique base de données où copier le document PC.

S'il s'agit d'un fichier source et si vous décidez de convertir le document PC, un numéro d'ordre et un format de date système (valeur initiale à zéro) seront ajoutés au fichier lors de la copie.

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.

Depuis le document (FROMDOC)

Indique le nom du document PC à copier ; la syntaxe doit être :

nomfich.suffixe

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

Ce paramètre est obligatoire.

Dans le membre (TOMBR)

Indique le nom du membre devant recevoir le document PC copié ; en cas d'omission, la copie s'effectuera sur le premier membre du fichier. S'il n'existe pas, il sera automatiquement créé.

*FIRST: Le document PC sera copié dans le premier membre.
*FROMDOC: Le nom du membre est celui du document PC à copier. Ce dernier doit alors avoir la syntaxe d'un nom de membre du système.
Nom du membre: Précise le nom du membre dans lequel vous voulez copier le document PC.

Remplacer ou ajouter enreg (MBROPT)

Indique si les enregistrements copiés seront ajoutés au fichier physique, ou s'ils remplaceront les enregistrements existants.

*REPLACE: Les enregistrements copiés remplaceront ceux du membre du fichier physique.
*ADD: Les enregistrements seront ajoutés au fichier physique.

Table de conversion (TRNTBL)

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

Remarque :Pour un jeu de caractères double octet défini par l'utilisateur, ce paramètre indique également si une conversion est effectuée et, le cas échéant, quelle table de conversion est utilisée pour la conversion à un octet. Remarque :For a user defined double-byte character set, this parameter also specifies if translation is performed and, if so, which translation table is used for single-byte translation.

*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 données ne seront pas converties d'ASCII en EBCDIC, mais directement copiées octet par octet.

Format de données PC (TRNFMT)

Définit le format des enregistrements de 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 du document PC, écrits en format DOS-ASCII standard de longueur variable, sont convertis au format de longueur fixe du fichier base de données. Les caractères de retour à la ligne, d'avance ligne et de fin de fichier sont supprimés. Tous les caractères de tabulation sont remplacés par des blancs et, pour respecter le format fixe, l'enregistrement est complété par des blancs définis en EBCDIC.
*NOTEXT: Les enregistrements du document PC sont définis avec un format de longueur fixe, identique à celui des enregistrements du fichier physique base de données dans lequel ils sont copiés.

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.

Insert DBCS SO/SI (IGCSOSI)

Specifies if shift-out and shift-in characters are inserted during translation. This parameter is valid only for double-byte character set users. Ce paramètre ne peut être utilisé si vous avez répondu *NONE à l'invite Table de conversion (paramètre TRNTBL).

*YES: Les caractères de décalage vers l'extérieur (shift-out) et vers l'intérieur (shift-in) sont insérés pendant la conversion. Shift-out and shift-in characters are inserted during translation.
*NO: Les caractères de décalage vers l'extérieur (shift-out) et vers l'intérieur (shift-in) ne sont pas insérés pendant la conversion. Shift-out and shift-in characters are not inserted during translation.

Exemples

None

Messages d'erreur

Messages *ESCAPE

IWS1603: Document PC copié dans le fichier, avec &6 enregistrements tronqués.
IWS1611: Le document PC &1 n'a pas été copié.