.TH mmcrfileset 04/06/06
mmcrfileset Command
.SH "Name"
.PP
\fBmmcrfileset\fR - Creates a GPFS fileset.
.SH "Synopsis"
.PP
\fBmmcrfileset\fR \fIDevice\fR \fIFilesetName\fR
\fB[-t\fR \fIComment\fR\fB]\fR
.SH "Description"
.PP
The \fBmmcrfileset\fR command constructs a new fileset with the
specified name. The new fileset is empty except for a root directory,
and does not appear in the directory name space until the
\fBmmlinkfileset\fR command is
issued. The \fBmmcrfileset\fR command is separate from the
\fBmmlinkfileset\fR command to allow
the administrator to establish policies and quotas on the fileset before it is
linked into the name space.
.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.
.PP
The maximum number of filesets that GPFS supports is 1000 filesets
per file system.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system to contain the new 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 newly created fileset.
.RE
.PP
.RS +3
\fB-t \fIComment\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.
.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 \fBmmcrfileset\fR
command.
.PP
You may issue the \fBmmcrfileset\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 example creates two filesets in file system \fBgpfs1\fR:
.sp
.nf
mmcrfileset gpfs1 fset1
.fi
.sp
.PP
The system displays output similar to:
.sp
.nf
Fileset 'fset1' created.
.fi
.sp
.sp
.nf
mmcrfileset gpfs1 fset2 -t "another fileset"
.fi
.sp
.PP
The system displays output similar to:
.sp
.nf
Fileset 'fset2' created.
.fi
.sp
.PP
To confirm the change, issue this command:
.sp
.nf
mmlsfileset gpfs1 -L
.fi
.sp
.PP
The system displays output similar to:
.sp
.nf
Name     Id RootInode  ParentId Created                  Comment
root      0         3        -- Thu Dec 12 15:59:18 2005 root fileset
fset1     1    261633         0 Mon Dec 13 13:55:28 2005\ 
fset2     2    261634         1 Mon Dec 13 13:56:12 2005 another fileset
.fi
.sp
.SH "See also"
.PP
mmchfileset Command
.PP
mmdelfileset Command
.PP
mmlinkfileset Command
.PP
mmlsfileset Command
.PP
mmunlinkfileset Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR