Library /sys$common/syshlp/helplib.hlb  —  PMDF  CLBUILD
    Compile a PMDF command definition file into an OpenVMS shareable
    image.

    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
    /SIZES                         /NOSIZES
    /STATISTICS                    /NOSTATISTICS

1  –  Parameters 

 cld-file-spec

    The file specification of a PMDF command line definition file to
    read as input, e.g., PMDF_COM:PMDF.CLD

2  –  Description 

    The CLBUILD utility compiles a command line definition file
    into an OpenVMS shareable image. The resulting image can then
    be installed with the OpenVMS INSTALL utility.

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

3  –  Command Qualifiers

3.1    /DEBUG 

       /DEBUG
       /NODEBUG (default)

    The /DEBUG qualifier causes CLBUILD to output debug information
    regarding its operation.

3.2    /IMAGE_FILE 

       /IMAGE_FILE=file-spec
       /NOIMAGE_FILE (default)

    By default, CLBUILD does 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_FILE qualifier. Note that the logical name 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_COM:PMDF.CLD.

3.3    /MAXIMUM 

       /MAXIMUM
       /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 CLBUILD invocation.

3.4    /OPTION_FILE 

       /OPTION_FILE[=file-spec]
       /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_FILE qualifier causes this file to be 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_COM:PMDF.CLD was
    the input parameter, then the default name for the output command
    option file would be PMDF_COM: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 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 command option file. The /NOIMAGE
    qualifier should always be specified when /MAXIMUM is specified
    since a maximum-size image would be truly enormous and extremely
    wasteful.

3.5    /SIZES 

       /SIZES
       /NOSIZES (default)

    The /SIZES qualifier instructs PMDF CLBUILD to output information
    on the sizes of the uncompiled command definitions.

3.6    /STATISTICS 

       /STATISTICS
       /NOSTATISTICS (default)

    The /STATISTICS qualifier instructs CLBUILD to 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_
    FILE qualifier is needed.

4  –  Examples 

      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
Close Help