6.3.15 Settings for ensuring that a fixed manager host name is used when event jobs are executed

When an event job is executed, the event/action control manager communicates with the agent on which the job is executed. In the communication, the manager sends its own name to the agent so that the agent can distinguish the manager from other agents. The manager host name is acquired when the JP1/AJS3 service on the manager is started.

Normally, unless the host name is changed intentionally, the acquired host name never changes when the JP1/AJS3 service on the manager is restarted. However, case for alphabetic characters (upper or lower case) used in the acquired host name might change for some reason when the JP1/AJS3 service is restarted. For example, a change in the case might occur if the OS settings related to DNS name resolution are changed.

Because event job execution agents treat manager host names as being case-sensitive, a change in the case, which is equivalent to a change in the manager host name, might cause the following problems:

• If the JP1/AJS3 service on the manager is restarted while a jobnet with start conditions is being executed, a duplication of monitored events might be detected after the restart.

• When the option for continuing execution of active event jobs is enabled, if the JP1/AJS3 service is restarted in hot-start mode on the manager while an event job is being executed, multiple occurrences of the same event are detected.

  For details about the option for continuing the execution of active event jobs, see 6.3.6 Resuming event jobs that stopped when the JP1/AJS3 service stopped.

To avoid these problems, enable the option for using a fixed manager host name (the FixedHostnameForAgent environment setting parameter). If this option is enabled, the event/action control manager always sends the host name in all lower case.

Cautionary note:

Be careful when you change the settings of the option for using a fixed manager host name while executing jobnets with start conditions or executing event jobs with the option for continuing the execution of active event jobs enabled. If you make a change, the case of the alphabetic characters of the manager host name might change.

Making such a change might cause inconsistencies in the management status of jobnets with start conditions or event jobs that have already been executed. For example, multiple jobnets might be incorrectly started for one event.

To avoid these types of problems, make sure you use the following procedure when enabling the option for using a fixed manager host name or changing the option settings:

1. Stop the JP1/AJS service on the agent host on which jobnets with start conditions or event jobs are being executed.

2. On the agent host in step 1, execute the jpoagoec command to delete the manager host name for which the option for using a fixed manager host name is to be enabled.

   For details about the jpoagoec command, see jpoagoec in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

3. On the manager host, enable the option for using a fixed manager host name.

   For details about how to enable the option, see (1) below.

4. Cold-start the JP1/AJS service on the agent host in step 2.

The following describes the procedure for enabling the option.

Organization of this subsection

• (1) Definition procedure

• (2) Environment setting parameter