CPYPTFGRP

La commande CPYPTFGRP copie les groupes de PTF à partir d'une bande, d'un support optique, d'un fichier sauvegarde ou d'un service, sur une bande, un support optique un fichier sauvegarde ou un service. Les informations du groupe de PTF sont copiées sur l'unité spécifiée. Les PTF nommées appartenant au groupe de PTF peuvent également être copiées au moyen du paramètre CPYPTF. La commande Gérer les groupes de PTF (WRKPTFGRP) permet de visualiser et de gérer la liste des groupes de PTF du système.

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.

Paramètres

Groupe de PTF (PTFGRP)

Spécifie les groupes de PTF à copier.

Ce paramètre est obligatoire.

*ALL

Tous les groupes de PTF sont copiés.

nom

Indique le nom du groupe de PTF à copier.

Unité d'origine (FROMDEV)

Spécifie l'unité qui contient les groupes de PTF à copier.

Ce paramètre est obligatoire.

*SERVICE

Les groupes de PTF sont copiés à partir du système. La commande Gérer les groupes de PTF (WRKPTFGRP) permet de visualiser la liste des groupes de PTF du système.

*SAVF

Les groupes de PTF sont copiés depuis un fichier sauvegarde.

nom

Entrez le nom de l'unité de bande ou de l'unité optique à partir de laquelle sont copiés les groupes de PTF.

Unité de destination (TODEV)

Indique l'unité sur laquelle les groupes de PTF sont copiés.

Ce paramètre est obligatoire.

*SERVICE

Les groupes de PTF sont copiés sur le système. La commande Gérer les groupes de PTF (WRKPTFGRP) permet de visualiser la liste des groupes de PTF du système. TODEV(*SERVICE) ne peut pas être indiqué avec FROMDEV(*SERVICE).

*SAVF

Les groupes de PTF sont copiés dans un fichier sauvegarde.

nom

Entrez le nom de l'unité de bande ou de l'unité optique sur laquelle les groupes de PTF sont copiés.

Fichier sauvegarde origine (FROMSAVF)

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

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

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 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 de bande à partir duquel les groupes de PTF sont copiés.

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

*SEARCH

La recherche du premier fichier de support pour le groupe de PTF indiqué s'effectue sur le volume de bande.

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 à l'issue de l'opération de copie. 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.

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

Identificateur de volume (TOVOL)

Indique l'identificateur de volume utilisé lors de la copie des groupes de PTF sur une bande ou un volume optique.

*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 le groupe de PTF copié.

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 groupes de PTF sont copiés à la fin de la bande.

1-16777215

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

Option fin support destination (TOENDOPT)

Indique l'opération qui est exécutée sur la bande ou le volume optique à l'issue de l'opération de copie. 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 TODEV (Unité de destination). 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 groupes de PTF sont copiés.

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

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

Mise à blanc (CLEAR)

Indique si un fichier sauvegarde non mis à blanc est automatiquement mis a blanc lors de la copie des groupes de PTF. Ce paramètre s'applique uniquement si TODEV(*SAVF) est indiqué.

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

Replace (REPLACE)

Indique ce qu'il convient de faire si un groupe de PTF copié existe déjà sur le système.

Le nombre de niveaux différents d'un groupe de PTF du même nom qui peut exister sur le système est contrôlé par le paramètre PTFGRPLVL (Niveau du groupe de PTF) de la commande CHGSRVA (Modifier les attributs de service). Lorsque vous copiez un groupe de PTF, la valeur indiquée pour le paramètre PTFGRPLVL signale le nombre maximal de niveaux différents du groupe de PTF qui peuvent exister sur le système. Les niveaux inférieurs du groupe de PTF sont automatiquement supprimés. Seuls restent les niveaux supérieurs du groupe de PTF sur le système une fois que le groupe de PTF a été copié.

Remarque :Ce paramètre s'applique uniquement lorsque TODEV(*SERVICE) est spécifié.

*LVLGT

Copiez un groupe de PTF existant portant le même nom uniquement lorsque le niveau du groupe de PTF copié est plus important que le niveau supérieur du groupe de PTF sur le système.

*NO

Ne copiez pas le groupe de PTF lorsqu'il existe déjà un groupe de PTF du même nom sur le système, quels que soient les niveaux du groupe de PTF existant. Une erreur sera générée si un groupe de PTF du même nom existe déjà sur le système et si PTFGRP(*ALL) n'est pas spécifié.

*YES

Copiez toujours le groupe de PTF quels que soient les niveaux du groupe de PTF existant portant le même nom. Si le niveau du groupe de PTF copié est inférieur à tous les autres niveaux existants du groupe de PTF, il peut être supprimé automatiquement si le nombre de niveaux du groupe de PTF sur le système dépasse la valeur actuelle du paramètre PTFGRPLVL de la commande CHGSRVA.

PTFGRPLVL (Niveau du groupe de PTF)

Spécifie le niveau du groupe de PTF à copier.

Remarque :Ce paramètre ne s'applique que si *SERVICE est spécifié pour le paramètre Unité d'origine (FROMDEV).

*INSTALLED

Le dernier niveau du groupe de PTF qui possède le statut Installé ou Appliquer à l'IPL suivant est copié. Si aucun niveau du groupe de PTF ne possède le statut Installé ou Appliquer à 'IPL suivant, le dernier niveau du groupe de PTF qui existe sur le système est copié.

*ALL

Tous les niveaux du groupe de PTF sont copiés.

*LATEST

Le dernier niveau du groupe de PTF qui existe sur le système est copié.

1-99999

Spécifiez le niveau du groupe de PTF à copier.

Copier groupes PTF associées (RELPTFGRP)

Indique si des groupes de PTF associés doivent être copiés.

Remarque :Ce paramètre ne s'applique que si *SERVICE est spécifié pour le paramètre Unité d'origine (FROMDEV).

*NO

Les groupes de PTF associés indiqués dans le groupe de PTF spécifié ne sont pas copiés.

*YES

Tous les niveaux des groupes de PTF associés appelés dans le groupe de PTF spécifié sont copiés. Tous les niveaux des groupes de PTF associés appelés dans des groupes de PTF associés sont également copiés.

*INSTALLED

Le dernier niveau des groupes de PTF associés appelés dans le groupe de PTF spécifié qui possède le statut Installé ou Appliquer à l'IPL suivant est copié. Tout groupe de PTF associé figurant dans des groupes de PTF associés est également copié. Si aucun niveau du groupe de PTF associé ne possède le statut Installé ou Appliquer à l'IPL suivant, le dernier niveau du groupe de PTF associé qui existe sur le système est copié.

*LATEST

Le dernier niveau des groupes de PTF associés appelés dans le groupe de PTF associé sont copiés. Tout groupe de PTF associé figurant dans des groupes de PTF associés est également copié.

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.

Copier les PTF (CPYPTF)

Indique si les PTF nommées appartenant au groupe de PTF indiqué doivent être copiées en plus des informations sur le groupe.

Remarque :Ce paramètre ne s'applique que si *SERVICE est spécifié pour le paramètre Unité d'origine (FROMDEV) et qu'un nom d'unité de bande ou de lecteur de disque optique est spécifié pour le paramètre Unité de destination (TODEV).

*NO

Les PTF nommées appartenant au groupe de PTF spécifié ne sont pas copiées.

*YES

Les PTF nommées appartenant au groupe de PTF spécifié sont copiées. Toutes les PTF préalables, simultanées et les PTF des conditions de distribution faisant partie des PTF nommées du groupe sont également copiées. Une PTF est copiée uniquement pour un produit pris en charge ou installé et si un fichier sauvegarde existe sur le système pour la PTF ou pour une PTF prépondérante.

Remplacer PTF de remplacement (RPLSPR)

Indique si les PTF ou les conditions de PTF nommées dans le groupe indiqué doivent être remplacées. Une PTF peut être remplacée si aucun fichier sauvegarde n'est trouvé et si une PTF prépondérante avec un fichier sauvegarde existe sur le système. Ce paramètre s'applique uniquement si CPYPTF(*YES) est indiqué.

*YES

Lors de la copie de PTF, si une PTF ou une condition de PTF nommée à l'intérieur du groupe indiqué ne possède pas de fichier sauvegarde, remplacez la PTF par la PTF immédiatement prépondérante qui possède un fichier sauvegarde. Si une PTF ou une condition de PTF nommée à l'intérieur du groupe indiqué possède un fichier sauvegarde, la PTF sera copiée indépendamment du fait qu'il existe une PTF prépondérante ou immédiatement prépondérante.

*NO

Pendant la copie de PTF, ne remplacez pas les PTF qui ne possèdent pas de fichier sauvegarde sur le système. Des fichiers sauvegarde doivent être présents pour toutes les PTF et conditions de PTF nommées à l'intérieur du groupe indiqué.

Copier lettre d'accompagnement (COVER)

Indique si les lettres d'accompagnement des PTF doivent être copiées.

Remarque :Ce paramètre ne s'applique que si *YES est spécifié pour le paramètre Copier les PTF (CPYPTF).

*DFT

Les lettres d'accompagnement sont copiées avec le code dispositif de langue par défaut. S'il n'existe qu'une lettre d'accompagnement pour la PTF, elle est copiée. S'il en existe plusieurs, les critères ci-après seront utilisés pour déterminer celle qui doit être copiée.

Le code dispositif de langue correspondant aux informations de points de contact de maintenance (WRKCNTINF) sera utilisé.

Si aucun code dispositif de langue ne correspond aux informations de points de contact de maintenance, c'est le code correspondant à la langue principale du système d'exploitation qui sera utilisé.

Si aucune lettre d'accompagnement ne correspond au code dispositif de langue du système d'exploitation, aucune lettre d'accompagnement n'est copiée pour la PTF.

*NONE

Aucune lettre d'accompagnement de PTF n'a été copiée.

caractère-valeur

Indiquez le code dispositif de langue associé aux lettres d'accompagnement de PTF à copier. Si une lettre d'accompagnement correspondant au code dispositif sélectionné n'est pas disponible, aucune lettre d'accompagnement n'est copiée pour la PTF.

Exemples

Exemple 1 : copie d'un groupe de PTF dans un fichier sauvegarde

CPYPTFGRP   PTFGRP(SF99100)  FROMDEV(*SERVICE)  TODEV(*SAVF)
            TOSAVF(MYLIB/MYSAVF)

Cette commande copie le dernier niveau installé pour le groupe de PTF appelé SF99100 sur le système dans un fichier de sauvegarde appelé MYSAVF dans la bibliothèque MYLIB. Les groupes de PTF associés nommés dans SF99100 ne sont pas copiés.

Exemple 2 : copie d'un groupe de PTF sur une bande

CPYPTFGRP   PTFGRP(SF99200)  FROMDEV(*SERVICE)  TODEV(TAP01)
            TOSEQNBR(1) RELPTFGRP(*YES) CPYPTF(*YES)

Cette commande copie le dernier niveau installé du groupe de PTF appelé SF99200 et tous les niveaux de ses groupes de PTF associés du système vers la bande montée dans l'unité TAP01, en commençant par le numéro de séquence 1. Toutes les PTF nommées à l'intérieur des groupes de PTF sont copiées sur la bande. Les lettres d'accompagnement sont copiées pour les PTF avec le code dispositif de langue par défaut.

Exemple 3 : copie de tous les groupes de PTF à partir du lecteur de disque optique

CPYPTFGRP   PTFGRP(*ALL)  FROMDEV(OPT01)  TODEV(*SERVICE)
            REPLACE(*YES)

Cette commande copie tous les groupes de PTF à partir du volume monté dans le lecteur de disque optique OPT01 vers le système. Tous les groupes de PTF existant déjà sur le système avec le même niveau sont remplacés.

Exemple 4 : copie d'un groupe de PTF d'une bande vers un fichier sauvegarde

CPYPTFGRP   PTFGRP(SF99300)  FROMDEV(TAP01)  TODEV(*SAVF)
            TOSAVF(MYLIB/MYSAVF)

Cette commande effectue une recherche sur la bande montée dans l'unité TAP01 et copie le groupe de PTF SF99300 vers le fichier sauvegarde MYSAVF dans la bibliothèque MYLIB.

Messages d'erreur

Messages *ESCAPE

CPF35CC

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

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

CPF355D

Le groupe de PTF n'existe pas sur le support de sauvegarde ou de restauration.

CPF355E

Fin anormale de CPYPTFGRP.

CPF355F

Les paramètres TODEV et FROMDEV ne peuvent pas indiquer la même unité.

CPF3598

Fonction PTF déjà en cours.

CPF36AB

Groupes PTF non trouvés.

CPF36A3

Le groupe de PTF &1 niveau &2 existe déjà.

CPF36A4

Groupe de PTF &1 non trouvé.

CPF36A5

Informations manquantes pour le groupe de PTF &1.

CPF36A6

Nom de groupe de PTF &1 incorrect.

CPF36B8

La PTF &2-&3 &5 ne peut pas être copiée sans un fichier sauvegarde.

CPF363A

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

CPF363E

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

CPF9812

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

CPF9814

Unité &1 non trouvée.

OPT1660

Le lecteur de disque optique &1 est vide.