unassignvol

Use the unassignvol command to remove the host ports from the assignment list for a volume. You must have Administrator authority to use this command.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoolunassignvol-user user_name -pwd password -url url -hphost_port-f-fs character-devGUID-header -help-qs character?-silentvolume_id-

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.
-hp host_port
Specifies the host ports. The host_port variable is a comma-separated list of worldwide port numbers (WWPNs).
-f
Turns off the confirmation message that is displayed before the ports are removed from the assignment list.
-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.
-dev GUID
Specifies the storage subsystem. The GUID variable is the globally unique identifier (GUID) of the storage subsystem as returned by the lsdev -subsys command.
-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.
volume_id | -
Specifies the volumes. The volume_ID variable is a comma-separated list of volume IDs, such as that obtained by running the lsvol command. If a single dash (-) is issued, the volume IDs are read from standard input.

Example: Removing host ports

The following command removes three host ports from the assignment list for the specified volume:
tpctool> unassignvol -user me -pwd mypass -url myhost:myport 
-hp 5005076300C79470,5005076300D09470,5005076300CB9470 2105.22232
The following output is returned:
Volume ID         PoolID             Status
===========================================   
2105.22232        P0                 SUCCESS
2105.22232        P1                 SUCCESS
2105.22232        P2                 SUCCESS