PMDF Installation Guide
OpenVMS Edition
PMDF-INST-VMS-6.0

If you are upgrading from an earlier version of PMDF and have been using one of PMDF's older single-threaded, TCP/IP-package-specific, TCP/IP channels, you must convert to using the new, higher performance multithreaded TCP/IP channel as the old single-threaded channels are no longer provided. The steps in converting to using the multithreaded SMTP server are as follows:

• Modify your PMDF configuration file, PMDF_TABLE:pmdf.cnf, by converting any old xtcp_* channels to tcp_* channels. For instance, if you previously had channel definitions

   
  ptcp_local smtp single_sys mx 
  PTCP-DAEMON 
   
  ptcp_internal smtp single_sys mx 
  PTCP-INTERNAL 
   
  

  you should modify your configuration to be

   
  tcp_local smtp single_sys mx 
  PTCP-DAEMON 
   
  tcp_internal smtp single_sys mx 
  PTCP-INTERNAL 
   
  

• If using a compiled PMDF configuration, recompile and reinstall it to get these configuration changes to take effect.
• Disable the old single threaded, TCP/IP-package-specific, PMDF SMTP server, as discussed in more detail below.
• Configure the PMDF Dispatcher, as described in Chapter 9 and Chapter 10 .
• Once the Dispatcher is configured, start it up with the command

  $ PMDF STARTUP DISPATCHER
  

  Starting the Dispatcher will start up the new, multithreaded SMTP server.
• Note that if there are any old, existing processes on your system that have been submitting messages to the old xtcp_* channels, such old processes may continue to try to submit to the old channel until the old process terminates. So unless you are making this configuration change on a system that has no other users or processes, you will need to keep an eye out for new message files appearing in the old PMDF_QUEUE:[xtcp_*] directories as long as the old processes continue to run. If you see any such message files showing up, then to get such messages delivered you will need to manually move the message files to the corresponding new PMDF_QUEUE:[tcp_*] directories, making sure to change the filename slightly in the process (say from *.00 to *.01), and issue the command

  $ PMDF CACHE/SYNCH
  

  The messages will then get delivered the next time the PMDF periodic delivery job runs. Or if you wish them to get an immediate delivery attempt, you can release the PMDF periodic delivery job which should be holding in the MAIL$BATCH queue.

  Disabling a PMDF UTCP SMTP server
  

  To disable a previous PMDF UTCP channel's SMTP server, issue the commands:

  $ UCX
  UCX> DISABLE SERVICE SMTP
  UCX> SET NOSERVICE SMTP
  UCX> SET CONFIGURATION DISABLE SERVICE SMTP
  UCX> EXIT
  

  If your site was previously using the PMDF UCX_SMTPD dispatcher, you must also delete that process; it will have a process name of UCX/PMDF server. Also remove any command from your system startup that starts up that process; e.g., remove any commands such as

  $ @PMDF_COM:start_ucx_smtpd.com 
  

  Disabling a PMDF PTCP SMTP server
  

  To disable a previous PMDF PTCP's channel SMTP server, issue the commands:

  $ RUN TCPWARE:netcu
  NETCU REMOVE SERVICE 25 TCP
  NETCU EXIT
  

  Or if you are running Process Software TCPware TCP/IP V5.3, you may disable the SMTP server using the interactive configuration tool

  $ @TCPWARE:CNFNET TCP
  

  by answering NO to the question regarding using the SMTP server, along the lines of:

  Do you want to use the SMTP Mail Transfer Agent? 
  

  Once you have disabled the SMTP server native to Process Software TCPware TCP/IP, or a previous PMDF PTCP channel, TCPware should then be shutdown and restarted with the commands:

  $ @TCPWARE:shutnet.com
  $ @TCPWARE:startnet.com
  

  If you have TCPware installed in a cluster environment you must restart TCPware on every node in the cluster to ensure that each node knows about the change.

  Disabling a PMDF MTCP SMTP server
  

  To disable a previous PMDF MTCP channel's SMTP server, issue the commands:

  $ MULTINET CONFIGURE/SERVERS
  SERVER-CONFIG> DISABLE SMTP
  SERVER-CONFIG> RESTART
  SERVER-CONFIG> EXIT
  

  If you have MultiNet installed in a cluster environment you must restart MultiNet on every node in the cluster to ensure that each node knows about the change.

  Disabling a PMDF WTCP SMTP server
  

  To disable a previous PMDF WTCP channel's SMTP server, edit the PathWay Access servers.dat database and comment out the SMTP service definition. For instance, such a commented out definition might appear as follows, if PMDF had previously been using a single threaded PathWay TCP/IP channel:

  # SMTP 
  # service-name    Smtp 
  # program         PMDF_EXE:WTCP_SLAVE.EXE 
  # socket-type     SOCK_STREAM 
  # socket-options  SO_ACCEPTCONN | SO_KEEPALIVE 
  # socket-address  AF_INET , 25 
  # working-set     1024 
  # maxservers      4 
  # priority        4 
  # INIT            TCP_Init 
  # LISTEN          TCP_Listen 
  # CONNECTED       TCP_Connected 
  # SERVICE         Run_Program 
  

  Next delete the INET_SERVERS process. Restart the INET_SERVERS process by issuing the command

  $ @TWG$TCP:[NETDIST.MISC]INETSERV.COM
  

  ---

  Previous | Next | Contents