6.1.6 Locale set for operation target devices during plug-in execution
The locale setting that applies to a device on which an operation is performed by a plug-in depends on the operating system. Below are descriptions of the locale settings applied when plug-ins are executed in each operating system.
- In Windows
When JP1/AO executes a script or command on an operation target device, make sure that the locale and character set of the operation target device match those of the JP1/AO server. The locale and character set are determined by the settings in the Windows Control Panel that govern date and time formats, user-level display languages, system-level display languages, and system locale settings.
For details about the character set JP1/AO uses for communication, see 6.1.7 Character set used for communication by JP1/AO during plug-in execution.
- In UNIX
-
The locale setting applied during plug-in execution depends on the Character Set Auto Judgment setting on the Remote Command tab of the Create Custom Plug-in or Edit Custom Plug-in dialog box.
If the Enabled check box is not selected in the Character Set Auto Judgment area
Scripts are executed with the LC_ALL=C locale. Make sure that commands and command parameters consist only of ASCII characters. If a command parameter, standard output, or standard error output contains non-ASCII characters, the characters might be garbled and prevent the command from executing normally.
If the Enabled check box is selected in the Character Set Auto Judgment area
JP1/AO references the default locale of the connecting user and executes the script accordingly.
When executing a script or command on an operation target device, JP1/AO sets the environment variable LC_ALL and LANG to the default locale of the connecting user. It does not change the settings of LC_XXXXX environment variables other than LC_ALL.
The locale assigned when executing a script or command is referenced in the order of priority as shown in the following table.
Table 6‒4: Priority of locale settings referenced during plug-in execution Priority
Environment variable
1
Value of LC_ALL
2
Value of LC_CTYPE
3
Value of LANG
If the script or command is encoded in a different character set from the one assigned at plug-in execution, the characters might be garbled and the script or command might not function properly. Note that the character set you can use in commands and command parameters depends on the operating system. For details, see 6.1.7 Character set used for communication by JP1/AO during plug-in execution.