PMDF System Manager's Guide


Previous Contents Index

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, a shareable image is created that is suitable for use on the architecture that you ran cnbuild on (VAX, Alpha, or I64). To generate shareable images for the other architectures, you must run cnbuild on systems of each of those other architectures.

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


Previous Next Contents Index