15.4.27 Detailed Definition - [Send Mail] dialog box

(1) Items displayed in common

The following figure shows the items displayed in common.

Figure 15‒156: Items displayed in common in the Detailed Definition - [Send Mail] dialog box

The following explains the items displayed in common.

Unit name

Specify a unit name. Use a character string of up to 30 bytes. The default is Send-Mail.

Comment

Specify a comment for the unit. Use a character string of up to 80 bytes. The default is a blank.

Exec-agent

Specify the execution agent name or execution agent group name to be assigned the task of emailing. Use a character string of up to 255 bytes. You can specify a macro variable in this field if the version of the connection-target JP1/AJS3 - Manager is 09-50 or later, and Standard is specified for Exec. service. The default is a blank.

This item appears as a text box when either of the following applies:

• The version of JP1/AJS - View or the connection-target JP1/AJS - Manager is earlier than 09-50

• The unit is being defined under a remote jobnet

Otherwise, this item appears as a combo box in which you can select an execution agent. You can also directly enter an execution agent name into the combo box. The content of the list component of the combo box differs depending on whether execution agent profiles are enabled, and the contents of those profiles.

When execution agent profiles are disabled

The list is empty.

When execution agent profiles are enabled

• If the specified job is associated with an execution agent profile

  The list displays the execution agents permitted for the specified job.

• If the specified job is not associated with an execution agent profile

  If the upper-level unit is associated with an execution agent profile, the list displays the execution agents permitted for the upper-level unit.

  If the upper-level unit is not associated with an execution agent profile, the list will be empty.

For details about execution agents, see 5.1.1 Execution agents in the manual Job Management Partner 1/Automatic Job Management System 3 Overview.

Cautionary note

If you have selected Queueless Agent in Exec. service on the Attributes page, specify the name of an execution host.

To Page Top

(2) Definition page

The following figure shows the Definition page in the Detailed Definition - [Send Mail] dialog box.

Figure 15‒157: Definition page in the Detailed Definition - [Send Mail] dialog box

The following explains the displayed items.

Recipients

Specify the address of a destination. Use a character string of up to 256 bytes. You must specify this item. You can use a macro variable. The default is a blank. Then, select TO, CC, or BCC.

• TO

  Sends email to the destination.

• CC

  Sends an email copy to the destination.

• BCC

  Sends an email copy to the destination; like paper BCC (blind carbon copy), this copy is hidden from other recipients.

If you click the Add button, this item is added to the list. You can add up to 20 addresses to the list.

The following table shows the address formats that you can type in the Recipients field when you choose PC for Platform.

Table 15‒44: Address formats supported in the Recipients field

No.	Profile type	Supported format
1	Exchange Server#	- Display name - Alias - Internet mail address
2	Internet mail (SMTP/POP3)	Internet mail address

Subject

Specify an email subject. Use a character string of up to 256 bytes. You can use a macro variable. The default is a blank.

If you omit this item when using an email client other than Outlook, emails are sent with a single-byte space as the subject line. In email clients other than Outlook, you can specify reserved words that are replaced by the date, time, and other information when the email is sent. Although you can specify a character string containing reserved words that is longer than 256 bytes, the character string must not exceed 989 bytes after it is converted. For details about the reserved words you can specify, see Table 15-45.

Message text

Specify the text of an email message in the text field by using a character string of up to 512 bytes (including linefeed characters). In UNIX, you need to add a linefeed character at the end of the final line when you send an email.

You can use macro variables in the text. You can also use the content of a file as the text. When using the content of a file as the text, select Use file and fill the text field with a file name consisting of a character string of up to 256 bytes. In this case, click the ... button, and then select a file name from the displayed dialog box. You can also use macro variables in the file name, but you cannot use them in the file itself.

In email clients other than Outlook, you can specify reserved words that are replaced by the date, time, and other information when the email is sent. Although you can specify a character string containing reserved words that is longer than 512 bytes, the length of the character string after conversion must not exceed 998 bytes per line. For details about the reserved words you can specify, see Table 15-45.

If you select Use file, note that what is specified in the text of the email message will be invalid.

Platform

Select the platform on which you want to execute jobs. You can select PC or UNIX. The default is PC. If you select UNIX, you can specify neither Profile name nor Attached file.

• PC

  A Windows environment is used.

• UNIX

  A UNIX environment is used.

Profile name

Specify a source profile name. Use a character string of up to 256 bytes. You can use a macro variable. If you have selected PC for Platform, be sure to specify this item. You cannot specify a profile name if you selected UNIX for Platform.

The default is a blank.

Attached file

If you click the Set button, the Detailed Definition - [Send Mail] - [Attached File] dialog box appears. Specify an attached file name. If you select Apply, the settings become valid. Only when you select PC in Platform, you can have the Detailed Definition - [Send Mail] - [Attached File] dialog box appear. You cannot specify an attached file if you selected UNIX for Platform.

For details about this dialog box, see 15.4.28 Detailed Definition - [Send Mail] - [Attached File] dialog box.

Reserved words

This item can be used only when Outlook is not used to send emails.

The following table lists the reserved words you can use in the Subject and Message text fields.

Table 15‒45: Reserved words

No.	Reserved word	Replaced with	Example
1	~Date~ ~date~	The date when the email sending job was executed by the execution agent	2012/12/01
2	~Time~ ~time~	The time when the email sending job was executed by the execution agent	12:15:30
3	~Year~	The year when the email sending job was executed by the execution agent	2012
4	~Month~	The month when the email sending job was executed by the execution agent	12
5	~DayOfMonth~	The day when the email sending job was executed by the execution agent	01
6	~Hour~	The hour when the email sending job was executed by the execution agent	12
7	~Minute~	The minute when the email sending job was executed by the execution agent	15
8	~Second~	The second when the email sending job was executed by the execution agent	30
9	~CurrentVersion~	The OS version of the execution agent	Windows NT 5.2 Service Pack 2
10	~ComputerName~	The computer name of the execution agent	COMPUTER1
11	~IPaddress~	The IP address of the execution agent If the execution agent has multiple IP addresses, this reserved word is replaced with the first IP address supplied by the operating system.	192.168.0.2

Notes on reserved words

• Reserved words are case sensitive.

• If a character string enclosed by tildes (~) does not match an entry in the table above, the character string will be sent as is.

• Replacement of reserved words takes place at the execution agent of the email sending job.

• Reserved words that relate to time are subject to the time zone setting of the execution agent.

Examples of reserved word substitutions

The following table shows examples of how certain character strings specified in the Subject and Message text fields appear in emails.

Table 15‒46: Examples of reserved word substitutions

No.	Specified character string	Replaced with	Description
1	~Date~ ~Time~	2012/12/01 12:15:30	The parts that match reserved words are replaced accordingly.
2	~Date~~Time~	2012/12/0112:15:30	The parts that match reserved words are replaced accordingly.
3	~~Date~~Time~~	~2012/12/0112:15:30~	The parts that match reserved words are replaced accordingly.
4	~DATE~	~DATE~	Because ~DATE~ is written in upper case letters, it does not match a reserved word and no substitution takes place.
5	~Date~Time~	2012/12/01Time~	Because Time is not enclosed by tildes (~), no substitution takes place.
6	~Today~	~Today~	Because ~Today~ is not a reserved word, no substitution takes place.

To Page Top

(3) Attributes page

The following figure shows the Attributes page in the Detailed Definition - [Send Mail] dialog box.

Figure 15‒158: Attributes page in the Detailed Definition - [Send Mail] dialog box

The following explains the displayed items.

Hold

Specify whether to place the unit in the hold status in advance. You can select No or Yes. The default is No.

Type

Set the unit type to Normal or Recovery. The default is Normal.

Exec. service

Select the target service. You can specify Standard or Queueless Agent. The default is Standard. Note that this text box appears for connection target JP1/AJS3 - Manager, or JP1/AJS2 - Manager 07-00-/C or later.

Set timeout period

Select whether to set a time-out period for job execution. You can specify No or Yes. The default is No.

Timeout period

If you select Yes in Set timeout period, specify a time-out period in minutes. You can set 1 to 1,440 minutes. The default is a blank.

Delayed end

Specify whether to monitor delayed end of jobs based on time required for execution. Select the Time-required-for-execution check box to monitor delayed end of jobs. The check box is not selected by default.

When you select the Time-required-for-execution check box, specify the time required for execution for a job from 1 to 1,440 (in minutes).

This section appears for the JP1/AJS3 - View, or JP1/AJS2 - View of version 08-50 or later. For details about cautionary notes on monitoring of delayed end of jobs based on time required for execution, see 5.1.1(3) End delay monitoring based on time-required-for-execution in the Job Management Partner 1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

Owner

Specify the owner of the unit. Use a character string of up to 31 bytes. The default is the login JP1 user name. Note that if the upper-level unit-attribute inheritance function has been set for the upper-level jobnet, the default is the owner of the upper-level unit.

JP1 resource group

Specify a JP1 resource group name. Use a character string of up to 63 bytes. You can specify alphanumeric characters and underscore (_). The default is the JP1 resource group name of the upper-level unit. If you specify a blank, you are not authorized to access this group.

Executed by

Select the user who executes the job. The default is User who registered. You can select either of the following.

• User who registered

  The JP1 user who registered the job executes the job.

• User who owns

  The JP1 user who owns the job executes the job.

You must perform user mapping on the host where you want to execute the job so that the specified user is converted to a OS user.

If the execution-user fixing function is configured for the upper-level unit, the execution user conforms to the unit-attribute profile regardless of the contents of this field.

To Page Top