unlinkfset

Use the unlinkfset command to unlink a fileset. You must have Administrator authority to use this command.

Unlinking a fileset makes all the files in the fileset inaccessible for as long as the fileset remains unlinked. The files are not deleted; they are only inaccessible.

Syntax

Read syntax diagramSkip visual syntax diagramtpctoolunlinkfset -user user_name -pwd password -url url -help-fileset file_set_id -f-header ?-silent-qs character-fs character

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.
-help | -h | -?
Lists help information for the command.
-fileset file_set_id
Specifies the IBM Spectrum Control key of the fileset to be unlinked. The fileset key is listed in the ID column of the lsfset command output.
-f
Forces the files to be unlinked. If you use this option, the command forcibly closes any open files, causing the ESTALE error the next time the file is used.
-header
Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
-silent
Suppresses all output for the command. If you omit this parameter, output is included.
-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 (").
-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.

Example: Unlinking a fileset

The following command unlinks the fileset named eefset01+eefs+kq458mv.ibm+00000200A2A0153C+0. 
tpctool> unlinkfset -fileset eefset01+eefs+kq458mv.ibm+00000200A2A0153C+0
-user admin -pwd password -url localhost:9550

The following output is returned:

FilesetId                                    Status
====================================================
eefset01+eefs+kq458mv.ibm+00000200A2A0153C+0 SUCCESS