Defining a project area by using the command line

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.

Before you begin

Be sure to have your completed configuration checklist available.

About this task

You can assign specific solutions and users to each project area. Each user can belong only to one project area and the default project area. Users can define and modify solutions only in the project area that they are assigned to. Users who are not assigned to a project area cannot log into Case Builder.

When you define a project area, you are prompted to select a connection point for use with the target object store for the new project area. After you define the project area, you have the option to reuse a target object store and its associated connection point when you define another project area. Do not reuse a target object store and connection point.

Procedure

To define a project area:

Change the current directory to the install_root/CaseManagement/configure directory. Where install_root is the location where IBM Business Automation Workflow is installed.
Run the following command. Do not enter any line breaks when you enter the command.
```
configmgr_cl defineProjectArea 
 -profile myprofile
 -projectAreaName project_area_name
 -projectAreaDesc project_area_description
 -peConnPt connection_point_name
[-help]
```
-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.

-help

Optional and displays a brief message on the command syntax instead of running the command.

What to do next

You can assign users and solutions to the project area.