JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun QFS File System 5.3 Configuration and Administration Guide     Sun QFS and Sun Storage Archive Manager 5.3 Information Library
search filter icon
search icon

Document Information

Preface

1.  File System Overview

2.  About the Master Configuration File

3.  mcf File Examples

4.  Configuring the File System

5.  Configuring a Shared File System

6.  Administering File System Quotas

7.  Advanced File System Topics

8.  SMB Service in SAM-QFS

9.  Configuring WORM-FS File Systems

10.  Tunable Parameters

11.  Using QFS File Systems with SANergy (SAN-QFS)

12.  Mount Options in a Shared File System

13.  Using the samu Operator Utility

samu Operator Utility at a Glance

Overview of the samu Operator Utility

How to Start the samu Utility

How to Display a samu Screen

How to Stop samu

Interacting With samu

Identifying a Device

Accessing Online Help

Operator Displays

(a) - Archiver Status Display

Navigation

Sample Display

Field Descriptions

(c) - Device Configuration Display

Navigation

Sample Display

Field Descriptions

(C) - Memory Display

Sample Display

(d) - Daemon Trace Controls Display

Sample Display

(D) - Disk Volume Dictionary

Sample Display

Flags

(f) - File Systems Display

Sample Display

Field Descriptions

(F) - Optical Disc Label Display

(h) - Help Display

Navigation

Sample Display

(I) - Inode Display

Navigation

Sample Display

(J) - Preview Shared Memory Display

Navigation

Sample Display

(K) - Kernel Statistics Display

Navigation

Sample Display

(l) - Usage Display

Sample Display

(L) - Shared Memory Tables

Sample Display

(m) - Mass Storage Status Display

Sample Display

Field Descriptions

(M) - Shared Memory Display

Navigation

Sample Display

(n) - Staging Status Display

Sample Display

(N) - File System Parameters Display

Navigation

Sample Display

(o) - Optical Disc Status Display

Navigation

Sample Display

Field Descriptions

(p) - Removable Media Load Requests Display

Navigation

Sample Display

Field Descriptions

Flags

(P) - Active Services Display

Navigation

Sample Display

(r) - Removable Media Status Display

Sample Display

Field Descriptions

(R) - Sun SAM-Remote Information Display

(s) - Device Status Display

Navigation

Sample Display

Field Descriptions

(S) - Sector Data Display

Navigation

(t) - Tape Drive Status Display

Navigation

Sample Display

Field Descriptions

(T) - SCSI Sense Data Display

Navigation

(u) - Staging Queue Display

Navigation

Sample Display

Field Descriptions

(U) - Device Table Display

Navigation

Sample Display

(v) - Automated Library Catalog Display

Navigation

Sample Display

Field Descriptions

Flags

(w) - Pending Stage Queue

Navigation

Sample Display

Field Descriptions

Status Codes

Removable Media Device Display Status Codes

File System Display Status Codes

States of an Operator Display Device

How to Change a Drive State From down to on

Operator Commands

Device Commands

File System Commands: I/O Management

The flush_behind Command

force_nfs_async and noforce_nfs_async Commands

readahead Command

sw_raid and nosw_raid Commands

writebehind Command

wr_throttle Command

File System Commands: Direct I/O Management

dio_rd_form_min and dio_wr_form_min Commands

dio_rd_ill_min and dio_wr_ill_min Commands

dio_rd_consec and dio_wr_consec Commands

dio_szero and nodio_szero Commands

forcedirectio and noforcedirectio Commands

File System Commands: Sun QFS Shared File Systems

meta_timeo Command

mh_write and nomh_write Commands

minallocsz and maxallocsz Commands

rdlease, wrlease, and aplease Commands

File System Commands: Miscellaneous

abr and noabr Commands

dmr and nodmr Commands

invalid interval Command

mm_stripe Command

qwrite and noqwrite Commands

refresh_at_eof and norefresh_at_eof Commands

suid and nosuid Commands

stripe Command

sync_meta Command

trace and notrace Commands

Miscellaneous Commands

clear vsn Command

devlog Command

diskvols flag Command

dtrace Commands

fs Command

mount Command

open Command

read Command

refresh Command

snap Command

! shell-command Command

Operator Displays

To view one of the operator displays, press its corresponding character key. The lowercase characters a through w display operational information.


Note - The uppercase samu(1M) displays (C, D, F, I, J, K, L, M, N, P, R, S, T, and U) are designed to be used at a customer site only with the assistance of a member of the technical support staff.

This topic does not describe these uppercase displays in detail.


When an operator display overflows the available screen area, the word more appears on the bottom of the display indicating additional information, as shown in the following example. Press Ctrl-F to page forward and see more content.

Example 13-1 samu Screen Indicating More Text Can Be Obtained

xb54  54  exb8505  pt03  0  yes  2  0  on
lt55  55  dlt2000  pt02  1  yes  4  0  on  ml65
hp56  56  hpc1716  pt01  1  yes  3  0  on  hp70
hp57  57  hpc1716  pt01  1  yes  4  0  on  hp70
more

When samu prompts you to provide a device, enter its associated equipment number. The configuration display (c) shows equipment numbers for all removable media devices. To control all displays, use the control keys listed for the display.

The following sections describe the operator displays in alphabetical order with examples. Descriptions of more complex displays are followed by a table describing the field in the display.


Note - If you are using only the Sun QFS software without the archiving features of SAM-QFS, not all operator displays will be available.


(a) - Archiver Status Display

The a display shows the archiver status. To display archiving details for a specific file system:

a filesystem

For filesystem, specify the name of a file system.

Navigation

The following table shows the control keys you can use in the a display.

Key
Function
Ctrl-B
Previous file system
Ctrl-F
Next file system
Ctrl-D
Page arcopies forward (bottom portion) — not available when viewing the details for a specified file system
Ctrl-U
Page arcopies backward (bottom portion) — not available when viewing the details for a specified file system

Sample Display

The following example shows the archiver status display.

Example 13-2 samu a Display

Archiver Status
samu 5.0 07:44:02 August 8 2008
sam-archiverd:  Waiting for resources
sam-arfind:  samfs1 mounted at /sam1
Waiting until 2005-05-08 07:54:02 to scan .inodes
sam-arfind:  samfs2 mounted at /sam2
Waiting until 2005-05-08 07:52:57 to scan .inodes
sam-arfind:  qfs1 mounted at /qfs1
Waiting until 2005-05-08 07:44:33 to scan .inodes
sam-arfind:  qfs2 mounted at /qfs2
Waiting until 2005-05-08 07:53:21 to scan .inodes
sam-arfind:  qfs3 mounted at /qfs3
Waiting until 2005-05-08 07:44:11 to scan .inodes

sam-arfind:  qfs4 mounted at /qfs4
Waiting until 2005-05-08 07:53:35 to scan .inodes

sam-arfind:  shareqfs1 mounted at /shareqfs1
Shared file system client.  Cannot archive.

sam-arfind:  shareqfs2 mounted at /shareqfs2
Shared file system client.  Cannot archive.

sam-arcopy:  qfs4.arset5.1.83 dt.DAT001
Waiting for volume dt.DAT001

Field Descriptions

The following table shows the fields in the detail display.

Field
Description
samfs1 mounted at
Mount point.
regular files
Number of regular files and their total size.
offline files
Number of offline files and their total size.
archdone files
Number of archdone files and size. Indicates that the archiver has completed processing and can perform no further processing. Files marked as archdone have been processed for archiving but have not necessarily been archived.
copy1
Number of files and total size for archive copy 1.
copy2
Number of files and total size for archive copy 2.
copy3
Number of files and total size for archive copy 3.
copy4
Number of files and total size for archive copy 4.
Directories
Number of directories and total size.
sleeping until
Indicates when archiver runs again.

(c) - Device Configuration Display

The c display shows your configuration's connectivity. It lists all device names and equipment numbers.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-U
Half-page backward

Sample Display

The following example shows the device configuration display.

Example 13-3 samu c Display

Device configuration:                  samu     5.0 07:48:11 Sept 8 2008
ty  eq state   device_name                        fs family_set
sk  100 on      /etc/opt/SUNWsamfs/dcstkconf      100 dcL700
tp  120 off     /dev/rmt/1cbn                     100 dcL700
sg  130 on      /dev/rmt/4cbn                     100 dcL700
sg  140 on      /dev/rmt/5cbn                     100 dcL700
tp  150 off     /dev/rmt/3cbn                     100 dcL700
hy  151 on      historian                         151

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the device.
state
Current operating state of the device. Valid device states are as follows:
  • on The device is available for access.

  • ro The device is available for read-only access.

  • off The device is not available for access.

  • down The device is available only for maintenance access.

  • idle The device is not available for new connections. Operations in progress continue until completion.

  • nalloc The nalloc flag has been set, which prohibits any future allocation to this device. For more information, see Per-Logical Unit Number (LUN) Allocation Control.

device_name
Path to the device.
fs
Family set equipment number.
family_set
Name of the storage family set or library to which the device belongs.

(C) - Memory Display

The C display shows the content of a specific memory address. To show the content at an address, type the address in hexadecimal.

To invoke this display:

C hex-address

For hex-address, specify the address of a memory location in hexadecimal. For example:

Command:C 0x1044a998

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the memory display. The sample output has been truncated.

Example 13-4 samu C Display

Memory    base: 0x1234567               samu 5.0 07:52:25 Sept 8 2008
00000000  80921000 137ff801 edd05e21 40853420  ......x.mP^!@.4
00000010  00a00420 018528b0 01a604e0 02840640  . . ..(0.&.”...@
00000020  02d030a1 a0853420 0080a0a0 100a6fff  .P0! .4 ..  ..o.
00000030  f6921000 13c65e23 582d0000 0ba01020  v....F^#X-... .
00000040  00c45e20 48c608e0 2fd05e21 40920080  .D^ HF.”/P^!@...
00000050  037ff801 fa941000 16c45e20 48a600a0  ..x.z....D^ H&.
00000060  80921000 137ff801 d5d05e21 40853420  ......x.UP^!@.4
00000070  00a00420 018528b0 01a604e0 02840640  . . ..(0.&.”...@
00000080  02d030a1 c0853420 0080a0a0 100a6fff  .P0!@.4 ..  ..o.
00000090  f6921000 13c65e23 58a01020 00c45e20  v....F^#X . .D^
000000a0  48c608e0 2fd05e21 40920080 037ff801  HF.”/P^!@.....x.
000000b0  e39405a2 00c45e20 48a600a0 80921000  c..".D^ H&. ....
000000c0  137ff801 bed05e21 40853420 00a00420  ..x.>P^!@.4 . .
000000d0  018528b0 01a604e0 02840640 02d030a1  ..(0.&.”...@.P0!
000000e0  e0853420 0080a0a0 100a6fff f6921000  ”.4 ..  ..o.v...
000000f0  13c65e23 58a01020 00c45e20 48c608e0  .F^#X . .D^ HF.”

(d) - Daemon Trace Controls Display

The d display shows the events being traced as specified in the defaults.conf file. For more information about enabling trace files, see defaults.conf(4) in Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Sample Display

The following example shows trace file information. It includes information about the daemons being traced, the paths to the trace files, the events being traced, and information about the size and age of the trace files.

Example 13-5 samu d Display

Daemon trace controls                   samu 5.0 07:56:38 Sept 8 2008
sam-amld       /var/opt/SUNWsamfs/trace/sam-amld
               cust err fatal misc proc debug date
               size    0    age 0
sam-archiverd  /var/opt/SUNWsamfs/trace/sam-archiverd
               cust err fatal misc proc debug date
               size    0    age 0
sam-catserverd /var/opt/SUNWsamfs/trace/sam-catserverd
               cust err fatal misc proc debug date
               size    0    age 0
sam-fsd        /var/opt/SUNWsamfs/trace/sam-fsd
               cust err fatal misc proc debug date
               size    0    age 0
sam-rftd       /var/opt/SUNWsamfs/trace/sam-rftd
               cust err fatal misc proc debug date
               size    0    age 0
sam-recycler   /var/opt/SUNWsamfs/trace/sam-recycler
               cust err fatal misc proc debug date
               size    0    age 0
sam-sharefsd   /var/opt/SUNWsamfs/trace/sam-sharefsd
               cust err fatal misc proc debug date
               size    0    age 0
sam-stagerd    /var/opt/SUNWsamfs/trace/sam-stagerd
               cust err fatal misc proc debug date
               size    0    age 0
sam-serverd    /var/opt/SUNWsamfs/trace/sam-serverd
               cust err fatal misc proc debug date
               size    0    age 0
sam-clientd    /var/opt/SUNWsamfs/trace/sam-clientd
               cust err fatal misc proc debug date
               size    0    age 0
sam-mgmt       /var/opt/SUNWsamfs/trace/sam-mgmt
               cust err fatal misc proc debug date
               size    0    age 0

(D) - Disk Volume Dictionary

The D display shows the disk volume dictionary, which keeps track of the disk media for disk archiving that has been defined in the diskvols.conf file. The dictionary contains information about each VSN, including the capacity, space remaining, and the status flags of the VSN. These flags include unavailable, read only, and bad media.

Sample Display

The following example shows the device configuration display.

Example 13-6 samu D Display

Disk volume dictionary     samu     5.0 07:48:11 May 8 2008

header
version 460

volumes
magic 340322 version 9 nkeys 2 ndata 2
index    space          capacity       used        flags    volume
    0    12882411520    12887785472    10291200    -----    disk01
    1     6443827200     6443892736       70656    -----    disk02
clients
magic 340322 version 9 nkeys 1 ndata 1

Flags

The following table shows the flags for the D display.

Flag
Description
l
Volume is labeled; seqnum file has been created. This is set by the administrator to prevent the software from creating a new seqnum file.
r
Volume is defined on a remote host.
U
Volume is unavailable.
R
Volume is read only.
E
Media error, indicating the software detects a write error on the disk archive directory.

To set or clear a disk volume dictionary flag, use the diskvols samu command. For more information, see the diskvols command.

(f) - File Systems Display

The f display shows the components of your Sun QFS file systems.

Sample Display

The following example shows the file systems display.

Example 13-7 samu f Display

File systems                                     samu 5.0 08:11:24 Sept 8 2008

ty     eq state          device_name   status    high low mountpoint server
ms     10    on               samfs1  m----2----d 90% 70% /sam1
 md    11    on    /dev/dsk/c5t8d0s3
 md    12    on    /dev/dsk/c5t8d0s4
 md    13    on    /dev/dsk/c5t8d0s5
 md    14    on    /dev/dsk/c5t8d0s6
 md    15    on    /dev/dsk/c5t8d0s7
ms     20    on               samfs2  m----2----d 90% 70% /sam2
 md    21    on    /dev/dsk/c5t9d0s3
 md    22    on    /dev/dsk/c5t9d0s4
 md    23    on    /dev/dsk/c5t9d0s5
 md    24    on    /dev/dsk/c5t9d0s6
 md    25    on    /dev/dsk/c5t9d0s7
ma     30    on                 qfs1  m----2----d 90% 70% /qfs1
 mm    31    on   /dev/dsk/c5t10d0s0
 md    32    on   /dev/dsk/c5t10d0s1
ma     40    on                 qfs2  m----2----d 90% 70% /qfs2
 mm    41    on   /dev/dsk/c5t11d0s0
 md    42    on   /dev/dsk/c5t11d0s1
ma     50    on                 qfs3  m----2---r- 90% 70% /qfs3
 mm    51    on   /dev/dsk/c5t12d0s0
 mr    52    on   /dev/dsk/c5t12d0s1
ma     60    on                 qfs4  m----2---r- 90% 70% /qfs4
 mm    61    on   /dev/dsk/c5t13d0s0
 mr    62    on   /dev/dsk/c5t13d0s1
ma    100    on            shareqfs1  m----2c--r- 80% 70% /shareqfs1 spade
 mm   101    on /dev/dsk/c6t50020F2300004655d0s0
 mr   102    on /dev/dsk/c6t50020F2300004655d0s1
ma    110    on            shareqfs2  m----2c--r- 80% 70% /shareqfs2 spade
 mm   111    on /dev/dsk/c6t50020F2300004655d0s6
 mr   112    on /dev/dsk/c6t50020F2300004655d0s7

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the device.
state
Current operating state of the device. Valid device states are as follows:
  • on The device is available for access.

  • ro The device is available for read-only access.

  • off The device is not available for access.

  • down The device is available only for maintenance access.

  • idle The device is not available for new operations. Operations in progress continue until completion.

  • nalloc The nalloc flag has been set, which prohibits any future allocation to this device. For more information, see Per-Logical Unit Number (LUN) Allocation Control.

device_name
File system name or path to the device.
status
Device status. For a description of status codes, see Status Codes.
high
High disk usage threshold percentage.
low
Low disk usage threshold percentage.
mountpoint
Mount point of the file system.
server
Name of the host system upon which the file system is mounted.

(F) - Optical Disc Label Display

The F display shows the label on an optical disc.

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

(h) - Help Display

The h display shows a summary of the samu displays available. By default, this is the first display that the system presents when you enter the samu command at the command line.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Page forward (top portion)
Ctrl-F
Page forward
Ctrl-U
Page backward (top portion)
Ctrl-K
Toggle path display

Sample Display

The online Help has several pages of help screens. On a Sun QFS file system, not all of the displays appear in the initial help screen. For example, the removable media displays are not available if you are running a Sun QFS system. The following example shows only the first page of the SAM-QFS configuration. Subsequent help screens show samu commands.

Example 13-8 samu Initial Help Screen for a Sun SAM System

Help information    page 1/15    samu 5.0     08:18:13 Sept 8 2008
Displays:
    a    Archiver status                 w    Pending stage queue
    c    Device configuration            C    Memory
    d    Daemon trace controls           D    Disk volume dictionary
    f    File systems                    F    Optical disk label
    h    Help information                I    Inode
    l    Usage information               J    Preview shared memory
    m    Mass storage status             K    Kernel statistics
    n    Staging status                  L    Shared memory tables
    o    Optical disk status             M    Shared memory
    p    Removable media load requests   N    File system parameters
    r    Removable media                 P    Active Services
    s    Device status                   R    SAM-Remote
    t    Tape drive status               S    Sector data
    u    Staging queue                   T    SCSI sense data
    v    Robot catalog                   U    Device table

    more (ctrl-f)

(I) - Inode Display

The I display shows the content of inodes.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Previous inode
Ctrl-F
Next inode
Ctrl-K
Advance display format

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the inode display.

Example 13-9 samu I Display

Inode     0x1 (1) format: file          samu     5.0 08:27:14 Sept 8 2008
    incore: y

00008100 mode       -r--------          409cdf57 access_time
00000001 ino        (1)                 1d32ea20
00000001 gen        (1)                 4096b499 modify_time
00000002 parent.ino (2)                 02588660
00000002 parent.gen (2)                 4096b499 change_time
00000000 size_u                         02588660
000c0000 size_l     (786432)            4096b443 creation_time
01000000 rm:media/flags                 409a8a7c attribute_time
00000000 rm:file_offset                 409c0ce6 residence_time
00000000 rm:mau                         00000000 unit/cs/arch/flg
00000000 rm:position                    00000000 ar_flags
00000000 ext_attrs  --------            00000000 stripe/stride/sg
00000000 ext.ino    (0)                 00000000 media  -- --
00000000 ext.gen    (0)                 00000000 media  -- --
00000000 uid        root                00000000 psize      (0)
00000000 gid        root                000000c0 blocks     (192)
00000001 nlink      (1)                 00000600 free_ino   (1536)
00011840 status -n-------  ----- -- --

Extents (4k displayed as 1k):
00_ 000000d0.00 000000e0.00 000000f0.00 00000100.00 00000110.00 00000120.00
06_ 00000130.00 00000140.00 00000150.00 00000160.00 00000170.00 00000180.00
12_ 00000190.00 000001a0.00 000001b0.00 000001c0.00 00000630.00 00000000.00
18_ 00000000.00

(J) - Preview Shared Memory Display

The J display shows the shared memory segment for the preview queue.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-U
Half-page backward

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the preview shared memory display. This sample output has been truncated.

Example 13-10 samu J Display

Preview shared memory   size: 155648    samu 5.0 08:30:05 Sept 8 2008

00000000  00040000 00014d58 00000000 00000000  ......MX........
00000010  00000000 00000000 73616d66 73202d20  ........samfs -
00000020  70726576 69657720 6d656d6f 72792073  preview memory s
00000030  65676d65 6e740000 00026000 00000000  egment..........
00000040  00025fff 00000000 00040000 00014d58  .._...........MX
00000050  00000000 00000000 00000000 00000000  ................
00000060  0000d9e0 00000064 00000000 000001b8  ..Y.....d.......8
00000070  3f800000 447a0000 0000d820 00000008  ?...Dz....X ....

(K) - Kernel Statistics Display

The K display shows kernel statistics, such as the number of inodes currently in memory.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-F
Page forward

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the kernel statistics display.

Example 13-11 samu K Display

Kernel statistics                       samu 5.0     08:33:19 Sept 8 2008

module: sam-qfs  name: general instance: 0 class: fs
version                       4.4.sam-qfs, gumball 2004-05-07 12:12:04
configured file systems       8
mounted file systems          8
nhino                         16384
ninodes                       129526
inocount                      129527
inofree                       128577

(l) - Usage Display

The l display shows the usage information for the file system, including the capacity and space used for each library and file system.

Sample Display

The following example shows a sample usage display.

Example 13-12 samu l Display

Usage information                     samu     5.0 08:36:27 Sept 8 2008

hostid = 80e69e6e OS name: SunOS Architecture: SPARC CPUs: 2 (2 online)

library     40: capacity    389.3G     bytes space    291.1G    bytes, usage     25%
library     51: capacity    9.5G       bytes space    9.5G      bytes, usage     0%
library     55: capacity    0          bytes space    0         bytes, usage     0%
library     56: capacity    10.7G      bytes space    10.7G     bytes, usage     0%
library totals: capacity    409.5G     bytes space    311.3G    bytes, usage     24%

filesystem samfs3: capacity    54.5M    bytes space    13.4M    bytes, usage     75%
filesystem samfs4: capacity    319.5M   bytes space    298.0M   bytes, usage      7%
filesystem samfs7: capacity    96.6M    bytes space    69.6M    bytes, usage     28%
filesystem samfs6: capacity    5.0G     bytes space    4.9G     bytes, usage      3%
filesystem samfs8: capacity    5.0G     bytes space    4.9G     bytes, usage      2%
filesystem totals: capacity    10.5G    bytes space    10.2G    bytes, usage      3%

Note - In versions of the software before 4.3, this display showed license information for the file system.


(L) - Shared Memory Tables

The L display shows the location of the shared memory tables. It also shows some system defaults that are kept in shared memory.

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following shows the shared memory tables.

Example 13-13 samu L Display

Shared memory tables                    samu 5.0 08:38:31 May  8 2008

shm ptr tbl:                            defaults:
size            12000 (73728)           optical         mo
left            44c8 (17608)            tape            lt
scanner pid     1861                    timeout         600
fifo path       01b0 /var/opt/SUNWsamfs/previews        100
dev_table       01cc                    stages          1000
first_dev       0450                    log_facility    184
scan_mess       cf50                    dio minfilesize 100
preview_shmid   1                       label barcode   FALSE
flags           0x20000000              barcodes low    FALSE
preview stages  55776                   export unavail  FALSE
preview avail   100                     attended        TRUE
preview count   0                       start rpc       FALSE
preview sequence  445
age factor         1                    vsn factor      1000
fs tbl ptr 0xd820                       fs count  8
fseq  10 samfs1 state 0      0      0      0      0
fseq  20 samfs2 state 0      0      0      0      0
fseq  30 qfs1 state 0      0      0      0      0
fseq  40 qfs2 state 0      0      0      0      0
fseq  50 qfs3 state 0      0      0      0      0
fseq  60 qfs4 state 0      0      0      0      0
fseq  100 shareqfs1 state 0      0      0      0      0
fseq  110 shareqfs2 state 0      0      0      0      0

(m) - Mass Storage Status Display

The m display shows the status of mass storage file systems and their member drives. This display shows only mounted file systems.

Sample Display

The following example shows the mass storage status display. Member drives are indented one space and appear directly below the file system to which they belong.

Example 13-14 samu m Display

Mass storage status                     samu 5.0     08:41:11 Sept 8 2008

ty      eq  status       use state ord  capacity      free    ra  part high low
ms      10  m----2----d   1% on          68.354G   68.343G    1M    16  90% 70%
 md      11               1% on      0   13.669G   13.666G
 md      12               1% on      1   13.669G   13.667G
 md      13               1% on      2   13.669G   13.667G
 md      14               1% on      3   13.674G   13.672G
 md      15               1% on      4   13.674G   13.672G
ms      20  m----2----d   1% on          68.354G   68.344G    1M    16  90% 70%
 md      21               1% on      0   13.669G   13.667G
 md      22               1% on      1   13.669G   13.667G
 md      23               1% on      2   13.669G   13.667G
 md      24               1% on      3   13.674G   13.672G
 md      25               1% on      4   13.674G   13.672G
ma      30  m----2----d   4% on          64.351G   61.917G    1M    16  90% 70%
 mm      31               1% on      0    4.003G    3.988G [8363840 inodes]
 md      32               4% on      1   64.351G   61.917G
ma      40  m----2----d   1% on          64.351G   64.333G    1M    16  90% 70%
 mm      41               1% on      0    4.003G    3.997G [8382784 inodes]
 md      42               1% on      1   64.351G   64.333G
ma      50  m----2---r-   1% on          64.351G   64.333G    1M    16  90% 70%
 mm      51               1% on      0    4.003G    3.997G [8382784 inodes]
 mr      52               1% on      1   64.351G   64.333G
ma      60  m----2---r-   1% on          64.351G   64.331G    1M    16  90% 70%
 mm      61               1% on      0    4.003G    3.997G [8382784 inodes]
 mr      62               1% on      1   64.351G   64.331G
ma     100  m----2c--r-   2% on         270.672G  265.105G    1M    16  80% 70%
 mm     101               1% on      0    2.000G    1.988G [4168992 inodes]
 mr     102               2% on      1  270.672G  265.469G
ma     110  m----2c--r-   3% on         270.656G  263.382G    1M    16  80% 70%
 mm     111               1% on      0    2.000G    1.987G [4167616 inodes]
 mr     112               2% on      1  270.656G  264.736G

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the mass storage device.
status
Device status. For a description of status codes, see Status Codes.
use
Percentage of disk space in use.
state
Current operating state of the mass storage device.
ord
Ordinal number of the disk device within the storage family set.
capacity
Number of 1024-byte blocks of usable space on the disk.
free
Number of 1024-byte blocks of disk space available.
ra
Read-ahead size in kilobytes.
part
Partial stage size in kilobytes.
high
High disk usage threshold percentage.
low
Low disk usage threshold percentage.

(M) - Shared Memory Display

The M display shows the raw shared memory segment in hexadecimal. This is a device table.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-U
Half-page backward

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the shared memory display. The sample output has been truncated.

Example 13-15 samu M Display

Shared memory       size: 73728         samu 5.0     08:43:20 May  8 2008

00000000  00040000 00014d58 00000000 00000000  ......MX........
00000010  00000000 00000000 73616d66 73202d20  ........samfs -
00000020  73686172 6564206d 656d6f72 79207365  shared memory se
00000030  676d656e 74000000 00012000 000044c8  gment..... ...DH
00000040  0000dd20 00000000 00000742 00000745  ..] .......B...E
00000050  00000001 00000000 00000000 c0000000  ............@...
00000060  00000001 0001534d 00000000 00000000  ......SM........
00000070  00000000 00000000 00000000 00000000  ................

00000080  00000000 00000000 00000000 00000000  ................
00000090  20000000 000001b0 000001cc 00000450   ......0...L...P
000000a0  0000cf50 00000001 00000001 4c696365  ..OP........Lice
000000b0  6e73653a 204c6963 656e7365 206e6576  nse: License nev
000000c0  65722065 78706972 65732e00 00000000  er expires......
000000d0  00000000 00000000 00000000 00000000  ................
000000e0  00000000 00000000 00000000 00000000  ................
000000f0  00000000 00000000 00000000 00000000  ................

(n) - Staging Status Display

The n display shows the status of the stager for all media. It displays a list of outstanding stage requests. To display the staging status for a specific media type:

n mt

For mt, specify one of the media types shown in the mcf(4) man page.

Sample Display

The following example shows the staging status display.

Example 13-16 samu n Display

Staging status                          samu 5.0     08:47:16 May  8 2008

Log output to: /var/opt/SUNWsamfs/stager/log

Stage request: dt.DAT001
Loading VSN DAT001

Staging queues
ty pid    user         status     wait  files  vsn
dt 16097  root         active     0:00    12   DAT001

(N) - File System Parameters Display

The N display shows all mount point parameters, the superblock version, and other file system information.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Previous file system
Ctrl-D
Page partitions forward
Ctrl-F
Next file system
Ctrl-I
Detailed status interpretations
Ctrl-U
Page partitions backward

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the file system parameters display.

Example 13-17 samu N Display

File system parameters                  samu 5.0     08:55:19 Sept 8 2008

mount_point    : /sam1                  partial        : 16k
fs_type        : 6                      maxpartial     : 16k
server         :                        partial_stage  : 16384
filesystem name: samfs1                 flush_behind   : 0
eq  type       : 10 ms                  stage_flush_beh: 0
state version  :    0    2              stage_n_window : 262144
(fs,mm)_count  :    5    0              stage_retries  : 3
sync_meta      : 0                      stage timeout  : 0
stripe         : 0                      dio_consec r,w :    0    0
mm_stripe      : 1                      dio_frm_min r,w:  256  256
high  low      :  90%  70%              dio_ill_min r,w:    0    0
readahead      : 1048576                ext_bsize      : 4096
writebehind    : 524288
wr_throttle    : 16777216
rd_ino_buf_size: 16384
wr_ino_buf_size: 512
config         : 0x08520530             mflag          : 0x00000044
status         : 0x00000001

Device configuration:
ty   eq state   device_name                        fs family_set
md   11 on      /dev/dsk/c5t8d0s3                  10 samfs1
md   12 on      /dev/dsk/c5t8d0s4                  10 samfs1
md   13 on      /dev/dsk/c5t8d0s5                  10 samfs1
md   14 on      /dev/dsk/c5t8d0s6                  10 samfs1
md   15 on      /dev/dsk/c5t8d0s7                  10 samfs1

(o) - Optical Disc Status Display

The o display shows the status of all optical disk drives configured within the environment.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-F
Page forward
Ctrl-D
Half-page forward
Ctrl-K
Select (manual, automated library, both, priority)
Ctrl-U
Half-page backward

Sample Display

The following example shows the optical disc drive status display.

Example 13-18 samu o Display

Optical disk status            samu    5.0     Thu Oct 11 13:15:40
ty  eq  status      act  use  state  vsn
mo  35  --l---wo-r    1  29%  ready  oper2

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the optical disc drive.
status
Device status. For a description of status codes, see Status Codes.
act
Activity count.
use
Percentage of cartridge space used.
state
Current operating state of the optical disc drive. Valid device states are as follows:
  • ready The device is on, and the disc is loaded in the transport; available for access.

  • notrdy The device is on, but no disc is present in the transport.

  • idle The device is not available for new connections. Operations in progress continue until completion.

  • off The device is not available for access.

  • down The device is available only for maintenance access.

vsn
Volume serial name assigned to the optical disc, or the keyword nolabel if the volume is not labeled.

(p) - Removable Media Load Requests Display

The p display lists information about pending load requests for removable media. You can use the mt argument to select either a specific type of media, such as DLT tape, or a family of media, such as tape. The priority display lists the priority in the preview queue, rather than the user queue, and sorts the entries by priority.

The displays shows mount requests in the following formats:

To display mount requests for devices of a given removable media type:

p mt

For mt, specify one of the media types shown in the mcf(4) man page.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-K
Toggle between the different display formats
Ctrl-U
Half-page backward

Sample Display

The following example shows the removable media load requests display.

Example 13-19 samu p Display

Removable media load requests all both  samu 5.0 09:14:19 Sept 8 2008
    count: 1

index type pid     user         rb   flags     wait count  vsn
   0  dt   15533   root         150  W--f---   0:00        DAT001

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
index
Index number in the preview table.
type
Device type code assigned to the removable media.
pid
UNIX process identifier. A process identifier of 1 indicates NFS access.
user
Name assigned to the user requesting the load.
priority
Priority of the request.
rb
Equipment number of the automated library in which the requested VSN resides.
flags
Flags for the device. See the Table 13-1table.
wait
The elapsed time since the mount request was received.
count
The number of requests for this VSN, if it is a stage.
vsn
Volume serial name of the volume.

Flags

The following table shows the flags for the p display.

Table 13-1 Flag Values for the samu p Display

Flag
Description
W-------
Write access requested
}}{{{}b----
Entry is busy
-C---
Clear VSN requested
--f--
File system requested
---N-
Media is foreign to the file system
---S{-}
Flip side already mounted
------s
Stage request flag

(P) - Active Services Display

The P display lists the services registered with the Sun QFS single port multiplexer.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-F
Page forward

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the active services display.

Example 13-20 samu P Display

Active Services                         samu     5.0    09:08:33 Sept 8 2008

Registered services for host ”pup’:
    sharedfs.qfs2
    sharedfs.qfs1
  2 services registered.

(r) - Removable Media Status Display

The r display monitors the activity on removable media devices such as tape drives. You can monitor either a specific type of device, such as video tape, or a family of devices such as all tape devices.

To display the status for a specific device:

r  eq

For eq, specify the equipment number for the device.

Sample Display

The following example shows the removable media status display.

Example 13-21 samu r Display

Removable media status: all             samu 5.0     09:11:27 Sept 8 2008

ty   eq  status      act  use  state    vsn
dt  150  --l------r    0  63%  ready    DAT001

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the drive.
status
Device status. For a description of status codes, see Status Codes.
act
Activity count.
use
Percentage of cartridge space used.
state
Current operating state of the removable media. Valid device states are as follows:
  • ready The device is on, and the disk or tape is loaded in the transport available for access.

  • notrdy The device is on, but no disk or tape is present in the transport.

  • idle The device is not available for new connections. Operations in progress continue until completion.

  • off The device is not available for access.

  • down The device is available only for maintenance access.

  • nalloc The nalloc flag has been set, which prohibits any future allocation to this device. For more information, see Per-Logical Unit Number (LUN) Allocation Control.

vsn
Volume serial name assigned to the volume, or the keyword nolabel if the volume is not labeled. Blank if no volume is present in the transport, or device is off.

(R) - Sun SAM-Remote Information Display

The R display shows information and status on Sun SAM-Remote configurations.

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

(s) - Device Status Display

The s display shows the status for all devices configured within the environment.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-U
Half-page backward

Sample Display

The following example shows the device status display.

Example 13-22 samu s Display

Device status                           samu     5.0     
09:14:05 Sept 8 2008

ty     eq     state   device_name                        fs  status       pos
sk    100     on      /etc/opt/SUNWsamfs/dcstkconf       100 m--------r  
stk_dismount / (2275) 0, volser 700073
sg    120     on      /dev/rmt/2cbn                      100 ---------p   empty
sg    130     on      /dev/rmt/5cbn                      100 --l----o-r   
Ready for data transfer
sg    140     on      /dev/rmt/6cbn                      100 ---------p   empty
sg    150     on      /dev/rmt/4cbn                      100 ---------p   empty
hy    151     on      historian                          151 ----------

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the device.
state
Current operating state of the device.
device_name
Path to the device. For file system devices, this is the file system name.
fs
Equipment number of the family set to which the device belongs.
status
Device status. For a description of status codes, see Status Codes.

(S) - Sector Data Display

The S display shows raw device data.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Previous sector
Ctrl-D
Page forward (top portion)
Ctrl-F
Next sector
Ctrl-K
Advance display format
Ctrl-U
Page backward (top portion)

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

(t) - Tape Drive Status Display

The t display shows the status of all tape drives configured within the environment.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-F
Page forward

Sample Display

The following example shows the tape drive status display.

Example 13-23 samu t Display

Tape drive status                       samu     5.0     09:21:07 Sept 8 2008

ty   eq  status      act  use  state    vsn
sg  120  ---------p    0   0%  notrdy          empty
sg  130  ---------p    0   0%  notrdy          empty
sg  140  ---------p    0   0%  notrdy          empty
sg  150  --l------r    0  41%  ready    700088 idle

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type.
eq
Equipment number of the drive.
status
Device status. For a description of status codes, see Status Codes.
act
Activity count.
use
Percentage of cartridge space used.
state
Current operating state of the removable media. Valid device states are as follows:
  • ready The device is on and the disk or tape is loaded in the transport; available for access.

  • notrdy The device is on but no disk or tape is present in the transport.

  • idle The device is not available for new connections. Operations in progress continue until completion.

  • off The device is not available for access.

  • down The device is available only for maintenance access.

  • nalloc The nalloc flag has been set, which prohibits any future allocation to this device. For more information, see Per-Logical Unit Number (LUN) Allocation Control.

vsn
Volume serial name assigned to the volume, or the keyword nolabel if volume is not labeled. Blank if no volume is present in the transport, or device is off.

(T) - SCSI Sense Data Display

The T display shows the SCSI status of a SCSI device.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Previous equipment
Ctrl-F
Next equipment

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

(u) - Staging Queue Display

The u display lists all files in the staging queue.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-K
Display the path on the second line of each entry
Ctrl-U
Half-page backward

Sample Display

The following example shows the staging queue display.

Example 13-24 samu u Display

Staging queue by media type: all        samu 5.0     09:24:23 Sept 8 2008
     volumes 1 files 22

ty     length  fseq        ino   position     offset vsn

dt   451.611k    20       1030      207cc        473 DAT001
dt   341.676k    20       1031      207cc        7fc DAT001
dt   419.861k    20       1032      207cc        aa9 DAT001
dt   384.760k    20       1033      207cc        df2 DAT001
dt   263.475k    20       1034      207cc       10f5 DAT001
dt   452.901k    20       1035      207cc       1305 DAT001
dt   404.598k    20       1036      207cc       1690 DAT001
dt   292.454k    20       1037      207cc       19bb DAT001
dt   257.835k    20       1038      207cc       1c05 DAT001
dt   399.882k    20       1040      207cc       1e0b DAT001
dt   399.882k    40       1029      208d7          2 DAT001
dt   257.835k    40       1030      208d7        323 DAT001
dt   292.454k    40       1031      208d7        528 DAT001
dt   404.598k    40       1032      208d7        772 DAT001
dt   452.901k    40       1033      208d7        a9d DAT001
dt   263.475k    40       1034      208d7        e28 DAT001
dt   384.760k    40       1035      208d7       1038 DAT001
dt   419.861k    40       1036      208d7       133b DAT001
dt   341.676k    40       1037      208d7       1684 DAT001
dt   451.611k    40       1038      208d7       1931 DAT001
dt   161.326k    40       1039      208d7       1cba DAT001
dt   406.400k    40       1040      208d7       1dfe DAT001

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type
length
File length
fseq
File system equipment number
ino
The inode number
position
The position of the archive file on the specific medium
offset
Offset of the archive file on the specific medium
vsn
Volume serial name of the volume

(U) - Device Table Display

The U display shows the device table in a human-readable form.

To display the device table for a specific device:

U eq

For eq, specify the equipment number of the device.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Previous equipment
Ctrl-F
Next equipment

This display is designed for debugging. It is intended to be used only with the assistance of an Oracle support staff person.

Sample Display

The following example shows the device table display.

Example 13-25 samu U Display

Device table: eq: 10    addr: 00000450  samu 5.0     09:28:40 Sept 8 2008

message:

0004000000014d58 0000000000000000       00000000 delay
0000000000000000 mutex                  00000000 unload_delay
00000aa8 next
73616d66 set:  samfs1
73310000
00000000
00000000
000a000a eq/fseq
08010801 type/equ_type
0000     state
00000000 st_rdev
00000000 ord/model
00000000 mode_sense
00000000 sense
00000000 space
00000000 capacity
00000000 active
00000000 open
00000000 sector_size
00000000 label_address
00000000 vsn:
00000000
00000000
00000000
00000000 status: ----------
00000000 dt
73616d66 name: samfs1

(v) - Automated Library Catalog Display

The v display shows the location and VSN of all disks or tapes currently catalogued in the automated library.

To display catalog information for a specific device:

v eq

For eq, specify the equipment number of the device. Type the keyword historian to view the historian catalog.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl -B
Page backward.
Ctrl -D
Next library catalog.
Ctrl -F
Page forward.
Ctrl -I
Detailed, two-line display format. When you enter Ctrl -I once, it shows times and barcodes. When you enter Ctrl -I a second time, it shows volume reservations on the second line.
Ctrl -K
Advance sort key. After you enter Ctrl-K, you can type one of the following numbers to select a sort key:
1 - Sort by slot
2 - Sort by count
3 - Sort by usage
4 - Sort by VSN
5 - Sort by access time
6 - Sort by barcode
7 - Sort by label time
Ctrl-U
Previous automated library catalog.
/
Search for VSN.
%
Search for barcode.
$
Search for slot.

Sample Display

The following example shows the automated library catalog display.

Example 13-26 samu v Display

Robot VSN catalog by slot       : eq 100samu     5.0     09:30:25 Sept 8 2008
    count 32
slot          access time count use flags         ty vsn

   0     2004/05/08 08:35   64   0% -il-o-b-----  sg 700071
   1     2004/05/08 09:08   27  12% -il-o-b-----  sg 700073
   2     2004/05/08 09:12   26  12% -il-o-b-----  sg 700077
   3     2004/05/08 08:39   37  40% -il-o-b-----  sg 700079
   4     2004/05/08 09:16   24   6% -il-o-b-----  sg 700084
   5     2004/05/08 09:18   24  41% -il-o-b-----  sg 700088
   6     none                0   0% -il-o-b-----  sg 700090
   7     none                0   0% -il-o-b-----  sg 700092
   8     none                0   0% -il-o-b-----  sg 000155
   9     none                0   0% -il-o-b-----  sg 000156
  10     none                0   0% -il-o-b-----  sg 000157
  11     none                0   0% -il-o-b-----  sg 000158
  12     none                0   0% -il-o-b-----  sg 000154
  13     none                0   0% -il-o-b-----  sg 000153
  14     none                0   0% -il-o-b-----  sg 000152

Field Descriptions

The following table shows the field descriptions for this display.

Table 13-2 samu v Display Field Descriptions

Field
Description
Robot VSN catalog
Name of the specified automated library and time the display refreshed.
count
Number of slots allocated in this library's catalog.
slot
Slot number within the specified library.
access time
Time the volume was last accessed.
count
Number of accesses to this volume since the last audit operation.
use
Percentage of space used for the volume.
flags
Flags for the device. See the table in the Table 13-3 section for information about the flags.
ty
Device type.
vsn
Volume serial name of the volume.
LVTime
Time stamp of when the entire tape was last verified.
LVPos
Position where the tpverify command was canceled.

Flags

The following table shows the flags using in the flags field. In some cases, more than one flag can occur in a field, and one flag overrides the other.

Table 13-3 Flags Values for samu v Display

Flags
Description
A-----------
Volume needs audit.
}}{{{}i--------
Slot in use.
-l--------
Labeled. Overrides N.
-N--------
Unlabeled. This volume is foreign to the environment.
--E-------
Media error. Set when the software detects a write error on a cartridge.
--o-----
Slot occupied.
---C----
Volume is a cleaning tape. Overrides p.
---p----
Priority VSN.
----b---
Barcode detected.
-----W--
Write protect. Set when the physical write protection mechanism is enabled on a cartridge.
------R{-}--
Read only.
-------c{-}-
Recycle.
--------d{-}
Duplicate VSN. Overrides U.
--------U{-}
Volume unavailable.
---------f
Archiver found volume full.
---------X
Export slot.

(w) - Pending Stage Queue

The w display shows queued stage requests for which the volumes have not yet been loaded.

To display the pending stage queue for a specific media type:

w mt

For mt, specify one of the media types shown in the mcf(4) man page.

Navigation

The following table shows the control keys you can use in this display.

Key
Function
Ctrl-B
Page backward
Ctrl-D
Half-page forward
Ctrl-F
Page forward
Ctrl-K
Display the path on the second line of each entry
Ctrl-U
Half-page backward

Sample Display

The following example shows the pending stage queue display.

Example 13-27 samu w Display

Pending stage queue by media type: all     samu     5.0     Thu Oct 11 13:20:27
    volumes 1 files 13

ty     length  fseq  ino  position  offset  vsn

at     1.383M     1   42     3a786    271b  000002
at     1.479M     1   56     3a786    5139  000002
at  1018.406k     1   60     3a786    6550  000002
at     1.000M     1   65     3a786    7475  000002
at     1.528M     1   80     3a786    99be  000002
at     1.763M     1   92     3a786    ce57  000002
at     1.749M     1  123     3a786   11ece  000002
at   556.559k     1  157     3a786   1532f  000002
at   658.970k     1  186     3a786   17705  000002
at   863.380k     1  251     3a786   1dd58  000002
at     1.268M     1  281     3a786   1f2b7  000002
at     1.797M     1  324     3a786   23dfa  000002
at     1.144M     1  401     3a786   2bb6d  000002

Field Descriptions

The following table shows the field descriptions for this display.

Field
Description
ty
Device type
length
File length
fseq
File system equipment number
ino
The inode number
position
The position (in decimal format) of the archive file on the specific medium
offset
Offset of the archive file on the specific medium
vsn
Volume serial name of the volume

Status Codes

The operator displays have different status codes for the removable media device displays and the file system displays. The following sections describe these status codes.

Removable Media Device Display Status Codes

The o, r, s, and t operator displays show status codes for removable media devices. Status codes are displayed in a 10-position format, reading from left (position 1) to right (position 10).

These status codes do not apply to the samu f, m, and v displays. For information about the status codes for the f and m displays, see Table 13-5. For information about the status codes for the v display, see (v) - Automated Library Catalog Display.

The following table defines the status codes for each position.

Table 13-4 Status Code for Removable Media Device Display

Status Bit
Meaning for a Device
s---------
Media is being scanned
m---------
The automated library is operational
M---------
Maintenance mode
}}{{{}E-------
Device received an unrecoverable error in scanning
}}{{{}a-------
Device is in audit mode
-l------
Media has a label
-N------
Foreign media
-L------
Media is being labeled
--I-----
Waiting for device to idle
--A-----
Needs operator attention
--C---
Needs cleaning
--U---
Unload has been requested
---R--
Device is reserved
----w{-}--
A process is writing on the media
-----o{-}-
Device is open
------P{-}
Device is positioning (tape only)
------F{-}
For automated libraries, all storage slots occupied. For tape and magneto-optical drives, media is full
---------R
Device is ready and the media is read-only
---------r
Device is spun up and ready
---------p
Device is present
---------W
Device is write protected

File System Display Status Codes

The f and m operator displays show status codes for file systems. Status codes are displayed in an 11-position format, reading from left (position 1) to right (position 11).

These status codes do not apply to the samu c, o, r, s, t, or v displays. For information about the status codes for the o, r, s, and t displays, see Table 13-4. For information about the status codes for the v display, see (v) - Automated Library Catalog Display.

The following table defines the status codes for each position.

Table 13-5 File System Display Status Codes

Status Bit
Meaning for a File System
m----------
File system is currently mounted
M----------
File system is being mounted
}}{{{}u--------
File system is being unmounted
-A-------
File system data is being archived
--R------
File system data is being released
--S----
File system data is being staged
---1---
Sun SAM file system version 1
---2---
Sun SAM file system version 2
----c--
Sun QFS shared file system
-----W{-}--
Single writer
------R{-}-
Multireader
-------r{-}
mr devices
----------d
md devices

States of an Operator Display Device

The c, m, o, r, s, and t operator displays show state codes for each device. These codes represent the current access state for the device.

The following table defines the state codes.

Table 13-6 Operator Display Device States

Device State
Description
on
The device is available for access. For certain displays, this state might be superseded by the states ready or notrdy.
ro
The device is available for read-only access. For certain displays, this state might be superseded by the states ready or notrdy.
off
The device is not available for access. For tape and optical disk drives, possible reasons for the device to be in the off state include the following:
  • Cleaning was requested but no cleaning cartridge was found in the automated library.

  • The cleaning cartridge cannot be loaded or unloaded from the drive.

  • Initialization found the drive status to be full and attempts to clear the drive failed.

  • The system was unable to clear a cartridge from a drive.

  • Opening the drive for I/O failed during spin-up.

  • An error other than NOT READY was received when spinning down the drive for unloading.

  • Opening the standard tape driver on the drive failed during spin-up.

down
The device is available for maintenance access only.
idle
The device is not available for new connections. Operations in progress continue until completion.
ready
The device is on and the disk or tape loaded in the transport is available for access.
notrdy
The device is on but no disk or tape is present in the transport.
unavail
The device is unavailable for access and cannot be used for automatic operations. You can continue to use the load and the unload commands for moving media while the device is in the unavail state.
nalloc
The nalloc flag has been set, which prohibits any future allocation to this device. For more information, see Per-Logical Unit Number (LUN) Allocation Control.

You can use the samu down, off, and on device state commands to change device states. You can issue these commands from any samu display, but if you issue them from the c, m, o, r, s, or t display, you can see the change in the display.

The following procedure show how to change a device's state from down to on.

How to Change a Drive State From down to on

  1. Type one of the following character keys to invoke a samu display that show drive and automated library device states: c, m, o, r, s, or t.
  2. Choose a device and verify that it is in the down state.
  3. Issue the off command to stop all activity for the device.
    command:off eq

    where eq is the equipment number of the device.

  4. Issue the on command.

    For example:

    Command:on eq

    For eq, specify the equipment number of the device.