Aller au contenu

CPYPTFCVR

Copier lettre d'accompagnement

En bref

La commande CPYPTFCVR copie les lettres d'accompagnement des modifications provisoires du logiciel (PTF) à partir d'une bande ou d'un support optique dans le fichier QAPZCOVER de la bibliothèque QGPL.

CPYPTFCVR se lit CPY (Copier) + PTFCVR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CPYPTFCVR DEV(…)

Paramètres

  • DEV Unité obligatoire
  • LICPGM Produit
  • SELECT Numéros de PTF à sélectionner
  • RLS Edition
  • CVROPT Option lettre d'accompagnement
  • ENDOPT Option de fin de support

Astuce : dans une session 5250, tapez CPYPTFCVR puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande CPYPTFCVR copie les lettres d'accompagnement des modifications provisoires du logiciel (PTF) à partir d'une bande ou d'un support optique dans le fichier QAPZCOVER de la bibliothèque QGPL. Chaque lettre d'accompagnement contient des informations telles que la description et la résolution de l'incident, ainsi que des instructions spéciales. Les lettres d'accompagnement peuvent être visualisées à l'aide des commandes Afficher lettre accompagnement (DSPPTFCVR) et Afficher les PTF (DSPPTF).

Restrictions :

  • Cette commande est fournie avec le droit public d'exclude (*EXCLUDE) et les profils utilisateur QPGMR, QSYSOPR, QSRV et QSRVBAS disposent de droits privés sur cette commande.

Paramètres

Mot-clé Description Valeurs possibles Remarques
DEV Unité Valeur caractère Obligatoire, positionnel 1
LICPGM Produit Valeur caractère, *ALL, *SUPPTD Facultatif, positionnel 2
SELECT Numéros de PTF à sélectionner Valeurs uniques: *NOTAPY, *ALL
Autres valeurs (jusqu'à 300 répétitions): Valeur caractère
Facultatif
RLS Edition Valeur caractère, *ALL Facultatif
CVROPT Option lettre d'accompagnement *NEW, *ADD, *ALL Facultatif
ENDOPT Option de fin de support *REWIND, *LEAVE, *UNLOAD Facultatif

Unité (DEV)

Spécifie l'unité qui contient les lettres d'accompagnement à copier.

Ce paramètre est obligatoire.

nom
Spécifiez le nom de l'unité de bande ou du lecteur de disque optique à partir duquel les lettres d'accompagnement sont copiées.

Produit (LICPGM)

Indique en 7 caractères l'identificateur du produit pour lequel les lettres d'accompagnement sont copiées.

*ALL
Les lettres d'accompagnement pour tous les produits installés ou pris en charge sont copiées.
*SUPPTD
Les lettres d'accompagnement pour tous les produits pris en charge sont copiées.
caractère-valeur
Indiquez l'ID produit des lettres d'accompagnement à copier.

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

Indique les lettres d'accompagnement copiées pour le produit désigné.

Valeurs uniques

*NOTAPY
Toutes les lettres d'accompagnement des PTF qui ne sont pas déjà appliquées ou remplacées pour le produit spécifié sont copiées.
*ALL
Toutes les lettres d'accompagnement du produit désigné sont copiées.

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

valeur-alphanumérique
Indiquez le numéro d'identification de PTF des lettres d'accompagnement à copier. Des identificateurs de PTF spécifiques peuvent être utilisés uniquement si un identificateur de produit spécifique est indiqué dans le paramètre Produit (LICPGM).

Edition (RLS)

Indique le niveau d'édition du produit logiciel.

*ALL
Les lettres d'accompagnement pour toutes les éditions du produit spécifié seront copiées.
caractère-valeur
Une édition spécifique peut être utilisée uniquement si un identificateur de produit spécifique est indiqué dans le paramètre Produit (LICPGM). 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.

Option lettre d'accompagnement (CVROPT)

Indique ce qu'il convient de faire si la lettre d'accompagnement copiée existe déjà sur le système.

*NEW
Si une lettre d'accompagnement pour la PTF existe déjà sur le système dans tout code dispositif de langue, elle ne sera pas copiée à partir du support. Si aucune lettre pour la PTF n'existe sur le système, la lettre d'accompagnement sera copiée.
*ADD
Si une lettre d'accompagnement pour la PTF existe avec un code dispositif de langue différent, elle sera copiée à partir du support. Sinon, la lettre d'accompagnement ne sera pas copiée.
*ALL
Si une lettre d'accompagnement dotée du même code dispositif de langue existe déjà sur le système, elle sera remplacée. Si aucune lettre d'accompagnement n'existe sur le système pour le code dispositif de langue, la lettre d'accompagnement sera copiée.

Option de fin de support (ENDOPT)

Indique l'opération automatiquement effectuée après une opération de PTF sur le volume de bande ou le volume optique. Si cette opération concerne un ou plusieurs volumes de support, ce paramètre ne s'applique qu'au dernier d'entre eux.

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

Exemples

CPYPTFCVR   DEV(OPT01)  LICPGM(57xxSS1)  SELECT(*ALL)
            RLS(VxRyMz)

Cette commande permet de copier à partir de l'unité OPT01 toutes les lettres d'accompagnement des PTF qui ne sont pas appliquées au produit 57xxSS1 édition VxRyMz.

Messages d'erreur

Messages *ESCAPE

CPF354D
Unité &1 non admise.
CPF3586
Liste de PTF incorrecte.
CPF358A
Édition non valide. Release not valid.
CPF359D
Aucune PTF sur l'unité &3 ne correspond aux critères de sélection.
CPF35BE
Produit &1 &4 non accepté ni installé.
CPF35E0
Erreur au cours de la copie des informations sur la PTF.
CPF35F1
Fichier de lettres d'accompagnement &1 introuvable dans &2.
CPF363C
Aucune lettre d'accompagnement de PTF n'a été copiée à partir de l'unité &3.
CPF9814
Unité &1 non trouvée.
CPF9822
Non autorisé au fichier &1 de &2.
CPF9825
Accès non autorisé à l'unité &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.