CPYPTF

La commande CPYPTF permet de copier des PTF spécifiées à partir d'une bande, d'un support optique, d'un service ou d'un fichier sauvegarde vers une bande, un support optique, un service ou un fichier sauvegarde. Chaque PTF contient un ou plusieurs objets, y compris des programmes, pouvant être chargés à l'aide de la commande Charger des PTF (LODPTF) et appliqués à un produit au moyen de la commande Appliquer des PTF (APYPTF).

Restrictions :

• Cette commande est fournie avec le droit public d'exclude (*EXCLUDE). Les profils utilisateur QPGMR, QSYSOPR, QSRV et QSRVBAS possèdent des droits privés sur cette commande.
• Si aucune édition cible n'est associée à la PTF en cours de copie ou si l'édition cible indiquée n'est pas admise pour des opérations de sauvegarde ou restauration, la PTF est copiée dans l'édition de sauvegarde et de restauration admise la plus récente pour les objets qu'elle contient.

Paramètres

Produit (LICPGM)

Indique le produit pour lequel des PTF sont copiées.

Remarque :Les paramètres LICPGM(*ALL) et LICPGM(*SUPPTD) ne sont admis que si le paramètre TODEV(*SERVICE) est spécifié.

Ce paramètre est obligatoire.

*ALL

Les PTF de tous les produits installés et pris en charge sont copiées.

*SUPPTD

Les PTF de tous les produits pris en charge sont copiées. Les PTF des produits qui sont installés mais non pris en charge ne sont pas copiées.

caractère-valeur

Indiquez l'identificateur, composé de 7 caractères, du produit pour lequel des PTF sont copiées.

Unité d'origine (FROMDEV)

Spécifie l'unité à partir de laquelle les PTF sont copiées.

Ce paramètre est obligatoire.

*SERVICE

Les PTF transmises par le système du service de maintenance sont copiées.

*SAVF

Les PTF sont copiées à partir d'un fichier sauvegarde.

nom

Spécifiez le nom de la bande ou du lecture de disque optique à partir duquel les PTF sont copiées.

Unité de destination (TODEV)

Indique l'unité dans laquelle les PTF sont copiées.

Ce paramètre est obligatoire.

*SAVF

Les PTF sont copiées dans un fichier sauvegarde.

*SERVICE

Les PTF qui n'existent pas encore sont copiées dans *SERVICE. Cette valeur n'est admise que si les paramètres SELECT(*ALL) et COVER(*YES) sont indiqués et qu'une bande ou une unité optique est spécifiée au paramètre FROMDEV.

nom

Spécifiez le nom de la bande ou du lecteur de disque optique sur lequel les PTF sont copiés.

Numéros de PTF à sélectionner (SELECT)

Indique les PTF qui sont copiées. Si des PTF sont précisées individuellement, aucune valeur ne doit être indiquée pour le paramètre Numéros de PTF à omettre (OMIT).

Valeurs uniques

*ALL

Toutes les PTF sont copiées. Ce paramètre ne peut pas être indiqué quand *SERVICE est défini pour le paramètre Unité d'origine (FROMDEV).

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

valeur-alphanumérique

Entrez le numéro de chaque modification de logiciel à copier. Le nombre de numéros de PTF pouvant être indiqué est limité à 50.

Numéros de PTF à omettre (OMIT)

Indique que toutes les PTF, à l'exception de celles mentionnées dans ce paramètre, sont copiées. Entrez les numéros des PTF à omettre (ne pas copier). Vous pouvez indiquer jusqu'à 50 numéros. Ce paramètre ne peut pas être spécifié si des numéros de PTF simples sont spécifiés pour le paramètre Numéros de PTF à sélectionner (SELECT).

valeur-alphanumérique

Spécifiez le numéro de PTF de chaque PTF à omettre (à ne pas copier).

Edition (RLS)

Indique le niveau d'édition du produit logiciel.

*ONLY

Cette valeur n'est correcte que si une seule édition est installée ou prise en charge sur le système lorsque FROMDEV(*SERVICE) est indiqué ou lorsque le paramètre FROMDEV correspond à une unité optique et qu'une seule édition du produit existe sur le support. Si le paramètre FROMDEV correspond à une unité de bande, le niveau d'édition du logiciel sur le support n'est pas pris en compte.

caractère-valeur

Indiquez le niveau d'édition dans l'un des formats suivants :

• VxRyMz, où Vx représente le numéro de version, Ry le numéro d'édition et Mz le niveau de modification. Les variables x et y peuvent être un nombre de 0 à 9. La variable z peut être un nombre de 0 à 9 ou une lettre de A à Z.
• vvrrmm, où la version vv et l'édition rr doivent être des nombres compris entre 00 et 35, et la modification mm doit être un chiffre compris entre 00 et 09 ou une lettre comprise entre 0A et 0Z. Les zéros de début sont obligatoires. Ce format doit être utilisé si la version ou l'édition du produit est supérieure à 9.

Fichier sauvegarde origine (FROMSAVF)

Spécifie le fichier de sauvegarde à partir duquel les PTF sont copiées.

Remarque :Ce paramètre n'est admis que si la valeur *SAVF est indiquée dans le paramètre Unité d'origine (FROMDEV).

Qualificatif 1 : Fichier sauvegarde origine

nom

Spécifiez le nom du fichier de sauvegarde.

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

Le fichier sauvegarde est recherché dans la bibliothèque en cours du travail. Si aucune bibliothèque en cours n'est indiquée en tant que bibliothèque en cours du travail, la bibliothèque QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque qui contient le fichier sauvegarde.

No séquence bande origine (FROMSEQNBR)

Indique le numéro de séquence du volume sur bande depuis lequel les PTF sont copiées.

Remarque :Ce paramètre n'est admis que si un nom d'unité de bande est indiqué pour le paramètre Unité d'origine (FROMDEV). Si la valeur *SERVICE est spécifiée pour le paramètre TODEV, ce paramètre est ignoré et tous les fichiers sont traités sur l'unité indiquée au paramètre Unité d'origine (FROMDEV).

*SEARCH

La recherche du premier fichier PTF du logiciel sous licence s'effectue sur le volume. Cette PTF est ensuite copiée.

1-16777215

Entrez le numéro de séquence qui servira de départ à la copie des données PTF. Ce numéro doit figurer sur la bande.

Option fin de support origine (FROMENDOPT)

Indique l'opération qui est exécutée sur la bande ou le volume optique après l'opération de copie de PTF. Si cette opération concerne un ou plusieurs volume(s), ce paramètre ne s'applique qu'au dernier d'entre eux.

Remarque :Ce paramètre n'est admis que si une bande ou une unité optique est spécifiée au paramètre FROMDEV. Pour les unités optiques, seule la valeur spéciale *UNLOAD est acceptée. Les valeurs *REWIND et *LEAVE ne seront pas prises en compte. Si la valeur *SERVICE est spécifiée pour le paramètre TODEV, ce paramètre est ignoré et la valeur *REWIND sera utilisée après le traitement de tous les fichiers de l'unité indiquée au paramètre Unité d'origine (FROMDEV).

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

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

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.

ID chemin source (FROMPATHID)

Indique le numéro permettant d'identifier un fichier sur le support optique contenant les PTF à copier. Un numéro de chemin est attribué à chacun des fichiers de PTF relatifs à chaque produit et édition stockés sur le support optique. Ils peuvent ainsi être traités dans un ordre précis. Seules les PTF provenant de l'ID chemin spécifié sont copiées sur votre système.

Remarque :Ce paramètre n'est admis que si un nom de lecteur de disque optique est indiqué pour le paramètre Unité d'origine (FROMDEV). Si la valeur *SERVICE est spécifiée pour le paramètre TODEV, ce paramètre est ignoré et tous les fichiers sont traités sur l'unité indiquée au paramètre Unité d'origine (FROMDEV).

*FIRST

Le premier fichier de PTF relatif au produit et à l'édition indiqués est recherché sur le support optique en fonction de la sélection indiquée au paramètre SELECT.

• Lorsqu'un identificateur de PTF spécifique est indiqué au paramètre SELECT, cette PTF est copiée dès la première occurrence.
• Lorsque *ALL est indiqué au paramètre SELECT, le fichier de PTF existant associé à l'ID chemin le moins élevé est copié.

*SELECT

La liste des fichiers de PTF stockés sur le support optique et correspondant au produit et à l'édition s'affiche. Vous pouvez sélectionner le fichier à partir duquel les PTF sont copiées. Cette valeur ne peut pas être sélectionnée en mode de traitement par lots.

1-9999

Spécifiez le numéro d'identificateur du chemin d'accès du fichier de PTF existant à partir duquel copier le données des PTF pour le produit et l'édition.

Identificateur de volume (TOVOL)

Spécifie l'identificateur du volume de la bande ou du volume optique qui reçoit le PTF copiées.

Remarque :Ce paramètre n'est admis que si une bande ou une unité optique est spécifiée au paramètre TODEV (Unité de destination).

*MOUNTED

Le volume présent sur l'unité est utilisé.

caractère-valeur

Entrez l'identificateur de volume de la bande ou du support optique.

No séquence bande destination (TOSEQNBR)

Indique le numéro de séquence du fichier de données qui reçoit les PTF copiées.

Remarque :Ce paramètre n'est admis que si un nom d'unité de bande est indiqué pour le paramètre Unité de destination (TODEV).

*END

Les PTF sont copiées à la fin de la bande.

1-16777215

Entrez le numéro de séquence du fichier de données qui reçoit les PTF copiées.

Option fin support destination (TOENDOPT)

Indique l'opération qui est exécutée sur la bande ou le volume optique après l'opération de copie de PTF. Si cette opération concerne un ou plusieurs volume(s), ce paramètre ne s'applique qu'au dernier d'entre eux.

Remarque :Ce paramètre n'est admis que si une bande ou une unité optique est indiquée au paramètre TODEV. Pour les unités optiques, seule la valeur spéciale *UNLOAD est acceptée. Les valeurs *REWIND et *LEAVE ne seront pas prises en compte.

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

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

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.

Fichier sauvegarde destination (TOSAVF)

Spécifie le fichier de sauvegarde dans lequel les PTF sont copiées.

Qualificatif 1 : Fichier sauvegarde destination

nom

Indiquez le nom du fichier sauvegarde.

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

Le fichier sauvegarde est recherché dans la bibliothèque en cours du travail. Si aucune entrée de bibliothèque en cours ne figure dans la liste des bibliothèques, la bibliothèque QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque qui contient le fichier sauvegarde.

Mise à blanc (CLEAR)

Indique si les fichiers sauvegarde non mis à blanc et rencontrés lors de la copie des PTF, sont automatiquement mis à blanc ou non.

Remarque :Ce paramètre n'est admis que si la valeur *SAVF est indiquée dans le paramètre Unité de destination (TODEV).

*NONE

Un fichier sauvegarde non mis à blanc n'est pas automatiquement mis à blanc.

*ALL

Un fichier sauvegarde non mis à blanc est automatiquement mis à blanc afin que l'opération puisse se poursuivre.

Copier lettre d'accompagnement (COVER)

Indique si la lettre d'accompagnement de la PTF doit être copiée. Les lettres d'accompagnement ne sont pas copiées si FROMDEV(*SERVICE) est spécifié avec plusieurs PTF (paramètre SELECT).

*YES

La lettre d'accompagnement est copiée.

*NO

La lettre d'accompagnement n'est pas copiée.

Langue lettre d'accompagnement (CVRLTRLNG)

Indique la langue de la lettre d'accompagnement de PTF à copier. Si FROMDEV(*SERVICE) est indiqué et si plusieurs lettres d'accompagnement (plusieurs langues) sont associées à une PTF, indiquez le code dispositif de langue associé à la lettre d'accompagnement que vous souhaitez copier.

Remarque :Ce paramètre n'est admis que si la valeur *YES est indiquée dans le paramètre Copier lettre d'accompagnement (COVER).

*ONLY

La seule lettre d'accompagnement associée à la PTF est copiée, quel que soit le code dispositif de langue.

caractère-valeur

Indiquez le code dispositif de langue associé à la lettre d'accompagnement de PTF à copier. Un code dispositif de langue peut être indiqué uniquement lorsque *SERVICE est spécifié dans le paramètre FROMDEV.

Compression des données (DTACPR)

Indique si la compression des données est utilisée.

*DEV

Si la sauvegarde se fait sur bande et que l'unité cible accepte la compression des données, la compression matérielle est effectuée. Sinon, les données ne seront pas comprimées.

*NO

La compression des données n'est pas utilisée.

*YES

Si la sauvegarde se fait sur bande et que l'unité cible accepte la compression des données, la compression matérielle est effectuée. Si la compression n'est pas prise en charge ou si les données de sauvegarde sont écrites dans un fichier de sauvegarde, celle-ci est exécutée par logiciel. Dans ce cas, la sauvegarde pourra avoir des conséquences néfastes sur les performances du système si d'autres travaux sont actifs dans le même temps.

Exemples

Exemple 1 : copie de PTF dans un fichier sauvegarde

CPYPTF   LICPGM(57xxSS1)  FROMDEV(TAP01)
         TODEV(*SAVF)  SELECT(*ALL)  TOSAVF(MYLIB/PTFFILE)

Cette commande permet de copier toutes les PTF à partir d'une bande nommée TAP01 dans un fichier sauvegarde nommé PTFFILE pour le produit 57xxSS1.

Exemple 2 : Copie de PTF à partir d'un lecteur de disque optique

CPYPTF   LICPGM(57xxSS1)  FROMDEV(OPT01)  TODEV(TAP01)
         SELECT(*ALL)  FROMPATHID(2)  RLS(*ONLY)

Cette commande permet de copier toutes les PTF du produit 57xxSS1 qui existent dans le fichier portant l'identificateur de chemin 0002, à partir de l'unité optique OPT01 sur l'unité de bande TAP01.

Exemple 3: Copie de PTF dans *SERVICE

CPYPTF   LICPGM(*ALL)  FROMDEV(OPT01)  TODEV(*SERVICE)
         SELECT(*ALL)

Cette commande permet de copier tous les fichiers sauvegarde et toutes les lettres d'accompagnement de PTF pour tous les produits installés et pris en charge à partir de l'unité optique OPT01 dans *SERVICE. Ces PTF peuvent ensuite être affichées, chargées ou copiées à l'aide des commandes de PTF. Si une PTF existe déjà dans *SERVICE, la PTF n'est pas copiée.

Messages d'erreur

Messages *ESCAPE

CPF35AE

PTF &1 trouvée en double.

CPF35CC

La bibliothèque requise pour une opération liée à des PTF existe déjà.

CPF35C2

Impossible d'inclure la PTF &1-&2 &5.

CPF35C3

Impossible d'inclure la PTF &1-&2.

CPF35C4

Fin anormale de CPYPTF.

CPF35C6

Paramètre TOVOL obligatoire.

CPF35C7

Nom du volume dans unité indiquée au paramètre FROMDEV identique à valeur de TOVOL.

CPF35C8

Fichier PTF à copier incorrect.

CPF35D5

La langue NLV de la lettre de couverture n'est pas valide. Cover letter NLV not valid.

CPF354C

Traitement de fichiers PTF sur volume optique impossible.

CPF354D

Unité &1 non admise.

CPF354F

Le fichier de PTF requis ne peut pas être traité.

CPF3558

Impossible d'allouer &1 dans &3 de type *&2. Cannot allocate &1 in &3 type *&2.

CPF358A

Édition non valide. Release not valid.

CPF3586

Liste de PTF incorrecte.

CPF3598

Fonction PTF déjà en cours.

CPF363A

Type de support de volume non admis pour cette opération.

CPF363D

Plusieurs lettres d'accompagnement existent pour la PTF &1-&2 &4.

CPF363E

Impossible d'écrire le fichier de PTF requis sur le volume optique.

CPF6602

PTF &1-&2 &4 non trouvée.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9814

Unité &1 non trouvée.