.\"
.\" $Id: nsr_mount_request.5,v 1.1.64.1 2005/07/25 17:17:33 btompkin Exp $ Copyright (c) 2005 EMC Corporation.
.\"

.\"
.\" Copyright (c) 2005 EMC Corporation.
.\"
.\" All rights reserved.  This is an UNPUBLISHED work, and
.\" comprises proprietary and confidential information of EMC.
.\" Unauthorized use, disclosure, and distribution are strictly
.\" prohibited.  Use, duplication, or disclosure of the software
.\" and documentation by the U.S. Government is subject to
.\" restrictions set forth in a license agreement between the
.\" Government and EMC or other written agreement specifying
.\" the Government's rights to use the software and any applicable
.\" FAR provisions, such as FAR 52.227-19.
.\"
.TH NSR_MOUNT_REQUEST 5 "Aug 23, 06" "StorEdge EBS 7.3.2"
.SH NAME
.B nsr_mount_request
\- Sun StorEdge EBS resource type "NSR mount request"
.SH SYNOPSIS
.B  "type: NSR mount request"
.SH DESCRIPTION
When a nsrmmd processes requires media for a session, e.g. save or recover,
it sends a request to nsrd. If there is no media currently mounted which
meets the requirements of the nsrmmd process, nsrd starts a nsrjb command
to mount media. Before nsrd starts the nsrjb command a resource of the type
.B NSR mount request
is created.
The resource exists until the corresponding nsrjb command exits.
This resource and all its attributes are read only. A resource
of this type may not be created or deleted using any administrative
interface.
See
.BR nsr_resource (5)
for information on Sun StorEdge EBS resources.
To view the
.B NSR mount request
resources run:
.br 
.RS
\fR\s10nsradmin -c "type:NSR mount request"\fP\s0
.RE
.br 
Be sure to include quotation marks and to insert a space between
"NSR", "mount", and "request".
.SH ATTRIBUTES
.LP
The following attributes are defined for the resource type
.BR "NSR mount request" .
The information in parentheses describes how the attribute values are accessed.
.B Read-only
indicates that the value cannot be changed by an administrator.
.B Hidden
indicates a hidden attribute of interest only to programs or experts.
These attributes can only be seen when the hidden option is turned on in
.BR nsradmin (8).
.B Static
attributes change values rarely, if ever.
.B Dynamic
attributes have values that change rapidly.
For example, an attribute marked
.B "(read-only, static)"
has a value that is set when the attribute is created and never changes.
.TP
.ta \w'volume current capacity:'u+4n
.BR "name " "	(read-only, static)"
The name attribute corresponds to the instance of the nsrjb
command that was created to load the media described by this
resource. The instance of the nsrjb command is specified using
the
.B \-O
command line option.
.br
.B Example:
\fR\s10name: 15;\fP\s0
.TP
.BR "nsrmmd id" "		(read-only/ static)"
This attribute records the number that identifies the nsrmmd process
which requested the media.
.br
.B Example:
\fR\s10nsrmmd id: 2;\fP\s0
.TP
.BR "nsrmmd host" "		(read-only/static)"
This attribute indicates the name of the host on which the nsrmmd
process which requested the media is running.
.br
.B Example:
\fR\s10nsrmmd host: host1;\fP\s0
.TP
.BR "nsrmmd mount id" "		(read-only/static/null ok)"
Some operations, e.g. cloning, require two nsrmmd processes and two volumes
be mounted at the same time. 
The value of this attribute will be the same for all mount requests
submitted by such nsrmmd processes.
When the nsrmmd which requested media is not participating in an operation
which requires another nsrmmd process to complete,
the value of this attribute is null.
.br
It is possible that only one cooperating nsrmmd process may be requesting
media be mounted. For example, this may occur while cloning data. If the
nsrmmd writing data reaches end of media while the nsrmmd process reading
data is still has data to be cloned, then the nsrmmd process writing data
will request a new volume be mounted.
.br
.B Example:
\fR\s10nsrmmd mount id: 5;\fP\s0
.TP
.BR "operation" "		(read-only/static)"
This attribute indicates the operation being performed by the nsrmmd
requesting media be mounted. The value for this attribute 
attribute can be either \fBreading\fR, \fBwriting\fR, or \fBmedia\fR.
If the value is set to \fBreading\fR, the nsrmmd process is reading data
from media. It could either be recovering data or the process that is reading
data from media as part of a cloning operation.
If the value is set to \fBwriting\fR, the nsrmmd process is writing data
to media. It could either be saving data or the process that is writing
data to media as part of a cloning operation.
If the value is set to \fBmedia\fR, the nsrmmd is performing an operation
that involves only the media, e.g. labeling media.
.br
.B Example:
\fR\s10operation: writing;\fP\s0
.TP
.BR "data operation" "			(read-only, static, null OK)"
This attribute has a value when the
.B operation
attribute is set to either \fBreading\fR or \fB writing\fR.
If the
.B operation
attribute is set to \fBmedia\fR
this attribute has no value.
Values for this attribute can be either \fBsave\fR, \fBrecover\fR,
\fBarchive\fR, \fBretrieve\fR, \fBmigrate\fR, \fBclone\fR, 
or \fBconsolidate\fR.
.br
.B Example:
\fR\s10data operation: save;\fP\s0
.TP
.BR "media operation" "			(read-only, static)"
This attribute indicates operations which are expected to be performed
on the media after it is loaded into a drive.
Values for this attribute can be
either \fBmount\fR, \fBlabel\fR, \fBrelabel\fR, or \fBverify\fR.
This attribute may have multiple values. For example media may
be labeled and then mounted.
.br
.B Example:
\fR\s10media operation: label, mount;\fP\s0
.TP
.BR "pool" "				(read-only, static)"
The pool to which the requested media belongs or the pool to which the
media is to be added if the
.B media operation
attribute includes \fBlabel\fR or \fBrelabel\fR values.
Valid values for this attribute are any currently defined pool.
.br
.B Example:
\fR\s10pool: Default;\fP\s0
.TP
.BR "volume" "				(read-only, static, null OK)"
This attribute records the name of the volume being mounted.
The value of the attribute is NULL if the volume name is not known
at the time the operation is started. This can occur when labeling
scratch media.
.br
.B Example:
\fR\s10volume: vol1;\fP\s0
.TP
.BR "client" "		(read-write, static, null ok)"
This attribute is used to record the name of the Sun StorEdge EBS client
from which data is being read while saving (archiving) data or
to which data is being written while recovering (retrieving) data.
.br
.B Example:
\fR\s10client: host1;\fP\s0
.TP
.BR "save set" "			(read-only, static, null ok)"
This attribute specifies the data being read from client and written to
media (save) or the data read from media and written to client (recover).
.br
.B Example:
\fR\s10save set: /usr;\fP\s0
.TP
.BR "group" "				(read-only, static, null ok)"
If the operation being performed by the nsrmmd which requested the mount
is the result of a command initiated by
.B savegrp (8),
this attribute records the name of the group.
Otherwise there is no value.
Valid values for this attribute are any currently defined group.
.br
.B Example:
\fR\s10group: Default;\fP\s0
.SH EXAMPLE
.LP
A complete example follows:
.nf
.na
.ta \w'nsrmmd mount id:'u+1nR +2n

	type:	NSR mount request;
	name:	10;
	nsrmmd id:	2;
	nsrmmd host:	host1;
	nsrmmd mount id:	tape;
	operation:	writing;
	data operation:	save;
	media operation:	label, mount;
	volume:	vol1;
	pool:	Default;
	client:	host1;
	save set:	/usr;
	group:	Default;
.ta
\fR\s0
.fi
.SH FILES
.I /nsr/res/nsrdb
\- files in this directory should never be edited directly. Use
.BR nsradmin (8),
or
.B Sun StorEdge EBS Management Console
instead.
.SH SEE ALSO
.na
.BR nsr_resource (5),
.BR nsr_pool (5),
.BR nsr_group (5),
.BR nsr_service (5),
.BR nsr (8),
.BR nsrmmd (8),
.BR nsradmin (8),
.ad