Keyword

Meaning

ADMIN_MAIL={on|off}

This required keyword enables or disables the administrative email services. If the keyword is not specified, the default action is the same as being set to 'off'.

ADMIN_MAIL_OUT={out}

This required keyword allows an administrative email to be sent for a Data Manager. The {out} string for this keyword specifies the SMTP outgoing mail server name (URL) or IP address.

ADMIN_MAIL_TO={to}

This required keyword allows an administrative email to be sent for a Data Manager. The {to} string for this keyword specifies the email address(es) of the recipients.

ADMIN_MAIL_FROM={from}

This required keyword allows an administrative email to be sent for a Data Manager. The {from} string for this keyword specifies a single email address of the sender.

 ADMIN_MAIL_MAXUSERS=[off]

By default this administrative email event is enabled for the Data Manager. If this optional keyword is set to 'off', this email event is disabled.

When this email event is enabled, an email is sent that identifies when the maximum number of user connections has been exceeded.

ADMIN_MAIL_STARTUP=[on]

By default this administrative email event is disabled for the Data Manager. If this optional keyword is set to 'on', this email event is enabled.

When this email event is enabled, an email is sent that identifies when the Data Manager enters the startup phase that accepts user logons.

ADMIN_MAIL_SHUTDOWN=[on]

By default this administrative email event is disabled for the Data Manager. If this optional keyword is set to 'on', this email event is enabled.

When this email event is enabled, an email is sent that identifies when the Data Manager main logon process is terminated.

ADMIN_MAIL_SUBJECT={subject}

If this keyword is not specified, a default email subject is sent as follows:

"SunDm Administrator Message"

When the ADMIN_MAIL_SUBJECT keyword is specified, the {subject} string is sent as the subject for the email message. The {subject} string length is limited to 200 bytes. If the {subject} string contains a '%s' substitution parameter, the '%s' is replaced with the body text being sent for the message. The intended use of the '%s' is to allow the subject for the email to give the specific reason for the server event without having to open the email body.

ADMIN_MAIL_BCC={bcc}

This optional keyword specifies the email address or addresses of the Blind Copy recipients. The {bcc} string may contain one or more recipient addresses. If more than one email recipient is specified, a comma separates the email addresses.

ADMIN_MAIL_CC={cc}

This optional keyword specifies the email address or addresses of the Copy recipients. The {cc} string may contain one or more recipient addresses. If more than one email recipient is specified, a comma separates the email addresses.

ADMIN_MAIL_USER={user}

This optional keyword specifies the username used for the login to the {out} email server specified by the ADMIN_MAIL_OUT keyword.

ADMIN_MAIL_PASSWORD={password}

This optional keyword specifies the password for the login to the out} email server specified by the ADMIN_MAIL_OUT keyword.

ADMIN_MAIL_PORT={port}

This optional keyword specifies the port number used when logging on to the {out} email server specified by the ADMIN_MAIL_OUT keyword. If this keyword is not specified, the default port number of twenty-five (25) is used. The {port} string must be specified as decimal digits that identify the email server port number to be used.

ADMIN_MAIL_SSL={on|off}

This optional keyword enables the SSL ( Secure Sockets Layer ) support if the OpenSSL libraries have been installed on the system where the Data Manager is executing.

ADMIN_MAIL_TIMEOUT={timeout}

This optional keyword specifies the timeout value used when communicating with the {out} email server specified by the ADMIN_MAIL_OUT keyword. If this keyword is not specified, the default timeout of sixty (60) seconds is used. There are no restrictions placed on the value specified. The {timeout} string must be specified as decimal digits that identify the timeout value to be used.

ADMIN_MAIL_TRACE={trace}

This optional keyword specifies the file name created to store all data messages sent and received when communicating with the {out email server specified by the ADMIN_MAIL_OUT keyword. Note that a trace file is overwritten for a each email that is sent. This keyword is normally only needed to provide debug information when email problems are being researched. Otherwise, this keyword should not be used. The ADMIN_MAIL_TRACE keyword takes precedence over the ADMIN_MAIL_TRACEAPPEND keyword if both keywords are specified in the configuration file.

ADMIN_MAIL_TRACEAPPEND={traceappend}

This optional keyword allows the trace data to be appended to an existing trace log file. This keyword is normally only needed to provide debug information when email problems are being researched. Otherwise, this keyword should not be used. The ADMIN_MAIL_TRACE keyword takes precedence over the ADMIN_MAIL_TRACEAPPEND keyword if both keywords are specified in the configuration file.

ADMIN_MAIL_DSNRECEIPT={dsn}

This optional keyword specifies that this email requires a Delivery Service Notification as specified by the {dsn} string. The {dsn} string can be specified as follows:

 DSNRECEIPT=Never

or

DSNRECEIPT=Success,Failure,Delay

Where:

Never

No return receipts are returned. This string option cannot be combined with other options.

Success

There will a notification on the successful delivery of message. This option can be combined with Failure/Delay.

Failure

There will be a notification when a delivery failure occurs. This option can be combined with Success/Delay.

Delay

This will be a notification when the delivery of a message is delayed. This option can be combined with Success/Failure.

When combining options in the {dsn} string, the options are separated with a comma delimiter.

ADMIN_MAIL_MDNRECEIPT={on|off}

This optional keyword requests that a client program receipt will be returned when the recipient reads this email.

ADMIN_MAIL_RETURN={return}

This optional keyword is only valid when the DSNRECEIPT keyword is used. This keyword specifies the recommended format of the return receipt that is being requested by the DSNRECEIPT keyword. The {return} string can be specified as follows:

RETURN=Full

or

RETURN=Hdrs

Where:

Full

The full message will be returned with the receipt. This option is not combined with the other option.

Hdrs

The returned receipt should only contain the message headers.

The options Full and Hdrs are mutually exclusive.

ADMIN_MAIL_REPLYTO={replyto}

This optional keyword specifies the email address that a recipient is to send a reply to when responding to this email.