rmappgroup

Use the rmappgroup command to delete a specific application and its members. If you use the rmappgroup command without the -rmchildren parameter, the application is deleted, and the members are moved up a level in the hierarchy.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoolrmappgroup-user user_name -pwd password -url url -idApplicationGroupID-rmchildren-fs character-header -help-qs character?-silent

Parameters and arguments

-user user_name
Specifies an IBM Spectrum Control user ID.
-pwd password
Specifies the password for the IBM Spectrum Control user ID.
-url url
Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
-id ApplicationGroupID
Specifies the unique ID of the application to be deleted. For example,/Application/5044 where 5044 is the database ID of the application.
-rmchildren
(Optional) Specifies that any members of the application can be deleted. When you use this parameter, any subcomponent that belongs only to the application is removed. If the subcomponent belongs to more than one application, it is removed from the application and not deleted.
-fs character
Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-help | -h | -?
Lists help information for the command.
-qs character
Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
-silent
Suppresses all output for the command. If you omit this parameter, output is included.

Example: Deleting an application and the subcomponents

The following command deletes a specified application and the subcomponents:
tpctool
tpctool> rmappgroup -id /Application/5044 -rmchildren

The following output is returned:

Name                  			Status
==================================
Db2appgroup                 SUCCESS

Example: Deleting an application and moving the subcomponent up a level

The following command deletes a specified application and moves the subcomponent up a level in the hierarchy:
tpctool
 tpctool> rmappgroup -id /Application/5044

The following output is returned:

Name                  			Status
==================================
Db2appgroup                 SUCCESS

If there are no top level applications in the hierarchy, the subcomponents become the top level application.