source: gpfs_3.1_ker2.6.20/share/man/man8/mmchfileset.8 @ 219

.TH mmchfileset 03/31/06
mmchfileset Command
.SH "Name"
.PP
\fBmmchfileset\fR - Changes the attributes of a GPFS
fileset.
.SH "Synopsis"
.PP
\fBmmchfileset\fR \fIDevice\fR {\fIFilesetName\fR |
\fB-J\fR \fIJunctionPath\fR} {[\fB-j\fR
\fINewFilesetName\fR] | [\fB-t\fR
\fINewComment\fR]}
.SH "Description"
.PP
The \fBmmchfileset\fR command changes the name or comment for an
existing GPFS fileset.
.PP
For information on GPFS filesets, see the chapter
\fIPolicy-based data management for
GPFS\fR in
\fIGeneral Parallel File
System: Advanced Administration Guide\fR.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system that contains the fileset.
.PP
File system names need not be fully-qualified. \fBfs0\fR is as
acceptable as \fB/dev/fs0\fR.
.RE
.PP
.RS +3
\fB\fIFilesetName\fR
\fR
.RE
.RS +9
Specifies the name of the fileset.
.RE
.PP
.RS +3
\fB-J \fIJunctionPath\fR
\fR
.RE
.RS +9
Specifies the junction path name for the fileset.
.PP
A junction is a special directory entry that connects a name in a directory
of one fileset to the root directory of another fileset.
.RE
.PP
.RS +3
\fB-j \fINewFilesetName\fR
\fR
.RE
.RS +9
Specifies the new name that is to be given to the fileset. This
name must be less than 256 characters in length. This flag may be
specified along with the \fB-t\fR flag.
.RE
.PP
.RS +3
\fB-t \fINewComment\fR
\fR
.RE
.RS +9
Specifies an optional comment that appears in the output of the
\fBmmlsfileset\fR command.
This comment must be less than 256 characters in length. This flag may
be specified along with the \fB-j\fR flag.
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to run the \fBmmchfileset\fR
command.
.PP
You may issue the \fBmmchfileset\fR command from any node in the GPFS
cluster.
.PP
When using the \fBrcp\fR and \fBrsh\fR commands for remote
communication, a properly configured \fB.rhosts\fR file must exist
in the root user's home directory on each node in the GPFS
cluster. If you have designated the use of a different remote
communication program on either the
\fBmmcrcluster\fR
or the
\fBmmchcluster\fR command, you must
ensure:
.RS +3
.HP 3
1. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
2. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.SH "Examples"
.PP
This command renames fileset \fBfset1\fR to \fBfset2\fR, and gives it
the comment "the first fileset":
.sp
.nf
mmchfileset gpfs1 fset1 -j fset2 -t 'the first fileset'
.fi
.sp
.PP
The system displays a message similar to:
.sp
.nf
Fileset 'fset1' changed.
.fi
.sp
.PP
To confirm the change, issue this command:
.sp
.nf
mmlsfileset gpfs1 -L
.fi
.sp
.PP
The system displays information similar to: 
.sp
.nf
Name    Id RootInode  ParentId Created                  Comment
root     0         3        -- Thu Dec 12 15:59:18 2005 root fileset
fset2    1    261633         0 Mon Dec 13 13:55:28 2005 the first fileset
.fi
.sp
.SH "See also"
.PP
mmdelfileset Command
.PP
mmcrfileset Command
.PP
mmlinkfileset Command
.PP
mmlsfileset Command
.PP
mmunlinkfileset Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP