rmdeptgroup

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

Syntax

Read syntax diagramSkip visual syntax diagramtpctoolrmdeptgroup-user user_name -pwd password -url url -idDepartmentGroupID-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 DepartmentGroupID
Specifies the ID of the department to be deleted.
-rmchildren
(Optional) Specifies that any members of the department are be deleted. When you use this parameter, any member that belongs only to the department is removed. If the members belong to more than one department, they are removed from the department 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 a department and the subdepartments

The following command deletes a specified department and the subdepartments:
tpctool
tpctool> rmdeptgroup -id /Department/5041 -rmchildren

The following output is returned:

Name                    Status
==================================
Accounting               SUCCESS

Example: Deleting a department and moving the subdepartment up a level

The following command deletes a specified department and moves any subdepartments up one level in the hierarchy:
tpctool
tpctool> rmdeptgroup -id /Department/5041

The following output is returned:

Name                    Status
==================================
Accounting               SUCCESS

If there are no top level departments in the hierarchy, the subdepartment or subdepartments become the top level department.