VMS Help  —  PRODUCT  PACKAGE  Qualifiers  /MATERIAL
       /MATERIAL=(path-name[,...])

    Specifies one or more locations in which the utility can search
    for product material files to include in the software product
    kit. Material files represent the output of the producer's
    software engineering process, that is, all files that make up
    the software product, including any command procedures that might
    be used during installation.

    Note that the location of the PDF and PTF are not specified
    with the /MATERIAL qualifier. See the /SOURCE qualifier for more
    information.

    This is a required qualifier for the PRODUCT PACKAGE command.
    Parentheses (())  are optional only when you specify a single
    path name. They are required when you specify multiple path
    names.

    The format for path-name is: device-name:[directory-name]

    You can specify path-name as a:

    Specific       Only one directory is searched.
    directory

    Wildcard       The directory name includes one or more of the
    directory      wildcard characters asterisk (*),  percent sign
                   (%),  or ellipsis (...). All directories that
                   satisfy the wildcard specification are searched.

    Root           A period (.)  following the directory name
    directory      indicates a root directory specification. For
                   example, TEST$:[ABC.FT2.] is combined with
                   the relative file specification from the FILE
                   statement in the PDF to locate the file during
                   packaging.

    When the path-name contains a root directory, the utility appends
    the relative file specification from the FILE statement in the
    PDF to the root directory to determine where to find the file.
    However, when either a specific directory or a wildcard directory
    is used in the path-name, the relative file specification from
    the FILE statement is not used to find the file. Instead, the
    directory as specified in the /MATERIAL qualifier is used to
    search for the file.

    Note that when you use either a wildcard directory or a list of
    path names, if files in different directories have the same name,
    only the first file in the search path is packaged in the kit.
    As a result, the same file is packaged each time a FILE statement
    refers to the file name because the relative file specification
    is not used to identify the file uniquely. Therefore, if your
    product has different files with the same name in different
    directories, you must use the root directory form of the path-
    name to package these files correctly.

    In general, using a specific directory or a root directory
    is more efficient than a wildcard directory. When packaging
    a product that contains hundreds of files, you might notice
    a significant difference in processing time, depending on the
    method you use to specify the path name. The choice of material
    path name does not affect the time required to install the kit.
Close Help