JavaScript is required to for searching.
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
search filter icon
search icon

Document Information

Preface

1.  User Commands (Man Pages Section 1)

2.  Maintenance Commands (Man Pages Section 1M)

archive_audit(1M)

archive_mark(1M)

archiver(1M)

archiver.sh(1M)

arcopy(1M)

arfind(1M)

auditslot(1M)

backto(1M)

build_cat(1M)

chmed(1M)

cleandrive(1M)

clri(1M)

damage(1M)

dev_down.sh(1M)

dmpshm(1M)

dump_cat(1M)

dump_log(1M)

exarchive(1M)

export(1M)

fsmadm(1M)

fsmdb(1M)

fsmgmtd(1M)

fsmgr(1M)

fsmgr_setup(1M)

fsmupd(1M)

generic(1M)

gnutar(1M)

HAStoragePlus_samfs(1M)

import(1M)

itemize(1M)

load(1M)

load_notify.sh(1M)

log_rotate.sh(1M)

mccfg(1M)

mount_samfs(1M)

move(1M)

nrecycler.sh(1M)

odlabel(1M)

qfsdump(1M)

qfsrestore(1M)

rearch(1M)

recover.sh(1M)

recycler(1M)

recycler.sh(1M)

releaser(1M)

reserve(1M)

restore.sh(1M)

robots(1M)

rpc.sam(1M)

sam-amld(1M)

sam-archiverd(1M)

sam-arcopy(1M)

sam-arfind(1M)

sam-catserverd(1M)

sam-clfsd(1M)

sam-clientd(1M)

sam-dbupd(1M)

sam-fsalogd(1M)

sam-fsd(1M)

sam-ftpd(1M)

sam-genericd(1M)

sam-grau_helper(1M)

sam-ibm3494d(1M)

sam-nrecycler(1M)

sam-recycler(1M)

sam-releaser(1M)

sam-rftd(1M)

sam-robotsd(1M)

sam-rpcd(1M)

sam-scannerd(1M)

sam-serverd(1M)

sam-sharefsd(1M)

sam-shrink(1M)

sam-sony_helper(1M)

sam-sonyd(1M)

sam-stagealld(1M)

sam-stagerd(1M)

sam-stagerd_copy(1M)

sam-stk_helper(1M)

sam-stkd(1M)

samadm(1M)

sambcheck(1M)

samchaid(1M)

samcmd(1M)

samcrondump(1M)

samcronfix(1M)

samd(1M)

samdb(1M)

samexplorer(1M)

samexport(1M)

samfsck(1M)

samfsconfig(1M)

samfsdump(1M)

samfsinfo(1M)

samfsrestore(1M)

samfstyp(1M)

samgetmap(1M)

samgetvol(1M)

samgrowfs(1M)

samimport(1M)

samload(1M)

sammkfs(1M)

samncheck(1M)

samquota(1M)

samquotastat(1M)

samset(1M)

samsharefs(1M)

samsnoop(1M)

samstorade(1M)

samtrace(1M)

samu(1M)

samunhold(1M)

save_core.sh(1M)

scanner(1M)

scsi_trace_decode(1M)

sefreport(1M)

sendtrap(1M)

set_admin(1M)

set_state(1M)

showqueue(1M)

stageall(1M)

stageback.sh(1M)

star(1M)

tapealert(1M)

tarback.sh(1M)

tplabel(1M)

tpverify(1M)

trace_rotate(1M)

umount_samfs(1M)

unarchive(1M)

undamage(1M)

unload(1M)

unrearch(1M)

unreserve(1M)

3.  Library Functions (Man Pages Section 3)

4.  Library Functions (Man Pages Section 3X)

5.  File Formats (Man Pages Section 4)

6.  Standards, Environment, and Macros (Man Pages Section 5)

7.  Device and Network Interfaces (Man Pages Section 7)

recycler.sh(1M)

NAME
     recycler.sh - Sun Storage Archive Manager (SAM-QFS) recycler
     post-processing script

SYNOPSIS
     /etc/opt/SUNWsamfs/scripts/recycler.sh gen_media vsn slot eq
     specific_media fs_name [ vsn_modifier ]

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The sam-recycler(1M) process executes the
     /etc/opt/SUNWsamfs/scripts/recycler.sh script after it has
     finished draining a cartridge of all known active archive
     images and recycling is complete.

     As released, /etc/opt/SUNWsamfs/scripts/recycler.sh sends
     email to root with the relevant information.

OPTIONS
     This script accepts the following arguments:

     gen_media Generic media type.  Specify od for
               magneto-optical media.  Specify tp for tape media.
               This argument is used to construct the name of the
               appropriate media labeling command, either
               odlabel(1M) or tplabel(1M).

     vsn       The volume serial name (VSN) of the cartridge
               being processed.

     slot      The slot location of the media in the library.

     eq        The Equipment Number of the library in which the
               media cartridge is located.

     specific_media
               The specific media type.  For information on
               specific media types, see the mcf man page.  This
               information is supplied to the chmed(1M) command
               if needed.

     fs_name   Either hy, which represents the historian, or the
               family set name of the library.

     vsn_modifier
               The VSN modifier.  Used only for magneto-optical.

EXAMPLE
     The following is an example
     /etc/opt/SUNWsamfs/scripts/recycler.sh file:

     #!/bin/csh -f
     #
     #   /etc/opt/SUNWsamfs/scripts/recycler.sh - post-process a VSN after recycler has
     #   drained it of all known active archive copies.
     #
     #   Arguments are:
     #      $1 - generic media type "od" or "tp" - used to construct the name
     #           of the appropriate label command: odlabel or tplabel
     #
     #      $2 - VSN of cartridge being post-processed
     #
     #      $3 - Slot in the library where the VSN is located
     #
     #      $4 - equipment number of the library where the VSN is located
     #
     #      $5 - actual media type ("mo", "lt", etc.) - used to chmed
     #           the media if required
     #
     #      $6 - family set name of the physical library, or the string
     #           "hy" for the historian library.    This can be used to
     #           handle recycling of off-site media, as shown below.
     #
     #          $7 - VSN modifier, used for optical and D2 media
     #
     #
     #

     #   It is a good idea to log the calls to this script
     #echo `date` $* >>  /var/opt/SUNWsamfs/recycler.sh.log

     #   As an example, if uncommented, the following lines will relabel the VSN,
     #   if it exists in a physical library.  If the VSN is in the historian
     #   catalog (e.g., it's been exported from a physical library and moved
     #   to off-site storage), then email is sent to "root" informing that the
     #   medium is ready to be returned to the site and reused.
     #
     #set stat=0
     #if ( $6 != hy ) then
     #    /opt/SUNWsamfs/sbin/chmed -R $5.$2
     #    /opt/SUNWsamfs/sbin/chmed -W $5.$2
     #    if ( $5 != "d2" ) then
     #        if ( $1 != "od" ) then
     #            /opt/SUNWsamfs/sbin/${1}label -w -vsn $2 -old $2 $4:$3
     #                       if ( $status != 0 ) then
     #                           set stat = 1
     #                       endif
     #        else
     #            /opt/SUNWsamfs/sbin/${1}label -w -vsn $2 -old $2 $4:$3:$7
     #                       if ( $status != 0 ) then
     #                           set stat = 1
     #                       endif

     #               endif
     #    else
     #        /opt/SUNWsamfs/sbin/${1}label -w -vsn $2 -old $2 $4:$3:$7
     #               if ( $status != 0 ) then
     #                       set stat = 1
     #               endif
     #    endif
     #else
     #    mail root <</eof
     #VSN $2 of type $5 is devoid of active archive
     #images.  It is currently in the historian catalog, which indicates that
     #it has been exported from the on-line libraries.
     #
     #You should import it to the appropriate library, and relabel it using
     #${1}label.
     #
     #This message will continue to be sent to you each time the recycler
     #runs, until you relabel the VSN, or you use the Sun QFS samu or
     #SAM-QFS Manager programs to export this medium from the historian catalog to
     #suppress this message.
     #/eof
     #endif
     #echo `date` $* done >>  /var/opt/SUNWsamfs/recycler.sh.log
     #if ( $stat != 0 ) then
     #       exit 1
     #else
     #       exit 0
     #endif
     #
     #
     #   These lines would inform "root" that the VSN should be removed from the
     #   robotic library:
     #
     #mail root <</eof
     #VSN $2 in library $4 is ready to be shelved off-site.
     #/eof
     #echo `date` $* done >>  /var/opt/SUNWsamfs/recycler.sh.log
     #exit 0

     #  The default action is to mail a message reminding you to set up this
     #  file.  You should comment out these lines (through and including the /eof
     #  below) after you've set up this file.
     #
     mailx -s "Robot $6 at hostname `hostname` recycle." root <</eof
     The /etc/opt/SUNWsamfs/scripts/recycler.sh script was called by
     the SAM-QFS recycler
     with the following arguments:

           Media type: $5($1)  VSN: $2  Slot: $3  Eq: $4
           Library: $6

     /etc/opt/SUNWsamfs/scripts/recycler.sh is a script which is called when the recy
     cler determines that a VSN has been drained of all known active archive
     copies. You should determine your site requirements for disposition of
     recycled media - some sites wish to relabel and reuse the media, some
     sites wish to take the media out of the library for possible later use
     to access historical files.  Consult the recycler(1m) man page for more
     information.
     /eof
     #echo `date` $* done >>  /var/opt/SUNWsamfs/recycler.sh.log
     exit 0

     The example first checks to see if the VSN is in a physical
     library.  If it is, the example script first clears the
     read-only and write-protect catalog bits.  It then issues a
     tplabel(1M) or odlabel(1M) command to relabel the cartridge
     with its existing label.  Relabeling has the effect of
     clearing all the expired archive images from the cartridges,
     thus enabling the archiver to re-use the cartridge.
     Labeling also clears the recycle bit in the VSN's catalog
     entry.

     If the VSN is in the historian catalog, the script sends an
     email message to root.  Note that a cartridge in a manually
     mounted drive is shown in the historian catalog as well, so
     you may want to see if the VSN is currently in a drive and
     relabel it if necessary.

SEE ALSO
     odlabel(1M), sam-recycler(1M), tplabel(1M).