admtape(1M)                    DG/UX R4.11MU05                   admtape(1M)


NAME
       admtape - manipulate the default parameters for tapes

SYNOPSIS
       admtape -o get { -f | -M }

       admtape -o set { -f | -M } value

       admtape -o list [ -qv ] { -f | -M }

DESCRIPTION
       Admtape gets or sets the current default parameters for tape
       operations or lists the possible values for the parameters.
       Currently the list of parameters includes the default file, and the
       default medium type.

       The default file is a device name, such as /dev/rmt/0, which will be
       given as the default drive for tape operations, including performing
       backups and loading software.

       The default medium is a tag from the dumptab file (see dumptab(4))
       which is the default medium to use for backups.

   Operations
       get       Write the default value for a given parameter to the
                 standard output.

       list      List the possible values for the given parameter to
                 standard output.

       set       Set the system-wide default for the given parameter to
                 value.

   Options
       -f        Manipulate the default tape drive for the system.

       -M        Manipulate the default medium type for the system.

       -q        Quiet.  Omit header lines from the output of the list
                 operation.

       -v        Verbose.  Include header lines in the output of the list
                 operation.  This option is enabled by default.

       One of -f and -M must be given to specify which tape parameter is
       used for the operation.

EXAMPLE
       In order to determine the default tape drive for the system, the
       following command line is used:

           $ admtape -o get -f
           /dev/rmt/0
           $


       To set the default medium type, this command line may be used:

           $ admtape -o set -M cartridge
           $


FILES
       /etc/sysadm/mt
                 The file used to maintain the tape defaults information.

       /etc/dumptab
                 List of possible media names.

OUTPUT
       The list operation displays the list of possible values for the given
       parameter to standard output.  No other information is provided.

DIAGNOSTICS
   Warnings
        -  The requested device file does not exist.

        -  The requested medium type is not found in the dumptab file.

   Errors
       None.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       admbackup(1M), admdefault(1M), admpackage(1M), dump2(1M), sysadm(1M),
       cap_defaults(5), dumptab(4).

NOTES
       You must have write permission to the /etc/sysadm/mt file to use the
       set operation.  Only a user with appropriate privilege has such
       permission.

       On a generic DG/UX system, appropriate privilege is granted by having
       an effective UID of 0 (root). See the appropriate_privilege(5) man
       page for more information.

       On a system with DG/UX information security , appropriate privilege
       is granted by having one or more specific capabilities enabled in the
       effective capability set of the user.  See cap_defaults(5) for the
       default capabilities for this command.

       The get and set operations manipulate the /etc/sysadm/mt database.
       Support for this database will be removed in a future release.  The
       information will be maintained by admdefault(1M) instead.


Licensed material--property of copyright holder(s)