| Skip Navigation Links | |
| Exit Print View | |
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
|
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME
samset - Change the Sun QFS or SAM-QFS environment
SYNOPSIS
samset [keyword [parameter...]]
AVAILABILITY
SUNWsamfs
DESCRIPTION
samset is used to change or display variables that control
SSun QFS or SAM-QFS operation. Without any arguments, sam-
set displays current settings to stdout. If samset is exe-
cuted with a keyword but with no parameter..., then the
current value for just that keyword is displayed to stdout.
The keywords all have values assigned to them at startup.
These values come from the defaults.conf file. samset
allows you to change keywords while sam-fsd is running. Any
changes made remain effective only during the current
instance of sam-fsd; values revert to the defaults in
defaults.conf at the next startup.
The following keywords are supported:
attended yes
attended no
attended tells the Sun QFS or SAM-QFS library dae-
mon if an operator is available to manually mount
media. Regardless of the attended setting,
requests for media which are mounted in a drive,
or present in a media changer, will be satisfied
as soon as possible. attended affects the
behavior of Sun QFS or SAM-QFS library daemon when
a medium is requested which is not currently
present in either a manually mounted drive, or in
a library. The usual action taken by the library
daemon when such a request occurs is to place it
into the preview display (see samu (1M)), and
await manual intervention (but see stale_time,
below). However, if either attended is set to no,
or the medium is marked "unavailable" in the his-
torian catalog, then the request will not go into
the preview display, and will fail with an ESRCH
error. If other archive copies are available,
they will be tried. If no further copies are
available, ENXIO will be returned to the reques-
ter.
exported_media +u eq...
exported_media -u eq...
This option controls the flagging of media
exported (see export(1M)) from the listed
libraries as unavailable (+u) or available (-u) in
the historian's catalog. See attended, above, for
the effect of this flag. The setting of the flag
for a given medium may be changed after export
using chmed.
idle_unload
This is the time (in seconds) that a media changer
controlled device may be idle before the media in
that device is unloaded. A value of zero will
disable this feature.
labels label-option
This option applies only to barcode-reader
equipped tape libraries.
The media daemon can obtain the tape label from
the upper-cased characters of the tape's barcode.
label-option may be: barcodes, to use the first
six characters of the barcode as label;
barcodes_low, to use the trailing six characters;
or read, to disable barcode processing and to read
the magnetic label from the tape.
When labels is set to barcodes or barcodes_low,
any tape robotically mounted for a write operation
that is write enabled, unlabeled, has never been
mounted before, and has a readable barcode will
have a magnetic label written before the write is
started.
stale_time minutes
Sets the amount of time (in minutes) that a
request for media will wait in the preview table
before being canceled with an ETIME. The file
system will react to an ETIME error in the same
way as an ESRCH error (see attended, above).
timeout seconds
Sets the time (in seconds) that will be allowed to
elapse between I/O requests for direct access to
removable media (see request(1)). If a process
fails to issue the next I/O to the device within
this time, the device will be closed and, on the
next I/O, the process will receive an ETIME error.
A value of 0 implies no timeout will occur.
debug debug manipulates the debug/trace flags within Sun
QFS or SAM-QFS environments to produce expanded
logging. Unless otherwise specified, the debug
messages are logged to the syslog facility at the
LOG_DEBUG priority. parameter... is a space
separated list of flags. To set a flag, give its
name. To clear a flag, give its name prefixed
with a '-'. The flags are:
all Turn on all debug flags (except
trace_scsi and robot_delay).
none Turn off all debug flags.
default Set all debug flags to the default as
defined by defaults.conf.
logging File system requests to the daemons and
the daemons response to the requests are
logged to files. These files are used
only by Oracle Corporation support.
debug This is catch-all for messages that
might be of interest but generally do
not show a problem.
moves Log move-media commands issued to media
changers.
events This should only be used by Sun
Microsystems analysts to trace the flow
of events used by the media changer dae-
mons. These messages are coded and of
little use in the field. These messages
are logged to syslog at LOG_NOTICE
priority.
timing This setting has been replaced by the
device log timing event devlog eq [
event ...]. This is described in more
detail under the devlog keyword.
od_range For optical disk media, log the range of
sectors allowed for writing.
labeling Log the VSN, blocksize (for tape media
only), and label date when a label is
read from a medium following the media's
being mounted. These messages are
logged to syslog at LOG_INFO priority.
canceled Log when the stage process detects a
canceled stage request.
disp_scsi Display the current SCSI cdb being exe-
cuted by a device. This information is
appended to any existing message. If
the length of the existing message and
the cdb would overflow the message area,
the cdb is not displayed. The message
area for a device can be viewed with
samu (see samu(1M)) in the "s" or "r"
displays.
messages This is used by Sun Microsystems
analysts to trace the flow of messages
used by the media changer daemons.
These messages are coded and of little
use to customers. These messages are
logged to syslog at LOG_NOTICE priority.
migkit Log events connected with the Sun Sam
Migration Toolkit.
mounts Log media mount requests.
opens Log open and close of removable media
devices.
trace_scsi
This option may only be set by the super
user through the samset command. It
causes all scsi commands issued through
the user_scsi interface to be written to
a file named /tmp/sam_scsi_trace_xx
(where xx is the equipment number of
either the media changer to which this
device belongs or the device itself if
it does not belong to a media changer.)
The trace file is opened with O_APPEND
and O_CREAT on the next I/O to each dev-
ice after this flag is set. It is
closed when the option is cleared and
the next I/O to that device occurs. Sun
Microsystems does not recommend running
with this option for long periods. The
format of the trace information is:
struct {
int eq; /* equipment number */
int what; /* 0 - issue, 1 - response */
time_t now; /* unix time */
int fd; /* the fd the ioctl was issued on */
char cdb[12]; /* the cdb */
char sense[20]; /* returned sense(valid if what=1) */
}cdb_trace;
Oracle Corporation does not recommend set-
ting this option indiscriminately, as
large output files are quickly produced.
stageall This should be used only by Sun
Microsystems analysts to trace stageall
processing.
devlog eq [ event ...]
devlog manipulates the device log event flags for
device eq. eq is either an equipment number or
"all"; if "all", then the flags are set or listed
for all devices. These flags control which events
get written to the device log files. [ event ...]
is a space separated list of event names. To set
an event flag, give its name. To clear a flag,
give its name prefixed with a '-'. The events
are:
all Turn on all events.
none Turn off all events.
default Set the event flags to the default which
are: err, retry, syserr, and date.
detail events which may be used to track the
progress of operations.
err Error messages.
label Labeling operations.
mig Migration toolkit messages.
msg Thread/process communication.
retry Device operation retries.
syserr System library errors.
time Time device operations.
module Include module name and source line in
messages.
event Include the event name in the message.
date Include the date in the message.
tapealert eq [on|off|default]
tapealert allows the user to enable or disable
support for device implemented TapeAlert.
eq is either an equipment number or "all";
if "all", then the flags are set or
listed for all devices.
on Enable TapeAlert if the device supports
it.
off Disable requesting TapeAlert information
from the device.
default Return TapeAlert to the factory setting.
sef eq [on|off|default] interval
sef allows the user to enable or disable support
for tape drive implemented Log Sense delivered via
sysevents.
eq is either an equipment number or "all";
if "all", then the flags are set or
listed for all devices.
on Enable requesting tape drive Log Sense
sysevents if the drive supports it.
off Disable requesting tape drive Log Sense
sysevents.
default Return tape drive Log Sense sysevents to
the factory setting.
interval Tape drive Log Sense polling interval in
seconds. A value of 300 is a polling
interval once every five minutes. A
string value of "once" specifies one
time just before media unload and is the
default. A value of 3600 is a polling
interval once every hour. The smallest
polling interval is five minutes.
SEE ALSO
request(1), chmed(1M), export(1M), samu(1M),
defaults.conf(4), mcf(4), tapealert(1M), sefsysevent(4).
NOTES
A complete description of SEF sysevents is in the Sun
Storage Archive Manager (SAM-QFS) Configuration and Adminis-
tration Guide.
|