PMDF System Manager's Guide
PMDF-REF-6.0

In this section, a cook book approach is used to demonstrate how to set up a cc:Mail configuration.

• Select a transport. In this example, we choose to use Pathworks to share a directory between the system running PMDF and the cc:Mail system running the Import/Export utility. On the PC running cc:Mail there are the three cc:Mail directories \CCADMIN, \CCMAIL, and \CCDATA on F:. Also, there is the directory \PMDF which is mapped to the directory diska:[ccmail.pmdf] on the system running PMDF. This is the directory which PMDF will use to communicate with cc:Mail.
• Establish a cc:Mail post office for PMDF. Your cc:Mail users will send mail to PMDF by addressing their messages to a cc:Mail post office. Messages to PMDF are then exported from this post office with the cc:Mail Import/Export utility. We shall use the name PMDF for this post office. Using the cc:Mail ADMIN utility, enter PMDF as the name, and enter P for post office for its location. This creates the PMDF post office.
• Add rewrite rules to your PMDF configuration. Now, suppose that the local cc:Mail post office is named ACME and the official local host name for the system running PMDF is ACME.COM. Then, a suitable domain name to associate with the ACME post office might be ccmail.acme.com. You need rewrite rules in your PMDF configuration file corresponding to these values. The PMDF-LAN configuration utility would create a file lan.rules of such rules, suitable for inclusion into the PMDF configuration file;if you have run it, you need merely uncomment the reference to lan.rules, Otherwise, edit the PMDF configuration file, PMDF_TABLE:pmdf.cnf (OpenVMS) or /pmdf/table/pmdf.cnf (UNIX), to include the rewrite rules:

  ccmail                      $u%ccmail.acme.com 
  ccmail.acme                 $u%ccmail.acme.com 
  ccmail.acme.com             $u@ccmail.acme.com 
  

  Add these rules towards the top of the file. They must appear before the first blank line in the file. Also, be sure to not introduce any blank lines to the file at this stage.
• Define the cc_local channel. The PMDF-LAN configuration utility would create a file lan.chans defining such a channel, suitable for inclusion into the PMDF configuration file;if you have run it, you need merely uncomment the reference to lan.chans. Otherwise, add the following channel definition to the pmdf.cnf file. To the very end of the file, add a blank line followed by these two lines:

  cc_local master defragment charset8 ibm437 
  ccmail.acme.com 
  

  When you have finished adding these lines, save the configuration file. If you are using a compiled configuration, then be sure to recompile and reinstall your configuration.
• Create the option file. The PMDF-LAN configuration utility would create a suitable file cc_local_option; if you have run it, you need do nothing at this step. Otherwise, create the world readable file cc_local_option in the PMDF table directory,⁵ containing lines such as shown here for OpenVMS

  ! An OpenVMS cc_local_option file 
  CC_GATEWAY_NAME=PMDF 
  CC_OUTPUT_FILE_NAME=DISKA:[CCMAIL.PMDF]CCMAIL.IMP 
  CC_INPUT_FILE_NAME=DISKA:[CCMAIL.PMDF]CCMAIL.EXP 
  CC_UNDEL_FILE_NAME=DISKA:[CCMAIL.PMDF]CCMAIL.UND 
  

  or such as shown here for UNIX

  ! A UNIX cc_local_option file 
  CC_GATEWAY_NAME=PMDF 
  CC_OUTPUT_FILE_NAME=/diska/ccmail/pmdf/ccmail.imp 
  CC_INPUT_FILE_NAME=/diska/ccmail/pmdf/ccmail.exp 
  CC_UNDEL_FILE_NAME=/diska/ccmail/pmdf/ccmail.und 
  

• Send a test message. At this point you should be able to send mail back and forth. If the PMDF system is an OpenVMS system, you can send mail from PMDF MAIL to the cc:Mail user "Smith, John" using the address

  "Smith, John"@CCMAIL.ACME.COM 
  

  or from VMS MAIL using the address:

  IN%"'Smith, John'@CCMAIL.ACME.COM" 
  

  If the PMDF system is a UNIX system, you can send mail to the same cc:Mail user using the address

  '"Smith, John"@CCMAIL.ACME.COM' 
  

  or from Pine using the address

  "Smith, John"@CCMAIL.ACME.COM 
  

• Process the cc:Mail import file. The previous step will result in PMDF producing a cc:Mail import file. This file will be that specified with the CC_OUTPUT_FILE_NAME option in the cc_local_option file of Step 5. Import this file into cc:Mail using the DOS commands:

  CD \PMDF 
  \CCADMIN\IMPORT FILES/HEX ACME password
  

  where password is the administrative password for the cc:Mail postoffice. At this point the test message should appear in the cc:Mail user's mailbox.
• Sending a test message from cc:Mail. Address mail to the PMDF post office with an address such as

  jsmith@acme.com AT PMDF 
  

• Export the cc:Mail messages for the PMDF post office. As a result of the previous step, there should now be a mail message waiting to be exported for the PMDF post office. Export this message with the DOS commands

  CD \PMDF 
  \CCADMIN\EXPORT FILES/HEX FORMAT/FAN PMDF password
  

• Process the cc:Mail export file. The last step produces the file ccmail.exp which should appear in the shared directory where PMDF may access it. On OpenVMS use the command

  $ @PMDF_COM:master cc_local poll
  

  or on UNIX use the command

  # pmdf run cc_local poll
  

  to get PMDF to pickup and process this file now.
• Automate the process. The PMDF-LAN configuration utility would create a command procedure called PMDF_COM:pc_post.com (OpenVMS) or shell script /pmdf/bin/pc_post suitable for automating the PMDF side of this process; or see Section 38.2.2 for several ways to automate the polling process on the PMDF side. On the PC side, you should create a file such as the following XFER.BAT file, and run the .BAT file on your PC.

  F: 
  CD \PMDF 
  :LOOP 
  \CCADMIN\IMPORT FILES/HEX ACME password
  \CCADMIN\EXPORT FILES/HEX FORMAT/FAN PMDF password
  \PMDF\DELAY 10min 
  GOTO LOOP 
  

  ---

  Note

  ⁵ I.e., create the file PMDF_TABLE:cc_local_option. on OpenVMS or /pmdf/table/cc_local_option on UNIX.

  ---

  ---

  Previous | Next | Contents