NAME

samu - StorageTek QFS and Oracle HSM operator utility

SYNOPSIS

samu [-d c] [-r i] [-c string] [-f cmd-file]

AVAILABILITY

SUNWqfs

SUNWsamfs

DESCRIPTION

samu is a full screen operator interface for StorageTek QFS and Oracle HSM environments. It has a number of displays that show the status of file systems and devices and allows the operator to control file systems and removable media devices.

OPTIONS

-d c

Specifies the initial display when samu starts execution. See DISPLAYS below.

-r i

Specifies the time interval in seconds for refreshing the display window.

-c string

Specifies an initial command string that should be executed when samu starts execution.

-f cmd-file

Specifies a file from which to read samu commands. Each line in the file is a command.

CONTROL KEYS

The following "hot" keys are available for all displays:

Table 1: Hot keys that are available for all displays

Key	Description
q	Quit
:	Enter command
space	Refresh display
control-l	Refresh display (clear)
control-r	Enable∕disable refresh (default is enabled)

The following keys perform the listed functions for each of the displays shown:

Table 2: Additional hotkeys that perform specified functions in specified displays

Key	Function	Display
control-f	Next file system	:a,a,g
	Page forward	c,h,o,p,s,t,u,v,w,x,y,z,A,J,K,M,P
	Next stage request	n
	Next inode	I
	Next sector	S
	Next equipment	T,U
	Next filesystem	N
control-b	Previous file system	:a,a,g
	Page backward	c,h,o,p,s,t,u,v,w,x,y,z,A,J,K,M,P
	Previous stage request	n
	Previous inode	I
	Previous sector	S
	Previous equipment	T,U
	Previous filesystem	N
control-d	Half-page forward	c,p,s,u,w,x,y,z,A,J,M
	Next robot catalog	v
	Page forward	g,h,S
	Page arcopies forward	a
	Page stage queue forward	n
	Page partitions forward	N
control-u	Half-page backward	c,p,s,u,w,x,y,z,A,J,M
	Previous robot catalog	v
	Page backward	g,h,S
	Page arcopies backward	a
	Page stage queue backward	n
	Page partitions backward	N
control-k	Advance display format	A,I,S
	Select (manual,robotic,both,priority)	p
	Advance sort key	v
	Toggle path display	n,u,w
control-i	Detailed (3-line) arcopy format	a
	Detailed (2-line) display format	v,x,y,D
	Detailed status interpretations	g,n,N
	Detailed (show cloud drives) display	s,t,z
control-j	Size display unit (base 2 or 10)	D,:a,l,n,m,v,x,y
1-7	Select sort key	v
∕	Search for VSN	v
%	Search for barcode	v
$	Search for slot	v

The sort selections for the v display are: 1 slot, 2 count, 3 usage, 4 VSN, 5 access time, 6 barcode, 7 label time.

DISPLAYS

The following displays are available. Those displays marked with '*' are the only ones available for StorageTek QFS. All others are available in Oracle HSM environments only if samd start has been executed.

Key	Display
a	Display archiver status
c	Display configuration	C	Memory
d*	Display tracing info.	D	Display disk volume dictionary
f*	Display filesystem info.	F	Optical disk label
g*	Display client information
h*	Display help information
l	Display usage information	I*	Inode
m*	Display mass-storage status	J	Preview shared memory
n	Display staging activity	K	Kernel statistics
o	Display optical disk status	L	Shared memory tables
p	Display mount request preview	M	Shared memory
r	Display removable media	N*	File system parameters
s	Display device status summary	P	Active Services
t	Display tape status	R	SAM-Remote info
u	Display stage queue	S	Sector data
v	Display robot VSN catalog	T	SCSI sense data
w	Display pending stage queue	U	Device table
x	Display active migration
y	Display migration vsns
z	Display cloud library status

COMMANDS

The following commands may be entered after a colon (:).

Table 4: Archiver commands

Command	Function
aridle [ dk | rm | fs.fsname ]	Idle archiving
arrerun	Soft restart archiver
arrestart	Restart archiver
arrmarchreq fsname.[* | archreq]	Remove ArchReq
arrun [ dk | rm | fs.fsname ]	Start archiving
arscan fsname[.dir | ..inodes][int]	Scan filesystem
arstop [ dk | rm | fs.fsname ]	Stop archiving
artrace [fs.fsname]	Trace archiver

Table 5: Display control commands

Command	Function
refresh i	Set refresh time
a filesystem	Select detailed "a" display
n media	Set n display media selection
p media	Set p display media selection
r media	Set r display media selection
u media	Set u display media selection
v eq	Set v display robot catalog
w media	Set w display media selection

Table 6: Device commands

devlog	eq [option …]	Set device logging options
idle	eq	Idle equipment
off	eq	Off equipment
on	eq	On equipment
readonly	eq	Mark equipment read-only
ro	eq	Mark equipment read-only
unavail	eq	Mark equipment unavailable
unload	eq	Unload mounted media∕magazine

Table 7: File System commands - miscellaneous

Command	Arguments	Function
stripe	eq value	Set stripe width
suid	eq	Turn on setuid capability
nosuid	eq	Turn off setuid capability
sync_meta	eq value	Set sync_meta mode
atime	eq value	Set access time (atime) update mode
trace	eq	Turn on file system tracing
notrace	eq	Turn off file system tracing
add	eq	Add eq to mounted file system
remove	eq	Remove eq; copy files to eqs with ON state
release	eq	Release eq; mark files offline
alloc	eq	Enable allocation on partition
noalloc	eq	Disable allocation on partition
def_retention	eq interval	Set default WORM retention time

Table 8: File System commands - Oracle HSM

Command	Arguments	Function
hwm_archive	eq	Turn on hwm archiver start
nohwm_archive	eq	Turn off hwm archiver start
maxpartial	eq value	Set maximum partial size in kilobytes
partial	eq value	Set size to remain online in kilobytes
partial_stage	eq value	Set where to start staging if partial
stage_flush_behind	eq value	Set stage flush behind size in kilobytes
stage_n_window	eq value	Set direct stage size in kilobytes
thresh	eq high low	Set high and low release thresholds

Table 9: File System commands - I∕O

Command	Arguments	Function
dio_rd_consec	eq value	Set number of consecutive dio reads
dio_rd_form_min	eq value	Set size of well-formed dio reads
dio_rd_ill_min	eq value	Set size of ill-formed dio reads
dio_wr_consec	eq value	Set number of consecutive dio writes
dio_wr_form_min	eq value	Set size of well-formed dio writes
dio_wr_ill_min	eq value	Set size of ill-formed dio writes
flush_behind	eq value	Set flush behind value in kilobytes
forcedirectio	eq	Turn on directio mode
noforcedirectio	eq	Turn off directio mode
force_nfs_async	eq	Turn on NFS async
noforce_nfs_async	eq	Turn off NFS async
readahead	eq value	Set maximum readahead in kilobytes
writebehind	eq value	Set maximum writebehind in kilobytes
sw_raid	eq	Turn on software RAID mode
nosw_raid	eq	Turn off software RAID mode
wr_throttle	eq value	Set outstanding write size in kilobytes
abr	eq	Enable Application Based Recovery
noabr	eq	Disable Application Based Recovery
dmr	eq	Enable Directed Mirror Reads
nodmr	eq	Disable Directed Mirror Reads
dio_szero	eq	Turn on dio sparse zeroing
nodio_szero	eq	Turn off dio sparse zeroing

Table 10: File System commands - StorageTek QFS

Command	Arguments	Function
mm_stripe	eq value	Set meta stripe width
qwrite	eq	Turn on qwrite mode
noqwrite	eq	Turn off qwrite mode

Table 11: File System commands - multireader

Command	Arguments	Function
invalid	eq interval	Set multireader invalidate cache delay
refresh_at_eof	eq	Turn on refresh at eof mode
norefresh_at_eof	eq	Turn off refresh at eof mode

Table 12: File System commands - shared fs

Command	Arguments	Function
minallocsz	eq value	Set minimum allocation size
maxallocsz	eq value	Set maximum allocation size
meta_timeo	eq interval	Set shared fs meta cache timeout
mh_write	eq	Turn on multihost read∕write
nomh_write	eq	Turn off multihost read∕write
aplease	eq interval	Set append lease time
rdlease	eq interval	Set read lease time
wrlease	eq interval	Set write lease time

Table 13: Robot commands

Command	Arguments	Function
audit	[-e] eq[:slot[:side]]	Audit slot or library. See auditslot (1m) for information on -e.
import	eq	Import cartridge from mailbox
export	eq:slot	Export cartridge to mailbox
export	mt.vsn	Export cartridge to mailbox
load	eq:slot[:side]	Load cartridge in drive
load	mt.vsn	Load cartridge in drive
priority	pid newpri	Set load priority for process 'pid'

Table 14: Stager commands

Command	Arguments	Function
stclear	mt.vsn	Clear stage request
stidle		Idle staging
strun		Start staging

Table 15: Migration commands

Command	Arguments	Function
migconfig		Configure migration
migstart		Start migration
migidle		Idle migration
migstop		Stop migration

Table 16: Miscellaneous commands

Command	Arguments	Function
clear	vsn [index]	Clear load request
diskvols	volume [+flag | -flag]	Set or clear disk volume dictionary flags
dtrace	daemon[.variable] value	Set daemon trace controls
fs	fsname	Set filesystem (N display)
mount	mntpt	Select a mount point (I, N displays)
open	eq	Open device (F, S displays)
read	addr	Read device
snap	file	Snapshot screen to file
!shell-command		Run shell command

SEE ALSO

curses(3).

mcf (4).