PMDF System Manager's Guide

8.1.1 Compiling the Configuration on OpenVMS

The PMDF CNBUILD utility on OpenVMS is used to compile a PMDF configuration (configuration file, alias file, PMDF option file, mapping file, conversion file, security configuration file, and system wide filter file). After you are satisfied with your configuration file, alias file, option file, mapping file, conversion file, security configuration file, and system wide filter file, issue the OpenVMS command

$ PMDF CNBUILD

to compile your configuration into a loadable, shareable image. The alias, option, mapping, conversion, security configuration, system wide filter, and configuration files will be read and the compiled configuration image will be created. Any errors detected in the files will be reported and will cause the compilation to abort without producing an image.

When CNBUILD is run on a VAX platform, an image suitable for use with OpenVMS VAX will be created; when run on an AXP (Alpha) platform, an OpenVMS AXP image is produced. Use the /ALPHA or /VAX qualifiers to specifically generate an Alpha or VAX image if you are executing the command on a system of the other type.

Once the image has been produced it must be installed for proper operation:

$ INSTALL CREATE PMDF_CONFIG_DATA/OPEN/SHARED/HEADER

If the image already exists and is being updated, use the command:

$ INSTALL REPLACE PMDF_CONFIG_DATA

In a cluster environment, the image should be replaced on every system that is running PMDF. You may also want to purge old copies of the image in PMDF_EXE:, since the files are fairly large.

At system startup, the PMDF startup procedure will install the PMDF_CONFIG_DATA image if one exists. There is no need to add the INSTALL command shown above to your system startup procedure.

Refer to Chapter 30 for complete details on the use of the CNBUILD utility.

Note

As always when there is a change to the PMDF configuration, e.g., a new compiled configuration, any resident PMDF processes such as the multithreaded SMTP server, POP3 server, IMAP server, BN_SLAVE, or FAX_RECEIVE should be restarted with the PMDF RESTART command. Also, if you run PMDF-MR, use the MR_NOTIFY feature of the Process Symbiont, and have modified the mr_local channel, then you need to STOP/QUEUE/RESET and then START/QUEUE your Process Symbiont queues. Or if you use PMDF-MR for MR TS replacement, then stop and restart your All-in-1 Sender, All-in-1 Fetcher, and MailWorks server.

Contents

Index