createprod - Create Product Line

createprod [-dk] [-v displayoptions] productline

createprod [-dk] -p product [-r release] -N newbranchname] [-v displayoptions] productline

createprod [-dk] -p product -b branch [-m markname] [-v displayoptions] productline

createprod creates the basic directory structure of your product line and the necessary files for it to operate. It also creates a customization branch by default, to which any changes to the local product line may be checked in.

Program Option Description
-p {product | extended_ description}

Specifies a product to view information for. You can specify the product in either product or extended_description format, where:

  • product is the product name.

    Example: createprod -p LMHCM_100001 -r 10.0.1.0

    and

  • extended_description takes the format

    product:release

    Use this to identify a product without specifying -r.

    Example: createprod -p LMHCM_100001:10.0.1.0. This is useful for specifying multiple products.

See table below for interaction of the -p option with -b.

-d Analyzes dependencies.
-r release

Specifies a release. If neither a release or branch name is given, then the most recent release of the product will be used.

See -p description for a way this can be omitted.

-b branch

Specifies a branch. If neither -r release nor -N branchname is specified, then the most recent release of the product will be used.

See table below for interaction of this option with -p.

-k Invokes a dialog box that let you edit repository credentials. Press Enter to accept the credentials shown.
-m markname Specifies a marked point on a branch.
-N branchname Allows you to name the customization branch that is created for a product line. If you do not use -N to name it, then createprod generates a branch name called productline_BRANCH
productline Names the product line being created. Product line names should be composed of lower case letters and digits. They should be less than or equal to 14 characters in length.
-v displayoptions

errorlevel, tracelevel, and verbose specified in any order, where:

  • errorlevel = {n}one | {f}atal | {e}rror | {w}arning (warning is the default)

  • tracelevel = 0:6 where 0 is no message and 6 is everything

  • verbose = whether to display exception stacktrace

Interaction of -p and -b

Use the following information as a guide in determining when to specify -p product and -b branch options.

Presence of -p Presence of -b Result
No No Creates a default local product line that is unconnected to the repository. This is for use with the development of a new application.
No Yes Error. Product is unknown, so cannot recognize branch.
Yes No Creates a new customization branch whose root is the specified product (and release and build, if also specified).
Yes Yes Retrieves the customized branch (and mark, if specified) into a new product line and creates a customization branch.