PMDF System Manager's Guide

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

1. 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.
2. 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.
3. Add rewrite rules to your PMDF configuration. Now, suppose that the local cc:Mail post office is named EXAMPLE and the official local host name for the system running PMDF is EXAMPLE.COM. Then, a suitable domain name to associate with the EXAMPLE post office might be ccmail.example.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.example.com ccmail.example $u%ccmail.example.com ccmail.example.com $u@ccmail.example.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.

4. 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.example.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.

5. 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

6. 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.EXAMPLE.COM

   or from VMS MAIL using the address:

   IN%"'Smith, John'@CCMAIL.EXAMPLE.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.EXAMPLE.COM'

   or from Pine using the address

   "Smith, John"@CCMAIL.EXAMPLE.COM

7. 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 EXAMPLE 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.

8. Sending a test message from cc:Mail. Address mail to the PMDF post office with an address such as

   jsmith@example.com AT PMDF

9. 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

10. Process the cc:Mail export file. The last step produces the file ccmail.exp which should appear in the shared directory where PMDF can 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.

11. 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 EXAMPLE password \CCADMIN\EXPORT FILES/HEX FORMAT/FAN PMDF password \PMDF\DELAY 10min GOTO LOOP