CRTMSGF

La commande CRTMSGF (Créer un fichier message) permet de créer un fichier des messages définis par l'utilisateur, destiné à stocker les descriptions de message. Ce fichier doit être inclus dans une bibliothèque à laquelle les utilisateurs de ces messages sont autorisés à accéder. Le système est livré avec les éléments suivants : fichiers message fournis par IBM et stockés dans la bibliothèque système QSYS ; fichier message QCPFMSG (pour le système IBM i et les messages d'interface machine) ; fichiers message de logiciel sous licence (QRPGMSG, par exemple).

Paramètres

fichier message (MSGF)

Indique le fichier message à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : fichier message

nom-fichier-messages

Indiquez le nom du fichier message en cours de création.

Qualificatif 2 : Biblio

*CURLIB

La bibliothèque en cours du travail permet de créer le fichier message. Si aucune entrée de bibliothèque en cours ne figure dans la liste des bibliothèques, la bibliothèque QGPL est utilisée par défaut.

nom-bibliothèque

Indiquez la bibliothèque où doit être créé le fichier message.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

'descriptif'

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

Taille du fichier (SIZE)

Indique la taille de mémoire initialement attribuée au fichier message, celle ajoutée à chaque incrémentation, et le nombre d'incrémentations possible. La taille de mémoire est exprimée en kilooctets (ko). (1 ko = 1024 octets de mémoire). La taille du fichier message est accrue lorsqu'un espace de fichier source est nécessaire pour l'ajout d'une description de message. Si SIZE n'est pas défini, la valeur prise en compte est SIZE(10 2 *NOMAX).

Elément 1 : Taille mémoire initiale

10

La taille de mémoire secondaire attribuée au fichier message est de 10 ko.

Kilo-octets-initiaux

Indiquez la taille initiale du fichier (obligatoirement supérieure à 0).

Elément 2 : Taille d'incrément mémoire

2

2 ko sont ajoutés à la mémoire attribuée au fichier message chaque fois que la taille de celui-ci est augmentée.

valeur-incrément

Indiquez le nombre de kilo-octets ajoutés à chaque augmentation de la taille du fichier message.

Elément 3 : Nombre maximal d'incréments

*NOMAX

La quantité maximale de mémoire qu'il est possible d'ajouter pour le fichier message n'est pas définie par l'utilisateur. La taille maximale est déterminée par le système.

nombre-incrémentations

Entrez le nombre maximal d'augmentations de la taille du fichier message. Indiquez 0 pour empêcher toute possibilité d'augmentation de la taille du fichier.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*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 réaliser des fonctions de base sur l'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. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*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 Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

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

Indique l'ID codé de jeu de caractères (CCSID) qui sera associé au fichier message. Le CCSID associé au fichier message remplace toujours le CCSID associé à la description de message. Pour utiliser ce dernier, vous devez remplacer la valeur du CCSID associé au fichier message par *MSGD. Pour plus d'informations sur le gestionnaire des messages et la manière dont ce dernier utilise les CCSID, reportez-vous au manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*HEX

La valeur du CCSID associé au fichier message est fixée à 65535. Cela signifie qu'aucune conversion n'est effectuée lors de l'ajout, la modification ou l'extraction de descriptions de messages dans le fichier message. Le CCSID associé à la description de message est sauvegardé au cas où la valeur du CCSID du fichier message serait remplacée par *MSGD.

*MSGD

La valeur du CCSID associé au fichier message est fixée à 65534. Cela implique que le CCSID associé à la description de message doit être utilisé lors de l'extraction d'un texte de message du fichier. Lors de l'ajout ou la modification de descriptions de messages dans le fichier message, aucune conversion n'est effectuée. La description de message porte le CCSID indiqué dans les commandes ADDMSGD ou CHGMSGD.

*JOB

Le CCSID du fichier message est le même que celui du travail qui appelle la commande.

ID-codé-jeu-caractères

Indiquez le CCSID avec lequel le fichier message sera créé. La valeur du CCSID de toute description de message ajoutée à ce fichier message passe du CCSID indiqué à celui du fichier message. Les valeurs admises sont comprises entre 1 et 65535. La liste des valeurs de CCSID admises est fournie dans le manuel Internationalisation de l'iSeries Information Center, à l'adresse http://www.ibm.com/eserver/iseries/infocenter. Seuls sont acceptés les CCSID possibles pour le travail concerné.

Exemples

CRTMSGF   MSGF(INVLIB/INVMSGS)
          TEXT('Messages d'application d'inventaire')

Cette commande crée un fichier de message appelé INVMSGS dans lequel sont stockés les messages prédéfinis d'application d'inventaire. Ce fichier est stocké dans la bibliothèque INVLIB, pour laquelle tous les utilisateurs du fichier doivent disposer du droit *USE. Etant donné que la valeur par défaut du paramètre AUT est utilisée, tous les utilisateurs disposent du droit *CHANGE sur le fichier, ce qui leur permet d'extraire des messages du fichier.

Messages d'erreur

Messages *ESCAPE

CPF2108

Objet &1, type *&3, non ajouté à la bibliothèque &2.

CPF2112

L'objet &1 de type *&3 existe déjà dans &2.

CPF2113

Impossible d'allouer la bibliothèque &1.

CPF2151

Erreur de l'opération sur &2 de &1 type *&3.

CPF2182

Non autorisé à utiliser la bibliothèque &1.

CPF2283

La liste d'autorisation &1 n'existe pas.

CPF2402

Bibliothèque &1 non trouvée

CPF247E

Le CCSID &1 est incorrect.

CPF2497

Taille de &1 dans &2 excède la limite de la machine.

CPF9838

Limite mémoire du profil utilisateur dépassée.