NetWorker command:      cdi_load_unload

NAME

       cdi_load_unload - load or unload a tape device

SYNOPSIS

       cdi_load_unload -f  device { -l | -u } [ -a ] [ -e ] [ -r ] [ -v ] [ -t
                       { s | t | g | n | m | i } ]

DESCRIPTION

       The cdi_load_unload program loads or unloads medium into or from a tape
       device.

OPERANDS

       -f     device
            Specifies the device to perform the load/unload operation on.

       { -l | -u }
              Perform a load (-l) or unload (-u) medium operation.

OPTIONS

       -a     Use  asynchronous  I/O  for the operation.  Rather than blocking
              till completion, the program will return immediately.   If  this
              flag  is  set  and  CHECK  CONDITION  status is returned for the
              load/unload operation, the load or unload operation will not  be
              performed.  The default is synchronous I/O.

       -e     Position  to end-of-medium before unloading the medium.  If this
              flag is specified with the -l flag (i.e., load medium), the SCSI
              device will return CHECK CONDITION status and the sense key will
              be set to ILLEGAL REQUEST in the sense data.

       -r     Apply the correct tension to the medium.  Not all  devices  have
              the  capability  to  re-tension media.  Please refer to the spe-
              cific device manuals to confirm whether the re-tension  function
              is available for the device.

       -t     Use the -t option to specify the method of tape functions to use
              to load/unload medium.  If the -t option is not  specified,  the
              default  method  is  to  use the OS tape driver SCSI passthrough
              functions.  Please refer to the libcdi (1) manpage  for  a  com-
              plete   list  of  access  methods  currently  supported  by  the
              cdi_load_unload program.

       -v     Run the program in verbose mode.  This option will print out the
              version number of the CDI library used by the program.

EXAMPLES

       Sample output from cdi_load_unload:

     % cdi_load_unload -l -f /dev/rmt/2cbn

     cdi load unload succeeds for   via /dev/rmt/2cbn:
       elapsed time for command was 0 seconds
       cdi_info.drivestat is:
         status = 0, DRIVE_STATUS_READY
         msg = The tape drive is ready for use

SEE ALSO

	libcdi(8)

NetWorker 7.5.1			 Mar 21, 09