4.0 Guidelines for Working with Zman

Follow these guidelines as you work with the zman command line utility of Micro Focus ZENworks:

  • If an XML file that is exported by using the zman commands such as bundle-create or policy-create contains diacritic or extended ASCII characters such as ñ,ë, and Ä, you must open the file in an editor using the UTF-8 encoding. If you make any changes to the file, you must save it the UTF-8 format.

  • If you want to redirect the output of a command containing extended ASCII characters to a file on Windows, you must not use the command line redirection operator (>), because the code page of an MS-DOS prompt is different from the code page used to write to files on most locales.

    For example, in case of Western European languages like English, French, German, and Spanish, the code page of the DOS prompt is cp437 or cp850, but the rest of the Windows operating system uses cp1252.

    To redirect the output to a file and correctly retain the extended ASCII characters, use the ‑R|--Redirect global option.

  • While connecting to Linux Servers from a Windows machine by using clients like PuTTY, set the character set used for translation to UTF-8. This ensures proper translation of characters other than standard ASCII characters.

    To set the character set for translation to UTF-8 in PuTTY:

    1. Open the PuTTY client.

    2. In the PuTTY Configuration window, click Windows > Translation.

    3. In the Received Data Assumed to be in Which Character Set drop-down list, select UTF-8.

    NOTE:You do not need to do this if the input to the command or its output contains only the a-z or A-Z characters.

  • By default, zman uses the default locale of the server. You can have zman use a specific language:

    • On Windows, specify the appropriate user language and file encoding as a value for the JVM_STARTUP_OPTIONS property in ZENworks_Installation_directory\Novell\ZENworks\conf\zman \properties\zman-config.properties.

      For example, to run zman in English, set the value of JVM_STARTUP_OPTIONS to -Duser.language=en -Dfile.encoding=cp850. After editing the file, change the code page of the command prompt to cp850 by using the chcp 850 command.

    • On Linux, edit /opt/novell/zenworks/bin/zman to add ‑Duser.language=<language> after /opt/novell/zenworks/lib/java/bin/java.

      For example, to run zman in English, change the zman script file as follows:

       /opt/novell/zenworks/lib/java/bin/java -Duser.language=en -Djava.library.path="${LD_LIB_PATH}" .....