CRTPTFPKG

La commande CRTPTFPKG permet de créer un module de modifications provisoires du logiciel (PTF). La liste des PTF contenues dans le module est écrite dans un fichier de sortie et, éventuellement, sur une bande ou un lecteur de disque optique. Les PTF sélectionnées doivent comporter des fichiers sauvegarde qui sont pour la distribution. Utilisez la commande Release Program Temporary Fix (RLSPTF) pour publier un fichier sauvegarde de PTF.

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

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données physique dans lequel est envoyé la liste de PTF figurant dans le module. Si le fichier de sortie existe déjà, le système cherche à l'utiliser. Dans le cas contraire, le système crée un fichier base de données physique (dont le nom est indiqué dans le paramètre OUTFILE) dans la bibliothèque désignée. Un membre est créé pour le fichier précisé au paramètre OUTMBR (Options pour membre de sortie). Si un nouveau fichier est créé, le fichier système QADSPPTF de la bibliothèque QSYS et de format QSCPTF est utilisé comme modèle.

Qualificatif 1 : Fichier recevant la sortie

nom

Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificatif 2 : Biblio

*LIBL

Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.

*CURLIB

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

nom

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

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

PTF pour sélect fichier (SELECT)

Indique la liste des PTFs à sélectionner pour le module de PTF.

Les valeurs possibles sont :

*SUPPTD

Le système génère la liste des PTF dans laquelle effectuer la sélection. La liste contient toutes les PTF de tous les produits pris en charge sur le système. Les PTF doivent comporter les fichiers sauvegarde qui sont publiés pour distribution à inclure dans le module.

Remarque :Si une PTF est remplacée, la dernière PTF de remplacement est incluse dans le module.

Elément 1 : Nom de fichier

Indique le fichier base de données physique contenant la liste des PTF à sélectionner pour le module de PTF. Ce fichier doit avoir le même format que le fichier système QADSPPTF dans la bibliothèque système QSYS avec le nom de format QSCPTF. La commande Afficher les PTF (DSPPTF) avec le paramètre OUTPUT(*OUTFILE) peut être utilisée pour créer le fichier.

Le nom du fichier peut être qualifié par l'une des valeurs de bibliothèques suivantes :

*LIBL

La recherche s'effectue dans toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur 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-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

nom-fichier

Indiquez le nom du fichier contenant la liste des PTF dans laquelle effectuer une sélection.

Elément 2: Membre de fichier

*FIRST

Le premier membre du fichier contient la liste des PTF dans laquelle effectuer une sélection.

nom-membre

Indiquez le membre de fichier de base de données contenant la liste des PTF dans laquelle effectuer une sélection.

PTF pour omettre fichier (OMIT)

Indique le fichier base de données contenant la liste des PTF à omettre du module. Les PTF répertoriées dans ce fichier et qui existent aussi dans le fichier spécifié au paramètre SELECT sont omise du module. Seules les PTF prérequises et les PTF associées pour les PTF sélectionnées sont incluses.

Les valeurs possibles sont :

*NONE

Toutes les PTF répertoriées dans le fichier spécifié au paramètre SELECT sont incluses dans le module.

Elément 1 : Nom de fichier

Indique le fichier base de données physique contenant la liste des PTF à omettre du module de PTF. Ce fichier doit avoir le même format que le fichier système QADSPPTF dans la bibliothèque système QSYS avec le nom de format QSCPTF.

Le nom du fichier peut être qualifié par l'une des valeurs de bibliothèques suivantes :

*LIBL

La recherche s'effectue dans toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur 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-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

nom-fichier

Indiquez le nom du fichier contenant la liste des PTF à omettre.

Elément 2: Membre de fichier

*FIRST

Le premier membre du fichier contient la liste des PTF à omettre.

nom-membre

Indiquez le membre de fichier de base de données contenant la liste des PTF à omettre.

Remplacer PTF de remplacement (SUPERSEDE)

Indique si les PTF de remplacement sont préparées à la place des PTF remplacées.

Remarque :SUPERSEDE(*NO) n'est pas admis avec SELECT(*SUPPTD).

Les valeurs possibles sont :

*YES

Toutes les PTF de remplacement sont préparées à la place des PTF remplacées.

*NO

Les PTF de remplacement ne sont pas préparées à la place des PTF remplacées.

Inclure PTF prérequises (PREREQ)

Indique si les PTF prérequises sont incluses dans le module. Si les PTF prérequises sont incluses dans le module, les PTF associées le sont également.

Les valeurs possibles sont :

*ALL

Inclure toutes les PTF prérequises et associées dans le module.

*NONE

Les PTF prérequises et les PTF associées ne sont pas incluses dans le module.

*SAMEPRD

Les PTF prérequises et les PTF associées qui figurent dans le même produit que les PTF sont incluses dans le module.

Unité (DEV)

Indique le nom de l'unité de bande ou de l'unité optique sur laquelle le module de PTF est sauvegardé.

Les valeurs possibles sont :

*NONE

Seul le fichier de sortie de module est généré.

nom-unité

Indiquez le nom de l'unité de bande ou de l'unité optique sur laquelle le module est sauvegardé.

Identificateur de volume (VOL)

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

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

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

Numéro de séquence (SEQNBR)

Indique le numéro de séquence du fichier de données qui reçoit le module sauvegardé.

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

*END

Le module de PTF est copié à la fin de la bande.

1-16777215

Indiquez le numéro de séquence du fichier de données qui reçoit le module sauvegardé.

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 :Ce paramètre n'est admis que si une bande ou une unité optique est spécifiée au paramètre Unité (DEV). 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.

Copier lettre d'accompagnement (COVER)

Indique si les lettres d'accompagnement des PTF doivent être incluses avec les PTF pour le module de PTF.

*NONE

Aucune lettre d'accompagnement de PTF n'est sauvegardée.

valeur-alphanumérique

Indiquez le code dispositif de langue associé aux lettres d'accompagnement de PTF à sauvegarder. 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

Pour pouvoir utiliser la commande CRTPTFPKG avec SELECT(file), il est nécessaire au préalable de créer le fichier en exécutant la commande DSPPTF pour diriger la sortie dans un fichier de sortie. Dans les exemples suivants, le fichier de sortie DSPPTFOUTF est créé en exécutant les commandes suivantes :

DSPPTF   OUTPUT(*OUTFILE)  OUTFILE(MYLIB/DSPPTFOUTF)

Exemple 1 : Création d'un module de PTF à partir de produits installés sur bande

CRTPTFPKG   OUTFILE(MYPTFPKG)  SELECT(MYLIB/DSPPTFOUTF *FIRST)
            DEV(TAP01)

Cette commande permet de créer une bande avec toutes les PTF des produits installés comportant des fichiers sauvegarde pour la distribution.

Exemple 2 : Création d'un module de PTF à partir de produits pris en charge pour un support optique

CRTPTFPKG   OUTFILE(MYPTFPKG)  SELECT(*SUPPTD)  DEV(OPT01)

Cette commande permet de créer un support optique avec toutes les PTF des produits pris en charge comportant des fichiers sauvegarde pour la distribution.

Messages d'erreur

Messages *ESCAPE

SMU1424

Le module de PTF n'a pas été créé.

CPF9860

Erreur lors du traitement du fichier de sortie.