defineProjectArea command
The defineProjectArea command defines a new project area for the development environment. You use project areas to limit the effects of resetting the test environment. You can define new project areas or define a default project area if you did not run the Define the Default Project Area task when you configured IBM® Business Automation Workflow.
Syntax
The following syntax includes line
breaks to format the command for reading. Enter the command and options
on a single line without any line breaks.
configmgr_cl defineProjectArea
-profile myprofile
-projectAreaName project_area_name
-projectAreaDesc project_area_description
-peConnPt connection_point_name
[-silent] [-force] [-help]Parameters
- -profile myprofile
- Specifies the development profile that is associated with the project area. The object store and
Content Platform Engine properties from the
profile are used to create the project area. The myprofile value can be one of
the following items:
- The name of the profile, such as develop1. The profile is located in the install_root/CaseManagement/configure/profiles directory. install_root is the location where IBM Business Automation Workflow is installed.
- The full path to the profile directory, such as "install_root\CaseManagement\configure\profiles\develop1" or /install_root/CaseManagement/configure/profiles/develop1.
- The full path to the profile input file, such as "install_root\CaseManagement\configure\profiles\develop1\develop1.cfgp" or /install_root/CaseManagement/configure/profiles/develop1/develop1.cfgp.
- -projectAreaName project_area_name
- The name of the project area. The default project area is named dev_env_connection_definition. The name can contain up to 255 characters. If the name includes a space, put the name in double quotation marks, for example, "Credit Dispute Area". The name cannot contain any of the following characters: \ / : * ? " < > |
- -projectAreaDesc project_area_description
- The description can contain up to 255 characters. If the description includes a space, put the description in double quotation marks, for example, "Solutions for credit card disputes".
- -peConnPt connection_point_name
- The connection point to use with this project area.
- -silent
- Optional: When you specify the -silent parameter, no prompts or informational messages are shown in the console, but the errors are written to the log. Failure messages and validation error messages are shown as needed, such as messages about missing passwords or invalid port numbers. If you run the execute command to run all the activities in a profile and you specify the -silent parameter, you must also specify the -force parameter.
- -force
- Optional and applies only when the -silent parameter is used. When you specify the -force parameter, the activity is run without pausing for required responses to validation error messages, such as messages about missing passwords or invalid port numbers.
- -help
- Optional: Shows a brief message on the command syntax instead of running the command.
Sample commands
The following examples include
line breaks to format the command for reading. Enter the command and
options on a single line without any line breaks.
- Define the default project area.
- The following command defines the default project area for the
development environment that was configured with the myDevelop1 profile:
configmgr_cl defineProjectArea -profile myDevelop1 -projectAreaName dev_env_connection_definition -projectAreaDesc "Default project area for myDevelop1" -peConnPt connpoint1 [-silent] [-force] - Define a new project area.
- The following command defines the new project area CreditDisputeArea
for the development environment that was configured with the myDevelop1
profile:
configmgr_cl defineProjectArea -profile myDevelop1 -projectAreaName CreditDisputeArea -projectAreaDesc "Credit card dispute project area for myDevelop1" -peConnPt connpoint1 [-silent] [-force] - Show the help for the defineProjectArea command.
- The following command shows the help for the defineProjectArea command:
configmgr_cl defineProjectArea -help