IBM Support

CWWKG0014E Error: An invalid XML character (Unicode: 0x4c) was found in the prolog of the document.

Question & Answer


Question

I re-installed the beta version on our development box and am getting this error :

CWWKG0014E: The configuration parser detected an XML syntax error while parsing the root of the configuration and the referenced configuration documents. Error: An invalid XML character (Unicode: 0x4c) was found in the prolog of the document. File: file:/XXX/zosconnect/v3r0/var/zosconnect/servers/XXX/server.xml Line: 1 Column: 1

Answer

It seems like the server.xml file has been encoded as EBCDIC (`0x4c` is '<' in EBCDIC) and the file would start with <?xml.

z/OS Connect EE expects server.xml to be in Unicode/UTF8 so when it sees the first character, '<', encoded as 0x4c (EBCDIC) in the file it actually reads 'L' (Unicode/UTF8) which is an invalid character with which to start an XML file.

Something that commonly causes this is problem is using FTP in ASCII or AUTO mode to transfer files to and from zFS. This performs an ASCII to host codepage (EBCDIC) conversion as it transfers the files. As such it is important to always use BINARY mode when using FTP to transfer z/OS Connect EE server files.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNPJM","label":"IBM z\/OS Connect"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

zCEE

Document Information

Modified date:
14 February 2023

UID

dwa1445775