... Client / Server Program Options
Mail (with SMTP) Client Program
The MAIL program provides local and internet mail services.
This program is recommended for systems not requiring a POP3
server. The startup options for MAIL are:
MAIL [?] [-fp filespec] [-i IP Address] [-h] [-t n] [-z s]
? List the Help Text and Exit MAIL
f filespec Command File
h Help list
i IP Address Intermediate Host Name / IP Address
p filespec Specify the Password Filespec
t n MAILER Delivery Task Number
z s Connection Timeout in Seconds
The Intermediate Host IP option provides a means of routing the
internet mail through another host machine. The TSX-Plus MAIL
program does not support retry operations if the mail cannot be
delivered, using an intermediate host supporting retries will
provide this feature to the TSX-Plus MAIL system. Permission to
use a particular host as a MAIL relay should be obtained from
the hosts' system manager. The option must be specified using
the complete name (an IP address may also be used). A typical
invocation follows:
-i mail.domain.name
The MAIL program is invoked from the command file MAIL.COM:
run/single TCP:mail
-hpz PAS:/paswrd.dsk/paswrd.fil 60 ^1 ^2 ^3 ^4 ^5 ^6
The MAIL program supports the following command line options:
? print local help information
bye terminate the MAIL program
copy copy a message to a file
debug toggle/set debugging mode
delete delete a message
dir list of unread mail messages
exit terminate the MAIL program
hash toggle printing `#' during transfers
help print local help information
home go to home (initial) directory
index an index of received mail
interactive turn on prompting on multiple commands
last read most recent mail message
lcd change local working directory
ldelete delete local files
ldir list contents of local directory
listmail list of unread mail messages
lls list contents of local directory
lmkdir make a local directory
lprotect set protection flag on local file
lpwd show local working directory
lrename rename a local file
lrmdir remove a local directory
ltype print a local file to the screen
lunprotect clear protection flag on a local file
mail go to mail directory
newmail count number of new mail messages
noninteractive turn off prompting on multiple commands
prompt toggle interactive prompting
on multiple commands
quit terminate the MAIL program
read read a mail message
scan scan directory for all mail messages
send [filespec] initiate the sending of a message
status show current status
user enter a new user/password access key
verbose toggle verbose mode
version MAIL-11 version displayed
wild toggle wildcard expansion of local file names
Mail is sent to a local user if only a name is specified and to
a remote machine if the user and IP address are specified.
Local: username
Internet: username@machine.domain.name
The MAIL programs MAIL.SAV, MMAIL.SAV, MAILER.SAV, RPOP3.SAV,
and RSMTP.SAV make use of the password file to restrict access
to the mail system. A user may have local and/or remote MAIL
access (or no access) depending on the password file parameters.
Incoming mail may be directed to a users' default directory
or to a specific mail directory (specified in the password
file). A typical configuration is to create a mail directory,
SY:MAIL.DSK, and have mail subdirectories for each user. Thus
the path SY:/MAIL/USER1/ specifies the users' unique mail direc-
tory and should be specified in the password configuration. The
local mail programs MAIL.SAV, MMAIL.SAV, and MAILER.SAV and the
remote mail programs RSMTP.SAV and RPOP3.SAV check the password
file to verify that the user has the privilege to send or re-
ceive mail via the network and places any received mail in the
specified mail directory. These programs will use/create a mail
index file in the mail directory which is used to keep an index
of all received mail.
The MAILER delivery task number should be specified if im-
mediate mail forwarding is required. The task number must be
that specified in the TCPIP.CFG for the MAILER task. The MAILER
task is started by MAIL when the program exits.
Mail (without SMTP) Client Program
The MMAIL program is a front end interface to the MAILER ser-
vice. This program is recommended for systems requiring a POP3
server. The startup options for MMAIL are:
MMAIL [?] [-fp filespec] [-t n] [-h]
? List the Help Text and Exit MMAIL
f filespec Command File
h Help list
p filespec Specify the Password Filespec
t n MAILER Delivery Task Number
The MAILER delivery task number must be specified. The task
number must be that specified in the TCPIP.CFG for the MAILER
task. The MAILER task is started by MMAIL when mail is sent.
The MMAIL program is invoked from the command file MMAIL.COM:
run/single TCP:mmail
-hpt PAS:/paswrd.dsk/paswrd.fil 1 ^1 ^2 ^3 ^4 ^5 ^6
The MMAIL program supports the following command line options:
? print local help information
bye terminate the MMAIL program
copy copy a message to a file
debug toggle/set debugging mode
delete delete a message
dir list of unread mail messages
exit terminate the SMAIL program
help print local help information
home go to home (initial) directory
index an index of received mail
interactive turn on prompting for multiple commands
last read most recent mail message
lcd change local working directory
ldelete delete local files
ldir list contents of local directory
listmail list of unread mail messages
lls list contents of local directory
lmkdir make a local directory
lprotect set protection flag on local file
lpwd show local working directory
lrename rename a local file
lrmdir remove a local directory
ltype print a local file to the screen
lunprotect clear protection flag on a local file
mail go to mail directory
newmail count number of new mail messages
noninteractive turn off prompting for multiple commands
prompt toggle interactive prompting
on multiple commands
quit terminate the MAIL program
read read a mail message
scan scan directory for all mail messages
send [filespec] initiate the sending of a message
status show current status
user enter a new user/password access key
version SMAIL-11 version displayed
wild toggle wildcard expansion of local file names
Mail is sent to a local user if only a name is specified and to
a remote machine if the user and IP address are specified.
Local: username
Internet: username@machine.domain.name
The MAIL programs MAIL.SAV, MMAIL.SAV, MAILER.SAV, RPOP3.SAV,
and RSMTP.SAV make use of the password file to restrict access
to the mail system. A user may have local and/or remote MAIL
access (or no access) depending on the password file parameters.
Incoming mail may be directed to a users' default directory
or to a specific mail directory (specified in the password
file). A typical configuration is to create a mail directory,
SY:MAIL.DSK, and have mail subdirectories for each user. Thus
the path SY:/MAIL/USER1/ specifies the users' unique mail direc-
tory and should be specified in the password configuration. The
local mail programs MAIL.SAV, MMAIL.SAV, and MAILER.SAV and the
remote mail programs RSMTP.SAV and RPOP3.SAV check the password
file to verify that the user has the privilege to send or re-
ceive mail via the network and places any received mail in the
specified mail directory. These programs will use/create a mail
index file in the mail directory which is used to keep an index
of all received mail.
POP3 Server Program
RPOP3 is a server program for remote access to the TSX-Plus
mail system via the extended POP3 protocol. This server sup-
ports the PC shareware packages PC Eudora and WinQVT/Net for
Windows 3.x and NT in particular and others using the POP3 pro-
tocol. The program startup options are:
RPOP3 [?] [-p filespec] [-aeqrtvyz] [parameters]
? List the Help Text and Exit RPOP3
a Attach to Service
e Enable Monitoring of RPOP3 Transactions
p Specify the Password Filespec
q n Specify an Alternate Connection Port
r Restart RPOP3 after Disconnect
t n TCPIP Task Number for Mail Delivery Agent
v Verbose Mode
y s Login Timeout in seconds
z s Inactivity Timeout in seconds
The MAILER delivery task number must be specified. The task
number must be that specified in the TCPIP.CFG for the MAILER
task. The MAILER task is started by RPOP3 when mail is sent.
The program may be started interactively (for diagnostic pur-
poses) by the command file RPOP3.COM:
run/single TCP:rpop3
-rptyz PAS:/paswrd.dsk/paswrd.fil 1 15 600 ...
... ^1 ^2 ^3 ^4 ^5 ^6
The program is normally invoked by the TCPIP network server pro-
gram by the command file RPOP3.SRV:
deassign
dismount ld0:
dismount ld1:
dismount ld2:
dismount ld3:
dismount ld4:
dismount ld5:
dismount ld6:
dismount ld7:
assign sy: wf:
mount ld6: dl1:paswrd.dsk
assign ld6: PAS:
mount ld7: dl1:tsxtcp.dsk
assign ld7: TCP:
run/single TCP:rpop3
-aptyz PAS:paswrd.fil 1 15 600
The service entry in the TCP/IP configuration file reflects the
default RPOP3 port of 110. If an alternate port is specified
for RPOP3 using the '-q' option then the TCP/IP configuration
file must be changed to match the port selection. A server pro-
gram may be configured to respond to multiple TCP/IP ports by
creating a service specification entry / service command file
pair for each additional port.
The MAIL programs MAIL.SAV, MMAIL.SAV, MAILER.SAV, RPOP3.SAV,
and RSMTP.SAV make use of the password file to restrict access
to the mail system. A user may have local and/or remote MAIL
access (or no access) depending on the password file parameters.
Incoming mail may be directed to a users' default directory
or to a specific mail directory (specified in the password
file). A typical configuration is to create a mail directory,
SY:MAIL.DSK, and have mail subdirectories for each user. Thus
the path SY:/MAIL/USER1/ specifies the users' unique mail direc-
tory and should be specified in the password configuration. The
local mail programs MAIL.SAV, MMAIL.SAV, and MAILER.SAV and the
remote mail programs RSMTP.SAV and RPOP3.SAV check the password
file to verify that the user has the privilege to send or re-
ceive mail via the network and places any received mail in the
specified mail directory. These programs will use/create a mail
index file in the mail directory which is used to keep an index
of all received mail.
Mail Server Program for MMAIL and RPOP3
MAILER is a backend program for MMAIL and RPOP3 which
provides mail delivery to local users and remote destinations.
When MAILER is activated it scans all user mail directories for
files with names similiar to ml____.nnn created by MMAIL or
RPOP3. These files are routed to their respective destinations
and then deleted. If the mail is not deliverable then the mes-
sage is directed back to the sender.
MAILER is also a backend program for MAIL, MMAIL, RPOP3, and
RSMTP which provides mail forwarding from a local user to
another local user or remote destination. When MAILER is ac-
tivated it scans each user-mail-directory enabled for forwarding
and sends any received mail to the forwarding address. After a
successful forward the local mail file is deleted. Forwarding
is enabled by specifying a forwarding address in the PASWRD pro-
gram.
The program startup options are:
MAILER [?] [-p filespec] [-i IP-address] [-t n] [-z s] [-ev]
? List the Help Text and Exit MAILER
e Enable Monitoring of MAILER Transactions
i IP-address Intermediate Host Name / IP Address
p filespec Specify the Password Filespec
t n (minutes) Continuous scanning time interval
v Verbose Mode
z s Conection Timeout in Seconds
The Intermediate Host IP option provides a means of routing the
internet mail through another host machine. The TSX-Plus MAIL
program does not support retry operations if the mail cannot be
delivered, using an intermediate host supporting retries will
provide this feature to the TSX-Plus MAIL system. Permission to
use a particular host as a MAIL relay should be obtained from
the hosts' system manager. The option must be specified using
the complete name (an IP address may also be used). A typical
invocation follows:
-i mail.domain.name
The program may be started interactively (for diagnostic pur-
poses) by the command file MAILER.COM:
run/single TCP:mailer
-p PAS:/paswrd.dsk/paswrd.fil ^1 ^2 ^3 ^4 ^5 ^6
The program is normally invoked by the TCPIP network server pro-
gram by the command file MAILER.SRV:
deassign
dismount ld0:
dismount ld1:
dismount ld2:
dismount ld3:
dismount ld4:
dismount ld5:
dismount ld6:
dismount ld7:
assign sy: wf:
mount ld6: dl1:paswrd.dsk
assign ld6: PAS:
mount ld7: dl1:tsxtcp.dsk
assign ld7: TCP:
run/single TCP:mailer
-piz PAS:paswrd.fil mail.domain.name 60
The specification of device wf: is required by MAILER to
temporarily store local mail messages before writing the mail to
the users mail directories. If wf: is undefined, inaccessable,
or not initialized then mail will not be delivered.
The MAIL programs MAIL.SAV, MMAIL.SAV, MAILER.SAV, RPOP3.SAV,
and RSMTP.SAV make use of the password file to restrict access
to the mail system. A user may have local and/or remote MAIL
access (or no access) depending on the password file parameters.
Incoming mail may be directed to a users' default directory
or to a specific mail directory (specified in the password
file). A typical configuration is to create a mail directory,
SY:MAIL.DSK, and have mail subdirectories for each user. Thus
the path SY:/MAIL/USER1/ specifies the users' unique mail direc-
tory and should be specified in the password configuration. The
local mail programs MAIL.SAV, MMAIL.SAV, and MAILER.SAV and the
remote mail programs RSMTP.SAV and RPOP3.SAV check the password
file to verify that the user has the privilege to send or re-
ceive mail via the network and places any received mail in the
specified mail directory. These programs will use/create a mail
index file in the mail directory which is used to keep an index
of all received mail.
SMTP Server Program
RSMTP is a server program for remote MAIL into TSX-Plus. The
program startup options are:
RSMTP [?] [-hp filespec] [-aeiqrtvz] [parameters]
? List the Help Text and Exit RSMTP
a Attach to Service
e Enable Monitoring of all RSMTP Transactions
h Specify the Help Filespec
i i m IP Validation and Mask
p Specify the Password Filespec
q n Specify an Alternate Connection Port
r Restart RSMTP after Disconnect
t n MAILER Delivery Task Number
v Verbose Mode
z s Inactivity Timeout in Seconds
The RSMTP help file RSMTP.HLP is of diagnostic use only.
The program may be started interactively (for diagnostic pur-
poses) by the command file RSMTP.COM:
run/single TCP:rsmtp
-rptz PAS:/paswrd.dsk/paswrd.fil 1 600 ...
... ^1 ^2 ^3 ^4 ^5 ^6
The program is normally invoked by the TCPIP network server pro-
gram by the command file RSMTP.SRV:
deassign
dismount ld0:
dismount ld1:
dismount ld2:
dismount ld3:
dismount ld4:
dismount ld5:
dismount ld6:
dismount ld7:
assign sy: wf:
mount ld6: dl1:paswrd.dsk
assign ld6: PAS:
mount ld7: dl1:tsxtcp.dsk
assign ld7: TCP:
run/single TCP:rsmtp
-aptz PAS:paswrd.fil 1 600
The service entry in the TCP/IP configuration file reflects the
default RSMTP port of 25. If an alternate port is specified for
RSMTP using the '-q' option then the TCP/IP configuration file
must be changed to match the port selection. A server program
may be configured to respond to multiple TCP/IP ports by creat-
ing a service specification entry / service command file pair
for each additional port.
The specification of device wf: is required by RSMTP to tem-
porarily store incoming mail messages before writing the mail to
the users mail directories. If wf: is undefined, inaccessable,
or not initialized then incoming mail will not be delivered.
The MAIL programs MAIL.SAV, MMAIL.SAV, MAILER.SAV, RPOP3.SAV,
and RSMTP.SAV make use of the password file to restrict access
to the mail system. A user may have local and/or remote MAIL
access (or no access) depending on the password file parameters.
Incoming mail may be directed to a users' default directory
or to a specific mail directory (specified in the password
file). A typical configuration is to create a mail directory,
SY:MAIL.DSK, and have mail subdirectories for each user. Thus
the path SY:/MAIL/USER1/ specifies the users' unique mail direc-
tory and should be specified in the password configuration. The
local mail programs MAIL.SAV, MMAIL.SAV, and MAILER.SAV and the
remote mail programs RSMTP.SAV and RPOP3.SAV check the password
file to verify that the user has the privilege to send or re-
ceive mail via the network and places any received mail in the
specified mail directory. These programs will use/create a mail
index file in the mail directory which is used to keep an index
of all received mail.
... Exit TCP/IP Documentation
... Home Page
Last Updated: June 2008