# PMDF System Manager's Guide

 Previous Next Contents Index

# clbuild

Compile a PMDF command definition file and load the resulting image file into shared memory.

## Syntax

### pmdf clbuild cld-file-spec

Command Qualifiers Defaults
`-debug` `-nodebug`
`-image_file=`file-spec `-noimage_file`
`-maximum` `-nomaximum`
`-option_file=`file-spec `-nooption_file`
`-remove` None
`-sizes` `-nosizes`
`-statistics` `-nostatistics`

### restrictions

Must have superuser privileges (UNIX) or be logged in as Administrator (NT) in order to use this utility.

## Parameters

### cld-file-spec

The file specification of a PMDF command definition file to read as input; e.g., on UNIX `/pmdf/lib/pmdf.cld` or on NT `C:\pmdf\lib\pmdf.cld`.

## Description

The `pmdf clbuild` utility compiles a command line definition file and loads the resulting image file into shared memory.

PMDF ships with a pre-compiled command line definition image so it is not normally necessary to run this utility.

## Command Qualifiers

### `-nodebug` (default)

The `-debug` qualifier causes `pmdf clbuild` to output debug information regarding its operation.

### `-noimage_file` (default)

By default, `pmdf clbuild` does not produce a compiled command definition image file. In order to produce a compiled command definition file, the file to produce must be specified using the `-image_file` qualifier. Note that the PMDF tailor file option PMDF_COMMAND_DATA may be specified as the image file-spec, if the goal is to produce a compiled version of the main PMDF command definition file, `/pmdf/lib/pmdf.cld`.

### `-nomaximum` (default)

The file `/pmdf/table/maximum_command.dat` is read when `-maximum` is 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 `-noimage_file` and `-option_file` qualifiers 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 `-maximum` to 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 ```pmdf clbuild``` invocation.

### `-option_file`[```=< /code>file-spec] ```

``` -nooption_file (default) pmdf 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_file qualifier causes this file to read as input and a new such option file created as output. If -option_file is 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/lib/pmdf.cld was the input parameter, then the default name for the output command option file would be /pmdf/lib/pmdf.cop. If the -nooption_file qualifier is specified (the default), then no option file will be output. Note that use of the -maximum qualifier causes pmdf clbuild to read options from maximum_command.dat in 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 option file. The -noimage_file qualifier should always be specified when -maximum is specified since a maximum-size image would be truly enormous and extremely wasteful. -remove Remove an existant compiled command definition image. Note that the PMDF_COMMAND_DATA name may be used to cause removal of the basic PMDF compiled command definition image, as referenced by this PMDF tailor file option (UNIX) or PMDF Tailor Registry key (NT). -sizes -nosizes (default) The -sizes qualifier instructs pmdf clbuild to output information on the sizes of the uncompiled command definitions. -statistics -nostatistics (default) The -statistics qualifier instructs pmdf clbuild to output information on the compiled command definition image. These numbers give a rough measurement of the efficiency of the compilation, and may indicate whether or not an additional rebuild with the -option_file qualifier is needed. ```
``` EXAMPLES The standard command used to compile the basic PMDF command definition file is on UNIX: # pmdf clbuild -option_file -image_file=PMDF_COMMAND_DATA /pmdf/lib/pmdf.cld or on NT: C:\> pmdf clbuild -option_file -image_file=PMDF_COMMAND_DATA C:\pmdf\lib\pmdf.cld Previous Next Contents Index ```