IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > Agent-based services
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2
UTF-8 encoded XML files
Unicode Transformation Format, 8-bit encoding form is designed for ease of use with existing ASCII-based systems and enables use of all the characters in the Unicode standard. When composing a local configuration XML file in a language that goes beyond the ASCII character set, such as letters with diacritics and double-byte character sets, use an editor that supports saving the file in UTF-8 encoding.
- ASCII characters use one byte and comprise the first 128 characters. You can write the XML file in any text editor. For non-ASCII characters, such as characters with diacritics and Kanji characters, an editor that can save the file as UTF-8 is required.
- Because UTF-8 is not displayed or edited on z/OS, the XML can be encoded in UTF-8 or using the agent's code page. The code page is set in the agent environment file with the environment variable LANG, such as LANG=en_US.IBM-1047. The environment file can be found in &hilev.&rte.RKANPARU, with member name KPCENV (where PC is the two-character product code). The LANG variable should match your terminal emulator if you are using the emulator to edit the file. The default code page for FTP is IBM-1047 if you are editing the file on Windows, Linux, or UNIX and then uploading the file as ASCII text to the host.
- See "Configuring hub and remote monitoring servers on z/OS" in Configure the Tivoli Enterprise Monitoring Server on z/OS.
- (EIF event destination configuration is not supported, nor are SNMPv3 informs.) Because UTF-8 is not displayed or edited on IBM i, the XML can be encoded in UTF-8 or the agent's code page. The code page is set in the agent environment file with the environment variable LANG, such as LANG=/QSYS.LIB/EN_US.LOCALE. It is best to set the LANG environment variable before starting qsh, the Qshell interpreter. Some utilities do not work correctly if the locale is not valid for the Coded Character Set ID and language ID of the job.
Parent topic:
Agent-based servicesRelated reference:
Private situation XML specification
Trap configuration XML specification
EIF event mapping XML specification
EIF event destination configuration XML specification
Configure the Tivoli Enterprise Monitoring Server on z/OS
i5/OS National language support (NLS) considerations