| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Message File (CHGMSGF) command changes the attributes of a specified message file or a list of message files.
Restrictions
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| MSGF | Message file | Qualified object name | Required, Key, Positional 1 |
| Qualifier 1: Message file | Generic name, name, *ALL | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB, *USRLIBL, *ALLUSR, *ALL | ||
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| CCSID | Coded character set ID | 1-65535, *SAME, *HEX, *MSGD, *JOB | Optional, Positional 2 |
| Top |
Specifies the message file or files whose attributes are being changed.
This is a required parameter.
Qualifier 1: Message file
Qualifier 2: Library
#CGULIB #DSULIB #SEULIB #COBLIB #RPGLIB #DFULIB #SDALIB
Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also searched:
QDSNX QRCLxxxxx QUSRDIRDB QUSRVI QGPL QSRVAGT QUSRIJS QUSRVxRxMx QGPL38 QSYS2 QUSRINFSKR QMGTC QSYS2xxxxx QUSRNOTES QMGTC2 QS36F QUSROND QMPGDATA QUSER38 QUSRPOSGS QMQMDATA QUSRADSM QUSRPOSSA QMQMPROC QUSRBRM QUSRPYMSVR QPFRDATA QUSRDIRCF QUSRRDARS QRCL QUSRDIRCL QUSRSYS
| Top |
Specifies text that describes the message file. The text specified replaces any previous text.
| Top |
Specifies the coded character set identifier (CCSID) that is to be associated with the message file. This will not result in any text conversions on the message descriptions that already exist in the message file. Any message descriptions subsequently added to this message file will be converted from the CCSID specified on the Add Message Description (ADDMSGD) command to the CCSID of the message file. The CCSID associated with the message file overrides the CCSID associated with the message description. To use the CCSID associated with the message description, change the CCSID associated with the message file to *MSGD.
Note: Changing the CCSID associated with the message file does not change the CCSID associated with the message descriptions. If the message file CCSID is ever changed back to *MSGD the original CCSIDs associated with the message descriptions are remembered.
Changing the CCSID associated with a message file that contains message descriptions may cause unpredictable results. This can occur when the character encoding of those message descriptions do not match the CCSID specified. Only change the CCSID of a message file that contains message descriptions to correct a message file CCSID. The change is made when a message file CCSID does not match the encoding of its message descriptions.
For more information on the message handler and its use of CCSIDs, see the i5/OS globalization topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
| Top |
CHGMSGF MSGF(*ALL/*ALL) CCSID(65534)
This command changes the CCSID to 65534 for all of the message files on the system.
| Top |
*ESCAPE Messages
| Top |