Compile a PMDF command definition file into an OpenVMS shareable image.
PMDF CLBUILD cld-file-spec
Command Qualifiers Defaults /DEBUG /NODEBUG /IMAGE_FILE=file-spec /NOIMAGE_FILE /MAXIMUM /NOMAXIMUM /OPTION_FILE=file-spec /NOOPTION_FILE /SIZES /NOSIZES /STATISTICS /NOSTATISTICS
cld-file-specThe file specification of a PMDF command line definition file to read as input, e.g.,
CLBUILDutility compiles a command line definition file into an OpenVMS shareable image. The resulting image can then be installed with the OpenVMS
PMDF ships with a pre-compiled command line definition image so it is not normally necessary to run this utility.
CLBUILDto output debug information regarding its operation.
/NOIMAGE_FILE (default)By default,
CLBUILDdoes not produce a compiled command definition file. In order to produce a compiled command definition file, the file to produce must be specified using the
/IMAGE_FILEqualifier. Note that the logical name
PMDF_COMMAND_DATAmay be specified as the image file-spec, if the goal is to produce a compiled version of the main PMDF command definition file,
/NOMAXIMUM (default)The file
PMDF_TABLE:maximum_command.datis read when
/MAXIMUMis specified. This file specifies near maximum table sizes but does not change any other command option file parameter settings. Only use this qualifier if the current table sizes are inadequate. The
/OPTION_FILEqualifiers should always be used in conjunction with this qualifier---it makes no sense to output the enormous command definition image that is produced by
/MAXIMUM, but it does make sense to use
/MAXIMUMto get past size restrictions in order to build a properly sized command option file so that a properly sized command definition image can be built with a subsequent
/NOOPTION_FILE (default)CLBUILD can optionally produce a command option file that contains correct table sizes to hold the command definitions which were just compiled (plus a little room for growth). The
/OPTION_FILEqualifier causes this file to be read as input and a new such option file created as output. If
/OPTION_FILEis specified with no value, then the file written will have the same name as the input command definition file, but with the file extension
.cop; for instance, if the file
PMDF_COM:pmdf.cldwas the input parameter, then the default name for the output command option file would be
PMDF_COM:pmdf.cop. If the
/NOOPTION_FILEqualifier is specified (the default), then no option file will be output. Note that use of the /MAXIMUM qualifier causes
CLBUILDto read options from
maximum_command.datin addition to any command option file. This file specifies near maximum table sizes. Only use this qualifier if the current table sizes are inadequate, and only use it to create a new command option file. The
/NOIMAGEqualifier should always be specified when
/MAXIMUMis specified since a maximum-size image would be truly enormous and extremely wasteful.
PMDF CLBUILDto output information on the sizes of the uncompiled command definitions.
CLBUILDto output information on the compiled conversion tables. These numbers give a rough measurement of the efficiency of the compilation, and may indicate whether or not an additional rebuild with the
/OPTION_FILEqualifier is needed.
The standard commands used to compile the basic PMDF command definition file and restart PMDF to use it, plus update the system DCL tables, are:
$ PMDF CLBUILD/OPTION_FILE/IMAGE_FILE=PMDF_COMMAND_DATA PMDF_COM:pmdf.cld $ INSTALL REPLACE PMDF_COMMAND_DATA $ SET COMMAND/TABLE=SYS$COMMON:[syslib]dcltables.exe - _$ /OUTPUT=SYS$COMMON:[syslib]dcltables.exe PMDF_COM:pmdf.cld $ INSTALL REPLACE SYS$LIBRARY:dcltables.exe