[Name (Default SMTP) ]
[Password (Defaul t
=SMTP) ]
[Inl ines (Default 1) ]
[Outlines (Default = 1) ] [Network Name (Default = Unknown) ]
[TepNode Name (Default Local) ] [Log File ([Sys](Sys)TCP.SMTP.LOG)]
[Log Level (Default = 8010) ] [Log Size (Default = 80Kb) ] [Suppress Convert to Sys (Default = No) ]
4-20
Parameter Name
[Password]
[Inlines (Default = 1)]
Description
This parameter specifies the name assigned to the SMTP Manager during its configuration as an OFIS Mail communication manager.
This parameter specifies a password for the SMTP Manager. This password must match the password assigned during the configuration of the SMTP Manager as an OFIS Mail communication manager.
The default is no password.
This parameter specifies the maximum number of TCP/IP connections that can receive mail at any given time. The value specified must be in the range of 0 to 64. If zero is specified, mail cannot be received from the network.
41511163-000
[Outlines
This parameter specifies the number of TCP/IP connections that can send mail at any given time. Valid values are 0 and 1. A value of 0 implies that you do not intend to send mail to other hosts. The sum of the Inlines and Outlines parameters cannot exceed 64 or the maximum number of connections that is specified in the MaxMaxConn parameter of the TCP /lP
configuration file.
This parameter is used as the name of the network that the TCP/IP transport service is connected to (fer example, ARPA). This value is used in many SMTP messages. If not specified, the value Unknown is used.
A maximum of 24 characters is allowed.
This parameter is the name of the B-Net node where TCP is installed. The default is the local node.
This parameter specifies the path and file name that the SMTP Manager will use to log information. Any valid BTOS file name is acceptable. When you specify a log level of 0, logging is disabled. See the Log Level parameter that follows. Information written to the log file is in ASCII format.
This parameter is checked to determine the type of information written to the log file. The default value is 1. A value of 0 disables logging. This parameter must be
in the hexadecimal format. .
The values of log level and their corresponding log file entries are shown in the following table.
4-21
Log Level Values Log Level Value
(base 16) Log Level (base 2) Log File Entry
0001 0000 0000 0000 0001 SMTP commands
0002 0000 0000 0000 0010 TCP/IP SMTP incoming
data buffer entries
0004 0000 0000 0000 0100 TCP/IP SMTP outgoing
data buffer entries
0008 0000 0000 0000 1000 SMTP Manager state
changes
0010 0000 0000 000 1 0000 Errors
0020 0000 0000 0010 0000 Mail Giver to Mail Server 0040 0000 0000 0100 0000 Details of mail given to
Mail Server
0080 0000 0000 1000 0000 Mail from Mail Server
0100 0000 0001 0000 0000 Details of mail from Mail Server
0200 0000 0010 0000 0000 Major software function
calls
0400 0000 0100 0000 0000 Major events (not errors)
0800 0000 1000 0000 0000 Reserved
1000 0001 0000 0000 0000 TCP/IP SMTP Protocol
2000 0010 0000 0000 0000 Decoding of encoded data
from remote SMTP Mail Manager
8000 1000 0000 0000 0000 Essential events
4-22 41511163-000
The log level values shown in Table 4-2 may be combined to produce log file entries of more than one type. The result of a bit-wise logical OR of the debug level values (base 2) for the desired entries can be used for this parameter value to produce a combined logging function.
For example, to record the SMTP commands, SMTP Manager state changes, and Major software function calls you would use a debug level of 0209hex
(0000 0010 0000 1001).
Note: Extensive log entries may slow the overall system response of SMTP.
[Log Size
This parameter specifies the maximum size of the log file divided by 1024. For example, a value of 20 implies that the maximum log file size is 20 x 1024 or 20,480 bytes. The default size is 80Kb.
When the log file entries exceed the Log size the file entries wrap (are written over).
This parameter specifies whether the SMTP Manager will become a system service through the BTOS function ConvertToSys.
Valid values are N for creation of a system service and Y for inhibiting the creation of a system service. If you specify N, logging information is written to the log file. If you specify Y, logging information is written to the screen as well as the log file. This parameter is useful for testing and debugging a new installation. When you select Y for this parameter, you must run the SMTP Manager under Context Manager.
After completing the form, press the GO key.
Note: SMTP Manager errors are written to the log file in the fonn of status codes.
See Appendix A for a listing of these SMTP status codes.
41511163-000 4-23
Suggestions for Using SMTP
It is recommended that you use a log level of 9010 for the testing of a new SMTP center. This will allow you to log the flow of messages between your system and remote hosts. After it is working satisfactorily, set it to the default, 8010.
You can use Context Manager to test your new SMTP center, as the following steps explain.
1. Install data link Install IP Install TCP Install Mail Server Install Context Manager
2. Install the SMTP Manager in one partition by supplying a log level of 9010 and answeringyes to the Suppress Convert-to-Sys parameter.
3. Install OFIS Mail in another partition.
4. Send mail between the local mail center and a remote mail center. Switch between contexts to watch the interaction. Be patient: the mail server may take a minute or two before it hands a message to the SMTP Manager.
5. When the SMTP Manager is running to your satisfaction, reinstall it as a system service by answering no to the Suppress Convert-to-Sys parameter and setting the log level parameter to 8010.
Note: The symbolic name that you use to indentify a remote host (as in Internet address mapping, e.g .. , UNIXl192.30.10.1) may not be the same name as used for the remote SMTP entity. Look at incoming mail messages to detennine the correct name and verify that it is an entry in the TCP/IP configuration file. If it is not, create an alias entry in the configuration file.
Installing Queue Manager
4-24
BTOS Queue Manager is required to process FTP requests.
To install the Queue Manager, at the Executive command line type Install Queue Manager and press the RETURN key. The following form appears: