Clbuild utility

Compile an MTA command definition file and generate an image file (suitable for memory mapping by MTA processes).

Syntax
imsimta clbuild cld-file-spec

Restrictions
Must have superuser privileges or be logged in as the MTA user (see the  option in  )  in order to use this utility.

The file specification of an MTA command definition file to read as input; e.g., on UNIX.

Description
The  utility compiles a command line  definition file and generates a binary file (suitable for memory  mapping by MTA processes).

The MTA ships with any pre-compiled command line definition files it needs so it is not normally necessary to run this utility.

,  (default)
The  switch causes    to output debug information regarding its operation.

,  (default)
By default,  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    switch.

,  (default)
The file  is  read when   is specified. This file specifies near maximum table sizes but does not change any other command option file  parameter settings. Only use this switch if the current table sizes are inadequate. The  and    switches should always be used in  conjunction with this switch---it makes no sense to output the  enormous command definition image that is produced by  , but it does make sense to use    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   invocation.

&#x5b; &#x5d;,   (default)
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   switch causes this file to read as input  and a new such option file created as output. If   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  ; for instance, if the  file   was the input parameter,  then the default name for the output command option file would be. If the   switch is specified (the default), then  no option file will be output. Note that use of the  switch causes    to read options from    in addition to any command option  file. This file specifies near maximum table sizes. Only use this switch if the current table sizes are inadequate, and only use it to  create a new option file. The  switch should always be specified when   is specified  since a maximum-size image would be truly enormous and extremely  wasteful.

Remove an existant compiled command definition image.

,  (default)
The  switch instructs   to output information on the sizes of the uncompiled  command definitions.

,  (default)
The  switch instructs   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   switch is needed.

Examples
The standard command used to compile the basic MTA command definition file on UNIX is: To remove the compiled version of the basic MTA command definitions, use
 * 1) imsimta clbuild -option -image=IMTA_TABLE:advanced/command_data IMTA_LIB:pmdf.cld
 * 1) imsimta clbuild -remove IMTA_TABLE:advanced/command_data

See also:
 * MTA command line utilities