You can provision an instance of an application to develop and test your program code that uses the objects in the application. A provisioned application instance is a copy of the objects in the original application. You can safely make changes to the objects in the provisioned instance without affecting the original objects of an application.
Before you begin
Before you can provision an instance of an application, a super administrator must register subsystems that contain the application objects, create a team and an environment, assign you to the team, create the application, and assign a team to the application.
You can provision instances of any application. However, in order to edit objects in the provisioned instance and to create pull requests for that instance, you must be a member of the team that owns the application.
Procedure
To provision an instance, complete the following steps:
-
On the navigation menu, select .
-
On the application that you want to provision, click Details.
-
In the application details page, click Provision instance.
Notes: Instead of these steps, you can alternatively open the
Provision instance dialog, as follows:
- On the navigation menu, select .
- Click Provision instance.
-
In the Provision instance dialog, specify the following fields:
- Instance name
- Type the name of the new instance.
-
Notes:
- The name cannot have leading or trailing spaces, as well as special characters such as <, >, /, \, or a period. The period is supported only after IBM® Unified Management Server for z/OS® 1.2.0.13 (UO05306) release.
- The instance name is case-insensitive; that is, lowercase and uppercase letters are not distinguished.
- Subsystem type
- If you open this dialog from the application details page, the subsystem type of the selected application is preset in this field. Otherwise, select a subsystem type to filter the applications that will be shown in the pull-down list of the Application name field.
- Application name
- If you opened this dialog from the application details page, the name of the selected application is preset in this field. Otherwise, select the application from which you want to provision an instance.
If the application is a Db2 application and a limit is set on the total size of all the instances for the application and the limit has already reached, you cannot provision that application.
- Include data from source application
- Select this checkbox if you want to include data from the source application.
- Team
- Select the team under which the instance is to be provisioned. If you are a member of multiple teams, you must specify which team you are provisioning the instance for.
If you are provisioning an instance from a Db2® application, storage limits can be placed on teams.
- Environment
- Select the environment to which you want to provision the instance.
If an instance limit is set for the environment and the limit has already reached, you cannot provision an instance for this environment.
- Additional instance owners
- This drop-down menu lists all the members of the team that you specified in the Team field. Select the users that you want to add as owners of this instance. You will be the default owner of this instance.
-
Click Provision.
The provisioning process might take a while. After the instance is provisioned, it will be displayed on the Instances page. Your instances are also displayed on the Dashboard page.
-
On the instance that has just been provisioned, click Details.
You will see the objects that are included in the provisioned instance.
What to do next
- Optionally, you can use the built-in SQL processor to run an SQL query against an application object in the instance to verify successful provisioning.
- After you have provisioned the instance, you can rename it by using the Update instance fields API. You can use the same API to add or remove the owners of this instance. To know how to use the API, see the Swagger documentation.