2.4.2 Details of the environment setting parameters for event/action control

(1) "WaitInfFileOutDir" = "name-of-directory-to-which-the-wait-information-file-is-output" (setting for the manager process)

Use this parameter to specify the name of the directory to which detailed information about event jobs and information about the receive status of events monitored by the start condition (wait information) is output. Specify a full path name. Note that you need to specify this directory only if you want to change the default directory.

Specify this parameter if you want to output the wait information to a folder that is not specified by default or to support a cluster configuration.

The wait information is output to the directory you specify in this parameter or to the following folder in the assumed directory.

• In Windows:

  sys\infodir

• In UNIX:

  sys/infodir

This parameter is valid only for a manager process in an ISAM configuration, which ensures compatibility, or for a manager process started from host-service management in a standard configuration.

Specifiable values

A character string of no more than 180 bytes

Default value

In Windows:

JP1/AJS3-Manager-installation-folder

During a new installation and setup of JP1/AJS3, one of the following values is set.

• In Windows Server 2012 or Windows Server 2008 in which the installation folder is in the default folder or a folder protected by the system:

  %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2

  The default for %ALLUSERSPROFILE% is system-drive\ProgramData.

  A folder protected by the system is the path to a folder in any of the following:

  - system-drive\Windows

  - system-drive\Program Files

  - system-drive\Program Files (x86) (for 64-bit Windows)

• In Windows Server 2012 or Windows Server 2008 in which an installation folder other than above is used:

  JP1/AJS3-Manager-installation-folder

• In Windows Server 2003:

  Blank

In UNIX:

/var/opt/jp1ajs2

During a new installation and setup of JP1/AJS3, the value is blank.

Recommended value

For a physical host:

• In Windows Server 2012 or Windows Server 2008 in which the installation folder is in the default folder or a folder protected by the system:

  %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2

  The default for %ALLUSERSPROFILE% is system-drive\ProgramData.

  A folder protected by the system is the path to a folder in any of the following:

  - system-drive\Windows

  - system-drive\Program Files

  - system-drive\Program Files (x86) (for 64-bit Windows)

• In Windows Server 2012 or Windows Server 2008 in which an installation folder other than above is used:

  JP1/AJS3-Manager-installation-folder

• In Windows Server 2003:

  Blank

• In UNIX:

  Blank

For a logical host:

directory-name-of-a-common-disk

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

For the name of the directory to which the wait information file is output, do not specify characters that the OS does not permit to be used for a directory name. For example, in Windows, double quotation marks (") and asterisks (*) cannot be used.

Also, do not specify a backslash (\) at the end of the directory name.

To Page Top

(2) "_AgentStartStopResolveMode" = "{optimized|normal}"

Use this parameter to specify whether to optimize the name resolution processing of an agent host.

This parameter is valid only for the compatible ISAM configuration.

Specifiable values

optimized

Specify this value to optimize the name resolution processing of an agent host name.

Only the name of the agent host that runs event jobs or jobnets with start conditions is resolved.

normal

Specify this value if you do not want to optimize name resolution processing of the agent host name.

Default value

normal

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(3) "FileWriteMode" = "{sync|nosync}" (setting for the manager process)

Use this parameter to specify whether to perform synchronous writing when the wait information file is updated.

Select the writing method appropriate for performance, reliability, and method of operation.

Specifiable values

sync

Synchronous writing is always performed when a file is updated. This writing mode improves reliability, but reduces performance.

Select this method when reliability is more important, as in a cluster environment.

nosync

Data is written to a disk in response to OS buffering. There is no synchronization with JP1/AJS3 processing. This mode provides better performance than sync, but a system failure will lead to inconsistent information, sometimes causing an event to disappear.

Default value

nosync

Recommended value

sync

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

Specify the same parameter value in the manager process (definition key JP1AJSMANAGER\SCHEDULER\EV\MANAGER) and the agent process (definition key JP1AOMAGENT). If you specify nosync for the manager process and sync for agent process, JP1/AJS3 slows down dramatically. This could happen if a jobnet using an event job or a jobnet with a start condition is registered for execution or is killed, or if an OR job preceded by many event jobs is executed. For the same reason, specify the same setting for the manager and the agents in the manager-agent system.

To Page Top

(4) "MacVarDQuotation" = "{Y|N}"

Use this parameter to specify whether to use the option for enabling double quotation marks (") in passing information.

Specifiable values

Y

The option is used.

N

The option is not used.

Default value

N

During a new installation and setup of JP1/AJS3, Y is set.

Recommended value

Y

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(5) "DNSEstablish" = "{Y|N}"

Use this parameter to specify whether to use an FQDN host name when DNS is used.

For details, see 6.3.5 Using fully qualified domain names (FQDN) when using event jobs during DNS operation in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.5 Using fully qualified domain names (FQDN) when using event jobs during DNS operation in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

Y

An FQDN host name is used when DNS is used.

N

An FQDN host name is not used when DNS is used. The manager sends a host name to agents instead of an FQDN host name.

Default value

N

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(6) "FixedHostnameForAgent" = "{Y|N}"

Use this parameter to specify whether lower case is always used for alphabetic characters in the manager host name for communication between event/action control processes.

For details, in Windows, see 6.3.16 Settings for ensuring that a fixed manager host name is used when event jobs are executed in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1. In UNIX, see 15.3.17 Settings for ensuring that a fixed manager host name is used when event jobs are executed in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1.

Specifiable values

Y

The host name obtained on the manager host is used for communication for event/action control after case conversion is performed so that all letters are lower case.

N

The host name obtained on the manager host is used for communication for event/action control without case conversion.

Default value

N

Recommended value

Y

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(7) "EvJobExecContinue" = "{Y|N}"

Use this parameter to specify whether to continue execution of an event job when you restart the JP1/AJS3 service on an execution.

For details, see 6.3.6 Resuming event jobs that stopped when the JP1/AJS3 service stopped in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.6 Resuming event jobs that stopped when the JP1/AJS3 service stopped in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

Y

Execution of the event job is continued.

N

Execution of the event job ends.

Default value

N

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

Set the option to continue execution of active event jobs for each manager of a physical host and a logical host.

To Page Top

(8) "BlockadeTimeoutInterval" = dword:time-for-monitoring-event-jobs-in-blocked-status

Use this parameter to specify the period of time until an event job in blocked status or a jobnet with start conditions is killed.

For details, see 6.3.10 Setting the period of time for monitoring event jobs in the blocked status in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.10 Setting the period of time for monitoring event jobs in the blocked status in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

A hexadecimal value (in hours) from 00000018 to 000002D0 (24 to 720 in decimal)

Default value

dword:000002D0 (720 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(9) "NotificationConstantRetry" = "{Y|N}"

Use this parameter to specify whether to use the regular or gradually increasing retry interval if the connection for communication from the manager host to the agent host fails because of a network error caused by a timeout.

For details, see 6.3.12 Settings for ensuring that the sending of unreported information is retried at regular intervals in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.13 Settings for ensuring that the sending of unreported information is retried at regular intervals in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

Y

If a network error caused by a timeout occurs, sending is retried at regular intervals.

N

If a network error caused by a timeout occurs, sending is retried at gradually increasing intervals.

Default value

N

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(10) "NotificationRetryInterval" = dword:retry-interval-for-sending-unreported-information-from-the-manager-host-to-the-agent-host

Use this parameter to specify the retry interval for sending unreported information from the manager host to the agent host.

For details, see 6.3.13 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.14 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

A hexadecimal value (in seconds) from 00000001 to 00015180 (1 to 86,400 in decimal)

Default value

dword:0000001E (30 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(11) "NotificationRetryCount" = dword:maximum-number-of-retries-for-sending-unreported-information-from-the-manager-host-to-the-agent-host

Use this parameter to specify the maximum number of retries for sending unreported information from the manager host to the agent host.

For details, see 6.3.13 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.14 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

A hexadecimal value (number of times) from 00000001 to 00015180 (1 to 86,400 in decimal)

Default value

dword:00000B40 (2,880 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(12) "ClientBindFlag" = dword:behavior-of-the-send-binding-method

Use this parameter to specify whether to match the send binding method used for communication when an event job is executed to the receive binding method.

For details, see 6.3.11 Setting the binding method applied to the outgoing communication used in the execution of event jobs in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.11 Setting the binding method applied to the outgoing communication used in the execution of event jobs in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

0

The setting for the send binding method used for communication when an event job is executed is canceled.

1

The send binding method used for communication when an event job is executed is matched to the receive binding method.

Default value

dword:00000000 (0 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(13) "ResolveAgentInfo"="{exec|host}"

Use this parameter to set the option for changing the agent host information that is to be used for name resolutions. For details, see 6.3.19 How to set the option for changing the agent information to be used for name resolution in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.19 How to set the option for changing the agent information to be used for name resolution in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

exec

When the IP address of an agent host is changed, the tasks on the manager host can be omitted.

host

When the IP address of an agent host is changed, tasks on the manager host are required.

Default value

host

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

Supplementary notes

• If you set this parameter, make sure that you set the same parameter value on both the manager and agent hosts. If different values are specified, the system assumes that host is specified on both hosts.

• If you set this parameter on the manager host, you must set this parameter in two locations: the host definition key [{JP1_DEFAULT|logical-host-name}\JP1AOMMANAGER] and the scheduler service definition key [{JP1_DEFAULT|logical-host-name}\JP1AJS2\SCHEDULER\EV\MANAGER]. If you specify different parameter values for these two locations, scheduler service processes output the KAVT0199-E message. This message is output for each scheduler service.

To Page Top

(14) "WaitInfFileOutDir" = "name-of-directory-to-which-the-wait-information-file-is-output" (setting for the agent process)

Use this parameter to specify the name of the directory to which information such as the event-generation status of the event job and receive status of events monitored by the start condition (wait information) is output. Specify a full path name. Note that you need to specify this directory only if you want to change the default directory.

Specify this parameter if you want to output the wait information to a folder that is not specified by default or to support a cluster configuration.

The wait information is output to the directory you specify here or to the following directory in the assumed directory.

• In Windows:

  sys\infoagt

• In UNIX:

  sys/infoagt

Specifiable values

A character string of no more than 180 bytes

Default value

In Windows:

JP1/AJS3 - Manager: JP1/AJS3-Manager-installation-folder

JP1/AJS3 - Agent: JP1/AJS3-Agent-installation-folder

During a new installation and setup of JP1/AJS3, one of the following values is set.

• In Windows Server 2012 or Windows Server 2008 in which the installation folder is in the default folder or a folder protected by the system:

  %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2

  The default for %ALLUSERSPROFILE% is system-drive\ProgramData.

  A folder protected by the system is the path to a folder in any of the following:

  - system-drive\Windows

  - system-drive\Program Files

  - system-drive\Program Files (x86) (for 64-bit Windows)

• In Windows Server 2012 or Windows Server 2008 in which an installation folder other than above is used:

  JP1/AJS3 - Manager: JP1/AJS3-Manager-installation-folder

  JP1/AJS3 - Agent: JP1/AJS3-Agent-installation-folder

• In Windows Server 2003:

  Blank

In UNIX:

/var/opt/jp1ajs2

During a new installation and setup of JP1/AJS3, it is set as blank.

Recommended value

For a physical host:

• In Windows Server 2012 or Windows Server 2008 in which the installation folder is in the default folder or a folder protected by the system:

  %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2

  The default for %ALLUSERSPROFILE% is system-drive\ProgramData.

  A folder protected by the system is the path to a folder in any of the following:

  - system-drive\Windows

  - system-drive\Program Files

  - system-drive\Program Files (x86) (for 64-bit Windows)

• In Windows Server 2012 or Windows Server 2008 in which an installation folder other than above is used:

  JP1/AJS3 - Manager: JP1/AJS3-Manager-installation-folder

  JP1/AJS3 - Agent: JP1/AJS3-Agent-installation-folder

• In Windows Server 2003:

  Blank

• In UNIX:

  Blank

For a logical host:

directory-name-of-a-shared-disk

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

For the name of the directory to which the wait information file is output, do not specify characters that the OS does not permit to be used for a directory name. For example, in Windows, double quotation marks (") and asterisks (*) cannot be used.

Also, do not specify a backslash (\) at the end of the directory name.

To Page Top

(15) "EvjobInfFile" = "name-of-directory-for-inheriting-event-or-job-information"

Use this parameter to specify the name of the directory in which the file inheriting the information received in the email reception monitoring jobs is saved. Specify a full path name. Note that you need to specify this directory only if you want to change the default directory.

Specify this parameter if you want to output the information to a folder that is not specified by default or to support a cluster configuration.

For details about the behavior of email reception monitoring jobs, see 2.1.2 Behavior when receiving email in the Job Management Partner 1/Automatic Job Management System 3 Linkage Guide.

Specifiable values

A character string of no more than 180 bytes

Default value

• For Windows Server 2012 or Windows Server 2008, if the installation folder is in the default folder or a folder protected by the system:

  %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\tmp\infodir

  The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

  A folder protected by the system is the path to a folder in any of the following:

  - system-drive\Windows

  - system-drive\Program Files

  - system-drive\Program Files (x86) (for 64-bit Windows)

• For Windows Server 2012 or Windows Server 2008 in which an installation folder other than the above is used:

  JP1/AJS3 - Manager: JP1/AJS3-Manager-installation-folder\tmp\infodir

  JP1/AJS3 - Agent: JP1/AJS3-Agent-installation-folder\tmp\infodir

• For Windows Server 2003:

  JP1/AJS3 - Manager: JP1/AJS3-Manager-installation-folder\tmp\infodir

  JP1/AJS3 - Agent: JP1/AJS3-Agent-installation-folder\tmp\infodir

• In UNIX:

  /var/opt/jp1ajs2/sys/infoagt/tmp/infodir

If it has been set as blank, the default value is assumed. It is set as blank during a new installation and setup of JP1/AJS3.

Recommended value

• Physical hosts

  Blank

• Logical hosts

  directory-name-of-a-shared-disk

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

JP1/AJS3 does not use the file saved in this directory. Also, because the file is not automatically deleted, delete it when it is no longer needed.

To Page Top

(16) "HowUseInfWhenHA" = "{Y|N}"

Use this parameter to specify whether information is to be passed if the JP1/AJS3 service in JP1/AJS3 - Manager or JP1/AJS3 - Agent stops unaccompanied by normal stop processing during failover or power-off processing. Specify whether information about the stoppage is to be passed to the failover destination or the restarted JP1/AJS3 - Manager or JP1/AJS3 - Agent.

Change this parameter if you want to discard an event occurring before the failover or JP1/AJS3 service stoppage when the JP1/AJS3 service stoppage unaccompanied by normal stop processing prevents the event from being reported to JP1/AJS3 - Manager.

Specifiable values

Y

The status when a stoppage without normal stop processing has occurred is passed to the failover destination or the restarted JP1/AJS3 - Manager or JP1/AJS3 - Agent. For example, after the switchover, an event that could not be reported to JP1/AJS3 - Manager before the failover occurred will be resent.

N

The status when a stoppage without normal stop processing has occurred is not passed to the failover destination or the restarted JP1/AJS3 - Manager or JP1/AJS3 - Agent. For example, an event that could not be reported to JP1/AJS3 - Manager before the failover occurred will be discarded.

Specify Y for normal operation.

Default value

Y

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(17) "InformationWhenShutDown" = "{K|B}"

Use this parameter to specify whether to report events that could not be reported to JP1/AJS3 - Manager when either the JP1/AJS3 - Manager host or JP1/AJS3 - Agent host was shut down (end with stop processing).

Change the parameter value to discard any such unreported events at the next restart.

Specifiable values

K

When JP1/AJS3 - Manager or JP1/AJS3 - Agent is started after the previous shutdown, the system reports the events that could not be reported to JP1/AJS3 - Manager before the shutdown. For example, when you start the terminated host, events generated before shutdown are reported to JP1/AJS3 - Manager. Note, however, that this applies only when JP1/AJS3 - Manager is started within 24 hours.

B

When JP1/AJS3 - Manager or JP1/AJS3 - Agent is started after the previous shutdown, the system does not report the events that could not be reported to JP1/AJS3 - Manager before the shutdown. That is any such events are discarded. Specify this value if you want information to be inherited only when a power failure occurs.

Specify K for normal operation.

Default value

K

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(18) "FilewatchinfContinue" = "{Y|N}"

Use this parameter to specify whether the information for a file-monitoring job existing at the last shutdown is inherited when JP1/AJS3 - Manager or JP1/AJS3 - Agent is shut down (end with stop processing) during execution of the file-monitoring job.

Change the parameter value in the following case: if the shut-down file-monitoring job is defined in the start conditions and is to be restarted, you do not want the monitoring status to be inherited.

Specifiable values

Y

The JP1/AJS3 - Manager or JP1/AJS3 - Agent started after the shutdown inherits the pre-shutdown monitoring status of a file-monitoring job.

N

The JP1/AJS3 - Manager or JP1/AJS3 - Agent started after shutdown doe not inherit the pre-shutdown monitoring status of a file-monitoring job.

Default value

N

During a new installation and setup of JP1/AJS3, Y is set.

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(19) "FileWriteMode" = "{sync|nosync}" (setting for agent processes)

Use this parameter to specify whether to permit synchronous writing when the event or job information and wait information file are updated.

Select the writing method appropriate for performance, reliability, and method of operation.

Specifiable values

sync

Synchronous writing is always performed when a file is updated. This writing mode improves reliability, but reduces the performance.

Select this method when reliability is more important, as in a cluster environment.

nosync

Data is written to a disk in response to OS buffering. There is no synchronization with the JP1/AJS3 processing. This mode provides better performance than sync, but a system failure will lead to inconsistent information, sometimes causing an event to disappear.

Default value

nosync

Recommended value

sync

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

Specify the same parameter value in the manager process (definition key JP1AJS2\SCHEDULER\EV\MANAGER) and the agent process (definition key JP1AOMAGENT). If you specify nosync for the manager process and sync for the agent process, JP1/AJS3 operation slows down dramatically. This might happen if a jobnet using an event job or a jobnet with a start condition is registered for execution or is killed, or if an OR job preceded by many event jobs is executed. For the same reason, specify the same setting for the manager and the agents in the manager-agent system.

To Page Top

(20) "EVProcessHA" = "{Y|N}"

When event/action control detail processes are terminated with a signal, specify whether to operate at a reduced level without terminating the event/action control agent process, or whether to terminate the processing after stopping all detail processes.

Specifiable values

Y

All the detail processes are stopped, after which the event/action control agent process terminates.

N

Operation continues at a reduced level. The event/action control agent process is not terminated. If some of the detail processes are terminated for a reason such as a signal, you will be able to use only the remaining event jobs that are not affected by those detail processes that have been terminated.

Default value

N

During a new installation and setup of JP1/AJS3, Y is set.

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary notes

• If you specify Y for the parameter value and then set restarting of the abnormally terminated JP1/AJS3 processes, the agent and detail processes are restarted when the JP1/AJS3 process is restarted. For details about how to restart the abnormally terminated JP1/AJS3 processes, see 7.3.1 Restarting an abnormally terminated JP1/AJS3 process in the Job Management Partner 1/Automatic Job Management System 3 Administration Guide.

• In UNIX, if you specify N for the parameter value and disable the detail process termination option, registering for execution a job related to an abnormally terminated detail process^# causes the job to terminate abnormally.

  #: For example, run the file-monitoring job when the jpocwtflMain process has terminated abnormally.

To Page Top

(21) "EventSequential" = "{Y|N}"

Use this parameter to specify whether to use the event order option.

Specifiable values

Y

Specify this value to use the event order option.

N

Specify this value if you do not use the event order option.

Default value

N

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top

(22) "RetryAgtStartNotification" = "{Y|N}"

Use this parameter to specify whether to resend the startup notification if sending the startup notification has failed.

Specifiable values

Y

The startup notification is resent.

N

The startup notification is not resent.

Default value

N

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary note

For details about the operating environment in which Y must be specified, see 6.3.7 Retrying startup notification of the event/action control agent in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) , or 15.3.7 Retrying startup notification of the event/action control agent in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

To Page Top

(23) "ClientConnectTimeout" = dword:connection-timeout-for-communication-between-the-event/action-control-manager-and-the-event/action-control-agent

Use this parameter to specify how long to wait for a connection if a connection request for a TCP/IP socket does not immediately result in either success or failure.

If the connection request is not completed within the specified time, the request is canceled as a timeout.

For details about setting this environment setting parameter in the manager environment, see 2.6.2(1) ClientConnectTimeout.

Specifiable values

A hexadecimal value (in milliseconds) from 000003E8 to 000927C0 (1,000 to 600,000 in decimal)

Default value

• In Windows:

  dword:00007530 (30,000 in decimal)

• In UNIX:

  dword:000003E8 (1,000 in decimal)

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service starts

Cautionary notes

• If the TCP/IP connection timeout value set in the OS is less than the value set in this environment setting parameter, the timeout value set in the OS overrides the value of the environment setting parameter.

• If this environment setting parameter is omitted, the default value is used.

• If a value that cannot be specified for event/action control is specified in this parameter, the default value is used.

To Page Top

(24) "NotificationRetryInterval" = dword:retry-interval-for-sending-unreported-information-from-the-agent-host-to-the-manager-host

Use this parameter to specify the retry interval for sending unreported information from the agent host to the manager host.

For details, see 6.3.13 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.14 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

A hexadecimal value (in seconds) from 00000001 to 00015180 (1 to 86,400 in decimal)

Default value

dword:0000000A (10 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(25) "NotificationRetryCount" = dword:maximum-number-of-retries-for-sending-unreported-information-from-the-agent-host-to-the-manager-host

Use this parameter to specify the maximum number of retries for sending unreported information from the agent host to the manager host.

For details, see 6.3.13 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 15.3.14 Changing the send retry interval and the number of retries for sending unreported information in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).

Specifiable values

A hexadecimal value (number of times) from 00000001 to 00015180 (1 to 86,400 in decimal)

Default value

dword:000021C0 (8,640 in decimal)

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service starts

To Page Top

(26) "EventServerName" = "event-server-name"

When you execute a log file monitoring job on a host on which an event server that has an FQDN event server name runs, use this parameter to specify the FQDN event server name specified in the JP1/Base event server index file (index).

Specifiable values

A character string of no more than 255 bytes

Default value

Specify the short name of the host on which JP1/AJS3 is running.

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

Cautionary notes

• The event server name specified in this option must be the name of an event server that is running on a host on which JP1/AJS3 is running.

• Because the event server name specified in this option is case sensitive, use the uppercase and lowercase characters exactly the same way as the FQDN event server name specified in the JP1/Base event server index file (index).

To Page Top

(27) "GetFQDNForShortNameOnly" = "{Y|N}"

Use this parameter to specify whether to acquire the local host name used for interprocess communication for event/action control from DNS. To specify Y for this environment setting parameter, you need to specify Y for the DNSEstablish environment setting parameter.

Specifiable values

Y

An FQDN local host name acquired from DNS is used for interprocess communication for event/action control even if a short local host name is specified for jp1hosts or jp1hosts2.

N

The short local host name specified for jp1hosts or jp1hosts2 is used for interprocess communication for event/action control.

If a short local host name is not specified for jp1hosts or jp1hosts2, an FQDN local host name acquired from DNS is used.

Default value

N

Recommended value

Set the value appropriate for the operating environment.

When the setting takes effect

The next time the JP1/AJS3 service is started

Supplementary note

To use the FQDN local host name acquired from DNS for all interprocess communication for event/action control, specify Y for this environment setting parameter for all the following hosts:

• Manager host on which the DNSEstablish environment setting parameter is set to Y

• Agent host that executes event jobs

To Page Top

(28) "RecvTimeout" = "{Y|N}"

In interprocess communication for event/action control, if data is not delivered to the receiver for some reason, use this parameter to specify whether to terminate the attempt to receive the data so that the system can proceed to other processing.

Specifiable values

Y

If data is not received within the specified period of time, the data receive processing times out.

N

The system waits for data to arrive.

Default value

Y

Recommended value

Default value

When the setting takes effect

The next time the JP1/AJS3 service is started

To Page Top