Using the Notification Utility › How to Configure the Notification Utility › Protocol-specific Parameters › SMTP-specific Parameters

SMTP-specific Parameters

If you are using the SMTP protocol to inform your users and package approvers of a CA Endevor SCM event, use the following information for the SMTP-specific parameters that the exit program must pass to the control block. Information is provided for assembler.

NOTATSIGN

This field allows you to override the default character used to construct email addresses. When no value is entered, CA Endevor SCM uses the default value, which can be either @ sign, or the value coded in $ESMTP table. Specify one byte hexadecimal value, or leave the field blank if you do not want to override the default value. :

NOTMSGVF

Indicates whether the message text format is fixed or variable length. The possible values are:

F-Fixed length. This is the default setting.

V-Variable length.

Note: If you select F, or do not select a value, use the NOTMSGTX parameter to specify the message text. Do not use the NOTSMTPM parameter.

NOTSIZE

Indicates the size field in the $NOTIFY control block.

NOTMSGMX

Indicates the maximum message length. Required only if the value of NOTMSGVF is V.

NOTSMTPM

The address of the email text. The text must be in the following format:

LLLLmessage-text

• LLLL-The length (in binary) of the message text.
• message-text-The message text.

NOTSMTPS

50-character text field used for the email's subject field.

NOTMSGLP

Text field used to specify the message.

• If NOTMSGVF is F, then the data string is treated as a string of fixed records. Fixed records are 84 bytes long, with a 4-byte address of the next record (zero - end), and 80 bytes of text content.
• If NOTMSGVF is V, then the data string is treated as a string of variable records, instead of as a string of a single variable record. The variable record format is a 4-byte address of the next record (zero - end), a 2-byte length of string, and nn bytes of string content (up to 32K bytes).

NOTFROM

A four-byte field that allows you to specify a FROM USER for the emails that are sent. The field should contain the address of an area of up to 50 bytes containing the FROM-ID that is to be used in emails. No spaces are allowed in the FROM-USER field. If the address is zeros, CA Endevor SCM uses a default FROM USER definition.

For a sample exit program that illustrates how to use these parameters, see XIT7MAIL in the iprfx.iqual.CSIQOPTN library.

Note: For more information about XIT7MAIL, see the Exits Guide.