IBM BPM, V8.0.1, All platforms > Install IBM BPM > IBM BPM Advanced for z/OS: Process Server > Configure IBM BPM Advanced for z/OS: Process Server > Configure components > Configure additional components > Configure Process Portal > Configure the Business Space component for Process Portal > Commands (wsadmin scripting) for configuring the Business Space component for Process Portal

uninstallBusinessSpaceWidgets command

Use the uninstallBusinessSpaceWidgets command to remove widgets and widget definitions from the profile, including removing individual widget assets (application, catalog, endpoints, spaces, templates, help).

The uninstallBusinessSpaceWidgets command removes widget files in a designated compressed file or an enterprise archive (EAR) file. The structure of the widget compressed file contains the following items:

• [ear\widgets_ name.ear] one or more EAR files.
• [catalog\catalog_ name.xml]
• [endpoints\*.xml] widget endpoints
• [templates\*.zip] Templates must be in a compressed file and follow IBM Lotus Mashups template format.
• [help\eclipse\plugins\*]

All folders are not required. Empty folders are valid.

If you customized REST endpoint information without using the updateBusinessSpaceWidgets command, those endpoint changes are lost after running the uninstallBusinessSpaceWidgets command.

After using the command, save your changes to the master configuration using one of the following commands:

• For Jython:

  AdminConfig.save()

• For Jacl:

  $AdminConfig save

If the application server is not running, supply the -conntype NONE option when running this command.

Required parameters

-serverName server_name

A parameter that specifies the server name for the configuration. For configuring Business Space on a server, you must specify both a serverName and a nodeName.

-nodeName node_name

A parameter that specifies the node name for the configuration. For configuring Business Space on a server, you must specify both a serverName and a nodeName.

-clusterName cluster_name

A parameter that specifies the cluster name for the configuration. For configuring Business Space on a cluster, you must specify a clusterName.

-widgets widgets_path

A parameter that specifies one of the following:

• the full path for the directory that contains the compressed files or the widget EAR files that contain the widgets. If you specify a directory, all widgets will be installed for all compressed files and EAR files in that directory.
• the full path to an individual compressed file that contains the widgets.
• the full path to an individual EAR file that contains the widgets.

Optional parameters

–save true|false

A parameter that indicates saving your configuration changes. The default value is true.

Example

The following example uses the uninstallBusinessSpaceWidgets command to remove widgets from a cluster.

The examples are for illustrative purposes only. They include variable values and are not meant to be reused as snippets of code.

• Jython example:

  AdminTask.uninstallBusinessSpaceWidgets('[-clusterName
    cluster_name -widgets X:/WPS/Temp]')

• Jacl example:

  $AdminTask uninstallBusinessSpaceWidgets {-clusterName 
   cluster_name -widgets X:/WPS/Temp}

Commands (wsadmin scripting) for configuring the Business Space component for Process Portal

Related information:

Obtaining online help using wsadmin scripting
Administrative command invocation syntax using wsadmin scripting
Use the wsadmin scripting tool
Jython script library