HELPLIB.HLB  —  MMS  Qualifiers  /DESCRIPTION
    /DESCRIPTION[=filespec...](D)
    /NODESCRIPTION target

    Controls whether MMS looks for a description file to update the
    target. These qualifiers affect the behavior of MMS, but not the
    execution of action lines.

    The filespec is an OpenVMS file specification or a logical name
    that identifies the description file. The default file type is
    .MMS. If a tilde (~)  follows the file specification, MMS fetches
    the description file from the default CMS library even if the
    description file exists in the default directory. The target is
    an OpenVMS file specification or a mnemonic name that designates
    the target to be built.

    When you specify more than one description file, separate the
    file specifications with either commas (,)  or plus signs (+)  and
    enclose them in parentheses or quotation marks.

    If you use commas, the description files are processed separately
    and the list of files must be enclosed in parentheses. For
    example:

    $ MMS/DESCRIPTION=(A, B)

    If you use plus signs, the description files are concatenated
    and processed as one file. The list of files must be enclosed in
    quotation marks. For example:

    $ MMS/DESCRIPTION="A + B"

    You can combine separate description files with description files
    to be concatenated and processed as one file. For example:

    $ MMS/DESCRIPTION=("A + B", CLEANUP)

    This command line directs MMS to process A.MMS and B.MMS as
    one file, and CLEANUP.MMS as another. In this case, there are
    two default targets: the first one is in either A.MMS or B.MMS
    (depending on the contents of the two files) and the second one
    is in CLEANUP.MMS.

    If you specify a list of description files in parentheses and a
    list of targets, the rules for updating all the listed targets
    must occur in all the listed description files. For example:

    $ MMS/DESC=(A,B) X,Y,Z

    In this case, the rules for updating X, Y, and Z must appear in
    both description files, A.MMS and B.MMS.

    If you specify a concatenated list of description files and a
    list of targets, the rules for updating all the listed targets
    must occur in the concatenated description file. For example:

    $ MMS/DESC="A + B" X,Y,Z

    In this case, the description file formed by the concatenation of
    A.MMS and B.MMS must contain the rules for updating X, Y, and Z.

    If you specify the /DESCRIPTION qualifier without a file
    specification or if you do not specify /DESCRIPTION, MMS looks
    first for the default description file DESCRIP.MMS. If it cannot
    locate that file, it looks for one called MAKEFILE.; if it
    cannot find MAKEFILE., it looks for target-name.MMS. If MMS
    finds target-name.MMS, it does not update the first target in
    the description file, but instead attempts to directly update the
    target indicated by target-name.MMS. For example:

    $ MMS MAIN.EXE

    In this example, if DESCRIP.MMS and MAKEFILE. are not present,
    MMS looks for a file named MAIN.MMS. If MAIN.MMS exists, MMS
    directly processes the target you specified on the command
    line, MAIN.EXE.

    If MMS cannot find any one of these files, it attempts to use
    built-in rules to build the target.

    If you use the /NODESCRIPTION qualifier, you must specify a
    target on the command line. /NODESCRIPTION directs MMS to ignore
    all description files and to build the target specified on the
    command line.

    For information on using the /DESCRIPTION qualifier with the
    description-file generator, refer to the /GENERATE qualifier.
Close Help