1.4 Notes common to service templates
The following cautionary notes apply to the service templates provided by JP1/AO:
-
The locale setting applied at plug-in execution differs depending on the operating system on the operation-target device.
-
For Windows
The locale depends on the configuration of the operating system.
-
For UNIX
The following services are executed with the locale LANG=C :Characters might become garbled when these services are used with multi-byte characters.
Table 1‒8: List of services executed with LANG=C Category
Service
JP1_Operations/Configuration
Add monitoring setting
Delete monitoring setting
Add JP1/Base monitoring settings
Adding of a node to be monitored by JP1/Cm2
Deletion of nodes monitored by JP1/Cm2
JP1_Operations/Management
Add operational user
Change operational user
Delete operational user
JP1/AJS root jobnet migration
Register JP1/AJS jobnet for execution
Get JP1 events
Get list of JP1/PFM monitoring targets
Get list of JP1/PFM alarm information
Get list of JP1/PFM process monitoring settings
Obtain JP1/CM2 monitored node list
Get list of JP1 users
Get JP1 user mapping definition
Batch change of operation users
JP1_Operations/Reports
Get JP1/PFM report
JP1_Operations/Troubleshoot
Get JP1/AJS and JP1/Base logs
Get JP1/IM and JP1/Base logs
Changing of the JP1 event action status
OS_Operations/Management
Get list of OS users
Get lists of OS users by batch
All other services use the default locale of the connected user.
-
-
When you execute a plug-in, certain commands must already be installed in the operating system of the operation-target device. For details, see the release notes.
-
If the operation target device is running Linux, files are transferred from the device to the JP1/AO server in binary mode. For this reason, when a text file is transferred, the linefeed code is not converted to a code that is appropriate for Windows. Conversely, when you transfer a file from the JP1/AO server to the operation target device, make sure that the linefeed code in the file conforms to the specification of the OS of the device.
-
If the operation target device is running Windows and you specify an output file in a property of the service template, do not use the following reserved keywords as file names:
CON, PRN, AUX, CLOCK$, NUL, COM0, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT0, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
-
(Local) in the property name indicates that the file or folder is located on the JP1/AO server. (Remote) means that the file or folder is on the operation target device.
-
If a service that uses an Email Notification Plug-in or User-Response Wait Plug-in to send email uses machine-dependent characters or characters that are incompatible with the character set assigned to the JP1/AO server and the operation-target device in the subject line or body of an email, characters are replaced with question marks (?) or other characters. In this scenario, either change the characters in the email, or change the encoding of the email.
- The following characters might not be converted correctly:
-
To connect to an operation-target device, you need to define a Connection Destination. If the operation-target device is running Windows, specify WMI as the protocol. If the device is running UNIX, specify SSH.
-
If you execute multiple services concurrently on a given Hyper-V server, the command executed by JP1/AO might result in an error, causing the task to terminate abnormally. In this case, CommandExitCode:False is output to the task log and the plug-in returns code 27.
-
When the operation-target device is running UNIX, the service templates provided by JP1/AO are executed with the privileges of the root user. Make sure that you set the relevant authentication information in the definition of the connection destination.
-
A content plug-in might return a value outside the 0 to 63 range. For details about the meaning of return values outside this range, see Return values of content plug-ins in the Job Management Partner 1/Automatic Operation Service Template Developer's Guide.
-
Do not use the following multi-byte symbols in the property of a service template:
-
The values you can specify in the properties of a service template depend on the data type. The range of values you can specify for each data type is shown below.
If the range of values you can specify for a property has been limited in your system, specify a value within that range.
-
For string data
1,024 characters
-
For integer data
-2147483648 to 2147483647
-
For double data
A numerical value from approximately ±4.9 × 10-324 to ±1.7 × 10308
Note that you cannot enter this value in the form of an exponent. We recommend that the value you specify has no more than 15 significant digits.
-
For password data
1,024 characters
-
-
When you use a user-defined character or surrogate pair character in an input value or input file of a property, characters might become garbled or might not be processed as the intended character.