CPYF

La commande CPYF (Copier un fichier) permet de copier tout ou partie d'un fichier de la base de données ou d'une unité externe vers la base de données ou une unité externe. Vous pouvez ainsi :

• Copier des fichiers de données et des fichiers source d'une base de données vers une autre. Les enregistrements copiés peuvent provenir de fichiers physiques ou logiques, mais peuvent être copiés exclusivement dans des fichiers physiques ( jamais dans des fichiers logiques).
• Copier, dans la base de données, des fichiers de données et des fichiers source provenant d'unités externes (disquettes ou bandes magnétiques).
• Copier, sur des unités externes, des fichiers de données et des fichiers source provenant de la base de données.
• Copier des fichiers de données et des fichiers source d'une unité externe vers une autre.
• Copier, dans la base de données ou sur une unité externe, des fichiers de données ou des fichiers source provenant de fichiers spoule en entrée.

Restrictions :

• Pendant l'exécution de la commande CPYF, le fichier indiqué dans l'invite Fichier de destination (paramètre TOFILE) peut être verrouillé (similaire à un verrouillage *EXCL sans délai) et donc inaccessible.
• Lorsque le paramètre CRTFILE(*YES) est précisé et que le fichier copié (indiqué au paramètre FROMFILE) est associé à un déclencheur, ce dernier n'est pas associé au fichier créé (indiqué au paramètre TOFILE). La commande ADDPFTRG doit alors être utilisée pour ajouter un déclencheur au fichier.
• Cette commande admet les unités d'exécution multiples, sous certaines conditions. Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas ces dernières lors d'une copie dans plusieurs membres de fichier base de données, fichiers d'unité (sauf les fichiers imprimante SPOOL(*YES)), fichiers répartis et fichiers DDM de type *SNA. Elle échoue pour les fichiers répartis utilisant une base de données relationnelle de type *SNA et les fichiers DDM de type *SNA. Elle admet les unités d'exécution multiples uniquement en cas de copie dans des membres d'un seul fichier base de données (local ou DDM de type *IP) et dans des fichiers imprimante SPOOL(*YES).

Paramètres

Fichier d'origine (FROMFILE)

Indique le fichier base de données ou unité qui contient les enregistrements à copier. Le fichier base de données peut être physique ou logique. Le fichier unité peut être un fichier disquette ou bande.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier d'origine

nom

Indiquez le nom du fichier base de données ou unité qui contient les enregistrements à copier.

Qualificatif 2 : Biblio

*LIBL

La recherche est effectuée dans toutes les bibliothèques utilisateur et système de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier base de données ou le fichier unité est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Fichier de destination (TOFILE)

Indique le nom du fichier qui reçoit les enregistrements copiés.

Ce paramètre est obligatoire.

Remarque :Un fichier unité peut être un fichier disquette, un fichier bande ou un fichier imprimante. Toutefois : 1) Si le fichier d'origine et le fichier de destination sont tous deux des fichiers disquette, le fichier de destination doit être envoyé dans le spoule (vous devez indiquer SPOOL(*YES) dans la commande CRTDKTF (Créer un fichier disquette), CHGDKTF (Modifier un fichier disquette) ou OVRDKTF (Substituer un fichier disquette)). 2) Un fichier imprimante à description externe ne peut pas être indiqué.

Considérations DBCS : Non applicable.

Valeurs particulières

*PRINT

Les données sont copiées dans un fichier imprimante du système (QSYSPRT) et formatées selon la valeur indiquée à l'invite Format d'impression (paramètre OUTFMT).

Qualificatif 1 : Fichier de destination

nom

Indiquez le nom du fichier physique ou du fichier unité qui reçoit les enregistrements copiés.

Qualificatif 2 : Biblio

*LIBL

La recherche est effectuée dans toutes les bibliothèques utilisateur et système de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier physique ou unité est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Membre d'origine (FROMMBR)

Indique le membre du fichier base de données ou le label du fichier disquette ou bande à utiliser pour la copie.

*FIRST

Le premier membre du fichier base de données est copié. Dans le cas d'une disquette, un identificateur de label doit figurer dans le fichier unité ou dans la commande OVRDKTF (Substituer un fichier disquette). *FIRST est l'unique option admise pour un fichier spoule en entrée.

*ALL

Tous les membres du fichier base de données, ou bien, dans le cas d'une disquette, tous les ID label de fichier sont copiés. L'option *ALL n'est pas admise pour un fichier bande ou un fichier spoule en entrée.

nom

Indiquez soit le nom du membre du fichier base de données d'origine, soit le label du fichier disquette ou bande d'origine.

nom-générique

Indiquez un nom générique pour copier tous les membres base de données dont le nom commence par le même préfixe ou, dans le cas d'une disquette, tous les fichiers de données dotés du même préfixe d'identificateur de label . Pour plus d'informations sur la copie de plusieurs membres d'origine ou identificateurs de label, reportez-vous à la description de FROMBR(*ALL).

Membre ou label de destination (TOMBR)

Indique le nom du membre de fichier base de données, ou bien l'ID label du fichier disquette ou bande, devant recevoir les enregistrements copiés. Si *PRINT est indiqué dans l'invite Fichier de destination (paramètre TOFILE), *FIRST ou *FROMMBR est obligatoire.

*FIRST

Le premier membre du fichier indiqué est utilisé.

*FROMMBR

Cette valeur impose une correspondance entre les noms de membres ou les identificateurs de label d'unité des fichiers d'origine et des fichiers de destination.

*ALL

Les données sont copiées dans le membre de destination approprié de la table partitionnée. La valeur *ALL est admise uniquement pour les tables partitionnées.

nom

Indiquez le nom du membre du fichier physique, ou bien l'identificateur de label du fichier disquette ou bande devant recevoir les enregistrements.

Remplacement ou ajout enregs (MBROPT)

Indique si les nouveaux enregistrements remplacent ou sont ajoutés aux enregistrements existants.

Remarque :Si les enregistrements sont copiés dans un fichier physique existant, ce paramètre doit avoir pour valeur *ADD, *UPDADD ou *REPLACE. Si le fichier cible n'existe pas mais que CRTFILE(*YES) est indiqué, l'opération de copie utilise MBROPT(*ADD) pour tous les enregistrements copiés dans le fichier après sa création quelle que soit la valeur indiquée pour ce paramètre.

Si *ADD ou *UPDADD est indiqué et que le fichier source est vide (ne contient pas d'enregistrements), l'opération de copie s'exécute normalement. Si *REPLACE est indiqué et que le fichier source est vide, l'opération a une fin anormale.

*NONE

Ce paramètre n'est pas utilisé dans le cas présent. Lorsque le fichier de destination est un fichier physique existant, *NONE n'est pas admis.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*UPDADD

Le système met à jour les enregistrements à clés en double et ajoute les nouveaux enregistrements à la suite des enregistrements existants. Pour plus d'informations, reportez-vous au manuel Catégorie des fichiers et systèmes de fichiers de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Créer le fichier (CRTFILE)

Indique, dans le cas d'une copie à partir d'un fichier physique ou logique, si un fichier physique est créé pour recevoir les données lorsque le fichier de destination donné n'existe pas. Dans le cas où le fichier de destination DDM (Gestion de fichiers éloignés) identifie un fichier éloigné qui n'existe pas, il est créé sur le système cible.

*NO

Le fichier de destination doit déjà exister lors de l'émission de la commande. Par conséquent, aucun fichier physique de destination n'est créé.

*YES

Si le fichier de destination n'existe pas, un fichier physique portant le nom indiqué dans l'invite Fichier de destination (paramètre TOFILE) est créé. Si le fichier d'origine est une table, une vue ou un index SQL contenant un type de données défini par l'utilisateur, une liaison de données, un type de zone LOB ou un type de zone XML, le fichier physique créé sera une table SQL. Dans tous les autres cas, le fichier de destination créé sera un fichier physique base de données qui n'est pas une table SQL. En plus des contrôles de validité habituels, les conditions spéciales suivantes doivent être remplies lors d'une opération de copie avec création de fichier de destination :

• Le fichier d'origine peut être physique ou logique.
• Un nom de bibliothèque doit être indiqué dans l'invite Fichier de destination (paramètre TOFILE). La valeur par défaut (*LIBL) n'est pas admise.
• Il ne peut pas y avoir substitution du nom de fichier ou de bibliothèque. Les valeurs indiquées dans la commande CPYF pour le fichier de destination doivent être utilisées.
• L'utilisateur doit être autorisé à ajouter le fichier à la bibliothèque de destination ; en outre, il doit disposer des droits d'opération sur la commande CRTPF (Créer un fichier physique).
• Le fichier d'origine ne doit comporter qu'un seul format d'enregistrement. Si le fichier d'origine est un fichier logique comportant plusieurs formats, l'invite Format du fichier logique (paramètre RCDFMT) doit préciser le nom de l'un de ces formats.

Format d'impression (OUTFMT)

Indique si les enregistrements sont imprimés sous forme alphanumérique, ou sous forme alphanumérique et hexadécimal. Ce paramètre est utilisé uniquement lorsque *PRINT est indiqué dans l'invite Fichier de destination (paramètre TOFILE) ou lorsque *EXCLD ou *COPIED est indiqué dans l'invite Enregistrements à imprimer (paramètre PRINT).

*CHAR

Les enregistrements sont imprimés en format alphanumérique.

*HEX

Les enregistrements sont imprimés en format alphanumérique et en format hexadécimal.

Enregistrements à imprimer (PRINT)

Indique si les enregistrements copiés et/ou exclus doivent être imprimés ou non.

Valeurs particulières

*NONE

Aucun enregistrement copié, exclu ou d'erreur n'est imprimé.

Autres valeurs (jusqu'à 3 répétitions)

*EXCLD

Les enregistrements exclus de la copie par les invites Inclusion enreg/test caractère (paramètre INCCHAR) et Inclusion enreg/test de zone (paramètre INCREL) sont imprimés.

*COPIED

Les enregistrements copiés sont imprimés.

*ERROR

Le nombre d'enregistrements d'erreur en sortie remédiable indiqué dans l'invite Nombre d'erreurs admises (paramètre ERRLVL) est imprimé.

Format du fichier logique (RCDFMT)

Indique, dans le cas d'une copie portant sur un fichier base de données uniquement, le nom du format d'enregistrement à copier. Si le fichier d'origine n'est ni logique, ni physique, *ONLY est la seule valeur admise. Dans le cas d'un fichier logique, le nom de format d'enregistrement est facultatif si ce fichier comporte un seul format ; en revanche, il convient d'indiquer soit un nom, soit *ALL si le fichier comporte plusieurs formats.

*ONLY

L'unique format d'enregistrement du fichier d'origine est copié. Dans le cas d'un fichier logique, cette option n'est admise que si le fichier comporte un seul format d'enregistrement.

*ALL

Tous les formats d'enregistrement du fichier logique d'origine sont copiés.

nom

Indiquez le nom du format d'enregistrement que vous souhaitez copier à partir du fichier logique ou physique d'origine.

Copie depuis numéro d'enreg (FROMRCD)

Indique le numéro d'enregistrement à partir duquel doit s'effectuer la copie. Vous ne pouvez pas indiquer de numéro d'enregistrement si une valeur autre que *NONE est indiquée dans l'invite Copie depuis la clé (paramètre FROMKEY) ou Copie jusqu'à la clé (paramètre TOKEY). Il en est de même si le fichier d'origine est un fichier logique à clé.

*START

La copie s'effectue à partir du premier enregistrement du fichier.

1-4294967288

Indiquez le numéro du premier enregistrement à copier depuis le fichier d'origine.

Copie jusqu'au numéro d'enreg (TORCD)

Indique le numéro du dernier enregistrement du fichier d'origine (ou de chaque membre du fichier d'origine) à copier. Vous ne pouvez pas indiquer de numéro d'enregistrement si une valeur autre que *NONE est précisée dans l'invite Copie depuis la clé (paramètre FROMKEY) ou Copie jusqu'à la clé (paramètre TOKEY), si une valeur autre que *END est précisée dans l'invite Nombre d'enreg à copier (paramètre NBRRCDS) ou si le fichier d'origine est un fichier logique à clé.

*END

Les enregistrements sont copiés jusqu'à détection d'une condition de fin de fichier.

1-4294967288

Indiquez le numéro du dernier enregistrement à copier depuis le fichier d'origine.

Copie depuis la clé (FROMKEY)

Indique, lorsque la copie porte sur un fichier à clé, la valeur de la clé du premier enregistrement du fichier (ou de chaque membre du fichier) à copier. Ce paramètre n'est admis que si le fichier d'origine est un fichier base de données à clé et si aucun numéro d'enregistrement n'est indiqué dans l'invite Copie depuis numéro d'enreg (paramètre FROMRCD) ou Copie jusqu'au numéro d'enreg (paramètre TORCD).

Valeurs particulières

*NONE

Le premier enregistrement à copier n'est pas sélectionné à l'aide d'une clé.

Elément 1 : Nombre de zones clés

*BLDKEY

Une liste de valeurs (comportant chacune 256 caractères) est fournie pour les différentes zones clés, plutôt qu'une seule chaîne alphanumérique représentant toutes les zones. *BLDKEY n'est pas admis si l'une des valeurs (50 au maximum) de la liste correspond à une zone clé acceptant des valeurs indéfinies.

La liste de valeurs indiquée pour l'élément 2 s'applique (dans l'ordre) aux zones correspondantes de la clé du fichier d'origine. Pour les zones alphanumériques, les chaînes de caractères sont converties du CCSID du travail en cours au CCSID de la zone du fichier d'origine. Pour les zones de type date, heure ou horodatage, les valeurs en entrée correspondantes sont converties selon le format et le type de séparateur de la zone du fichier d'origine. Pour les zones de longueur variable, indiquez uniquement les données alphanumériques, sans la partie longueur de deux octets. Considérations DBCS : Non applicable. Considérations DBCS : Non applicable.

nombre-entier

Indiquez le nombre de zones clés utilisées pour localiser le premier enregistrement à copier.

Elément 2 : Valeur de la clé

valeur-alphanumérique

Indiquez une chaîne de caractères donnant la valeur réelle de la clé en fonction du nombre de zones clés indiqué pour le premier élément. La chaîne clé doit être mentionnée entre apostrophes si elle contient des blancs ou des caractères spéciaux. Il est possible de la représenter en hexadécimal, en particulier si la clé contient des zones décimales condensées ou numériques binaires ou s'il s'agit d'une zone alphanumérique de longueur variable. Les conversions de CCSID ne sont pas effectuées sur des zones alphanumériques lorsqu'une seule chaîne est indiquée.

Copie jusqu'à la clé (TOKEY)

Indique, lorsque la copie porte sur un fichier à clé, la valeur de la clé du dernier enregistrement du fichier (ou de chaque membre du fichier) à copier. Ce paramètre n'est admis que si le fichier d'origine est un fichier base de données à clé. En outre, il n'est pas autorisé si un numéro d'enregistrement est indiqué dans l'invite Copie depuis numéro d'enreg (paramètre FROMRCD) ou Copie jusqu'au numéro d'enreg (paramètre TORCD) ou bien si un nombre d'enregistrements est indiqué dans l'invite Nombre d'enreg à copier (paramètre NBRRCDS).

Valeurs particulières

*NONE

Le dernier enregistrement à copier n'est pas sélectionné à l'aide d'une clé.

Elément 1 : Nombre de zones clés

*BLDKEY

Une liste de valeurs (comportant chacune 256 caractères) est fournie pour les différentes zones clés, plutôt qu'une seule chaîne alphanumérique représentant toutes les zones. *BLDKEY n'est pas admis si l'une des valeurs (50 au maximum) de la liste correspond à une zone clé acceptant des valeurs indéfinies.

La liste de valeurs indiquée pour l'élément 2 s'applique (dans l'ordre) aux zones correspondantes de la clé du fichier d'origine. Pour les zones alphanumériques, les chaînes de caractères sont converties du CCSID du travail en cours au CCSID de la zone du fichier d'origine. Pour les zones de type date, heure ou horodatage, les valeurs en entrée correspondantes sont converties selon le format et le type de séparateur de la zone du fichier d'origine. Pour les zones de longueur variable, indiquez uniquement les données alphanumériques, sans la partie longueur de deux octets. Considérations DBCS : Non applicable. Considérations DBCS : Non applicable.

nombre-entier

Indiquez le nombre de zones clés utilisées pour localiser le dernier enregistrement à copier.

Elément 2 : Valeur de la clé

valeur-alphanumérique

Indiquez une chaîne de caractères donnant la valeur réelle de la clé en fonction du nombre de zones clés indiqué pour le premier élément. La chaîne clé doit être mentionnée entre apostrophes si elle contient des blancs ou des caractères spéciaux. Il est possible de la représenter en hexadécimal, en particulier si la clé contient des zones décimales condensées ou numériques binaires ou s'il s'agit d'une zone alphanumérique de longueur variable. Les conversions de CCSID ne sont pas effectuées sur des zones alphanumériques lorsqu'une seule chaîne est indiquée.

Nombre d'enreg à copier (NBRRCDS)

Indique le nombre d'enregistrements copiés dans le fichier de destination.

*END

Les enregistrements sont copiés jusqu'à ce que la fin du fichier d'origine soit atteinte (condition EQF), sauf si le paramètre TOKEY ou TORCD a été indiqué.

1-4294967288

Indiquez le nombre d'enregistrements à copier dans le fichier de destination.

Inclusion enreg/test caractère (INCCHAR)

Indique que les enregistrements à copier sont sélectionnés par comparaison d'une chaîne de caractères avec des données situées à une position déterminée au sein de l'enregistrement ou d'une zone de l'enregistrement.

Valeurs particulières

*NONE

Les enregistrements à copier ne sont pas sélectionnés par comparaison.

Valeurs de comparaison

Pour établir la comparaison permettant de déterminer les enregistrements à copier, entrez *RCD ou un nom de zone suivi de trois valeurs correspondant à une position de début, un opérateur et une chaîne de caractères. Tous les enregistrements répondant aux conditions ainsi définies seront copiés dans le fichier de destination.

Elément 1 : Nom de la zone

*RCD

Dans chaque enregistrement du fichier d'origine, la chaîne de caractères est comparée avec les données situées à la position de départ indiquée.

*FLD

Cette valeur est équivalente à *RCD.

nom

Indiquez le nom d'une zone du format d'enregistrement, sur laquelle portera la comparaison. Elle doit être définie en tant que zone caractère dans les DDS du fichier d'origine.

Elément 2 : Position du caractère

position-début

Indiquez la position à laquelle la comparaison doit commencer au sein de l'enregistrement ou de la zone. Pour les zones de longueur variable, cette position se situe dans la partie réservée aux données. Pour tous les opérateurs à l'exception de *CT, la comparaison est limitée à la longueur de la chaîne alphanumérique indiquée (256 caractères au maximum). Pour l'opérateur *CT, la chaîne de caractère est recherchée entre la position de début indiquée et la fin de la zone ou de l'enregistrement.

Elément 3 : Opérateur relationnel

Indiquez l'opérateur exprimant la relation souhaitée entre l'enregistrement ou la zone et la chaîne de caractères mentionnée.

*EQ

Egal

*GT

Supérieur à

*LT

Inférieur à

*NE

Différent de

*GE

Supérieur ou égal à

*NL

Non inférieur à

*LE

Inférieur ou égal à

*NG

Non supérieur à

*CT

Contient

Elément 4 : Valeur

valeur-alphanumérique

Indiquez la chaîne de caractères (256 au maximum) à comparer au contenu de l'enregistrement ou de la zone indiqué. Elle doit figurer entre apostrophes si elle comporte des blancs ou des caractères spéciaux. Dans le cas d'un nom de zone, la valeur de la chaîne de caractères correspondant au CCSID du travail en cours est convertie en CCSID de zone avant la comparaison. Dans le cas d'une zone de longueur variable, seules les données de type caractère à comparer doivent être précisées, sans la partie longueur de deux octets. Lorsqu'un nom de zone est indiqué, toute relation de comparaison avec une valeur indéfinie est fausse. Considérations DBCS : Non applicable. Considérations DBCS : Non applicable.

Inclusion enreg/test de zone (INCREL)

Indique que les enregistrements à copier sont sélectionnés lorsque certaines de leurs zones contiennent des données satisfaisant les relations indiquées. Ce paramètre n'est pas admis pour une copie de tous les formats d'enregistrement d'un fichier logique à formats multiples.

Valeurs particulières

*NONE

Aucune relation n'est utilisée pour sélectionner les enregistrements à copier.

Valeurs de relation

Vous devez définir un ensemble de valeurs pour exprimer chacune des conditions déterminant la copie des enregistrements. Vous pouvez définir jusqu'à 50 valeurs de relation. Chaque ensemble doit contenir quatre valeurs :

1. un opérateur logique,
2. le nom de la zone à comparer,
3. un opérateur relationnel,
4. la valeur de comparaison.

Elément 1 : Relation

*IF

Cette valeur doit constituer le premier élément de la première comparaison.

*AND

Pour que l'enregistrement soit copié, chacune des relations entre valeurs de zone figurant de part et d'autre de l'opérateur *AND doit être satisfaite.

*OR

Pour que l'enregistrement soit copié, l'une au moins des relations entre valeurs de zone figurant de part et d'autre de l'opérateur *OR doit être satisfaite.

Elément 2 : Nom de la zone

nom

Indiquez le nom de la zone à comparer. Celle-ci doit exister dans le format d'enregistrement du fichier d'origine ; elle peut être définie comme étant de type caractère ou numérique dans les DDS correspondant au fichier.

Elément 3 : Opérateur relationnel

Indiquez l'opérateur exprimant la relation souhaitée entre la zone de l'enregistrement et la valeur de la zone de référence précisée.

*EQ

Egal

*GT

Supérieur à

*LT

Inférieur à

*NE

Différent de

*GE

Supérieur ou égal à

*NL

Non inférieur à

*LE

Inférieur ou égal à

*NG

Non supérieur à

Elément 4 : Valeur

*NULL

*NULL peut être utilisé afin de déterminer si la valeur d'une zone dans un enregistrement est indéfinie ou non. *EQ et *NE sont les seuls opérateurs admis lorsque *NULL est indiqué. La relation "*EQ *NULL" est vraie seulement si une valeur de zone dans un enregistrement est indéfinie. La relation "*NE *NULL" est vraie seulement si une valeur de zone dans un enregistrement n'est pas indéfinie.

valeur-alphanumérique

Indiquez la valeur (256 caractères au maximum) à comparer au contenu de la zone mentionnée. Cette valeur ne doit pas correspondre au nom d'une autre zone. Elle doit figurer entre apostrophes si elle contient des blancs ou des caractères spéciaux, et peut être représentée en hexadécimal. Toute relation de comparaison non *NULL avec une valeur de zone indéfinie dans un enregistrement sera fausse, quel que soit l'opérateur utilisé. Pour les zones de longueur variable, indiquez uniquement les données à comparer, sans la partie longueur de deux octets. Considérations DBCS : Non applicable. Considérations DBCS : Non applicable.

Mappage de zone des formats (FMTOPT)

Dans le cas d'une copie depuis un fichier physique ou logique vers un fichier physique, ce paramètre indique les éventuelles modifications à apporter au niveau des zones des formats d'enregistrement. Si les fichiers d'origine et de destination sont des fichiers base de données de types différents (*SRC et *DATA), *CVTSRC est obligatoire.

Valeurs particulières

*NONE

Aucun mappage ni omission de zone n'est effectué au cours de la copie. Cette valeur est admise uniquement lorsque les fichiers d'origine et de destination ne sont pas tous deux des fichiers base de données, ou bien s'il s'agit de deux fichiers base de données avec des formats d'enregistrement identiques. Il y a identité de formats seulement lorsque toutes les zones sont communes aux deux formats et lorsque leurs positions de début et leurs attributs sont les mêmes dans les deux enregistrements. Les attributs indiquent si une zone accepte ou non les valeurs indéfinies et décrivent le format et le séparateur de date ou d'heure (s'il s'agit d'une zone de type date/heure). Les valeurs indéfinies sont copiées si *NONE est admis.

*NOCHK

Si les formats d'enregistrement des deux fichiers base de données sont différents, la copie se poursuit néanmoins. Les données des enregistrements sont copiées directement (de gauche à droite) d'un fichier à l'autre. *NOCHK est obligatoire lorsque tous les formats d'enregistrement d'un fichier logique à formats multiples doivent être copiés dans un fichier physique dont le type (source ou données) est identique à celui du fichier d'origine. Si cette valeur est indiquée, les valeurs indéfinies ne sont pas prises en compte et la conversion des données de type date/heure n'est pas effectuée.

*CVTSRC

Cette option s'utilise pour effectuer une copie d'un fichier base de données à un autre, d'un fichier source à un fichier de données, ou réciproquement. Elle n'est admise que lorsque le fichier d'origine et le fichier de destination sont de types différents (source et données). La conversion du type de fichier s'effectue de la manière suivante :

• Si le fichier de destination est un fichier de données, les zones comportant le numéro de séquence et la date dans le fichier d'origine ne sont pas retenues. Seule la partie données source de chaque enregistrement du fichier d'origine est copiée dans le fichier de destination.
• Si le fichier de destination est un fichier source, les zones comportant le numéro de séquence et la date sont ajoutées aux données des enregistrements du fichier d'origine, lesquelles sont copiées dans la partie données source de chaque enregistrement du fichier de destination. Les valeurs indéfinies ne sont pas prises en compte et aucune conversion de données de type date/heure n'est effectuée.
• Lorsque le fichier d'origine ou le fichier de destination n'est pas un fichier base de données, le paramètre FMTOPT(*CVTSRC) n'est pas obligatoire pour effectuer une copie d'un fichier source dans un fichier de données, ou réciproquement. Selon le type de fichier, les zones comportant le numéro de séquence et la date sont automatiquement ajoutées ou omises. Si le fichier de destination est un fichier physique source, les paramètres SRCOPT et SRCSEQ peuvent être utilisés pour gérer les numéros de séquence affectés aux enregistrements copiés dans ce fichier.

Autres valeurs (jusqu'à 2 répétitions)

*MAP

Les zones de même nom dans les formats d'enregistrement des deux fichiers sont copiées. Les zones du fichier de destination qui n'ont pas de zone correspondante dans le fichier d'origine prennent la valeur par défaut indiquée au mot clé DFT des spécifications DDS du fichier de destination ou bien la valeur zéro pour les zones numériques, des blancs pour les zones alphanumériques, la date ou l'heure en cours pour les zones de ce type ou une valeur indéfinie pour les zones acceptant ce type de valeur.

*MAP et *DROP ne sont pas incompatibles. Les zones mappées peuvent avoir des positions de début différentes dans les formats d'enregistrement des fichiers d'origine et de destination.

Si *MAP est indiqué et qu'une conversion de données admise est définie entre le CCSID de la zone du fichier d'origine et celui du fichier de destination, les données alphanumériques sont converties au CCSID de la zone du fichier d'origine. Les données ne sont pas converties si le CCSID de l'un des deux fichiers est 65535.

*MAP admet la conversion de données de type date/heure et la copie de valeurs nulles.

*DROP

Cette valeur doit être indiquée pour le mappage au niveau des zones dès lors que des noms de zones dans le format d'enregistrement du fichier d'origine n'ont pas de correspondance dans le format du fichier de destination. *DROP et *MAP ne sont pas incompatibles. Lorsque *DROP est indiqué, tous les noms de zones communs aux deux formats d'enregistrement doivent avoir des attributs et des positions relatives identiques ; si ce n'est pas le cas, *MAP doit également être indiqué. Les valeurs indéfinies sont copiées.

*CVTFLOAT

Toutes les zones en virgule flottante identifiées par la description externe du fichier physique base de données en sortie sont traitées par CPYF et converties du format en virgule flottante IBM 390 au format IEEE utilisé par l'i5/OS.

*NULLFLAGS

Demande à CPYF de prendre l'octet suivant chaque zone identifiée par la description externe du fichier en sortie comme étant de valeur indéfinie, et de l'utiliser comme indicateur pour spécifier si la zone d'entrée correspondante est de valeur indéfinie. Si l'octet est à blanc ('40'X) ou contient '00'X, les données sont considérées comme non indéfinies. Pour toute autre valeur de l'indicateur, les données d'entrées correspondantes seront ignorées et la valeur en sortie deviendra indéfinie.

Remarque : La description externe du fichier en entrée n'est pas utilisée pour le mappage des données copiées lorsque la valeur *CVTFLOAT ou *NULLFLAGS est indiquée et que le fichier en entrée comporte une description externe. Lorsque *CVTFLOAT ou *NULLFLAGS est indiquée, toute autre valeur est ignorée (à moins que *CVTFLOAT et *NULLFLAGS soient indiquées toutes les deux). TOFILE doit être un fichier de données physique à description externe. Les valeurs suivantes de paramètre ne peuvent être indiquées avec *CVTFLOAT ou *NULLFLAGS :

• RCDFMT(*ALL) lorsque le fichier d'origine est un fichier logique comportant plusieurs formats
• Valeur autre que la valeur par défaut du paramètre CRTFILE (sauf si le TOFILE existe déjà, auquel cas la valeur *YES est ignorée), FROMKEY, TOKEY, INCCHAR, INCREL, SRCOPT et SRCSEQ.

*** ATTENTION ***

*CVTFLOAT et *NULLFLAGS ne peuvent être utilisées que pour les conversions de données au format i5/OS et doivent être utilisées correctement afin d'éviter toute corruption des données.

*****************

Options de mise à jour source (SRCOPT)

Indique, dans le cas d'une copie vers un fichier physique source uniquement, si de nouveaux numéros de séquence doivent être insérés dans les zones correspondantes et si les zones date doivent être remises à zéro. Vous pouvez mentionner à la fois *SEQNBR et *DATE.

Valeurs particulières

*SAME

Les numéros de séquence source ne sont pas modifiés et les zones date source ne sont pas remises à zéro au sein des enregistrements copiés dans le fichier de destination. *SAME est obligatoire si le fichier de destination n'est pas un fichier physique source.

Autres valeurs (jusqu'à 2 répétitions)

*SEQNBR

De nouveaux numéros de séquence source sont insérés au sein des enregistrements copiés dans le fichier de destination. Le nouveaux numéros de séquence sont déterminés par la valeur de l'invite Numérotation du source (paramètre SRCSEQ).

*DATE

La zone date source est remise à zéro au sein des enregistrements copiés dans le fichier de destination.

Numérotation du source (SRCSEQ)

Indique (uniquement lorsque *SEQNBR est précisé dans l'invite Options de mise à jour source (paramètre SRCOPT)) le numéro de séquence attribué au premier enregistrement copié dans le fichier de destination et la valeur ajoutée pour renuméroter tous les autres enregistrements copiés.

Elément 1 : Numéro de séquence de début

1.00

Le numéro de séquence 0001.00. est attribué au premier enregistrement source copié dans le fichier de destination.

0.01-9999.99

Indiquez le numéro de séquence du premier enregistrement source copié dans le fichier de destination.

Elément 2 : Incrément

1.00

Un nombre entier incrémenté d'une unité est attribué aux enregistrements source copiés et renumérotés dans le fichier de destination.

0.01-9999.99

Indiquez la valeur ajoutée pour renuméroter tous les enregistrements source copiés après le premier enregistrement.

Nombre d'erreurs admises (ERRLVL)

Ce paramètre indique, pour chaque membre du fichier base de données d'origine ou chaque ID label du fichier bande d'origine, le nombre maximal d'erreurs de lecture ou d'écriture remédiables admises lors de la copie.

0

Si une erreur réparable se produit, la copie s'interrompt au membre où s'est produit l'erreur.

*NOMAX

Aucun nombre maximal d'erreurs n'est indiqué. Toutes les erreurs remédiables sont tolérées.

nombre-entier

Indiquez le nombre maximal d'erreurs remédiables autorisées dans chaque membre ou label copié depuis le fichier d'origine.

Compression enreg supprimés (COMPRESS)

Indique si les données du fichier d'origine doivent être comprimées dans le fichier de destination. Une compression a lieu lorsque les enregistrements supprimés du fichier d'origine ne sont pas copiés dans le fichier de destination. *NO est utilisé pour copier tous les enregistrements lorsque les fichiers d'origine et de destination sont tous deux des fichiers physiques. Si le fichier d'origine possède un attribut de suppression alors que le fichier de destination n'en possède pas, l'option *YES est obligatoire.

*YES

Les enregistrements copiés dans le fichier de destination sont comprimés. Autrement dit, les enregistrements supprimés du fichier d'origine ne sont pas copiés dans le fichier de destination.

*NO

Les enregistrements supprimés et non supprimés du fichier d'origine sont copiés dans le fichier de destination.

Exemples

Exemple 1 : fichier physique à fichier physique

CPYF   FROMFILE(PERSONNEL/PAYROLL)  TOFILE(TESTPAY/PAYROLL)
       MBROPT(*ADD)  CRTFILE(*YES)  ERRLVL(10)

Cette commande permet de copier tous les enregistrements du fichier physique PAYROLL de la bibliothèque PERSONNEL dans le fichier PAYROLL de la bibliothèque TESTPAY. Si le fichier d'origine contient plusieurs membres, seul le premier membre est copié. Si TESTPAY/PAYROLL n'existe pas, il est créé avant la copie des enregistrement et un membre portant le même nom que le fichier d'origine est ajouté à TESTPAY/PAYROLL pour la réception des enregistrements copiés.

Puisque MBROPT(*ADD) est indiqué, les enregistrements copiés sont ajoutés aux enregistrements existants dans le membre du fichier de destination. Puisque RCDFMT(*NONE) est adopté par défaut, le fichier de destination TESTPAY/PAYROLL doit présenter le même format d'enregistrement que le fichier d'origine. Si le fichier de destination (TESTPAY/PAYROLL) est créé par l'opération de copie, il possédera les mêmes format d'enregistrement et chemin d'accès que le fichier d'origine (PERSONNEL/PAYROLL). Si plus de dix erreurs remédiables se produisent pendant la copie, l'opération est interrompue.

Si FROMMBR(*ALL) et TOMBR(*FROMMBR) ont été également indiqués, tous les membres du fichier d'origine sont copiés vers les membres correspondants (portant le même nom) du fichier de destination. Pour chaque membre d'origine qui ne possède pas de membre de destination correspondant, un membre est ajouté dans le fichier de destination et tous les enregistrements du membre d'origine sont copiés vers le nouveau membre. Pour chaque membre de destination déjà existant, seuls les nouveaux enregistrements sont ajoutés. Aucune mise à jour n'est appliquée aux enregistrements existants quel que soit le type de l'opération de copie. Si le fichier de destination contient des membres pour lesquels il n'existe pas de membres correspondants dans le fichier d'origine, le fichier de destination contient plus de membres que le fichier d'origine après la copie.

Si plus de dix erreurs remédiables se produisent pendant la copie d'un membre, l'opération est interrompue et les membres restants ne sont pas copiés. ERRLVL(*NOMAX) peut être indiqué pour tolérer tous les erreurs remédiables. Ainsi, la copie n'est pas interrompue, quel que soit le nombre d'erreurs remédiables dans un membre de fichier spécifique.

Exemple 2 : fichier physique à fichier physique

CPYF   FROMFILE(PERSONNEL/EMP1)  TOFILE(PERSONNEL/VACLEFT)
       FROMMBR(VAC)  MBROPT(*REPLACE)
       FROMKEY(1 X'0008872F')  TOKEY(1 X'0810199F')
       INCREL((*IF VAC *GT 5.0))  FMTOPT(*MAP *DROP)

Dans cet exemple, le fichier de destination (VACLEFT) est un fichier physique existant, mais son format d'enregistrement diffère de celui du fichier physique EMP1 en cours de copie. Les deux fichiers se trouvent dans la bibliothèque PERSONNEL. Le fichier d'origine contient des enregistrements "employés" et possède une clé (numéro d'employé). Les enregistrement sélectionnés dans le fichier d'origine sont ceux dont les numéros d'employé sont compris entre 008872 et 810199. Seuls les enregistrements relatifs aux employés ayant plus de cinq jours de repos (VAC) sont mappés au fichier de réception. Les enregistrements sont sélectionnés dans le membre VAC et remplacent les enregistrements existants dans le premier membre du fichier VACLEFT.

Comme la clé du fichier est un nombre décimal condensé, les valeurs FROMKEY et TOKEY doivent être indiquées en tant que chaînes hexadécimales, et les zéros à gauche et le signe hexadécimal sont obligatoires dans la valeur. Vous pouvez également définir la même plage de valeurs de clé de la façon suivante :

       FROMKEY(*BLDKEY 8872)  TOKEY(*BLDKEY 810199)

Lorsque *BLDKEY est indiqué, l'opération de copie convertit chaque nombre au format requis pour la définition de clé de fichier. Etant donné qu'une seule valeur est indiquée, une seule zone clé est utilisée. La forme *BLDKEY des paramètres FROMKEY et TOKEY permet d'omettre les zéros à gauche et un signe positif lorsque la clé est numérique.

Si la clé d'un fichier regroupe plusieurs zones clés, la forme *BLDKEY est utilisée avec une liste de valeurs pour les paramètres FROMKEY et TOKEY. Par exemple, si les zones clés d'un fichier sont la zone commerciale (10 caractères) et les ventes du dernier mois (7 nombres décimaux condensés avec deux positions décimales), une clé complète est indiquée de l'une des manières suivantes :

       FROMKEY(*BLDKEY (GEORGIA  99.50))
       - ou -
       FROMKEY(2 X'C7C5D6D9C7C9C14040400009950F')

Lorsque la forme *BLDKEY est utilisée, chaque zone alphanumérique est remplie avec des blancs et chaque zone numérique est convertie au format de clé réel avec la valeur décalée à gauche ou à droite pour un alignement correct du symbole décimal.

Exemple 3 : fichier de données physique à fichier source physique

CPYF   FROMFILE(MYLIB/DATAFILE)  TOFILE(QIDU/QTXTSRC)
       FROMMBR(A1)  TOMBR(*FROMMBR)  MBROPT(*REPLACE)
       FMTOPT(*CVTSRC)

Cette commande permet de copier des enregistrements du fichier physique DATAFILE de la bibliothèque MYLIB, défini en tant que FILETYPE(*DATA), dans le fichier physique QTXTSRC de la bibliothèque QIDU, défini en tant que FILETYPE(*SRC). Comme les deux fichiers base de données sont de types différents, FMTOPT(*CVTSRC) doit être indiqué. Les enregistrements sont copiés dans le membre A1, qui porte le même nom que le membre d'origine. Des valeurs commençant par 1,00 et incrémentées de 1,00 sont affectées à la zone source de numéro de séquence des enregistrements copiés dans le fichier source. Si SRCOPT(*SEQNBR) est indiqué, le paramètre SRCSEQ est utilisé pour contrôler les numéros de séquence créés. La zone source de date contient toujours des zéros.

Exemple 4 : fichier logique à fichier physique

CPYF   FROMFILE(DEPTS/SALES)  TOFILE(DEPTS/YTDSALES)
       FROMMBR(TOTSALES)  TOMBR(MARCH)  RCDFMT(AA)
       NBRRCDS(5)  MBROPT(*REPLACE)

Cette commande permet de copier cinq enregistrements du membre TOTSALES du fichier logique SALES (bibliothèque DEPTS) vers le membre MARCH du fichier physique YTDSALES (bibliothèque DEPTS). Si le membre MARCH n'existe pas, il est créé et ajouté automatiquement au fichier de destination par l'opération de copie. Seuls les enregistrements du fichier logique SALES (bibliothèque DEPTS) qui utilisent un format d'enregistrement AA sont copiés vers YTDSALES, qui présente le même format. Après la copie, le membre MARCH ne contient que cinq enregistrements non supprimés. En effet, tous les enregistrements du membre sont d'abord effacés, puis seules les données des cinq premiers enregistrements (par ordre de clé) du membre TOTSALES sont copiées.

Exemple 5 : fichier unité à fichier physique

CPYF   FROMFILE(QDKT)  TOFILE(QGPL/QCLSRC)  FROMMBR(PAY*)
       TOMBR(*FROMMBR)  MBROPT(*REPLACE)
       SRCOPT(*SEQNBR)  SRCSEQ(1  .25)

Cette commande permet de copier des enregistrements de l'ensemble générique de labels de disquette dont le nom commence par les caractères PAY. Ils sont enregistrés vers les membres du fichier source QCLSRC (bibliothèque QGPL) qui portent le même nom. Bien que le fichier de destination soit un fichier source, un fichier disquette (QDKT) défini en tant que FILETYPE(*DATA) est utilisé comme fichier d'origine car QDKT est plus efficace qu'un fichier unité défini en tant que FILETYPE(*SRC). Pour chaque label copié, le premier enregistrement prend le numéro de séquence 1,00 et les numéros sont incrémentés de 0,25 pour chaque enregistrement suivant. Des zéros sont automatiquement affectés à la zone source de date.

Exemple 6 : fichier physique à imprimante

CPYF   FROMFILE(TEMPFILE)  TOFILE(*PRINT)  FROMMBR(EMP1)
       FROMKEY(1 448762)  NBRRCDS(20)  OUTFMT(*HEX)

Cette commande permet de copier des enregistrements du membre EMP1 du fichier TEMPFILE. Les enregistrements sont des enregistrements "employés". Une zone clé, le numéro d'employé, est utilisée pour la recherche des clés d'enregistrement. Vingt enregistrements commençant par le numéro d'employé 448762 sont copiés dans le fichier imprimante QSYSPRT fourni par IBM et répertoriés aux formats alphanumérique et hexadécimal. Le fichier imprimante fourni par IBM est indiqué par TOFILE(*PRINT).

Exemple 7 : fichier physique à fichier unité

CPYF   FROMFILE(PERSONNEL/PAYROLL)  TOFILE(DISK1)
       FROMMBR(VAC1)  INCCHAR(NAME 1 *CT SMITH)
       INCREL((*IF VAC *GT 10.5)(*AND HOLIDAYS *EQ 0))

Cette commande permet de copier tous enregistrements "employés" relatifs aux employés portant le nom de famille SMITH et ayant cumulé plus de dix jours et demi de congés qui ne correspondent pas à des vacances, du fichier PAYROLL (bibliothèque PERSONNEL) sur disquette. Le nom du membre de fichier copié est VAC1. Les zones de repos (VAC) et de vacances (HOLIDAYS) sont définies comme des zones décimales condensées, mais une valeur est indiquée sous forme alphanumérique dans le paramètre INCREL. Le fichier disquette DISK1 est utilisé. Il contient le label du fichier vers lequel la copie est effectuée et d'autres attributs de disquette tels que l'emplacement et l'ID volume.

Exemple 8 : fichier physique à fichiers unité

CPYF   FROMFILE(PERSONNEL/PAYROLL)  TOFILE(DISK1)
       FROMMBR(*ALL)  TOMBR(*FROMMBR)

Cette commande permet de copier tous les membres du fichier PAYROLL (bibliothèque PERSONNEL) dans des fichiers de données sur disquette (fichier unité DISK1). Le nom de chaque membre du fichier d'origine doit être un identificateur de label de disquette correct. Au besoin, utilisez la commande RNNM (Rebaptiser un membre) pour rebaptiser les membres dans le fichier d'origine avant de les copier.

Messages d'erreur

Messages *ESCAPE

CPF2807

Réponse d'annulation reçue pour le message &7.

CPF2816

Fichier &1 de &2 non copié à la suite d'une erreur.

CPF2817

Commande de copie interrompue à la suite d'une erreur.

CPF2818

TOMBR(*FROMMBR) non admis.

CPF2835

Position de début et longueur excessives pour chaîne de caractères INCCHAR.

CPF2857

Copie de plusieurs membres ou labels incompatible avec substitution.

CPF2858

Attributs de fichier incorrects pour sortie imprimée.

CPF2859

Partage d'un chemin d'ouverture non admis.

CPF2864

Non autorisé au fichier &1 de &2.

CPF2875

Le membre ou label ouvert n'est pas celui prévu.

CPF2883

Erreur lors de la création du fichier &1 dans &2.

CPF2888

Le membre &3 n'a pas été ajouté au fichier à la suite d'une erreur.

CPF2904

Labels de disquette incorrects pour copie de plusieurs labels.

CPF2906

Valeur incorrecte dans la zone INCREL.

CPF2909

Erreur à la mise à blanc du membre &3 de &1 dans &2.

CPF2949

Erreur à la fermeture du membre &3 de &1 dans &2.

CPF2952

Erreur lors de l'ouverture du fichier &1 de &2.

CPF2968

Erreur de positionnement lors de la copie du fichier &1 de &2.

CPF2971

Erreur de lecture du membre &3 du fichier &1.

CPF2972

Erreur d'écriture dans le membre &3 du fichier &1.

CPF2975

Erreur de lecture d'un fichier avec clé.

CPF2976

Nombre d'erreurs supérieur à la valeur de ERRLVL.

CPF3140

Initialisation ou copie du membre &2 annulée.

CPF3143

Incréments non admis pour le membre &2.

CPF3148

Espace mémoire insuffisant pour l'ajout d'enregistrements au membre &2.

CPF3150

La copie de base de données a échoué pour le membre &2.

CPF9212

Impossible de charger ou décharger le fichier DDM &2 de &3.