2.6.3 List file for email reception monitoring job (Windows only)

When an email reception monitoring job detects the reception of an email with attached files, you can have the system create a file that lists the attached files.

To create a list file, you need to specify the name of the list file, as well as the folder where the attached files are to be saved.

To specify this information, use one of the following methods:

When defining the email reception monitoring job from the Jobnet Editor window of JP1/AJS3 - View
1. In the Detailed Definition - [Receive Mail] dialog box, select the PC option for the Platform setting, and then click the Set button under Option after receive.
  
  The Detailed Definition - [Receive Mail] - [Option after Receive] dialog box appears.
2. In the Detailed Definition - [Receive Mail] - [Option after Receive] dialog box, enter the relevant settings in the Folder for saving attached file and List file fields.
For details on the definitions you can set, see 12.4.20 Detailed Definition - [Receive Mail] dialog box in the JP1/Automatic Job Management System 3 Operator's Guide. See also 12.4.21 Detailed Definition - [Receive Mail] - [Option after Receive] dialog box in the JP1/Automatic Job Management System 3 Operator's Guide.
When defining the email reception monitoring job using the ajsdefine command

When writing the definition information for the job in the unit definition file, specify PC as the platform. Also specify the folder for saving attached files and the list file name.

For details on how to define these parameters, see ajsdefine in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference, 5.1.1 Format of unit definition files in the manual JP1/Automatic Job Management System 3 Command Reference. See also 5.2.11 Email reception monitoring job definition in the manual JP1/Automatic Job Management System 3 Command Reference.

When the email reception monitoring job detects that an email has been received, information about the sender, when the email was received, the number of attached files, and details of each file is output to the list file for attached files.

The information output to the list file falls into two categories:

File information

Information about a file attached to the received email.

The full path of the attached file (including the folder where the file is saved) is output to the list file.
OLE object information

Information relating to an object embedded in the email message by the mail client software that sent the message (for example a Microsoft Outlook item).

Windows cannot handle these objects as system files. For this reason, OLE objects are not saved to the folder for saving attached files. Instead, the message The attached file cannot be saved since it is an OLE object is output to the list file.

The following table shows the format of list files.

Table 2‒11: Format of list files
Place	Format	Output content
1^st line	`From:` `sender`	The sender of the email.
2^nd line	`Date:` `date`	The date and time when the email was received.
3^rd line	`Files:` `number-of-attached-files`	The number of files (files and OLE objects) attached to the email.
4^th and later lines	Information about individual attachments	Information about each attached file. Each line of information represents a different file. Files: The full path of the file OLE objects: The character string `The` `attached` `file` `cannot` `be` `saved` `since` `it` `is` `an` `OLE` `object.`

If you specify a list file name but not folder for saving attached files when defining an email reception monitoring job, 0 appears for Files (the number of files) in the list file. In this case, information about individual attachments is not output.

If the specified list file already exists, the system overwrites the existing file with the new information.

The following figure shows an example of the information output to a list file:

Figure 2‒15: Example of output to list file

In this example, the list file presents the following information about the received email:

The email sender was Sales.
The email was received at 12:34 on 1 August 20XX.
The email has three attachments (estimate.doc, an OLE object, and order.xls). The attached files, with the exception of the OLE object, were saved to the folder C:\USER\DEFAULT\customer-A.

To Page Top