CTDDS ATTRIBUTES

Control-D External Destinations includes CTDDS ATTRIBUTES statements. These statements can contain the variables described in the previous section. After the variables are resolved, most of the attributes are passed to Control-D Delivery Server and used for the report distribution. These attributes are described in the Control-D Delivery Server Administration Guide.

The attributes which are processed on the mainframe side are described below.

Attribute	Description
TRNTAB=tabname	This parameter can be specified in CTDDS ATTRIBUTES, if the CONVERT TO ASCII parameter is set to YES. When TRNTAB is specified, the translation table that is stored in the tabname member in the IOA PARM library is used for the translation from EBCDIC to ASCII. If the parameter TRNTAB is not specified, the TRNE2A default translation table is used for translation from EBCDIC to ASCII.
BODYTEXT=member_name	member_name is the name of the member in the IOA BANNERS library containing the body text of the e-mail that the distributed report is attached to. This member can contain one or more sections, each containing the body text associated with a different report name. Each section starts with a +++repname statement, where repname is either a complete report name or a mask. Only the body text from one section is used for a specific report name. Since the first repname that matches the report name determines which section provides the body text, the repname statements must be listed in order, starting with specific names and ending with the most general mask. Lines beginning with asterisks are comments and are not included in the body text of the email. The body text, which follows the statement, can be simple text or HTML. The text is then converted to ASCII and sent to the Control-D Delivery Server. Example: The parameter BODYTEXT=MYBODY is specified in CTDDS attributes. The MYBODY member contains the following statements: +++REP* line 11 line 12 line 13 +++* line 21 line 22 The text consisting of line 11, line 12, and line 13 will be inserted into emails that are distributing reports with report names starting with REP. The text consisting of line 21, and line 22 will be inserted into all other emails that are distributing reports.
RECIPIENT=list of recipients	The list of recipients can contain several entries separated by semicolons. Each entry can be specified as: e-mail address %EMAIL% member_name The %EMAIL% variable is resolved by the list of the e-mail addresses or member names defined in the CTD tree recipient entry. The e-mail_address or member_name must be specified in a description statement, such as EMAIL= e-mail_address or EMAIL=member_name. Several such description statements can be defined in the recipient entry. The member_name variable is the name of the member containing a list of e-mail addresses in the IOA BANNERS library. This member can contain one or more sections, each containing a list of e-mail addresses associated with a different report name. Each section starts with a +++repname statement, where repname is either a complete report name or a mask. In each list, the e-mail addresses related to the specified report name are defined. Each e-mail address starts from the beginning of a new line and is defined as EMAIL= e-mail_address. If the definition cannot fit on one line, it can be continued from any position on the next line (without the EMAIL= keyword). Only one list of e-mail addresses from one section is used for a specific report name. Since the first repname that matches the report name determines which section provides the list of e-mail addresses, the repname statements must be listed in order, starting with specific names and ending with the most general mask. Example: The following is specified in CTDDS attributes: RECIPIENT=%EMAIL%;MAILLST The following is specified in the CTD tree: DESC EMAIL=myaddress@bmc.com The MAINLST member contains the following lines: +++REP* EMAIL=recip1@bmc.com EMAIL=recip2@bmc.com +++* EMAIL=recip3@bmc.com Reports with names started with REP will be distributed to: myaddress@bmc.com; recip1@bmc.com; recip2@bmc.com All other reports will be distributed to: myaddress@bmc.com; recip3@bmc.com

Attribute

Description

TRNTAB=tabname

This parameter can be specified in CTDDS ATTRIBUTES, if the CONVERT TO ASCII parameter is set to YES.

When TRNTAB is specified, the translation table that is stored in the tabname member in the IOA PARM library is used for the translation from EBCDIC to ASCII.

If the parameter TRNTAB is not specified, the TRNE2A default translation table is used for translation from EBCDIC to ASCII.

BODYTEXT=member_name

member_name is the name of the member in the IOA BANNERS library containing the body text of the e-mail that the distributed report is attached to. This member can contain one or more sections, each containing the body text associated with a different report name. Each section starts with a +++repname statement, where repname is either a complete report name or a mask.

Only the body text from one section is used for a specific report name. Since the first repname that matches the report name determines which section provides the body text, the repname statements must be listed in order, starting with specific names and ending with the most general mask.

Lines beginning with asterisks are comments and are not included in the body text of the email.

The body text, which follows the statement, can be simple text or HTML. The text is then converted to ASCII and sent to the Control-D Delivery Server.

Example:

The parameter BODYTEXT=MYBODY is specified in CTDDS attributes. The MYBODY member contains the following statements:

+++REP*

line 11

line 12

line 13

+++*

line 21

line 22

The text consisting of line 11, line 12, and line 13 will be inserted into emails that are distributing reports with report names starting with REP.

The text consisting of line 21, and line 22 will be inserted into all other emails that are distributing reports.

RECIPIENT=list of recipients

The list of recipients can contain several entries separated by semicolons.

Each entry can be specified as:

e-mail address
%EMAIL%
member_name

The %EMAIL% variable is resolved by the list of the e-mail addresses or member names defined in the CTD tree recipient entry. The e-mail_address or member_name must be specified in a description statement, such as EMAIL= e-mail_address or EMAIL=member_name. Several such description statements can be defined in the recipient entry.

The member_name variable is the name of the member containing a list of e-mail addresses in the IOA BANNERS library. This member can contain one or more sections, each containing a list of e-mail addresses associated with a different report name. Each section starts with a +++repname statement, where repname is either a complete report name or a mask. In each list, the e-mail addresses related to the specified report name are defined. Each e-mail address starts from the beginning of a new line and is defined as EMAIL= e-mail_address. If the definition cannot fit on one line, it can be continued from any position on the next line (without the EMAIL= keyword).

Only one list of e-mail addresses from one section is used for a specific report name. Since the first repname that matches the report name determines which section provides the list of e-mail addresses, the repname statements must be listed in order, starting with specific names and ending with the most general mask.

Example:

The following is specified in CTDDS attributes:

RECIPIENT=%EMAIL%;MAILLST

The following is specified in the CTD tree:

DESC EMAIL=myaddress@bmc.com

The MAINLST member contains the following lines:

+++REP*

EMAIL=recip1@bmc.com

EMAIL=recip2@bmc.com

+++*

EMAIL=recip3@bmc.com

Reports with names started with REP will be distributed to:

myaddress@bmc.com; recip1@bmc.com; recip2@bmc.com

All other reports will be distributed to:

myaddress@bmc.com; recip3@bmc.com

Parent Topic

User Requirements