VMS Help  —  SET  MAGTAPE
    Defines the default characteristics associated with a specific
    magnetic tape device for subsequent file operations.

    The SET MAGTAPE command is valid for magnetic tape devices
    mounted with foreign volumes.

    Format

      SET MAGTAPE  device-name[:]

1  –  Parameter

 device-name[:]

    Specifies the name of the magnetic tape device for which the
    characteristics are to be set. The device must not be currently
    allocated to any other user.

2  –  Qualifiers

2.1    /DENSITY

       /DENSITY=density-value

    Specifies the default density for all write operations on the
    magnetic tape device when the volume is mounted as a foreign tape
    or as an unlabeled tape.

    Valid density values are:

    Keyword     Meaning

    DEFAULT     Default density
    800         NRZI 800 bits per inch (BPI)
    1600        PE 1600 BPI
    6250        GRC 6250 BPI
    3480        IBM 3480 HPC 39872 BPI
    3490E       IBM 3480 compressed
    833         DLT TK50: 833 BPI
    TK50        DLT TK50: 833 BPI
    TK70        DLT TK70: 1250 BPI
    6250        RV80 6250 BPI EQUIVALENT
      NOTE: Only the keywords above are understood by TMSCP/TUDRIVER
    code prior to OpenVMS Version 7.2. The remaining keywords in this
     table are supported only on Alpha and Integrity server systems.
    TK85        DLT Tx85: 10625 BPI - Cmpt III - Alpha/Integrity
                servers only
    TK86        DLT Tx86: 10626 BPI - Cmpt III - Alpha/Integrity
                servers only
    TK87        DLT Tx87: 62500 BPI - Cmpt III - Alpha/Integrity
                servers only
    TK88        DLT Tx88: (Quantum 4000) - Cmpt IV - Alpha/Integrity
                servers only
    TK89        DLT Tx89: (Quantum 7000) - Cmpt IV - Alpha/Integrity
                servers only
    QIC         All QIC drives are drive-settable only -
                Alpha/Integrity servers only
    8200        Exa-Byte 8200 - Alpha/Integrity servers only
    8500        Exa-Byte 8500 - Alpha/Integrity servers only
    DDS1        Digital Data Storage 1 - 2G - Alpha/Integrity servers
                only
    DDS2        Digital Data Storage 2 - 4G - Alpha/Integrity servers
                only
    DDS3        Digital Data Storage 3 - 8-10G - Alpha/Integrity
                servers only
    DDS4        Digital Data Storage 4 - Alpha/Integrity servers only
    AIT1        Sony Advanced Intelligent Tape 1 - Alpha/Integrity
                servers only
    AIT2        Sony Advanced Intelligent Tape 2 - Alpha/Integrity
                servers only
    AIT3        Sony Advanced Intelligent Tape 3 - Alpha/Integrity
                servers only
    AIT4        Sony Advanced Intelligent Tape 4 - Alpha/Integrity
                servers only
    DLT8000     DLT 8000 - Alpha/Integrity servers only
    8900        Exabyte 8900 - Alpha/Integrity servers only
    SDLT        SuperDLT1 - Alpha/Integrity servers only
    SDLT320     SuperDLT320 - Alpha/Integrity servers only

    Note that tape density keywords cannot be abbreviated.

2.2    /END_OF_FILE

    Writes a tape mark at the current position on the magnetic tape
    volume.

2.3    /FAST_SKIP

       /FAST_SKIP=option

    Requires PHY_IO privilege.

    Allows you to skip by file mark or by record.

                                   NOTE

       This tape positioning qualifier is for use on local SCSI
       tape drives only.

    PER_IO          Allows a local MK device to use the skip-by-
    (default)       filemarks function. The tape drive must be able
                    to do a SCSI READ POSITION command and report
                    blank check at end-of-data. The IO$M_ALLOWFAST
                    function modifier must be supplied with IO$_
                    SKIPFILE. Otherwise, the tape will skip files
                    using the skip-by-records function.

    ALWAYS          Allows a local MK device to use the skip-by-
                    filemarks function. The tape drive must be able
                    to support the skip-by-filemarks function, and
                    no modifications should be needed to the IO$_
                    SKIPFILE function.

    NEVER           Specifies that a local MK device skip only by
                    records. If you use a utility that depends on the
                    semantics of skipping with skip-records, you may
                    also need to use this option because it causes
                    BACKUP or COPY to use the previous positioning.

2.4    /LOG

       /LOG
       /NOLOG

    Displays information about the operations performed on the
    magnetic tape volume.

2.5    /LOGSOFT

       /LOGSOFT (default)
       /NOLOGSOFT

    Controls whether soft errors on the specified device are to be
    logged in the error log file. Soft errors are errors corrected
    by the hardware without software intervention. This qualifier
    affects only devices that support hardware error correction, such
    as the TU78 magnetic tape drive. When used with other devices,
    this qualifier has no effect.

2.6    /MEDIA_FORMAT

       /MEDIA_FORMAT=[NO]COMPACTION

    Controls whether data records are automatically compacted and
    blocked together on a TA90E tape drive. Data compaction and
    record blocking increase the amount of data that can be stored
    on a single tape cartridge.

    Note that once data compaction or noncompaction has been selected
    for a given cartridge, that same status applies to the entire
    cartridge.

2.7    /RETENSION

    Moves a TZK10 tape cartridge to the end of the tape, and then
    back to the beginning of the tape. Use the /RETENSION qualifier
    on a regular basis to help maintain the integrity of TZK10 tape
    cartridges.

    The /RETENSION qualifier must be used in conjunction with the
    /REWIND or /UNLOAD qualifier. The /RETENSION qualifier completes
    its action before /REWIND or /UNLOAD. Use /RETENSION/REWIND when
    you want the tape cartridge to remain loaded in the drive. Use
    /RETENSION/UNLOAD when you want to unload the tape cartridge
    after the retension operation.

    This qualifier only affects TZK10 tape cartridge drives and has
    no effect on non-SCSI drives.

2.8    /REWIND

    Requests that the volume on the specified device be rewound to
    the beginning of the magnetic tape.

2.9    /SKIP

       /SKIP=option

    Requests that the magnetic tape volume be positioned according to
    any of the following options:

    BLOCK:n         Skips the specified number of blocks.

    END_OF_TAPE     Positions the volume at the end-of-tape (EOT)
                    mark.

    FILES:n         Skips the specified number of tape marks (not
                    files).

                    The tape is positioned just past the nth tape
                    mark. If n is negative, the tape is still
                    positioned after the nth tape mark, not before
                    it. If the tape is already positioned immediately
                    after a tape mark, a skip of -1 results in no
                    net movement. (The tape moves to the preceding
                    mark, but is then repositioned to the end of the
                    mark, where it began.) For more information on
                    tape marks and files, see the VSI OpenVMS System
                    Manager's Manual.

    RECORD:n        Skips the specified number of records up to
                    32767.

2.10    /UNLOAD

    Requests that the volume on the specified device be rewound and
    unloaded.

3  –  Examples

    1.$ MOUNT MTB1:/FOREIGN
      $ SET MAGTAPE MTB1: /DENSITY=800

      The MOUNT command in this example mounts a foreign tape on the
      device MTB1. The SET MAGTAPE command defines the density for
      writing the magnetic tape at 800 bpi.

    2.$ MOUNT MTA0:/FOREIGN
      $ SET MAGTAPE MTA0:/SKIP=FILES:4

      The MOUNT command in this example mounts a foreign tape on the
      device MTA0; the SET MAGTAPE command directs the magnetic tape
      position to skip four files.
Close Help