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

2.2.4 Setting up the environment for the mail system linkage

This subsection describes the environment setup procedure in JP1/AJS3 and items to be specified for linking a mail system on a Windows host.

Organization of this subsection

(1) Procedure for environment setup

(2) Registering the mail system linkage function

(3) Setting environment setting parameters for the mail system linkage function

(4) Environment setting parameters used by the mail system linkage function

(1) Procedure for environment setup

To set up the environment:

Register the mail system linkage function in Windows.
For details on how to register the mail system linkage function, see (2) Registering the mail system linkage function.

Set the environment setting parameters required by the mail system linkage function.
For details on setting these parameters, see (3) Setting environment setting parameters for the mail system linkage function.
For details on the environment setting parameters that the mail system linkage function uses, see (4) Environment setting parameters used by the mail system linkage function.

Set up Windows automatic logon.
If you are using desktop-based mail system linkage, set up Windows automatic logon as required. The user account specified in the Windows automatic logon settings will be used to execute the JP1/AJS3 mail monitoring process. At this stage, specify the user account that you used to create the profile. If you specify any other user account, the system cannot reference the profile when starting the JP1/AJS3 mail monitoring process, and cannot connect to the mail server. This prevents the JP1/AJS3 mail monitoring process from starting.
For details on how to set up Windows automatic logon, see the documentation provided by Microsoft.

Restart the JP1/AJS3 service and the JP1/AJS3 mail monitoring process or JP1/AJS3 Mail service.
After restarting the JP1/AJS3 service, restart the JP1/AJS3 mail monitoring process if implementing mail system linkage from the desktop, and the JP1/AJS3 Mail service if implementing mail system linkage with a service. The environment is set up with the defined information, and you can now use the mail system linkage function.

(2) Registering the mail system linkage function

The following describes how to register the mail system linkage function in Windows.
When using the mail system linkage function from the desktop
Create a shortcut to the file JP1/AJS3-installation-folder\bin\jpomldsk.exe, and change the name of the shortcut file to Mail monitoring process. Then, copy the renamed shortcut file to the following two locations:

The All Users startup group

From the Windows Start menu, choose All Programs or Programs, right-click Startup, and then choose Open All Users.

Copy the shortcut file to the displayed folder.
 
The JP1_Automatic Job Management System 3 - Manager or JP1_Automatic Job Management System 3 - Agent folder in the Start menu for All Users

Right-click the Windows Start menu, and choose Open All Users.

Copy the shortcut file to the JP1_Automatic Job Management System 3 - Manager folder or JP1_Automatic Job Management System 3 - Agent in the Programs folder.
When using the mail system linkage function from a service
Execute the following command to register the JP1/AJS3 Mail service:
 
sc create JP1_AJS2_MAIL binPath= "\"JP1/AJS3-installation-folder\bin\jpomlsrv.exe\"" type= own start= demand error= normal obj= LocalSystem DisplayName= "JP1/AJS3 Mail"
 
For example, if JP1/AJS3 is installed in C:\Program Files\HITACHI\JP1AJS2, execute the command as follows:

sc create JP1_AJS2_MAIL binPath= "\"C:\Program Files\HITACHI\JP1AJS2\bin\jpomlsrv.exe\"" type= own start= demand error= normal obj= LocalSystem DisplayName= "JP1/AJS3 Mail"

Because the JP1/AJS3 Mail service must be run from the account that you used to log on to Windows when you created the profile used by the mail system linkage function), ensure that this user account is set in the properties window of the JP1/AJS3 Mail service.
The sc command is provided by Microsoft. For details on this command, see the Microsoft documentation.
Also, when you execute the sc command, specify the settings (other than the JP1/AJS3 installation folder name) as shown in the above example. If you change the settings other than the JP1/AJS3 installation folder name, you might not be able to use the mail system linkage function.

(3) Setting environment setting parameters for the mail system linkage function

Execute the following command:
 
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]
["environment-setting-parameter-7"=definition-content-7]
["environment-setting-parameter-8"=definition-content-8]
["environment-setting-parameter-9"=definition-content-9]
 
For details on the definition content of the environment setting parameters required to set up the environment for an email reception monitoring job, see (4) Environment setting parameters used by the mail system linkage function.

(4) Environment setting parameters used by the mail system linkage function

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 intended for maintenance purposes. Do not change these values.

Table 2-2 Environment setting parameters used for mail system linkage

No. Definition key Environment setting parameter Defined information

1 [JP1_DEFAULT\JP1AOMAGENT\mail_link] "ExecMode"= Whether to use the mail system linkage function

2 "ProfileName1"= Name of the profile used to log in to the mail service

3 "ProfileName2"=

4 "ProfileName3"=

5 "ProfileName4"=

6 "WINMAILCLIENT"= Specify an Outlook client compatible with the linked mail system.

7 "AfterReceiveMail"= Handling applied to received messages that match the monitoring conditions

8 "NextAddress"= The type of information set as the MLRCVADDRESS passing information of the email reception monitoring job

9 "ReceiveIntervalC"= Interval at which email reception is monitored

The following describes details of the environment setting parameter definitions:

"ExecMode"="{S|D|N}"

Specify whether to enable or disable the mail system linkage function. The default is N.

S

Use the mail system linkage function with a service.

D

Use the mail system linkage function from the desktop.

N

Do not use the mail system linkage function.

"ProfileName1"="profile-name"

Specify the name of the profile used to log in to the mail service. Specify no more than 256 characters for the profile name. You can specify a maximum of four profiles using the parameters ProfileName1 to ProfileName4. When using the mail system linkage function with a service, specify a profile created by the local user.

Specify a profile name that is different from the environment setting parameters ProfileName2 to 4. If profile names are not unique, you might not be able to use the mail system linkage function.

"ProfileName2"="profile-name"

Specify a profile name that is different from the environment setting parameters ProfileName1, and 3 to 4. If profile names are not unique, you might not be able to use the mail system linkage function.

"ProfileName3"="profile-name"

Specify a profile name that is different from the environment setting parameters ProfileName1 to 2, and 4. If profile names are not unique, you might not be able to use the mail system linkage function.

"ProfileName4"="profile-name"

Specify a profile name that is different from the environment setting parameters ProfileName1 to 3. If profile names are not unique, you might not be able to use the mail system linkage function.

"WINMAILCLIENT"=dword:{0|1}

When using the mail system linkage function from the desktop, specify an Outlook client compatible with the linked mail system. The default is 0.

0

Select this option when using Outlook 2000.

1

Select this option when using Outlook 2002 or later.

For details on the versions of Outlook that each mail system supports, see Table 2-1 in 2.2.1(1) Functions and programs required for linking mail systems.

Windows Server 2008 only supports Outlook 2003 or later. Specify 1 when using Windows Server 2008.

The version of Outlook has no effect on the service-based mail system linkage function. For this reason, you do not need to set this parameter when using the mail system linkage function with a service.

"AfterReceiveMail"="{O|D}"

Select how to handle received mail that matches the monitoring conditions. The default is O.

O

Mail that matches the monitoring conditions is marked as read.

D

Mail that matches the monitoring conditions is deleted.

"NextAddress"="{Address|Nickname}"

Select the type of information to be set in the passing information MLRCVADDRESS of the email reception monitoring job. The default is Address. MLRCVADDRESS is information representing the sender specified in the email reception monitoring job. This setting affects all email reception monitoring jobs that run on the host where the setting has been made. Select one of the following:

Address

Sets the mail address as passing information.

Nickname

Sets the display name (nickname) as passing information.

"ReceiveIntervalC"=dword:time-interval

Specify the time interval for checking whether email has been received, as a hexadecimal value. Specify a value from 1 to 5A0 (in minutes). The default is A (10 minutes).

No.	Definition key	Environment setting parameter	Defined information
1	[JP1_DEFAULT\JP1AOMAGENT\mail_link]	"ExecMode"=	Whether to use the mail system linkage function
2	"ProfileName1"=	Name of the profile used to log in to the mail service
3	"ProfileName2"=
4	"ProfileName3"=
5	"ProfileName4"=
6	"WINMAILCLIENT"=	Specify an Outlook client compatible with the linked mail system.
7	"AfterReceiveMail"=	Handling applied to received messages that match the monitoring conditions
8	"NextAddress"=	The type of information set as the MLRCVADDRESS passing information of the email reception monitoring job
9	"ReceiveIntervalC"=	Interval at which email reception is monitored

[Contents][Back][Next]

[Trademarks]