CHGMSGF

La commande CHGMSGF permet de modifier les attributs d'un fichier message particulier ou une liste de fichiers message.

Restrictions

1. La recherche est effectuée uniquement dans les bibliothèques pour lesquelles vous disposez du droit *USE.
2. Vous devez disposer des droits *USE et *DLT sur le fichier message.

Paramètres

fichier message (MSGF)

Indique le nom du ou des fichier(s) de messages dont les attributs sont en cours de modification.

Ce paramètre est obligatoire.

Qualificatif 1 : fichier message

*ALL

Tous les fichiers message des bibliothèques identifiées dans le qualificatif de bibliothèque sont modifiés.

nom-générique*-fichier-messages

Indiquez le nom générique du fichier message dont les attributs sont à modifier. Un nom générique est une chaîne composée de un ou plusieurs caractères suivis d'un astérisque (*) (par exemple, ABC*). L'astérisque remplace tout caractère admis. Un nom générique désigne tout objet dont le nom commence par le préfixe générique sur lequel l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom complet de l'objet. Si le nom de l'objet est indiqué en entier et que le qualificatif de bibliothèque est *USRLIBL, *ALL ou *ALLUSR, tous les fichiers message portant le nom indiqué sont modifiés.

nom

Indiquez le nom du fichier message dont les attributs sont à modifier.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche s'effectue dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.

*USRLIBL

La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques de l'unité d'exécution.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Texte 'descriptif' (TEXT)

Désigne le texte décrivant le fichier message. Le texte indiqué remplace éventuellement le texte précédent.

*SAME

Le texte, s'il existe, reste inchangé.

*BLANK

Aucun texte n'est indiqué.

'descriptif'

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

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

Indique l'ID codé de jeu de caractères (CCSID) qui sera associé au fichier message. Aucune conversion de texte ne sera effectuée dans les descriptions de messages existant déjà dans le fichier message. La valeur de CCSID de toute description de message ajoutée ultérieurement dans ce fichier message passera de celle qui est indiquée dans la commande ADDMSGD à celle du fichier message. Le CCSID associé à ce fichier message remplace le CCSID associé à la description de message. Pour utiliser ce dernier, vous devez remplacer la valeur du CCSID associé au fichier message par *MSGD.

*SAME

Le CCSID associé au fichier message reste inchangé.

*HEX

La valeur du CCSID associé au fichier message est fixée à 65535, ce qui signifie que les conversions ne seront pas effectuées lors de l'ajout, la modification ou l'extraction de descriptions dans le fichier message. Le CCSID indiqué dans les commandes ADDMSGD ou CHGMSGD 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 65534, ce qui signifie que le CCSID associé à la description de message sera utilisé lors de l'extraction d'un texte de message de ce fichier message. En cas d'ajout ou de modification de descriptions de messages dans le fichier message, aucune conversion ne sera effectuée et la description de message portera le CCSID indiqué dans les commandes ADDMSGD ou CHGMSGD.

*JOB

Le CCSID associé à ce fichier message est remplacé par le CCSID du travail appelant cette commande.

ID-codé-jeu-caractères

Indiquez l'ID codé de jeu de caractères (CCSID) qui sera associé au fichier message. Les valeurs admises sont comprises entre 1 et 65535. Seuls sont acceptés les CCSID possibles pour le travail concerné. 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.

Remarque :Si vous modifiez le CCSID associé au fichier message, le CCSID associé aux descriptions de messages demeure inchangé. Si la valeur du CCSID du fichier message est de nouveau fixée à *MSGD, les CCSID initialement associés aux descriptions de messages sont rappelés.

La modification du CCSID associé à un fichier message contenant des descriptions de messages peut entraîner des résultats imprévisibles. Cela peut se produire lorsque le codage des caractères associés à ces descriptions de messages ne correspond pas au CCSID indiqué. Ne modifiez que le CCSID d'un fichier message contenant des descriptions de messages pour corriger le CCSID d'un fichier message. La modification est effectuée lorsque le CCSID d'un fichier message ne correspond pas au codage des descriptions de messages qu'il contient.

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

Exemples

CHGMSGF   MSGF(*ALL/*ALL)  CCSID(65534)

Cette commande change le CCSID et lui affecte la valeur 65534 pour l'ensemble des fichiers message du système.

Messages d'erreur

Messages *ESCAPE

CPF2401

Accès non autorisé à la bibliothèque &1.

CPF2407

fichier message &1 non trouvé dans &2.

CPF2411

Accès non autorisé au fichier message &1 dans &2.

CPF247E

Le CCSID &1 est incorrect.

CPF2483

fichier message en cours d'utilisation.

CPF9830

Allocation de la bibliothèque &1 impossible.