CRTPTF

Créer correction temporaire prog

Create Program Temporary Fix

En bref

La commande CRTPTF (Créer des modifications provisoires du logiciel) vous permet de créer une modification provisoire du logiciel pour un produit que vous avez développé.

CRTPTF se lit CRT (Créer) + PTF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTPTF PTF(…) LICPGM(…) RLS(…)

Paramètres

PTF PTF obligatoire
LICPGM Produit obligatoire
RLS Edition obligatoire
OPTION Option
LODID Identificateur de chargement
PTFOBJ Objets de la PTF
OBJLIB Bibliothèques d'objets
PTFDOC Documents de PTF
DIROBJ Objets d'un répertoire
COVER Lettres accompagnement
PREREQ PTF prérequises
COREQ PTF corequises
EXITPGM Programmes exit PTF
TGTRLS Edition cible

Astuce : dans une session 5250, tapez CRTPTF 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 CRTPTF (Créer des modifications provisoires du logiciel) vous permet de créer une modification provisoire du logiciel pour un produit que vous avez développé. Le produit doit être créé et installé avant l'utilisation de cette commande. Un fichier sauvegarde de PTF est créé dans la bibliothèque générale (QGPL). Ce fichier sauvegarde contient un objet de contrôle de PTF et un nombre d'objets de correction. Le nom du fichier sauvegarde se compose de l'identificateur de PTF précédé de la lettre Q. Si un fichier du même nom existe déjà dans QGPL, un nom unique est généré par le système. Ce nom est un horodatage précédé de la lettre Q. Une fois la PTF créée, vous pouvez utiliser la commande DSPPTF (Afficher PTF) pour afficher les attributs 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

Mot-clé	Description	Valeurs possibles	Remarques
PTF	PTF	Valeur caractère	Obligatoire, positionnel 1
LICPGM	Produit	Valeur caractère	Obligatoire, positionnel 2
RLS	Edition	Valeur caractère	Obligatoire, positionnel 3
OPTION	Option	1-99, *BASE	Facultatif
LODID	Identificateur de chargement	Valeur caractère, *CODEDFT	Facultatif
PTFOBJ	Objets de la PTF	Valeurs uniques: NONE Autres valeurs (jusqu'à 300 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Nom d'objet	Nom
	Élément 2: Type d'objet	Valeur caractère
OBJLIB	Bibliothèques d'objets	Liste d'éléments	Facultatif
	Élément 1: Bibliothèque développement	Nom, *CURLIB
	Élément 2: Bandothèque principale	Nom, *PRINCIPAL
PTFDOC	Documents de PTF	Valeurs uniques: NONE Autres valeurs (jusqu'à 300 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Document	Valeur caractère
	Élément 2: Dossier	Valeur caractère
DIROBJ	Objets d'un répertoire	Valeurs uniques: NONE Autres valeurs (jusqu'à 30 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Répertoire produit	Chemin d'accès
	Élément 2: Répertoire développement	Chemin d'accès, *PRDDIR
	Élément 3: Objet	Values (jusqu'à 100 répétitions): Valeur caractère
COVER	Lettres accompagnement	Valeurs uniques: NONE Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Fich lettre accomp source	Nom d'objet qualifié
	Qualificatif 1: Fich lettre accomp source	Nom
	Qualificatif 2: Bibliothèque	Nom, *LIBL
	Élément 2: Membre lettre accomp source	Nom
	Élément 3: Version nationale	Valeur caractère
PREREQ	PTF prérequises	Valeurs uniques: NONE Autres valeurs (jusqu'à 300 répétitions): Valeur caractère*	Facultatif
COREQ	PTF corequises	Valeurs uniques: NONE Autres valeurs (jusqu'à 300 répétitions): Valeur caractère*	Facultatif
EXITPGM	Programmes exit PTF	Valeurs uniques: NONE Autres valeurs (jusqu'à 50 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Programme	Nom d'objet qualifié
	Qualificatif 1: Programme	Nom
	Qualificatif 2: Bibliothèque	Nom, *CURLIB
	Élément 2: Option d'exécution	BOTH, APPLY, REMOVE, PREAPY, PRERMV, PREBTH
	Élément 3: Type	PTF, OBJLST
	Élément 4: Référence utilisateur	Valeur caractère, *NONE
TGTRLS	Edition cible	Valeur caractère, CURRENT, PRV	Facultatif

PTF (PTF)

Indique l'ID éloigné de la PTF en cours de création. Le premier caractère de l'identificateur de PTF doit être numérique. Le deuxième et le troisième caractères doivent être alphabétiques.

Produit (LICPGM)

Indique l'ID de produit pour lequel la PTF est créée.

Edition (RLS)

Indique la version, l'édition et le niveau de modification du produit pour lequel la PTF est créée. 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 (OPTION)

Indique si la PTF est pour le produit de base ou pour une option du produit de base.

Les valeurs possibles sont :

*BASE: La PTF est pour l'option de base.
numéro-option-produit: Indiquez l'option de produit de la PTF créée.

Identificateur de chargement (LODID)

Indique l'ID de chargement de la PTF créée.

Les valeurs possibles sont :

*CODEDFT: L'ID de chargement du code par défaut, 5001, est utilisé.
ID-chargement: Indiquez un ID de chargement de langue ou un ID de chargement de code correct. Pour un chargement de langue, l'ID de chargement doit être l'une des versions en langue nationale IBM valides et il doit être spécifié au format 29xx. Pour un chargement de code, l'ID de chargement doit être une valeur de 5001 à 9999.

Objets de la PTF (PTFOBJ)

Indique les objets qui doivent figurer dans la PTF. Ces objets doivent être répertoriés avec le type d'objet qui leur est associé. Ils doivent exister dans la bibliothèque de développement indiquée au paramètre OBJLIB. Vous pouvez spécifier jusqu'à 300 objets.

Les valeurs possibles sont :

*NONE: Aucun objet n'est spécifié pour les PTF.
nom-objet: Indiquez le nom de l'objet de la PTF.

Les types d'objet de PTF possibles sont les suivants :

type-objet: Indiquez le type d'objet de la PTF.

Bibliothèques d'objets (OBJLIB)

Indique la bibliothèque de développement et la bibliothèque principale de cette PTF.

Pour la bibliothèque de développement, les valeurs possibles sont :

*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.
bibliothèque-développement: Indiquez la bibliothèque contenant les objets de PTF.

Pour la bibliothèque principale, les valeurs possibles sont :

*PRINCIPAL: Les objets de PTF sont associés à la bibliothèque principale de l'option de produit spécifiée.
bibliothèque-principale: Indiquez la bibliothèque de logiciel à laquelle sont associés les objets de PTF.

Documents de PTF (PTFDOC)

Indique les documents qui doivent figurer dans la PTF. Vous pouvez spécifier jusqu'à 300 documents.

Les valeurs possibles sont :

*NONE: Aucun document n'est spécifié pour les PTF.
nom-du-document: Indiquez le nom du document.

Les valeurs possibles pour le nom de dossier de PTF sont les suivantes :

nom-dossier: Indiquez le dossier dans lequel le document de PTF sera installé. La fonction de création de PTF ajoutera "/QP" au nom de dossier spécifié et sauvegardera le document du sous-dossier résultant.

Objets d'un répertoire (DIROBJ)

Indique le répertoire produit destiné à la PTF, le répertoire de développement où se trouve la PTF, ainsi que les noms des objets du répertoire de développement qui figurent dans la PTF.

Vous pouvez indiquer jusqu'à 30 répétitions. Un répertoire produit, un répertoire de développement, et au moins un nom d'objet doivent être indiqués, sauf si DIROBJ(*NONE) est spécifié.

Les restrictions suivantes s'appliquent lors de l'affectation des noms de répertoire :

Vous ne pouvez pas indiquer les répertoires /QSYS.LIB et /QDLS
Vous devez indiquer des noms de chemin uniques
Le nom de chemin ne doit pas commencer ni se terminer par une barre oblique
Vous ne devez pas utiliser les combinaisons de caractères "." ou ".." dans le nom de chemin de répertoire.

Un barre oblique inversée (\) dans le nom de répertoire est systématiquement convertie en barre oblique (/). Une barre oblique de fin est toujours ignorée. Les caractères suivants ne sont pas autorisés dans un nom de répertoire :

Astérisque (*)
Tilde
Point d'interrogation (?)
Apostrophe (')
Guillemet (")

Si la barre oblique de début (/) est omise, elle est utilisée par défaut, et son inclusion ne doit pas entraîner le dépassement de la longueur maximum du nom de répertoire, fixée à 1024 caractères. Le nom de répertoire peut indiquer un répertoire qui est imbriqué dans d'autres répertoires, par exemple, /A/B/C. La longueur de de nom de répertoire maximum inclut toutes les barres obliques et tous les noms de répertoire imbriqués.

Les valeurs possibles sont les suivantes :

*NONE: La PTF n'inclut pas les objets qui seront stockés dans les répertoires lors de son application.

Elément 1 : Nom de répertoire du produit

nom-répertoire: Indiquez le répertoire défini par le produit qui est le produit par défaut où résideront les objets une fois la PTF appliquée. Les objets d'origine sont remplacés par de nouveaux objets.

Elément 2 : Nom du répertoire de développement

*PRDDIR: Le répertoire de développement est identique au répertoire produit.
nom-répertoire: Indique le répertoire dans lequel résident les objets qui seront inclus dans la PTF.

Elément 3 : Nom de l'objet

nom-objet

Indique la liste des objets du répertoire de développement qui sont inclus dans cette PTF. il est possible d'indiquer jusqu'à 100 noms d'objet pour chaque répertoire de développement. Si plus de 100 objets doivent être inclus pour un répertoire produit donné, la combinaison de répertoire de développement peut de nouveau être spécifiée en utilisant un ensemble de noms d'objet différent.

Un nom d'objet donné ne peut pas être indiqué plus d'une fois.

Les noms d'objets peuvent comporter 255 caractères au maximum.

Lettres accompagnement (COVER)

Indique le fichier contenant le texte source de la lettre d'accompagnement de la PTF. Le fichier de lettre d'accompagnement peut être un fichier source avec une longueur d'enregistrement maximum de 92 ou un fichier physique avec une longueur d'enregistrement de 80. Il est nécessaire d'indiquer un membre qui contaient la source de chaque lettre d'accompagnement de PTF.

Un membre est ajouté au fichier de lettre d'accompagnement de PTF QAPZCOVER dans la bibliothèque QGPL. Les données du texte source, la langue de PTF, les données qui prennent la place des données, ainsi que les requises, sont copiés dans le membre. Vous pouvez indiquer jusqu'à 50 lettres d'accompagnement.

Les valeurs possibles sont les suivantes :

*NONE: Aucune lettre d'accompagnement n'est spécifiée pour cette PTF.

La valeur possible pour le membre de la lettre d'accompagnement est :

membre-source-lettre-accompagnement: Indiquez le nom du membre de fichier qui contient le texte de la lettre d'accompagnement.

Les valeurs possibles pour la bibliothèque sont :

*LIBL: Le fichier est recherché dans la liste des bibliothèques.
nom-bibliothèque: Indiquez le nom de la bibliothèque de recherche du fichier.

La valeur possible pour le fichier de la lettre d'accompagnement est :

nom-fichier: Indiquez le nom du fichier qui contient le texte de la lettre d'accompagnement.

La valeur possible pour la valeur de langue de la lettre d'accompagnement est la suivante :

NLV: Indiquez le code NLV (version en langue nationale) pour la source de lettre d'accompagnement. Chaque code langue ne peut être spécifié qu'une fois.

PTF prérequises (PREREQ)

Indique une liste des PTF qui doivent être appliquées avant l'application de la PTF en cours. Si ces PTF ne sont pas appliquées, la PTF en cours ne fonctionnera pas. Une PTF prérequise doit déjà exister sur le système ou bien l'opération de création n'aboutira pas. Vous pouvez spécifier jusqu'à 300 PTF prérequises et associées.

Les valeurs possibles sont :

*NONE: Aucune PTF n'est requise.
ID-PTF: Indiquez le numéro de la PTF requise par cette PTF.

PTF corequises (COREQ)

Indique une liste des PTF qui doivent être appliquées en même temps que la nouvelle PTF. La PTF en cours n'est pas appliquée tant que toutes PTF associées ne sont pas aussi appliquées. Vous pouvez spécifier jusqu'à 300 PTF prérequises et associées.

Les valeurs possibles sont :

*NONE: Aucune PTF n'est requise.
ID-PTF: Indiquez le numéro de la PTF.

Programmes exit PTF (EXITPGM)

Indique le programme d'exit qui doit être appelé durant l'opération d'application ou de retrait de PTF. Grâce aux programmes d'exit, il n'est plus nécessaire d'exécuter des instructions manuelles pour installer la PTF. L'option d'exécution détermine le moment où le programme d'exit est appelé. Vous pouvez indiquer jusqu'à 50 programmes d'exit.

Remarque :Si le même programme d'exit est indiqué dans deux PTF, une PTF remplace l'autre. Pour éviter un remplacement de PTF involontaire, expédiez le programme d'exit avec un nom d'objet temporaire différent dans chaque PTF.

Les valeurs possibles sont les suivantes :

*NONE: Aucun programme d'exit n'est spécifié pour cette PTF.

Les valeurs possibles pour le nom de programme sont les suivantes :

programme: Indiquez le nom du programme d'exit pour cette PTF.

Les valeurs possibles pour la bibliothèque sont :

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

Les valeurs possibles pour l'option d'exécution sont les suivantes :

*BOTH: Le programme d'exit est appelé durant les opérations d'application et de retrait.
*APPLY: Le programme d'exit est appelé durant l'opération d'application uniquement.
*REMOVE: Le programme d'exit est appelé durant l'opération de retrait uniquement.
*PREAPY: Le programme d'exit est appelé avant l'application de PTF et à la fin de l'application de PTF.
*PRERMV: Le programme d'exit est appelé avant et à la fin du retrait de PTF.
*PREBTH: Le programme d'exit est appelé avant l'application ou le retrait de PTF et à la fin de l'application ou du retrait de PTF.

Les valeurs possibles pour le type sont les suivantes :

*PTF: L'objet du programme d'exit est inclus avec les objets de PTF. Le programme d'exit est un objet temporaire qui existe uniquement jusqu'à ce que la PTF soit appliquée de façon définitive. Un objet temporaire est identifié par QPZ1 en tant que 4 premiers caractères du nom.
*OBJLST: L'objet du programme d'exit n'est pas inclus avec les objets de PTF. Le programme d'exit doit exister dans la liste d'objets pour le produit, l'option, l'édition et le chargement de la PTF ou le chargement de code pour l'option de base du produit.

Les valeurs possibles pour les valeurs de données utilisateur sont les suivantes :

*NONE: Aucune donnée utilisateur n'est transmise au programme d'exit lorsqu'il est appelé.
référence-utilisateur: Indiquez les données utilisateur à transmettre au programme d'exit.

Edition cible (TGTRLS)

Indique l'édition la plus ancienne du système d'exploitation sur laquelle vous souhaitez charger et appliquer les PTF.

*CURRENT: La PTF doit être chargée et appliquée sur l'édition en cours du système d'exploitation installée sur votre système. Cette PTF peut également être chargée et appliquée sur un système doté d'une édition ultérieure du système d'exploitation installé.
*PRV: La PTF doit être chargée et appliquée sur l'édition précédente, niveau de modification 0, du système d'exploitation. Cette PTF peut être chargée et appliquée sur un système doté d'une édition ultérieure du système d'exploitation installé.
niveau-cible: Indique l'édition du système d'exploitation sur laquelle vous souhaitez charger et appliquer les PTF. Le niveau d'édition est indiqué au format VxRyMz, où Vx est la version, Ry est l'édition et Mz est le niveau de modification. Les valeurs admises dépendent de la version, de l'édition et du niveau de modification en cours. Elles changent avec chaque nouvelle édition.

Exemples

Exemple 1 : Création d'une PTF

CRTPTF   PTF(1X00001)  LICPGM(1X12345)  RLS(V1R2M0)
         OPTION(*BASE)  LODID(*CODEDFT)  PTFOBJ((X00PGM01 *PGM))
         OBJLIB(PTFDEVLIB *PRINCIPAL)

Cette commande permet de créer la PTF X00001 pour l'édition V1R2M0 du produit 1X12345. La PTF est créée à l'aide du programme X00PGM01 de la bibliothèque PTFDEVLIB. Lorsqu'elle est appliquée, cette PTF remplace le programme X00PGM01 dans la bibliothèque de logiciel principale du chargement de code de l'option *BASE. Cette PTF est créée en vue de son chargement et de son application dans l'édition en cours du système d'exploitation ou d'une édition ultérieure.

Exemple 2 : Création d'une PTF avec un programme d'exit

CRTPTF   PTF(1X00002)  LICPGM(1X12345)  RLS(V1R2M0)
         OPTION(*BASE)  LODID(*CODEDFT)
         EXITPGM((EXTPGMLIB/QPZ1X00003 *BOTH *PTF))

Cette commande permet de créer la PTF 1X00002 pour l'édition V1R2M0 du produit 1X12345. La valeur *PTF spécifiée au paramètre de programme d'exit entraîne la sauvegarde du programme QPZ1X00003 avec la PTF comme objet temporaire. Les objets temporaires sont supprimés lorsque la PTF est appliquée ou retirée de manière définitive. Notez que la convention d'appellation d'objet temporaire est utilisée pour le programme d'exit. Assurez-vous que les noms d'objet temporaires utilisés sont uniques pour cette édition du produit. Si la valeur *BOTH est indiquée, le programme d'exit est appelé lors du traitement des opérations d'application et de retrait.

Exemple 3 : Création d'une PTF avec une lettre d'accompagnement

CRTPTF   PTF(1X00003)  LICPGM(1X12345)  RLS(V1R2M0)
         OPTION(*BASE)  LODID(*CODEDFT)  PTFOBJ((X00PGM02 *PGM))
         OBJLIB(PTFDEVLIB *PRINCIPAL)
         COVER((PTFDEVLIB/PTFCVRLTRF PTF1X00003 2924))

Cette commande permet de créer la PTF 1X00003 pour l'édition V1R2M0 du produit 1X12345. La lettre d'accompagnement de la PTF est créée à partir du texte source du fichier PTFCVRLTRF dans la bibliothèque PTFDEVLIB membre PTF1X00003. Elle est créée pour la version en langue nationale 2924.

Exemple 4 : Création d'une PTF pour une édition précédente

CRTPTF   PTF(1X00004)  LICPGM(1X12345)  RLS(V1R2M0)
         OPTION(*BASE)  LODID(*CODEDFT)
         PTFOBJ((X00PGM03 *PGM))
         OBJLIB(PTFDEVLIB *PRINCIPAL)  TGTRLS(*PRV)

Cette commande permet de créer la PTF 1X00004 pour l'édition V1R2M0 du produit 1X12345. La PTF est créée à l'aide du programme X00PGM03 de la bibliothèque PTFDEVLIB. Lorsqu'elle est appliquée, cette PTF remplace le programme X00PGM03 dans la bibliothèque de logiciel principale du chargement de code de l'option *BASE. Cette PTF est créée en vue de son chargement et de son application dans l'édition précédente du système d'exploitation ou d'une édition ultérieure.

Messages d'erreur

Messages *ESCAPE

CPF35CC: La bibliothèque requise pour une opération liée à des PTF existe déjà.
CPF35DC: Bibliothèque principale introuvable. Primary library not found.
CPF35D3: La lettre d'accompagnement n'a pas été copiée. Cover letter not copied.
CPF3505: La PTF associée &1-&2 &5 contient des objets communs.
CPF3506: Longueur de nom de répertoire excessive.
CPF3507: PTF associée &1-&2 &8 non indiquée.
CPF3509: PTF associée &1-&2 &7 indiquée non admise.
CPF351A: Nom d'objet répertoire non admis.
CPF351B: Objet répertoire indiqué plusieurs fois.
CPF357A: La valeur de paramètre n'est pas valide. Parameter value not valid.
CPF357B: Produit introuvable. Product not found.
CPF357D: Le nom du document ou du dossier n'est pas correct. Document or folder name not correct.
CPF3571: L'ID de PTF &1 n'est pas dans la plage valide. PTF ID &1 not within valid range.
CPF3572: PTF &2-&1 &4 already exists.
CPF3573: Les ressources nécessaires au produit &1 ne sont pas disponibles. Resources required for product &1 are not available.
CPF3574: L'ID de PTF n'est pas valide. PTF ID not valid.
CPF358A: Édition non valide. Release not valid.
CPF358B: La PTF n'a pas été créée. PTF not created.
CPF358C: La création de PTF n'est pas autorisée pour le produit &1. Create PTF not allowed for product &1.
CPF359C: Le type de prérequis n'est pas valide. Requisite type not valid.
CPF3901: PTF &1-&2 &4 non créée.