Job Management Partner 1/Automatic Job Management System 3 Linkage Guide
- Organization of this subsection
- (1) For Windows
- (2) For UNIX
(1) For Windows
The following figure shows the behaviour of a Windows system at email reception.
Figure 2-3 Behavior at email reception (for Windows)
The details about the places for storing data in the above figure are as follows:
- Mail server
This stores received email.
- Inbox
This stores received email. Outlook manages this folder.
- Email text
If you specify a message text file name in the Detailed Definition - [Receive Mail] - [Option after receive] dialog box, the text of an email that satisfies the monitoring condition is stored in this file. If there is a file with the same name in the folder, it will be overwritten.
- Attached file
If you specify a folder for saving attached files in the Detailed Definition - [Receive Mail] - [Option after receive] dialog box, the files attached to an email that satisfies the monitoring condition are stored in this folder. The attached files are saved in the specified folder without their names being changed. If there is a file with the same name in the folder, it will be overwritten.
- List file for attached files
If you specify a list file name in the Detailed Definition - [Receive Mail] - [Option after receive] dialog box, a list of the files attached to an email that satisfies the monitoring condition is stored in this file. If there is a file with the same name in the folder, it will be overwritten. For details on the format of the list, see 2.5.3 List file for email reception monitoring job (Windows only).
For details on the email text, attached files, and list file for attached files, and how to perform the Option after receive settings in the Detailed Definition - [Receive Mail] dialog box, see 15.4.17 Detailed Definition - [Receive Mail] dialog box in the Job Management Partner 1/Automatic Job Management System 3 Operator's Guide. See also 15.4.18 Detailed Definition - [Receive Mail] - [Option after Receive] dialog box in the Job Management Partner 1/Automatic Job Management System 3 Operator's Guide.
- File for storing passing information
If you specify passing information in the window that appears when you click the Pass Info button in the Detailed Definition - [Receive Mail] dialog box, this file stores information on emails that satisfy the monitoring condition when received email is passed to the succeeding job.
The following information is stored in the mail folder in the folder specified in the EvjobInfFile environment setting parameter.
The default folder is as follows:
- For Windows Server 2008
- %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\tmp\infodir
- (The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.)
- For Windows Server 2003
- JP1/AJS3-installation-folder\tmp\infodir
- Email text
Every time the email reception monitoring job in which MLRCVBODY is specified as passing information encounters email that satisfies the monitoring condition, a file is created (with an arbitrary name) and the email text is stored in the file.
- Attached file
Every time the email reception monitoring job in which MLRCVATTACHFILExx (where xx is a value from 01 to 20) is specified as passing information encounters email that satisfies the monitoring condition, a folder is created (with an arbitrary name) and the files attached to the email are stored in the folder (with the file name unchanged).
- List file for attached files
Every time the email reception monitoring job in which MLRCVATTACHLIST is specified as passing information encounters email that satisfies the monitoring condition, a file is created (with an arbitrary name) and details of the files attached to the email are stored in the file. For details on the format of the list file, see 2.5.3 List file for email reception monitoring job (Windows only).
For details on the Pass Info button in the Detailed Definition - [Receive Mail] dialog box, see 15.4.17 Detailed Definition - [Receive Mail] dialog box in the Job Management Partner 1/Automatic Job Management System 3 Operator's Guide.
- Cautionary notes
- After email is received, the files are created for storing the email text, the attached files, the list of attached files, and passing information. However, JP1/AJS3 does not automatically delete these files. These files might use a large amount of system disk space, so delete them when they become unnecessary.
- In the environment for mail system linkage, if the action after email reception is set to Open, the opened email will remain in Inbox of Outlook. This email might use a large amount of system disk space in the mail server or in the computer where mail system linkage is performed. Activate Outlook with the profile for the mail system linkage on a regular basis to delete the opened email remaining in Inbox.
Note that before you delete email from Inbox of Outlook, you must stop the JP1/AJS3 mail monitoring process or the JP1/AJS3 Mail service.
For details on the procedures for starting and stopping the JP1/AJS3 mail monitoring process and the JP1/AJS3 Mail service, see 2.2.6 Starting and ending the mail system linkage function.
(2) For UNIX
The following figure shows the behaviour of a UNIX system at email reception.
Figure 2-4 Behavior at email reception (for UNIX)
The details about the files for storing data in the above figure are as follows:
- Internal email file
This stores received email. This file can be used by the JP1/AJS3 mail linkage function. Upon reception of email, the jpomailrecv command (email delivery setting command) executed by the sendmail appends the received email to the internal mail file.
The name of the internal email file is created by adding the monitoring user name to /var/opt/jp1ajs2/tmp/mailbox/.
- File for storing passing information
When received email is passed to the succeeding job, if the email reception monitoring job in which MLRCVMAILBODY is specified as passing information encounters email that satisfies the monitoring condition, a file is created and the received email is stored in the file.
A file for storing passing information is assigned a name that begins with MLDT. This file is stored in the mail directory under the event job information passing directory specified by the EvjobInfFile environment setting parameter of event/action control. The default directory is /var/opt/jp1ajs2/sys/infoagt/tmp/infodir/.
- File for storing email
Received email is appended to this file when the email reception monitoring job instructed to save received email encounters the email that satisfies the monitoring condition.
The name of the email storage file is the value of the MailFileName environment setting parameter of event/action control.
- File for storing unmatched email
This stores (to the end) the email that does not satisfy the monitoring condition of the email reception monitoring job.
The name of the file for storing unmatched email is created by adding the monitoring user name to the directory specified for the NotMatchMailDir environment setting parameter of event/action control.
- File for listing received email
The mail header is appended to this file when the email reception monitoring job specifying the name of the file for listing received email encounters the email that satisfies the monitoring condition.
The name of the file for listing received email is specified for the email reception list of the email reception monitoring job.
- Error email file
If mail reception monitoring fails while judging email, the email is appended to this file.
The name of the error email file is /var/opt/jp1ajs2/sys/infoagt/tmp/mail/errmail.
- Cautionary notes
- The email reception monitoring job creates files for storing passing information, email, unmatched email, received email listing, and error email. However, JP1/AJS3 does not automatically delete these files. These files might use a large amount of system disk space, so delete them when they become unnecessary.
- With the mail system linkage function of JP1/AJS3, email continues to accumulate in the internal email files created by the delivery function unless an email reception monitoring job is executed. The internal email files might use a large amount of system disk space, so periodically delete unnecessary internal email files.
Note that before you delete internal email files, you must stop the mail reception monitoring process and set the mail delivery function so that email is not delivered to the internal mail file.
For details on the mail delivery function, see 2.3.3 Setting up the mail delivery function.
Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.