Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Required job variables include the to variable to specify the recipient of mail.
  • Any other variables are optional provided that a job resource is used that specifies connection details to your mail server, see below. Otherwise individual settings such as the SMTP host, SMTP port etc. can be specified from variables.
  • Select the check box provided with each job variable if you want this variable to be added to the arguments of the mail job.

...

  • from individual variables as offered by the job wizard.
  • by use of a job resourceresources.

Use of Job Resource for Mail Settings

A number of settings for sending mail most probably carry the same values when used for a number of mail jobs. This includes e.g. the SMTP host, SMTP port etc.

...

  • The variable names specified are selected to match use with the JITL MailJob template.
  • Consider the use of variable names that start with mail.smtp.

...

NameRequiredDefault ValuePurpose
commandtoyesCarries the SQL statements.

hibernate_configuration_file

no./config/hibernate.cfg.xml

Specifies the configuration file (XML) format for Hibernate connections, see JS7 - Database. By default Agents ship without hibernate configuration files, however, if a file with the default name is available then it will be applied.

resultset_as_warning

no

Raises a warning if the SQL statement creates a result set.

exec_returns_resultset

no

If stored procedures are called that return a result set then this argument has to be set to true in order to run the stored procedure as a query.

resultset_as_variables

no

Specifies how a result set is forwarded to order variables for subsequent jobs:

  • false: no result set is processed (default)
  • column_value: for the first record of the result set from each column name a variable is created that holds the column value.
  • name_value:  the first two columns of the result set will be added to order variables. The values of the first column of each record included with the result set will become the variable names, the values of the second column will become the variable values. 

Explanation:

...

  • Some DBMS might require and additional newline character.
  • For example
    • update MY_TABLE set a='foo' where b='bar'; commit;

list of mail recipient's e-mail address, multiple e-mail addresses are separated by comma

from

no

e-mail address used for sending mail

from_name

no

the free-text name of the account that sends mail

reply_to

no

if no replies should be accepted then typically use an e-mail address such as no-reply@example.com is used for the respective domain

cc

no

e-mail address of carbon copy recipient, multiple e-mail addresses are separated by comma

bccno
e-mail address of blind carbon copy recipient, multiple e-mail addresses are separated by comma
subjectyes
the mail subject, consider to use ASCII 7bit characters
bodyyes
the mail body specified as plain text or HTML depending on the content_type setting
content_typenotext/plaina content type text/plain specifies plain text mail, a content type text/html specifies use of HTML mails.
encodingno7bitthe character encoding of subject and body, by default ASCII 7bit is used
charsetnoiso-8859-1by default Latin 1 (iso-8859-1) is used
attachmentno
the path to a file to be attached, multiple files are separated by comma
attachment_content_typenoapplication/octet-streamthe attachment content-type typically allows binary files
attachment_encodingnoBase64any attached files are encoded with printable base64 characters
attachment_charsetnoiso-8859-1by default Latin 1 (iso-8859-1) is used
mail.smtp.hostyes
the hostname or IP address of the SMTP server
mail.smtp.portno25the port of the SMTP server
mail.smtp.userno
the user account to be used in case that the SMTP server requires authentication
mail.smtp.passwordno
the password to be used in case that the SMTP server requires authentication
mail.smtp. ...no
any additional Java properties can be used as applicable to the JavaMail package

...

Further information

...