After completing installation, but before sending messages, you must define the appropriate parameters in the IOAPARM member in the IOA PARM library. For email messages, specify the parameters in the MAIL section of IOAPARM describe in the table. For SNMP messages, specify the parameters in the SNMP section of IOAPARM described in the second table. A sample MAIL section of the IOAPARM member is shown below.
Table 55 Parameters in the MAIL section of the IOAPARM member
Parameter |
Description |
---|---|
SMTPNAME |
Global parameter. 1 through 8 characters. Has the same value that the ExtWrtName parameter is set to in the CSSMTP configuration. If ExtWrtName is omitted, then by default, SMTPNAME is equal to the local SMTP STC name. Mandatory. |
DFLTSFFX |
Global parameter. 1 through 50 characters. The default suffix of the local company e-mail address, in the format mail-id.domain.com. Mandatory. Note: Do not include the @ character. |
DFLTRPTO |
This field can hold up to 60 characters. The default full Reply To email address. On replying, this parameter overrides the From address and can be used where a possible reply to an actual address is needed. |
DFLTSNDR |
This field can hold up to 25 characters. This parameter enables the site to set a default sender name to be used in the FROM line of all emails sent by the INCONTROL monitors (for example, Control-M monitor) using the DO MAIL function. If this parameter does not appear in the MAILDEST parameter member or if it is left empty, the rule or job owner is used as the sender's name. |
OWNRSUFX |
Identifying information that is appended as a suffix to the name of the owner (the owner ID of the Control-M job). The value of this parameter will be appended to the name of the owner of the Control-M job definition. Up to 30 characters. |
HOSTNAME |
Global parameter. 1 through 8 characters. Name of the TCP host. Mandatory. |
CLASS |
Class of sysout from IOAMAIL to SMTP. 1 character. This must be a JES non-held class. |
DEST |
Destination for output of IOAMAIL. 1 through 8 characters. |
FORM |
Location of SYSOUT. 1 through 4 characters. The SYSOUT file that is directed to the SMTP will include the value of the FORM parameter. |
ENVELOPE |
Determines how IOAMAIL envelopes the mail message. Valid values are:
|
TIMEZONE |
Time zone used to set message transmission time. 5 characters can be used to identify a recognizable time zone. Default: LCL (local time zone) |
ATSIGN |
The AT SIGN (@) value that will be used as separator between the name and its address. It is useful when a site uses a pagecode in which the @ character is not X'7C'. |
ATCHSET |
Character set For example, ISO-8859-1. |
ATCHENC |
Character encoding. For example, 8. |
CTMLMAIL |
Specifies whether Control-M will write a message to the IOA Log whenever it sends a mail message. Email can be sent via the DO EMAIL, DO SHOUT, or SHOUT WHEN statements. Values:
|
Table 56 Parameters in the SNMP section of the IOAPARM member
Parameter |
Description |
---|---|
MODE |
Global parameter. 1 through 8 characters. Mode of SNMP. Mandatory. For example, SUBAGENT. |
HOST |
Global parameter. IP address or the host name. Mandatory. Host name (1 through 64 characters) or IP address (standard dotted-decimal notation) of an SNMP destination. |
PORT |
SNMP port number (1 through 65535). If not specified, SNMP port number defaults to 162. |
COMMUNTY |
This field can hold up to 32 characters. Community in Master Agent setup. If this parameter does not appear in the MAILDEST parameter member or if it is left empty, the rule or job owner is used as the sender's name. |
Figure 5 Sample MAIL section in IOAPARM
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Parent Topic |