Job Management Partner 1/Automatic Job Management System 3 Linkage Guide

2.3.2 Setting up the environment for an email reception monitoring job

This subsection describes the environment setup procedure in JP1/AJS3 and items to be specified for using an email reception monitoring job on a UNIX host. Note that the mail system linkage function in JP1/AJS3 is disabled when it is installed. To use an email reception monitoring job, be sure to perform the steps below.

Organization of this subsection

(1) Procedure for setting up the environment

(2) Procedure for setting up event/action control

(3) Environment setting parameters used for email reception monitoring jobs

(1) Procedure for setting up the environment

To set up the environment:

Use the environment setting parameters for event/action control to set up the environment for an email reception monitoring job.
For details on how to do so, see (2) Procedure for setting up event/action control.

Set up the mail delivery function.
For further details regarding setting up the mail delivery function, see 2.3.3 Setting up the mail delivery function.

Set up a mail filter application (code conversion tool), as required.
If you want to monitor the reception of mail containing multibyte characters or MIME or other encoded mail, you must prepare an appropriate mail filter application and set it up to use with the mail system linkage function. For details on a mail filter application, see 2.4 Mail filtering application specifications.

After executing the command, restart JP1/AJS3.
The mail system linkage function is activated with the settings you defined.

(2) Procedure for setting up event/action control

The definition file for the event and action execution environment (EVAction.conf) contains the information necessary for setting up the environment for email reception monitoring jobs.

To change the definition of the environment setting parameters:
Execute the following command to set the environment setting parameters that define the environment for email reception monitoring jobs.
 
jajs_config -k definition-key-name "environment-setting-parameter-1"=definition-content-1
["environment-setting-parameter-2"=definition-content-2]
["environment-setting-parameter-3"=definition-content-3]
["environment-setting-parameter-4"=definition-content-4]
["environment-setting-parameter-5"=definition-content-5]
["environment-setting-parameter-6"=definition-content-6]
 
For details on the environment setting parameters required to define the environment for email reception monitoring jobs, see (3) Environment setting parameters used for email reception monitoring jobs.
In the default environment, email reception monitoring jobs are disabled. To enable the use of email reception monitoring jobs, specify U for the ExecMode environment setting parameter.

(3) Environment setting parameters used for email reception monitoring jobs

The table below lists the event/action control environment setting parameters associated with email reception monitoring jobs. For details on the environment setting parameters that relate to event/action control in general, see 2.4 Setting up the event/action control environment in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 2.

Parameters not described in the manual are for maintenance. Do not change these values.

Table 2-4 Environment setting parameters related to an email reception monitoring job (EVAction.conf)

Definition key Environment setting parameter Defined information

[{JP1_DEFAULT|logical-host-name}\JP1AOMAGENT\mail_link]^# "ReceiveIntervalC"= Interval at which mail reception is monitored

"UserName"= User name

"MailFileDir"= Mail file directory name

"MailFileName"= Mail storage file name

"NotMatchMailDir"= Directory in which the file for storing unmatched email is stored

"ExecMode"= Whether to use the mail system linkage function

#

For {JP1_DEFAULT|logical-host-name}, specify JP1_DEFAULT or a logical host name.

The following describes details of the environment setting parameter definitions:

"ReceiveIntervalC"=dword:time-interval

Specify the interval at which email reception is monitored. You can specify a value between 1 and 1,440 (minutes). If you do not specify a value, an interval of 10 minutes is assumed.

"UserName"="user-name"

Specify the name of a user for which you want to monitor the reception of email. 1 to 256 bytes of characters can be specified.

"MailFileDir"="mail-file-directory-name"

Specify the name of the mail file directory storing email for the user specified with the UserName environment setting parameter. 1 to 180 bytes of characters can be specified. However, specify a different directory from the directory specified for the NotMatchMailDir environment setting parameter. In JP1/AJS3, email is received using the mail delivery function. Therefore, always specify /var/opt/jp1ajs2/tmp/mailbox. For further details regarding setting up the mail delivery function, see 2.3.3 Setting up the mail delivery function.

"MailFileName"="mail-storage-file-name"

Specify the full path name of the file storing the email that satisfies the monitoring condition. 1 to 255 bytes of characters can be specified. Specify a file different from the mail file with the user name specified for the UserName environment setting parameter for storage in the directory specified by using the MailFileDir environment setting parameter.

"NotMatchMailDir"="directory-in-which-file-for-storing-unmatched-email-is-stored"

Specify the full path name of the directory that contains the file storing email that does not satisfy the monitoring condition. 1 to 180 bytes of characters can be specified. However, specify a different directory from the directory specified for the MailFileDir environment setting parameter.

If you do not specify a directory name, the system deletes any email that does not satisfy the monitoring condition.

"ExecMode"="{U|N}"

Specify whether to enable or disable the mail linkage function.

U

Use the mail system linkage function.

N

Do not use the mail system linkage function.

Definition key	Environment setting parameter	Defined information
[{JP1_DEFAULT\|logical-host-name}\JP1AOMAGENT\mail_link]^#	"ReceiveIntervalC"=	Interval at which mail reception is monitored
"UserName"=	User name
"MailFileDir"=	Mail file directory name
"MailFileName"=	Mail storage file name
"NotMatchMailDir"=	Directory in which the file for storing unmatched email is stored
"ExecMode"=	Whether to use the mail system linkage function

[Contents][Back][Next]

[Trademarks]