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 × 10³⁰⁸

    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.

To Page Top