CRTCLD

Créer description locale C

Create C Locale Description

En bref

La commande Créer description d'environnement local C/400* (CRTCLD) crée un objet description d'environnement local (*CLD) à partir des informations source fournies dans les paramètres SRCFILE et SRCMBR. The Create C/400* Locale Description (CRTCLD) command creates a locale description object (*CLD) using the source information provided on the SRCFILE and SRCMBR parameters.

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

Syntaxe minimale

CRTCLD CLD(…)

Paramètres

CLD Nom de l'environnement local Locale name obligatoire
SRCFILE Fichier source Source file
SRCMBR Membre source Source member
TEXT Description du texte Text description
OPTION Option de listage de la source Source listing option
LISTING Niveau de listage des erreurs Error listing level
PRTFILE Fichier d'impression Print file
REPLACE Remplacer Replace
AUT Droits Authority
TGTRLS Édition cible Target Release

Astuce : dans une session 5250, tapez CRTCLD 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 Créer description d'environnement local C/400* (CRTCLD) crée un objet description d'environnement local (*CLD) à partir des informations source fournies dans les paramètres SRCFILE et SRCMBR. Le fichier source de description d'environnement local doit exister. The Create C/400* Locale Description (CRTCLD) command creates a locale description object (*CLD) using the source information provided on the SRCFILE and SRCMBR parameters. The locale description source file must exist.

Pour modifier un environnement local existant, utilisez la commande Extraire source de description d'environnement local C (RTVCLDSRC). To change an existing locale, use the Retrieve C Locale Description (RTVCLDSRC) command.

Messages d'erreur CRTCLD

Messages *ESCAPE *ESCAPE Messages

PSE1707: L'option de listage de la commande CRTCLD a échoué. The listing option on the CRTCLD command failed.
PSE1708: Le membre &3 est introuvable dans le fichier et la bibliothèque indiqués. Member &3 is not found in the specified file and library.
PSE1709: Le fichier &1 est introuvable dans la bibliothèque &2. File &1 is not found in library &2.
PSE1739: La mémoire nécessaire n'a pas pu être allouée. The necessary storage could not be allocated.
PSE1749: La compilation a échoué. L'objet d'environnement local &1 n'est pas créé. Compilation failed. Locale object &1 is not created.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CLD	Nom de l'environnement localLocale name	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1 : Nom de l'environnement localQualificatif 1: Locale name	Nom
	Qualificatif 2: BibliothèqueQualificatif 2: Library	Nom, *CURLIB
SRCFILE	Fichier sourceSource file	Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1 : Fichier sourceQualificatif 1: Source file	Nom, QCLDSRC
	Qualificatif 2: BibliothèqueQualificatif 2: Library	Nom, LIBL, CURLIB
SRCMBR	Membre sourceSource member	Nom, *CLD	Facultatif, positionnel 3
TEXT	Description du texteText description	Valeur caractère, SRCMBRTXT, BLANK	Facultatif, positionnel 4
OPTION	Option de listage de la sourceSource listing option	NOSOURCE, SOURCE, NOSRC, SRC	Facultatif, positionnel 5
LISTING	Niveau de listage des erreursError listing level	NOSECLVL, SECLVL	Facultatif, positionnel 6
PRTFILE	Fichier d'impressionPrint file	Nom d'objet qualifié	Facultatif, positionnel 7
	Qualificatif 1 : Fichier d'impressionQualificatif 1: Print file	Nom, QSYSPRT
	Qualificatif 2: BibliothèqueQualificatif 2: Library	Nom, LIBL, CURLIB
REPLACE	RemplacerReplace	YES, NO	Facultatif, positionnel 8
AUT	DroitsAuthority	Nom, LIBCRTAUT, ALL, CHANGE, USE, *EXCLUDE	Facultatif, positionnel 9
TGTRLS	Édition cibleTarget Release	CURRENT, PRV, V3R0M5, V3R1M0, V3R6M0	Facultatif, positionnel 10

Nom de l'environnement local (CLD)Locale name (CLD)

Indique le nom et la bibliothèque de la nouvelle description d'environnement local C/400. Specifies the name and the library of the new C/400 locale description.

locale-name: Entrez un nom pour la description d'environnement local C/400. Enter a name for the C/400 locale description.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*CURLIB: La bibliothèque en cours est utilisée pour stocker l'environnement local lors du traitement de CRTCLD. Si vous n'avez pas indiqué de bibliothèque en cours, QGPL est utilisée. The current library is used to store the locale when CRTCLD is processed. If you have not specified a current library, QGPL is used.
nom-bibliothèque: Entrez le nom de la bibliothèque dans laquelle la description d'environnement local C/400 doit être créée. La bibliothèque doit déjà exister. Enter the name of the library where the C/400 locale description is to be created. The library must already exist.

Fichier source (SRCFILE)Source file (SRCFILE)

Indique le nom du fichier physique source et la bibliothèque de la source de description d'environnement local C/400. Le fichier physique source et la bibliothèque doivent tous deux exister. Specifies the source physical file name and library of the C/400 locale description source. Both the source physical file and the library must exist.

QCLDSRC: Nom par défaut du fichier physique source contenant la source de description d'environnement local C/400 à traiter. The default name for the source physical file containing the C/400 locale description source to be processed.
source-file-name: Entrez le nom du fichier contenant la source de description d'environnement local C/400. Enter the name of the file containing the C/400 locale description source.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*LIBL: La liste de bibliothèques est parcourue pour trouver la bibliothèque contenant le fichier source lors du traitement de CRTCLD. The library list is searched to find the library containing the source file when CRTCLD is processed.
*CURLIB: La bibliothèque en cours est parcourue pour trouver le fichier source lors du traitement de CRTCLD. Si vous n'avez pas indiqué de bibliothèque particulière comme bibliothèque en cours, QGPL est utilisée. The current library is searched for the source file when CRTCLD is processed. If you have not indicated a specific library as your current library, QGPL is used.
nom-bibliothèque: Entrez le nom de la bibliothèque contenant le fichier source de description d'environnement local C/400. Enter the name of the library containing the C/400 locale description source file.

Membre source (SRCMBR)Source member (SRCMBR)

Indique le membre contenant la source de description d'environnement local C/400. Le membre se trouve dans le fichier et la bibliothèque indiqués dans le paramètre SRCFILE. Ce membre doit exister. Specifies the member containing the C/400 locale description source. The member is in the file and library specified on the SRCFILE parameter. This member must exist.

*CLD: Le nom d'environnement local identifié par le paramètre CLD est aussi le nom du membre. The locale name identified by the CLD parameter is also the name of the member.
source-file-member-name: Entrez le nom du membre de fichier qui contient la source de description d'environnement local à traiter. Enter the name of the file member that contains the locale description source to be processed.

Description du texte (TEXT)Text description (TEXT)

Entrez le texte qui décrit la description d'environnement local C/400. Enter text that describes the C/400 locale description.

*SRCMBRTXT: La description textuelle associée à la source de description d'environnement local est utilisée. The text description associated with the locale description source is used.
*BLANK: Aucun texte n'apparaît. No text appears.
'description': Entrez un texte descriptif d'au plus 50 caractères, placé entre apostrophes. Les apostrophes ne font pas partie de la chaîne de 50 caractères. Enter descriptive text no longer than 50 characters, and enclose it in single quotation marks. The quotation marks are not part of the 50 character string.

Option de listage de la source (OPTION)Source listing option (OPTION)

Indique les options que vous souhaitez utiliser lors du traitement de la source de description d'environnement local C/400. Specifies the options you want to use when you process the C/400 locale description source.

*NOSOURCE or *NOSRC: Ne crée pas de listage de la source. Does not create a source listing.
*SOURCE or *SRC: Crée un listage de la source. Creates a source listing.

Niveau de listage des erreurs (LISTING)Error listing level (LISTING)

Indique le niveau de détail des messages d'erreur à inclure dans le listage de la source créé. Specifies the level of detail of error messages to include in the created source listing.

*NOSECLVL: Seul le texte de premier niveau des messages d'erreur est inclus dans le listage de la source créé. Only the first-level error message text is included in the created source listing.
*SECLVL: Les deux niveaux de texte des messages sont inclus dans le listage de la source créé. Le texte de second niveau décrit la cause de l'erreur, les mesures de reprise possibles et une description technique des étapes de traitement effectuées à cause de l'erreur. Both levels of message text are included in the created source listing. The second level text describes the cause of the error, the possible steps to take to recover, and a technical description of the processing steps taken because of the error.

Fichier d'impression (PRTFILE)Print file (PRTFILE)

Indique le nom et la bibliothèque du fichier d'impression qui sera utilisé pour imprimer le listage de la source. Specifies the name and library of the printer file that will be used to print the source listing.

QSYSPRT: Le listage est dirigé vers le fichier d'impression par défaut QSYSPRT. The listing is directed to the default printer file QSYSPRT.
print-file-name: Entrez le nom du fichier d'impression vers lequel vous souhaitez diriger votre listage de la source. Il doit être défini avec une longueur d'enregistrement minimale de 132 caractères. Enter the name of the printer file where you want to direct your source listing. It must be defined to have a minimum record length of 132 characters.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*LIBL: Le système recherche le fichier d'impression dans la liste de bibliothèques. The system searches the library list for the printer file.
*CURLIB: Le fichier d'impression est recherché dans la bibliothèque en cours. Si vous n'avez pas indiqué de bibliothèque particulière comme bibliothèque en cours, QGPL est utilisée. The current library is searched for the printer file. If you have not indicated a specific library as your current library, QGPL is used.
nom-bibliothèque: Entrez le nom de la bibliothèque dans laquelle se trouve le fichier d'impression. Enter the name of the library where the printer file will be found.

Remplacer (REPLACE)Replace (REPLACE)

Indique si la version existante de l'objet description d'environnement local doit être remplacée par la version en cours. Specifies whether the existing version of the locale description object is to be replaced by the current version.

YES: La description d'environnement local existante est remplacée par la nouvelle version. L'ancienne version est déplacée dans la bibliothèque QRPLOBJ et renommée d'après la date et l'heure du système. La description textuelle de la description d'environnement local remplacée est remplacée par le nom de la description d'environnement local d'origine. L'ancienne description d'environnement local est supprimée lors de l'IPL suivant si vous ne la supprimez pas explicitement. The existing locale description is replaced with the new version. The old version is moved to the library, QRPLOBJ, and renamed based on the system date and time. The text description of the replaced locale description is changed to the name of the original locale description. The old locale description is deleted at the next IPL if you do not explicitly delete it.
*NO: La description d'environnement local existante n'est pas remplacée. Si une description d'environnement local de même nom existe dans la bibliothèque indiquée, un message est affiché et la description d'environnement local n'est pas créée. The existing locale description is not replaced. If a locale description with the same name exists in the specified library, a message is displayed and the locale description is not created.

Droits (AUT)Authority (AUT)

Indique les droits sur l'objet que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas dans la liste d'autorisation ou dont le groupe n'a pas de droits spécifiques sur l'objet. Specifies the object authority you are granting the users who do not have specific authority to the object, who are not on the authorization list, or whose group has no specific authority to the object.

*LIBCRTAUT: Les droits publics sur l'objet seront extraits du mot clé CRTAUT de la bibliothèque cible (la bibliothèque qui contiendra l'objet créé). Cette valeur sera déterminée à la création de l'objet. Si la valeur CRTAUT de la bibliothèque est modifiée après la création de l'objet, la nouvelle valeur n'affectera PAS les objets existants. The public authority for the object will be taken from the CRTAUT keyword of the target library (the library that will contain the created object). This value will be determined when the object is created. If the CRTAUT value for the library changes after the object is created, the new value will NOT affect any existing objects.
*CHANGE: Fournit tous les droits sur les données et le droit d'exécuter toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits objet et gestion d'objet. Vous pouvez modifier l'objet et exécuter des fonctions de base sur celui-ci. Provides all data authority and the authority to perform all operations on the object except those limited to the owner or controlled by object authority and object management authority. You can change the object and perform basic functions on it.
*USE: Fournit le droit d'exploitation de l'objet et le droit de lecture ; droit d'effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Vous ne pouvez pas modifier l'objet. Provides object operational authority and read authority; authority for basic operations on the object such as running a program or reading a file. You are prevented from changing the object.
*ALL: Droit pour toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par le droit de gestion de la liste d'autorisation. Vous pouvez contrôler l'existence de l'objet, définir sa sécurité, le modifier et exécuter des fonctions de base sur celui-ci, mais vous ne pouvez pas transférer sa propriété. Authority for all operations on the object except those limited to the owner or controlled by authorization list management authority. You can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object, but you cannot transfer its ownership.
*EXCLUDE: Vous ne pouvez pas accéder à l'objet. You are prevented from accessing the object.

Édition cible (TGTRLS)Target Release (TGTRLS)

Indique l'édition du système d'exploitation sur laquelle vous prévoyez d'utiliser l'objet en cours de création. Specifies the release of the operating system on which you intend to use the object being created.

\nRemarque : Ce paramètre n'a aucune fonction dans la commande CRTCLD, mais il est inclus par souci de cohérence avec les autres commandes CL de création d'objets. Un objet *CLD créé avec l'une des valeurs TGTRLS autorisées peut être restauré et utilisé avec la version précédente du système d'exploitation. Remarque :This parameter has no function in the CRTCLD command but is included for consistency with other CL commands for creating objects. A *CLD object created with any of the allowed TGTRLS values can be restored and used with the previous version of the operating system.

*CURRENT

L'objet doit être utilisé sur l'édition du système d'exploitation en cours d'exécution sur votre système. Par exemple, si V3R6M0 est en cours d'exécution sur le système, *CURRENT signifie que vous prévoyez d'utiliser l'objet sur un système où V3R6M0 est installé. Vous pouvez également utiliser l'objet sur un système où est installée toute édition ultérieure du système d'exploitation. The object is to be used on the release of the operating system currently running on your system. For example, if V3R6M0 is running on the system, *CURRENT means you intend to use the object on a system with V3R6M0 installed. You can also use the object on a system with any later release of the operating system installed.

*PRV

L'objet doit être utilisé sur l'édition précédente du système d'exploitation. Par exemple, si V3R6M0 est en cours d'exécution sur votre système, *PRV signifie que vous prévoyez d'utiliser l'objet sur un système où V2R3M0 est installé. Vous pouvez également utiliser l'objet sur un système où est installée toute édition ultérieure du système d'exploitation. The object is to be used on the previous release of the operating system. For example, if V3R6M0 is running on your system, *PRV means you intend to use the object on a system with V2R3M0 installed. You can also use the object on a system with any later release of the operating system installed.

release-level

Specify the release in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level.

L'objet peut être utilisé sur un système où est installée l'édition indiquée du système d'exploitation ou toute édition ultérieure. The object can be used on a system with the specified release or any later release of the operating system installed.

Les valeurs valides dépendent de la version, de l'édition et du niveau de modification en cours, et elles changent à chaque nouvelle édition. Appuyez sur la touche F4 (Invite) à partir du paramètre TGTRLS pour afficher la liste des valeurs valides pour cette édition. Valid values depend on the current version, release, and modification level, and these change with each new release. Press the F4 (Prompt) key from the TGTRLS parameter to see the list of valid values for this release.

Exemples

None

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

PSE1707: L'option de listage de la commande CRTCLD a échoué. The listing option on the CRTCLD command failed.
PSE1708: Le membre &3 est introuvable dans le fichier et la bibliothèque indiqués. Member &3 is not found in the specified file and library.
PSE1709: Le fichier &1 est introuvable dans la bibliothèque &2. File &1 is not found in library &2.
PSE1739: La mémoire nécessaire n'a pas pu être allouée. The necessary storage could not be allocated.
PSE1749: La compilation a échoué. L'objet d'environnement local &1 n'est pas créé. Compilation failed. Locale object &1 is not created.