CRTPRDDFN

Créer définition de produit

Create Product Definition

En bref

La commande CRTPRDDFN permet de créer un objet de définition de produit.

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

Syntaxe minimale

CRTPRDDFN PRDDFN(…) PRDID(…) RLS(…) RGSID(…) MSGF(…) PRDOPT(…) CPYRGTFST(…)

Paramètres

PRDDFN Définition de produit obligatoire
PRDID ID produit obligatoire
RLS Edition obligatoire
RGSID Indentificat enregistrement obligatoire
MSGF Fichier de messages fichier message obligatoire
PRDOPT Options de produit obligatoire
CPYRGTFST Copyright 1er année obligatoire
CPYRGTCUR Copyright année en cours
ALWMLTRLS Editions multiples admises
PRDIDSFX Suffixe ID produit
RLSDATE Date d'édition
TEXT Texte 'descriptif'
AUT Droits

Astuce : dans une session 5250, tapez CRTPRDDFN 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 CRTPRDDFN permet de créer un objet de définition de produit. Cet objet contient des informations communes pour le produit.

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
PRDDFN	Définition de produit	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Définition de produit	Nom
	Qualificatif 2: Biblio	Nom, *CURLIB
PRDID	ID produit	Valeur caractère, *SER	Obligatoire, positionnel 2
RLS	Edition	Valeur caractère	Obligatoire, positionnel 3
RGSID	Indentificat enregistrement	Liste d'éléments	Obligatoire, positionnel 4
	Élément 1: Type d'enregistrement	PHONE, CUSTOMER
	Élément 2: Valeur d'enregistrement	Valeur caractère
MSGF	fichier message	Nom	Obligatoire, positionnel 5
PRDOPT	Options de produit	Values (jusqu'à 100 répétitions): Liste d'éléments	Obligatoire, positionnel 6
	Élément 1: Option du produit	1-99, *BASE
	Élément 2: Identificateur de message	Nom
	Élément 3: Appellation dynamique admise	NODYNNAM, ALWDYNNAM
	Élément 4: ID chargemt langue	Valeurs uniques: NONE, IBMLNG, BASEOPT Autres valeurs (jusqu'à 51 répétitions): Valeur caractère*
	Élément 5: ID chargemt code	Valeur caractère, *CODEDFT
CPYRGTFST	Copyright 1er année	Valeur caractère, CURRENT, NONE	Obligatoire, positionnel 7
CPYRGTCUR	Copyright année en cours	Valeur caractère, CURRENT, NONE	Facultatif
ALWMLTRLS	Editions multiples admises	NO, YES	Facultatif
PRDIDSFX	Suffixe ID produit	Valeur caractère	Facultatif
RLSDATE	Date d'édition	Date, *NONE	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif
AUT	Droits	LIBCRTAUT, USE, ALL, CHANGE, *EXCLUDE	Facultatif

Définition de produit (PRDDFN)

Indique le nom qualifié de l'objet de définition de produit en cours de création.

Le nom de la définition de produit peut être qualifié de l'une des valeurs de bibliothèque suivantes :

*CURLIB: La bibliothèque en cours du travail permet de créer la définition de produit. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque dans laquelle la définition de produit doit être créée.

ID produit (PRDID)

Indique l'identificateur de sept caractères du produit pour lequel une définition de produit est en cours de création. L'identificateur de produit doit avoir le format nlxxxxx, où n est un caractère numérique de 0 à 9, l est une lettre majuscule de A à Z, et x est un caractère numérique de 0 à 9 ou une lettre majuscule de A à Z.

Les valeurs possibles sont :

*SER: Le numéro de série du système, combiné au paramètre PRDIDSFX (Suffixe de l'identificateur de produit), est utilisé comme ID de produit. Cela ne garantit pas un ID de produit unique.
ID-produit: Indiquez l'identificateur de sept caractères du produit pour lequel une définition de produit est en cours de création.

Edition (RLS)

Indique la version, l'édition et le niveau de modification du produit en cours de création.

niveau-édition

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

Indiquez le niveau d'édition au format VxRyMz. Vx représente le numéro de version, Ry le numéro d'édition et Mz le niveau de modification. Les valeurs admises pour x et y sont comprises entre 0 et 9, et pour z entre 0 et 9 et entre A et Z.

Indiquez le niveau d'édition en utilisant le format vvrrmm. vv correspond à des caractères numériques compris entre 00 et 35 et représentant la version du produit, rr correspond à des caractères numériques compris entre 00 et 35 et représentant l'édition du produit, et mm correspond à une valeur comprise entre 00 et 09 ou entre 0A et 0Z et représentant le niveau de modification du produit.

Indentificat enregistrement (RGSID)

Indique l'identificateur d'enregistrement de l'organisation qui développe le produit.

Les valeurs possibles pour le Type d'enregistrement sont les suivantes :

*PHONE: Cette valeur d'enregistrement de 14 caractères se compose d'un code de pays ou de région, d'un code de ville et d'un numéro de téléphone.
*CUSTOMER: Cette valeur d'enregistrement se compose d'un code de pays et d'un numéro de client IBM.

Les valeurs possibles pour Valeur d'enregistrement sont les suivantes :

valeur-enregistrement: Indiquez la valeur de 14 caractères à utiliser comme ID d'enregistrement.

fichier message (MSGF)

Indique le nom du fichier de messages qui doit contenir les messages qui décrivent le produit et ses options. L'ID message de l'option de base est l'ID message du produit. Les ID message sont répertoriés au paramètre PRDOPT. Ce fichier de messages doit figurer dans l'option de base du produit.

Remarque :Si le produit de base comporte des dispositifs de langue, le fichier de messages doit être un objet de la liste des objets du chargement de langue et non du chargement de code. Un fichier de messages peut ainsi être créé pour chaque langue et les fichiers de messages peuvent être installés dans les bibliothèques appropriées.

Options de produit (PRDOPT)

Indique les options autorisées pour ce produit.

La première option d'un produit doit être définie comme étant l'option de base. L'option de l'option de base est *BASE. Pour indiquer des options supplémentaires, sélectionnez les options 1 à 99. Il n'est pas nécessaire que les options supplémentaires soient spécifiées dans un ordre séquentiel. Indiquez jusqu'à 100 options (option de base et jusqu'à 99 options supplémentaires). Les options de produit doivent être répertoriées dans la définition de produit avant d'être packagées à l'aide de la commande PKGPRDOPT).

Les valeurs possibles pour Option de produit sont les suivantes :

*BASE: Les informations de l'option de base sont créées.
option-produit: Indiquez le numéro d'option de l'option de produit à laquelle s'appliquent les informations. Vous pouvez entrer une valeur comprise entre 1 et 99.

La valeur possible pour ID message est la suivante :

ID-message: Indiquez l'ID message du message qui décrit l'option de produit.

Les valeurs possibles pour Autoriser l'appellation dynamique sont les suivantes :

*NODYNNAM: Les bibliothèques et les dossiers principaux ne sont nommés de façon dynamique au moment de l'installation. Les noms de bibliothèque principale et de dossier principal sont utilisés, sauf lorsqu'un nom de bibliothèque de langue secondaire est utilisée.
*ALWDYNNAM: Les bibliothèques et les dossiers principaux peuvent être nommés de façon dynamique au moment de l'installation. Si l'option de produit contient des répertoires, vous devez autoriser l'appellation dynamique pour l'option. Si vous n'autorisez pas l'appellation dynamique, vous devrez préparer le produit dans un répertoire initial autre que celui défini dans une édition précédente. Gardez à l'esprit que si vous vous n'autorisez pas l'appellation dynamique, le système peut ne pas vous autoriser à installer votre produit ce dernier a un ID d'enregistrement différent installé dans le répertoire.

Les valeurs possibles pour ID de chargement de langue sont les suivantes :

*NONE: Aucun chargement de langue n'est utilisé.
*IBMLNG: L'option de produit est disponible dans toutes les langues IBM.
*BASEOPT: Les ID de langue spécifiés pour l'option de base sont utilisés pour les ID de chargement de langue.
ID-chargement-langue: Indiquez les langues (29xx) dans lesquelles l'option est disponible.

Les valeurs possibles pour ID de chargement de code sont les suivantes :

*CODEDFT: L'ID de chargement du code par défaut, 5001, est utilisé.
ID_chargement-code: Indique l'ID de chargement de code pour cette option de produit. Les valeurs admises sont comprises entre 5001 et 9999.

Copyright 1er année (CPYRGTFST)

Indique la première année de copyright pour le produit. Cette année doit être spécifiée sous la forme d'un nombre à quatre chiffres (1990, par exemple).

Les valeurs possibles sont :

*CURRENT: L'année en cours est extraite du système.
*NONE: Aucune première année de copyright n'est indiquée. La valeur est stockée sous la forme de 4 blancs.
première-année-copyright: Indiquez le nombre à quatre chiffres de la première année de copyright.

Copyright année en cours (CPYRGTCUR)

Indique l'année de copyright actuelle pour le produit.

Remarque :Si ni CPYRGTCUR(*NONE) ni CPYRGTFST(*NONE) n'est spécifié, CPYRGTCUR doit être supérieur ou égal à CPYRGTFST. Lorsque les deux années de copyright sont spécifiées, la valeur de CPYRGTCUR doit être supérieure ou égale à la valeur CPYRGTFST.

Les valeurs possibles sont :

*CURRENT: L'année en cours est extraite du système.
*NONE: Aucune année de copyright actuelle n'est indiquée.
année-copyright-actuelle: Indiquez l'année de copyright sous la forme d'un nombre à quatre chiffres (1991, par exemple).

Editions multiples admises (ALWMLTRLS)

Indique si plusieurs éditions du produit peuvent exister le système en même temps.

Les valeurs possibles sont :

*NO: Une seule édition du produit est autorisée sur un système à un moment donné.
*YES: Le produit peut être installé plusieurs fois si les niveaux d'édition sont distincts.

Suffixe ID produit (PRDIDSFX)

Indique le suffixe à utiliser avec l'ID de produit lorsque PRDID(*SER) est spécifié. Les caractères admis sont les suivants : lettres majuscules de A à Z et nombre de 0 à 9.

Date d'édition (RLSDATE)

Indique la date d'édition du produit.

Les valeurs possibles sont :

*NONE: Aucune date d'édition n'est associée au produit.
date-édition: Indiquez la date d'édition dans le format déterminé par la description de travail.

Texte 'descriptif' (TEXT)

Désigne le texte court de description de l'objet.

Les valeurs possibles sont :

*BLANK: Aucun texte n'est indiqué.
'descriptif': Tapez un texte d'au plus 50 caractères, entre apostrophes.

Droits (AUT)

Indique les droits accordés aux utilisateurs qui ne disposent d'aucun droit spécifique sur la définition de produit, qui ne figurent pas dans la liste d'autorisation, ou dont le groupe ne possède pas les droits spécifiques sur l'interface de réseau.

Les valeurs possibles sont :

*LIBCRTAUT: Les droits pour la définition de produit proviennent du paramètre CRTAUT (Créer des droits) de la bibliothèque dans laquelle la définition de produit est en cours de création. Si la valeur spécifiée pour le paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.
*USE: L'utilisateur peut effectuer des opérations de base sur le produit, telles que l'exécution d'un programme ou la lecture d'un fichier. L'utilisateur ne peut pas modifier le chargement de produit. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).
*ALL: L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet et il peut également modifier le droit de propriété de cette définition de produit.
*CHANGE: L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut également effectuer des fonctions de base sur cet objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données.
*EXCLUDE: L'utilisateur ne peut accéder à la définition de produit.

Exemples

CRTPRDDFN   PRDDFN(TESTLIB/TEST01)  PRDID(9XYZ123)  RLS(V1R2M0)
            RGSID(*PHONE 1234567)  MSGF(TSTMSGF)
            PRDOPT((*BASE MSG0001 *NODYNNAM 2924 *CODEDFT)
            CPYRGTFST(2001)  CPYRGTCUR(2006)  ALWMLTRLS(*NO)
            RLSDATE(*NONE)  TEXT('product TEST01')
            AUT(*LIBCRTAUT)

Cette commande permet de créer la définition de produit TEST01 dans la bibliothèque TESTLIB. L'ID de produit est 9XYZ123, le niveau d'édition du produit est V1R2M0, et le numéro de téléphone de l'enregistrement est 1234567. Le fichier message TSTMSGF de la bibliothèque TESTLIB contiendra les messages qui décrivent le produit. L'option de base est utilisée avec l'ID de chargement de la langue 2924. Les paramètres restants sont inclus pour davantage définir l'objet.

Messages d'erreur

*ESCAPE Messages

CPF9899: Erreur lors du traitement de la commande.