CRTLOCALE

La commande CRTLOCALE (Créer un environnement local) permet de créer un objet environnement local (*LOCALE) utilisant des informations source à partir du fichier indiqué au paramètre SRCFILE.

Un environnement local est un objet qui peut déterminer la manière de traiter, d'imprimer et d'afficher les données. Il est constitué de catégories qui définissent la langue, les données culturelles et les jeux de caractères. Les environnements locaux ne sont pas livrés avec le système d'exploitation en tant qu'objets système. En revanche, leurs fichiers source de définition sont livrés.

Pour plus de détails sur les environnements locaux, reportez-vous au manuel Internationalisation de l'iSeries Information Center, à l'adresse http://www.ibm.com/eserver/iseries/infocenter.

Restriction

Tout environnement local doit être créé dans le système de fichiers QSYS.

Paramètres

Nom d'environnement local (LOCALE)

Indique le nom du chemin à l'environnement local créé.

Nom chemin fichier source (SRCFILE)

Indique le nom du chemin au fichier source contenant la description de l'environnement local en cours de création. Si le CCSID du fichier est 65535, cette commande adopte le CCSID par défaut du travail. Si le fichier provient du système de fichiers QSYS, il doit être un fichier physique source base de données.

Remarque :Si le fichier source n'est pas un fichier enregistrement, chaque ligne doit avoir été terminée par une nouvelle ligne ou par un caractère de saut de ligne lors de la création du fichier.

ID codé de jeu de caractères (CCSID)

Indique l'ID de jeu de caractères codés (CCSID) dans lequel les informations d'environnement local doivent être stockées pour l'objet environnement local.

Les valeurs possibles sont les suivantes :

*JOB

Indique que le CCSID du travail est utilisé pour les informations d'environnement local. Si le CCSID du travail est 65535, le CCSID par défaut de ce dernier est utilisé.

*UTF

Indique que deux environnements locaux seront créés, un pour UTF8 et un autre pour UTF32. _8 et _4 seront associés respectivement aux noms indiqués pour les environnements locaux UTF8 et UTF32. Le nom d'environnement local sera limité à 8 caractères si CCSID(*UTF) est indiqué.

ID-codé-jeu-caractères

Indiquez le CCSID utilisé pour les informations d'environnement de travail.

Niveau gravité pour génération (GENLVL)

Indique le niveau de gravité de contrôle à appliquer lors de la création. Le niveau de gravité des messages générés détermine le type des erreurs qui peuvent se produire.

Remarque :Si des erreurs d'un niveau de gravité supérieur à 20 se produisent, l'environnement local n'est pas créé.

Les valeurs possibles sont les suivantes :

10

L'environnement local est créé avec des erreurs du niveau de gravité 10.

20

L'environnement local est créé avec des erreurs du niveau de gravité 20.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'environnement local.

Les valeurs possibles sont les suivantes :

*BLANK

Aucun texte n'est indiqué.

'descriptif'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Sortie (OUTPUT)

Indique si une liste de compilation est générée.

Les valeurs possibles sont les suivantes :

*PRINT

La liste de compilation est générée. Les informations qu'elle contient dépendent des valeurs indiquées au paramètre OPTION.

*NONE

La liste de compilation n'est pas générée. Pour améliorer les performances de la compilation, indiquez cette valeur lorsque la liste n'est pas indispensable.

Options pour liste source (OPTION)

Indique le type des listes de sortie créées lors du traitement de la commande.

Les valeurs possibles sont les suivantes :

*SRC

L'entrée source utilisée pour créer l'environnement local est imprimée.

*NOSRC

L'entrée source utilisée pour créer l'environnement local n'est pas imprimée.

*NOSECLVL

Seul le texte des messages d'erreur de premier niveau est inclus dans la liste source.

*SECLVL

Le texte des messages de deuxième niveau est imprimé.

Remplacer objet (REPLACE)

Indique si toute version existante de l'environnement local doit être remplacée par la nouvelle version.

Les valeurs possibles sont les suivantes :

*YES

La nouvelle version de l'environnement local remplace la précédente. Celle-ci est placée dans la bibliothèque QRPLOBJ et rebaptisée selon la date et l'heure système ; la description locale initiale n'est pas utilisée comme nouvelle description locale. Elle sera supprimée lors du prochain IPL, mais vous pouvez la supprimer avant, à l'aide de la commande DLTLOCALE (Supprimer environnement local).

*NO

La version précédente de l'environnement local n'est pas remplacée et un message d'erreur est généré.

Droits publics sur données (DTAAUT)

Indique les droits publics accordés aux utilisateurs sur les données contenues dans l'objet créé.

Les valeurs possibles sont les suivantes :

*INDIR

Les droits sur l'objet dépendent de ceux associés au répertoire dans lequel il est créé. Si *INDIR est indiqué pour DTAAUT, il est requis également pour OBJAUT.

*RWX

L'utilisateur dispose des droits *RWX sur l'objet. Cela permet d'exécuter toutes les opérations, à l'exception de celles qui sont réservées au propriétaire ou contrôlées par les droits d'existence sur l'objet, de gestion de l'objet, de modification des attributs de l'objet et de référence sur l'objet. L'utilisateur peut donc modifier l'objet et exécuter les fonctions de base, les droits *RWX comprenant les droits opérationnels et tous les droits sur les données.

*RX

Les droits *RX permettent à l'utilisateur d'exécuter les opérations de base sur l'objet, telles que l'exécution d'un programme ou l'affichage du contenu d'un fichier. En revanche, il ne peut pas modifier l'objet. Les droits *RX incluent les droits opérationnels sur l'objet et les droits de lecture et d'exécution.

*RW

Les droits *RW permettent à l'utilisateur de visualiser et de modifier le contenu de l'objet. Ils incluent les droits opérationnels et les droits de lecture, d'ajout, de mise à jour et de suppression de données.

*WX

Les droits *WX permettent à l'utilisateur de modifier le contenu de l'objet, d'exécuter un programme ou de rechercher une bibliothèque ou un répertoire. Ils incluent les droits opérationnels, les droits d'ajout, de mise à jour et de suppression de données, ainsi que les droits d'exécution.

*R

Les droits *R permettent à l'utilisateur de visualiser le contenu de l'objet. Ils incluent les droits opérationnels et les droits de lecture.

*W

Les droits *W permettent à l'utilisateur de modifier le contenu de l'objet. Ils incluent les droits opérationnels et les droits d'ajout, de mise à jour et de suppression de données.

*X

Les droits *X permettent à l'utilisateur d'exécuter un programme ou de rechercher une bibliothèque ou un répertoire. Ils incluent les droits opérationnels et les droits d'exécution.

*EXCLUDE

La valeur spéciale EXCLUDE empêche l'utilisateur d'accéder à l'objet. Si vous l'utilisez, vous devez indiquer *NONE pour OBJAUT.

*NONE

Les utilisateurs ne disposent d'aucun droit sur les données de l'objet. Vous ne pouvez pas utiliser cette valeur si *NONE est indiqué pour OBJAUT.

nom-liste-autorisation

Indiquez le nom de la liste d'autorisation utilisée.

Droits publics sur l'objet (OBJAUT)

Indique les droits sur l'objet accordés aux utilisateurs.

Les valeurs possibles sont les suivantes :

*INDIR

Les droits sur l'objet dépendent de ceux associés au répertoire dans lequel il est créé. Si *INDIR est indiqué pour DTAAUT, il est requis également pour OBJAUT.

*NONE

Aucun des autres droits sur l'objet (existence, gestion, modification des attributs et référence) n'est accordé aux utilisateurs. Vous devez indiquer cette valeur si *EXCLUDE ou un nom de liste d'autorisation est spécifié pour le paramètre DTAAUT.

*ALL

Tous les autres droits sur l'objet (existence, gestion, modification des attributs et référence) sont accordés aux utilisateurs.

Vous pouvez également indiquer quatre valeurs au maximum parmi les suivantes :

*OBJEXIST

Accorde aux utilisateurs les droits d'existence sur l'objet.

*OBJMGT

Accorde aux utilisateurs les droits de gestion de l'objet.

*OBJALTER

Accorde aux utilisateurs les droits de modification des attributs de l'objet.

*OBJREF

Accorde aux utilisateurs les droits de référence sur l'objet.

Exemples

CRTLOCALE   LOCALE('/QSYS.LIB/MYLIB.LIB/USLOCALE.LOCALE')
            SRCFILE('/QSYS.LIB/MYLIB.LIB/LSRC.FILE/USLOCALE.MBR')
            CCSID(37)  TEXT('Environnement local pour les Etats-Unis')

Cette commande permet de créer l'environnement local USLOCALE dans la bibliothèque MYLIB, système de fichiers QSYS.LIB, avec le CCSID 37. Le paramètre TEXT indique qu'il s'agit d'un environnement local pour les Etats-Unis.

CRTLOCALE   LOCALE('/QSYS.LIB/MYLIB.LIB/USLOCALE.EXAMPLE')
            SRCFILE('/QSYS.LIB/MYLIB.LIB/LSRC.FILE/EXAMPLE.MBR')
            CCSID(*UTF))  TEXT('Exemples d'environnements locaux UTF')

Cette commande permet de créer deux environnements locaux nommés EXAMPLE_4 (CCSID 1232) et EXAMPLE_8 (CCSID 1208) dans la bibliothèque MYLIB, système de fichiers QSYS.LIB. Le paramètre TEXT indique qu'il s'agit d'exemples d'environnements locaux UTF.

Messages d'erreur

Messages *ESCAPE

CPF3BE1

Objet d'environnement local &1 non créé.