CPYTOIMPF

La commande CPYTOIMPF (Copier dans un fichier d'importation) permet de copier un fichier à description externe dans un fichier d'importation. Le terme fichier d'importation est utilisé pour décrire un fichier créé dans le but de permettre la copie de données entre des bases de données hétérogènes. Le fichier d'importation (paramètre TOSTMF ou TOFILE) sera appelé fichier de destination dans cette commande.

La commande CPYTOIMPF permet d'exécuter entre autres les fonctions spécifiques suivantes :

• Copie depuis un fichier physique à description externe vers le fichier de destination (paramètre TOFILE ou TOSTMF).
• Ajout d'enregistrements dans un membre de fichier de destination existant ou remplacement du contenu du membre de fichier de destination (paramètre MBROPT).

Gestion des erreurs : Le message d'arrêt programme CPF2817 est émis pour les nombreuses erreurs susceptibles de se produire au cours d'une opération de copie. Il est toujours précédé d'au moins un message de diagnostic indiquant le cas d'erreur spécifique. Pour plus de détails, consultez le 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/.

Substitutions Toutes les substitutions sont prises en compte pour cette commande. Les paramètres de substitution pris en charge par la commande CPYTOIMPF sont les suivants :

• FILE
• MBR
• OPNSCOPE
• SHARE
• LVLCHECK
• RCDFMTLCK
• SEQONLY
• INHWRT
• WAITRCD
• DSTDTA
• NBRRCDS

Message d'état : Pendant l'exécution de la commande CPYTOIMPF, le message CPI2801 est émis sous la forme d'un message d'état informant l'utilisateur interactif qu'une opération de copie est en cours. Pour savoir comment empêcher l'affichage de ces messages d'état, consultez le 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/.

Restrictions :

• Pendant l'exécution de la commande CPYTOIMPF, le fichier indiqué dans l'invite Fichier BD de destination (paramètre TOFILE) peut être verrouillé (similaire à un verrouillage *EXCL sans délai) et donc inaccessible.
• Si le fichier d'origine possède l'attribut SHARE(*YES), les résultats sont imprévisibles. En conséquence, vous devez vous assurer que le fichier d'origine n'est pas ouvert par un autre processus avant l'opération de copie.
• Si STMFAUT(*FILE) ou STMFAUT(*INDIRFILE) est indiqué, l'utilisateur doit disposer du droit de gestion des objets (*OBJMGT) sur le fichier base de données et sur le fichier STREAM.

  Remarque : Ne faites pas précéder une entrée d'un astérisque sauf si celle-ci est une "valeur spéciale" présentée (dans l'écran lui-même ou dans les informations d'aide) avec un astérisque.

Paramètres

Fichier d'origine (FROMFILE)

Indique le fichier contenant les enregistrements à copier. Le fichier base de données peut être de type logique à format unique, physique ou multisystème.

Ce paramètre est obligatoire.

Elément 1 : Fichier

Qualificatif 1 : Fichier

nom

Indiquez le nom du fichier contenant les enregistrements à copier.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

Elément 2 : Membre

*FIRST

Le premier membre (par ordre de date de création) du fichier d'origine indiqué est utilisé. L'option *FIRST n'est pas admise si le fichier d'origine ne contient pas de membres.

*ALL

Tous les membres du fichier indiqué sont copiés.

nom

Indiquez le nom du membre du fichier d'origine contenant les enregistrements à copier.

Fichier BD de destination (TOFILE)

Indique le fichier base de données destiné à recevoir les enregistrements copiés. Il est obligatoire d'indiquer soit ce paramètre, soit le paramètre TOSTMF.

Les différents types de fichier de destination possibles sont les suivants :

• fichier physique source,
• fichier physique décrit dans les programmes,
• fichier physique à description externe comportant une zone non numérique.

Elément 1 : Fichier

Qualificatif 1 : Fichier

nom

Indiquez le nom du fichier destiné à recevoir les enregistrements copiés.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

Elément 2 : Membre

*FIRST

Le premier membre (par ordre de date de création) du fichier de destination indiqué est utilisé.

La valeur *FIRST n'est pas admise si le fichier de destination indiqué ne comporte pas de membres et qu'aucune substitution (commande OVRDBF) indiquant un nom de membre pour le fichier de destination n'est active.

*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.

*FROMMBR

Cette valeur impose une correspondance entre les noms de membres des fichiers d'origine et des fichiers de destination.

nom

Indiquez le nom du membre du fichier de destination qui doit recevoir les enregistrements copiés. Si aucun membre de ce nom n'existe dans le fichier de destination, il est créé.

Fichier STREAM de destination (TOSTMF)

Indique le fichier STREAM en sortie dans lequel doivent être copiées les données. Soit ce paramètre, soit le paramètre TOFILE est obligatoire. Tous les répertoires inclus dans le nom du chemin d'accès doivent exister. Aucun répertoire n'est créé. Si le fichier STREAM n'existe pas, il est créé.

Remarque :Le système de fichiers QSYS.LIB n'admet pas la définition d'attributs, de sorte que si le chemin indiqué au paramètre TOSTMF est un membre QSYS, des messages de diagnostic seront consignés dans l'historique des travaux. Ces messages de diagnostic n'empêchent pas la poursuite de l'opération de copie.

nom-chemin

Indiquez le chemin d'accès au fichier STREAM en sortie dans lequel doivent être copiées les données.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remplacement ou ajout enregs (MBROPT)

Indique si la copie échoue ou si elle effectue un remplacement ou un ajout d'enregistrements dans le membre du fichier de destination lorsqu'un membre de ce nom existe déjà. Si le membre n'existe pas, il est créé et ajouté au fichier.

Remarque :Si *ADD est indiqué alors que le fichier de destination ne contient aucun enregistrement, l'opération de copie s'exécute normalement. Si *REPLACE est indiqué et que le fichier de destination ne contient pas d'enregistrements, l'opération se termine anormalement.

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/.

*ADD

Les enregistrements copiés sont ajoutés après ceux du membre.

*REPLACE

Les enregistrements copiés remplacent ceux du membre.

CCSID d'origine (FROMCCSID)

Indique le CCSID à utiliser pour les zones du fichier d'origine.

*FILE

Les données sont converties à partir du CCSID de zone du fichier d'origine. Si le CCSID de zone du fichier d'origine est 65535, la zone n'est pas convertie et elle est traitée comme si elle contenait des données binaires.

1-65533

Indiquez le CCSID à utiliser lorsque le CCSID de la zone de fichier d'origine est 65535. Si le CCSID de la zone de fichier d'origine n'est pas 65535, ce paramètre n'est pas pris en compte.

CCSID de destination (TOCCSID)

Indique le CCSID à utiliser pour le fichier indiqué dans l'invite Fichier BD de destination (paramètre TOFILE).

*FILE

Le CCSID du fichier base de données de destination est utilisé.

1-65533

Indiquez le CCSID à utiliser si le fichier de destination possède le CCSID 65535. Si ce CCSID est différent de 65535, un message d'erreur est généré.

CCSID fichier STREAM (STMFCCSID)

Indique la méthode qui permet d'obtenir l'équivalent CCSID de la page de codes associée au fichier STREAM à utiliser pour la conversion de données.

Ce paramètre ne peut pas être indiqué avec le paramètre Page de codes fichier STREAM (STMFCODPAG).

*STMF

Si le fichier STREAM existe et que la conversion de données est demandée, celle-ci utilise l'équivalent CCSID de la page de codes associée au fichier.

Si le fichier STREAM n'existe pas, l'équivalent CCSID du CCSID fichier base de données source est utilisé.

*STDASCII

Si le fichier STREAM existe, cette option n'est admise que si l'équivalent CCSID de la page de codes associée au fichier STREAM est identique à la valeur indiquée. Sinon, l'opération échoue.

Si le fichier STREAM n'existe pas, un CCSID du schéma de codage de données PC IBM PC (x2100) est calculé. Ce CCSID est associé au fichier STREAM cible et est utilisé pour la conversion de données si cette opération est demandée.

*PCASCII

Si le fichier STREAM existe, cette option n'est admise que si l'équivalent CCSID de la page de codes associée au fichier STREAM est identique à la valeur indiquée. Sinon, l'opération échoue.

Si le fichier STREAM n'existe pas, un CCSID du schéma de codage de données Microsoft Windows (x4105) est calculé. (Microsoft et Windows sont des marques de Microsoft Corporation.) Ce CCSID est associé au fichier STREAM cible et est utilisé pour la conversion de données si cette opération est demandée. Cette option permet aux applications Microsoft Windows d'utiliser des données qui en résultent.

1-65533

Indiquez le CCSID souhaité du fichier STREAM. Si le fichier STREAM existe, cette option n'est admise que si la valeur indiquée correspond au CCSID du fichier STREAM. Sinon, un message d'erreur est généré. Si le fichier STREAM n'existe pas, le CCSID indiqué est associé au fichier STREAM au moment de sa création.

Page de codes fichier STREAM (STMFCODPAG)

Indique la méthode qui permet d'obtenir la page de codes du fichier STREAM et l'équivalent CCSID de cette page de codes à utiliser pour la conversion de données.

Ce paramètre ne peut pas être indiqué avec le paramètre CCSID fichier STREAM (STMFCCSID).

Remarque :Ce paramètre est remplacé par STMFCCSID mais STMFCODPAG peut toujours être utilisé. Toutefois, comme STMFCODPAG peut être amené à disparaître dans une prochaine version, utilisez de préférence STMFCCSID.

*STMF

Si le fichier STREAM existe et que la conversion de données est demandée, celle-ci utilise l'équivalent CCSID de la page de codes associée au fichier.

Si le fichier STREAM n'existe pas, l'équivalent de la page de codes associée au CCSID fichier base de données source est utilisé.

*STDASCII

Si le fichier STREAM existe, cette option n'est admise que si la page de codes associée au fichier STREAM est identique à la valeur indiquée. Sinon, l'opération échoue.

Si le fichier STREAM n'existe pas, une page de codes du schéma de codage de données PC IBM (x2100) est calculée. Cette page de codes est associée au fichier STREAM cible et est utilisée pour la conversion de données si cette opération est demandée.

*PCASCII

Si le fichier STREAM existe, cette option n'est admise que si la page de codes associée au fichier STREAM est identique à la valeur indiquée. Sinon, l'opération échoue.

Si le fichier STREAM n'existe pas, une page de codes du schéma de codage de Microsoft Windows (x4105) est calculée. (Microsoft et Windows sont des marques de Microsoft Corporation.) Cette page de codes est associée au fichier STREAM cible et est utilisée pour la conversion de données si cette opération est demandée. Cette option permet aux applications Microsoft Windows d'utiliser des données qui en résultent.

1-32767

Indiquez la page de codes à utiliser. Si le fichier STREAM existe, cette option n'est admise que si la page de codes associée au fichier STREAM est identique à la valeur indiquée. Sinon, un message d'erreur est généré. Si le fichier STREAM n'existe pas, il est créé et associé à la page de codes indiquée.

Droit d'accès fichier STREAM (STMFAUT)

Indique la méthode d'affectation des paramètres de droits d'accès au fichier STREAM en sortie indiqué dans lequel les données doivent être copiées. Si le fichier STREAM en sortie existe, ce paramètre est ignoré.

*DFT

Le propriétaire du fichier STREAM bénéficie du droit sur les données *RWX de ce fichier. Les groupes primaires et *PUBLIC n'ont aucun droit (*NONE) sur les données de ce fichier. Les droits sur les objets reposent sur ceux du répertoire dans lequel le fichier STREAM doit être créé.

*INDIR

Les paramètres des droits du fichier STREAM en sortie reposent sur les droits du répertoire dans lequel le fichier STREAM doit être créé. Le fichier STREAM reçoit les mêmes droits publics, droits privés, groupe primaire, droits du groupe principal, liste d'autorisation et valeur d'audit que ceux du répertoire dans lequel il est créé. Si le système de fichiers cible ne prend pas en charge la valeur spéciale *INDIR, la commande échoue.

*FILE

Les paramètres des droits du fichier STREAM en sortie reposent sur les droits de l'objet indiqués dans le paramètre Fichier d'origine (FROMFILE). Le fichier STREAM reçoit les mêmes droits publics, droits privés, groupe primaire, droits du groupe principal, liste d'autorisation et valeur d'audit que ceux de l'objet fichier d'origine en cours de copie. Si le système de fichiers cible ne prend pas en charge une ou plusieurs de ces valeurs, les valeurs non prises en charge sont ignorées.

Si l'objet fichier d'origine est un fichier multisystème, la valeur par défaut *DFT est utilisée à la place de la valeur *FILE.

*INDIRFILE

Les informations sur les droits résultantes sont similaires à celles qui sont produites par copie et collage d'un fichier STREAM à l'aide de l'interface graphique IBM System i Navigator. Les informations sur les droits du fichier STREAM reposent au départ sur le répertoire dans lequel le fichier STREAM est créé. Ensuite, les informations sur les droits de l'objet indiquées dans le paramètre Fichier d'origine (FROMFILE) sont copiées dans l'objet. Ces informations peuvent remplacer certaines des informations sur les droits initiales obtenues du répertoire.

Si l'objet fichier d'origine est un fichier multisystème, la valeur par défaut *INDIR est utilisée à la place de la valeur *INDIRFILE.

Délimiteur d'enregistrement (RCDDLM)

Indique le délimiteur d'enregistrement du fichier de destination.

Si le paramètre TOFILE est défini, les valeurs admises sont *EOR ou une valeur alphanumérique. Si le paramètre TOSTMF est défini, les valeurs admises sont *CR, *CRLF, *LF, *LFCR ou *ALL.

*EOR

Fin d'enregistrement.

*CRLF

Un retour ligne suivi d'un saut de ligne est ajouté en fin de ligne.

*LF

Un saut de ligne est ajouté en fin de ligne.

*CR

Un retour ligne est ajouté en fin de ligne.

*LFCR

Un saut de ligne suivi d'un retour ligne est ajouté en fin de ligne.

valeur-alphanumérique

Spécifiez le caractère indiquant la fin d'un enregistrement unique.

Format enr fichier importation (DTAFMT)

Indique le format des données du fichier de destination généré.

*DLM

Les données contiennent des caractères de délimitation. Pour plus de détails sur les caractères de délimitation de chaîne, de zone et d'enregistrement, reportez-vous aux descriptions de paramètres des commandes STRDLM, FLDDLM et RCDDLM.

*FIXED

Format de données fixe. Les données figurent dans des colonnes de données fixes dans chaque enregistrement. Pour plus de détails sur les zones de données indéfinies dans le fichier de destination, reportez-vous à l'invite Indicateur de zone indéfinie (paramètre NULLIND). La longueur fixe maximale est déterminée par le nombre maximal de caractères requis par la zone, et cela peut entraîner le renvoi de caractères excédentaires pour remplir la longueur maximale.

Délimiteur de chaîne (STRDLM)

Indique le délimiteur de chaîne utilisé pour les données des zones dans lesquelles une copie est effectuée. Le caractère spécifié permet d'indiquer le début et la fin des chaînes alphanumériques, de date, d'heure et d'horodatage dans le fichier de destination. Suivant le programme utilisé pour créer le fichier de destination, il est possible que certains types de chaînes ne comportent aucun délimiteur dans le fichier de destination.

Le caractère délimiteur indiqué sera converti du CCSID du travail dans le CCSID du fichier de destination. Si le CCSID du fichier de destination est 1200, 1208 ou 13488, le délimiteur est converti au CCSID du travail ou au CCSID par défaut du travail lorsque le CCSID du travail est 65535.

*DBLQUOTE

Un guillemet est utilisé comme délimiteur de chaîne.

*NONE

Aucun caractère n'est défini comme délimiteur de chaîne. La valeur *NONE représente un blanc ( ).

valeur-alphanumérique

Indiquez la valeur alphanumérique utilisée comme délimiteur de chaîne.

Caractère d'échap de chaîne (STRESCCHR)

Indique le caractère d'échappement qui doit être généré dans les zones de chaîne du fichier de destination. Les zones alphanumériques du fichier de destination peuvent contenir des caractères ayant une signification particulière pour l'utilitaire d'importation. Ces caractères sont le délimiteur de chaîne de caractères et le caractère d'échappement de chaîne lui-même.

Le caractère d'échappement de chaîne précède ces caractères dans le fichier de destination et révoque leur signification particulière. L'utilitaire d'importation peut alors déterminer si le caractère est une données ou un délimiteur de chaîne.

Le caractère d'échappement de chaîne spécifié sera converti du CCSID du travail au CCSID du fichier de destination. Si le CCSID du fichier de destination est 1200, 1208 ou 13488, le caractère d'échappement de chaîne est converti au CCSID du travail ou au CCSID par défaut du travail lorsque le CCSID du travail est 65535.

*STRDLM

Le délimiteur de chaîne de caractères est utilisé comme caractère d'échappement. Chaque délimiteur de chaîne d'une zone alphanumérique de fichier d'origine est exportée sous forme de deux délimiteurs de chaînes adjacents.

*NONE

Aucun caractère d'échappement de chaîne n'est inséré dans les données. Si le caractère délimiteur de chaîne est présent dans les données, des résultats inattendus peuvent se produire dans l'utilitaire d'importation qui se base sur le fichier de destination.

valeur-alphanumérique

Indiquez le caractère à utiliser comme caractère d'échappement.

Retrait des blancs (RMVBLANK)

Indique si les blancs doivent être enlevés ou conservés. Ce paramètre n'est pas pris en compte lorsque le paramètre DTAFMT a pour valeur *FIXED, sauf si la valeur *EOR est utilisée.

*NONE

Tous les blancs à gauche et les blancs de fin sont conservés.

*LEADING

Les blancs à gauche sont enlevés.

*TRAILING

Les blancs de fin sont enlevés.

*BOTH

Les blancs à gauche et les blancs de fin sont enlevés.

*EOR

Les blancs de fin sont enlevés de la dernière zone de l'enregistrement.

Délimiteur de zone (FLDDLM)

Indique le délimiteur de zone utilisé dans l'enregistrement. La valeur spécifiée est placée entre les différentes zones.

','

Une virgule est utilisée comme séparateur de zone.

*TAB

Le caractère de tabulation horizontale est utilisé comme délimiteur de zone.

valeur-alphanumérique

Indiquez la valeur alphanumérique utilisée comme délimiteur de zone.

Indicateur de zone indéfinie (NULLIND)

Indique si le premier caractère suivant chaque zone contient la valeur Y ou N afin de préciser si la zone est indéfinie ou non. NULLIND(*YES) est admis uniquement si *FIXED est indiqué pour l'invite Format enr fichier importation (paramètre DTAFMT).

*NO

Aucun indicateur de valeur indéfinie ne doit être ajouté à la suite de chaque zone.

*YES

Un indicateur de valeur indéfinie doit être ajouté à la suite de chaque zone du fichier de destination à format fixe généré.

Remplissage zone numérique (NUMFLDPAD)

Indique le remplissage appliqué aux zones numériques. Ce paramètre n'est pas pris en compte lorsque le paramètre DTAFMT n'est pas *FIXED.

*NONE

Pas de remplissage, avec pour résultat l'alignement à gauche.

*BLANK

Remplissage à gauche avec des blancs, avec pour résultat l'alignement à droite.

*ZERO

Remplissage à gauche avec des zéros.

Symbole décimal (DECPNT)

Indique le symbole décimal à utiliser lors de la copie de données numériques dans le fichier de destination.

*PERIOD

Un point (.) est utilisé comme symbole décimal.

*COMMA

Une virgule (,) est utilisée comme symbole décimal.

Format de date (DATFMT)

Indique le format de date à utiliser lors de la copie de zones de date dans le fichier de destination.

*ISO

Le format de date ISO (aaaa-mm-jj) est utilisé.

*USA

Le format de date américain (mm/jj/aaaa) est utilisé.

*EUR

Le format de date européen (jj.mm.aaaa) est utilisé.

*JIS

Le format de date JIS (aaaa-mm-jj) est utilisé.

*YYMD

Le format de date aaaammjj est utilisé.

Format d'heure (TIMFMT)

Indique le format d'heure à utiliser lors de la copie de zones d'heure dans le fichier de destination.

*ISO

Le format d'heure ISO (hh-mm-ss) est utilisé.

*USA

Le format d'heure américain (hh:mm xx, où xx représente AM ou PM) est utilisé.

*EUR

Le format d'heure européen (hh.mm.ss) est utilisé.

*JIS

Le format d'heure JIS (hh:mm:ss) est utilisé.

Tri sur (ORDERBY)

Indique l'ordre dans lequel les enregistrements seront insérés dans le fichier de destination.

*NONE

Aucun ordre spécifique n'est demandé.

*ARRIVAL

Les enregistrements seront insérés dans l'ordre où ils ont été insérés dans le fichier d'origine.

valeur-alphanumérique

Indiquez une clause SQL ORDER BY qui sera utilisée pour le classement des enregistrements dans le fichier de destination.

Ajout de noms de colonnes (ADDCOLNAM)

Indique si les noms de colonne doivent être ajoutés au premier enregistrement du fichier de destination.

*NONE

Aucun nom de colonne ne sera ajouté.

*SQL

Les noms de colonne SQL seront ajoutés.

*SYS

Les noms de colonne système seront ajoutés.

Exemples

CPYTOIMPF   FROMFILE(DB2FILE)  TOFILE(EXPFILE)
            FLDDLM(';')  RCDDLM(X'07')
            STRDLM(*DBLQUOTE) DATFMT(*JIS) TIMFMT(*JIS)

Tous les enregistrements du fichier à description externe DB2FILE seront copiés dans le fichier d'importation EXPFILE. Les zones du fichier d'importation seront délimitées par des points-virgules (;). Les enregistrements du fichier d'importation seront délimités par un caractère hexadécimal '07'. Les valeurs alphanumériques, de date, d'heure et d'horodatage commenceront et se termineront par des guillemets. Les zones de date et d'heure seront au format *JIS.

Messages d'erreur

Messages *ESCAPE

CPF2817

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