CPYTOTAP

La commande CPYTOTAP (Copier sur une bande) permet de copier des enregistrements dans un fichier bande. Le fichier de destination doit obligatoirement être un fichier bande. Le fichier d'origine peut être physique, logique, DDM, bande ou spoule en entrée.

Remarque :Pour plus d'informations sur les fichiers DDM, reportez-vous au manuel Rubriques Programmation d'une base de données répartie de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Cette commande met à votre disposition une partie des paramètres associés à la commande CPYF (Copier un fichier), ainsi que des paramètres propres aux bandes.

Restrictions :

• Lors de l'opération de copie, le partage du chemin d'ouverture d'un fichier (ODP) avec un autre programme du travail (phase d'activation) est impossible.

Paramètres

Fichier d'origine (FROMFILE)

Indique le fichier physique, logique, DDM, bande ou spoule en entrée à partir duquel les enregistrements doivent être copiés.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier d'origine

nom

Indiquez le nom du fichier à 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.

Fichier bande (TOFILE)

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

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier bande

nom

Indiquez le nom du fichier bande à utiliser pour le fichier de destination.

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.

Membre d'origine (FROMMBR)

Indique les membres base de données ou les identificateurs des fichiers bande à copier à partir du fichier d'origine. Si celui-ci est un fichier spoule en entrée, vous devez indiquer *FIRST pour ce paramètre.

*FIRST

Le premier membre du fichier indiqué est utilisé.

*ALL

Tous les membres d'un fichier base de données d'origine sont copiés. FROMMBR(*ALL) n'est pas admis pour un fichier bande ou un fichier de données en entrée.

nom-générique

Indiquez le nom générique de l'ensemble des membres base de données à copier. Un nom générique n'est pas correct pour un fichier bande ou un fichier spoule en entrée.

nom

Indiquez le nom du membre du fichier base de données, ou bien l'ID label de fichier de données bande, à copier. Si l'ID label de bande du fichier bande à copier comporte des caractères spéciaux ou plus de dix caractères, vous devez le spécifier à l'aide d'une commande CRTTAPF, CHGTAPF ou OVRTAPF à exécuter pour le fichier unité.

Numéro de séquence fichier (TOSEQNBR)

Indique le numéro de séquence du fichier de données qui recevra les enregistrements copiés.

*TAPF

Le numéro de séquence figurant dans le fichier bande est utilisé.

*END

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

Pour un fichier bande comportant un label, le label indiqué au paramètre TOLABEL doit correspondre à ce numéro de séquence. Les numéros de séquence admis sont compris entre 1 et 16777215.

Si un nouveau fichier de données est ajouté dans le fichier bande de destination, le numéro de séquence doit être supérieur de 1 au numéro de séquence du dernier fichier de données de ce volume. Aucune omission n'est admise dans la série des numéros de séquence. Si un numéro de séquence d'un fichier de données existant est indiqué, ce fichier est écrasé et tous les fichiers suivants du volume sont détruits.

1-16777215

Indiquez le numéro de séquence du fichier de données qui recevra les enregistrements copiés.

Label bande (TOLABEL)

Indique le label du fichier de données devant recevoir les enregistrements copiés. Cet ID est ignoré si la bande est sans label.

*FROMMBR

Le fichier de données recevant les enregistrements copiés dans le fichier de destination porte le même label que le membre ou le label copié du fichier d'origine. Si un nom de membre ou de label a été indiqué comme valeur du paramètre FROMMBR (ou implicitement spécifié par (*TAPF)), un fichier de données portant ce nom dans le fichier bande de destination reçoit les enregistrements copiés. Cette valeur n'est pas admise si un nom générique ou *ALL est indiqué au paramètre FROMMBR.

Si le fichier d'origine est un fichier bande sans label, un ID label est créé pour le fichier bande de destination au format CPYnnnnn, "nnnnn" désignant le numéro de séquence bande du fichier de données.

*TAPF

Le label indiqué dans le fichier bande ou dans un fichier de substitution est utilisé pour identifier le fichier de destination des enregistrements.

*NONE

Aucun identificateur de fichier de données n'est indiqué. *NONE n'est pas admis lorsque le fichier bande de destination a des labels standard.

valeur-alphanumérique

Indiquez le label identifiant le fichier base de données destiné à recevoir les enregistrements copiés.

Unité (TODEV)

Indique le nom des unités à utiliser pour copier les enregistrements dans le fichier bande de destination.

Valeurs uniques

*TAPF

Les unités indiquées dans la description du fichier bande sont utilisées.

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

nom

Indiquez les noms (quatre au maximum) des unités de bande, d'une unité de bande virtuelle ou d'une bandothèque utilisées pour l'écriture des enregistrements dans le fichier bande de destination. L'ordre de ces noms détermine l'ordre d'écriture dans le fichier bande de destination. Chaque unité doit avoir été définie dans une description d'unité à l'aide de la commande CRTDEVD avant d'être indiquée dans cette commande.

Spécifications bandes destinat (TOREELS)

Indique le type de label à utiliser sur les bandes recevant les enregistrements copiés. Le système ne peut écrire que sur des bandes dont le label est standard ou sur des bandes sans label.

*TAPF

La valeur indiquée dans le fichier bande de destination est utilisée.

*SL

Les labels du ou des volumes de destination sont standard.

*NL

Les volumes utilisés n'ont pas de labels. La fin des différents volumes et des fichiers correspondants est repérée par des marques.

*LTM

Le ou les volumes utilisés n'ont pas de labels, mais une marque de début de bande précède le premier enregistrement.

Longueur d'enregistrement (TORCDLEN)

Indique la longueur (en octet) des enregistrements écrits dans le fichier bande de destination. Les enregistrements du fichier d'origine peuvent être tronqués ou complétés de blancs de sorte que leur longueur soit identique à celle indiquée avant leur écriture sur la bande. Si un fichier de données existant (avec labels standard) est en cours d'extension sur la bande, la longueur d'enregistrement est extraite à partir du deuxième label d'en-tête (HDR2). La longueur d'enregistrement, la longueur de bloc et le format de bloc d'enregistrement doivent être cohérents. Si un nouveau fichier de données est ajouté ou s'il est sans label, la longueur d'enregistrement doit être explicitement spécifiée par ce paramètre ou par le paramètre RCDLEN indiqué avec l'une des commandes relatives aux fichiers bande.

*FROMFILE

La longueur d'enregistrement du fichier de destination est identique à celle du fichier d'origine. Si la longueur d'enregistrement du fichier d'origine est variable, la longueur maximale est choisie comme longueur d'enregistrement pour le fichier de destination.

*TAPF

La longueur d'enregistrement indiquée dans le fichier bande est utilisée.

*CALC

La longueur d'enregistrement indiquée dans le label du fichier de données existant est utilisée.

longueur-enregistrement

Indiquez la longueur (de 1 à 32767 octets) à utiliser pour les enregistrements écrits dans le fichier de destination. La longueur d'enregistrement doit être cohérente avec la longueur de bloc et le format de bloc d'enregistrement.

Option fin de bande (TOENDOPT)

Indique le type de positionnement qui doit s'effectuer automatiquement sur le dernier volume bande de destination lors de la fermeture du fichier bande. Dans le cas d'un fichier multivolume, toutes les bandes intermédiaires sont positionnées avec *UNLOAD. Le paramètre ne s'applique donc qu'à la dernière bande.

*TAPF

La bande se repositionne en fonction de la valeur indiquée dans le fichier bande.

*REWIND

La bande est rembobinée, mais pas déchargée.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération.

*LEAVE

La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

Identificateur de volume (TOVOL)

Indique, pour des bandes ayant des labels standard, le ou les identificateurs de volume des bandes à utiliser pour la copie des enregistrements dans le fichier bande de destination. L'ordre d'installation des volumes sur l'unité doit être celui dans lequel sont entrés les identificateurs. Si l'ordre est différent, un message est envoyé à l'opérateur.

Valeurs uniques

*TAPF

Les identificateurs de volume de bande indiqués dans le fichier bande sont utilisés.

*NONE

Aucun identificateur de volume de bande n'est indiqué pour le fichier. Le système vérifie si l'unité contient un volume ayant le type de label approprié (aucune autre vérification de volume n'est effectuée).

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

valeur-alphanumérique

Indiquez les identificateurs de volume (50 au maximum) à utiliser pour identifier les bandes de destination. L'ordre des volumes sur l'unité doit être identique à l'ordre d'indication de leurs ID et à celui des noms d'unité spécifiés au paramètre TODEV. Si l'ordre est différent, un message est envoyé à l'opérateur. Chaque identificateur comprend de 1 à 6 caractères alphanumériques.

Longueur de bloc (TOBLKLEN)

Indique la longueur (en octets) des blocs de données à transférer sur la bande. Cette longueur doit être compatible avec la longueur d'enregistrement et le format de bloc.

*TAPF

La longueur de bloc indiquée dans le fichier bande est utilisée.

*CALC

Aucune longueur de bloc n'est indiquée pour le fichier bande de destination. La longueur de bloc mentionnée dans le label du fichier de données existant est utilisée.

18-524288

Indiquez la longueur maximale du bloc de données écrit sur la bande.

Type de bloc enregistrement (TORCDBLK)

Indique le format et les attributs de bloc des enregistrements à copier dans le fichier bande de destination. Si un fichier de données existant est en cours d'extension en tant que fichier de destination, son format de bloc d'enregistrement est utilisé. La longueur d'enregistrement, la longueur de bloc et le format de bloc d'enregistrement doivent être cohérents.

*TAPF

La valeur de format de bloc d'enregistrement figurant dans le fichier bande est utilisée.

*F

Des enregistrements de longueur fixe, dégroupés et de format EBCDIC ou ASCII sont utilisés.

*FB

Des enregistrements de longueur fixe, groupés et de format EBCDIC ou ASCII sont utilisés.

*V

Des enregistrements de longueur variable, dégroupés et de format EBCDIC sont utilisés.

*VB

Des enregistrements de longueur variable, groupés et de format EBCDIC sont utilisés.

*D

Des enregistrements de longueur variable, dégroupés et de format ASCII type D sont utilisés.

*DB

Des enregistrements de longueur variable, groupés et de format ASCII type D sont utilisés.

*VS

Des enregistrements variables et fractionnés sont utilisés.

*VBS

Des enregistrements variables, fractionnés et groupés sont utilisés.

*U

Des enregistrements de format non défini sont utilisés.

Date d'expiration du fichier (TOEXPDATE)

Indique la date de péremption du fichier de données à ajouter au fichier de destination. Cette date n'est établie que pour les fichiers bande ayant un label standard. Elle est enregistrée dans le label d'en-tête de bande qui précède immédiatement le fichier de données décrit par le label.

*TAPF

La date de péremption figurant dans le fichier bande est utilisée pour le fichier de destination.

*PERM

Le fichier ajouté est protégé définitivement.

date

Indiquez la date de péremption à utiliser pour le fichier de données. La date doit figurer au format défini par les valeurs système QDATFMT et (si des séparateurs sont utilisés) QDATSEP.

Nombre d'enreg à copier (NBRRCDS)

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

*END

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

1-4294967288

Indiquez le nombre d'enregistrements à copier. La copie prend fin si une condition EOF (fin de fichier) est rencontrée avant que le nombre d'enregistrements indiqué soit atteint.

Compactage des données (COMPACT)

Indique si le compactage des données par l'unité est effectué. Ce paramètre est ignoré lorsque l'unité de bande utilisée par le fichier de destination ne prend pas en charge le compactage des données.

*TAPF

Le compactage de données est effectué, à condition que l'unité contenant le fichier de destination assure cette fonction.

*NO

Le compactage des données n'est pas effectué.

Exemples

Exemple 1 : copie du premier membre d'un fichier base de données sur bande

CPYTOTAP   FROMFILE(MYLIB/MYFILE)  TOFILE(QTAPE)  TODEV(QTAPE1)
           TORCDLEN(*FROMFILE)  TOEXPDATE(10 15 89)

Cette commande permet de copier le premier membre du fichier base de données MYFILE, bibliothèque MYLIB, sur bande. Le fichier bande QTAPE est utilisé. Il possède les attributs SEQNBR(1) et RCDBLKFMT(*F), qui sont utilisés comme valeurs par défaut pour les paramètres TOSEQNBR et TORCDBLK. Les attributs supplémentaires indiqués dans la commande de copie incluent le nom de l'unité de bande et la date d'expiration du fichier écrit sur la bande. Le nom de label utilisé sur la bande est identique à celui du membre copié. La longueur d'enregistrement du fichier bande est également identique à celle du fichier base de données d'origine car TORCDLEN (*FROMFILE) a été indiqué.

Exemple 2 : copie d'un membre d'un fichier base de données sur bande

CPYTOTAP   FROMFILE(MYLIB/MYFILE)  TOFILE(QTAPE)  FROMMBR(M1)
           TOLABEL(BACKUPM1)  TODEV(QTAPE1)  TORCDLEN(50)
           TOBLKLEN(1000)  TORCKBLK(*FB)  TOENDOPT(*LEAVE)

Cette commande permet de copier le membre M1 du fichier base de données MYFILE, bibliothèque MYLIB, sur bande à l'aide du fichier bande QTAPE. Les enregistrements sont copiés vers le label BACKUPM1 sur l'unité de bande QTAPE1 et la bobine reste dans la position en cours lorsque la copie est terminée. Le fichier de données écrit sur la bande comporte des enregistrements de 50 octets de longueur fixe regroupés en blocs de 1000 octets (ou 20 enregistrements).

Messages d'erreur

Messages *ESCAPE

CPF2816

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

CPF2817

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

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.

CPF2904

Labels de disquette incorrects pour copie de plusieurs labels.

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.

CPF9212

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