qualstar :: 500521H Tapestar for DOS Users Guide 1994

165 Pages·1994·7.2 MB·English

User's Guide
for
Corporation
TapestarTM for DOS
Tape Utility Application
Document 500521 H
Qualstar Corporation
6709 Independence Avenue
Canoga Park, CA 91303
FAX: [phone]
Phone: [phone]
Copyright ©1994 by Qua/star Corporation
All rights reserved.
Copyright Notice
Information contained in this document is copyrighted by Qualstar Corporation and may not be
reproduced in full or in part without prior written permission from QuaIstar Corporation. Every
effort has been made to keep the information contained in this document current and accurate as
of the date of publication or revision. However, no guarantee is given or implied that the document
is error-free or that it is accurate with regard to any specification. QuaIstar reserves the right to
modify product designs and specifications without notice.
Trademarks
QuaIstar® is a registered trademark of Quaistar' Corporation.
Other brand and product names are trademarks or registered trademarks of their respective
owners.
Qualstar Corporation
6709 Independence Avenue
Canoga Park, CA 91303
FAX: [phone]
Phone: [phone]
ii 500521 H
Document Revision Table
CHAPTER TITLE REVISION
Title Page H
1 Introduction to Tapestar H
2 MCS-l Installation H
3 SCSI Installation H
4 Installing BACK-IT 4 LAN E
5 Using TAPETEST.EXE H
6 Using T APEMENU.EXE H
7 Drive Selection H
8 Using TAPE2DSK.EXE H
I
9 Using DSK2TAPE.EXE H
I
I
10 Using TLABEL.EXE ! H
I
11 Using TCONVERT.EXE H
12 Using TAPEUST.EXE H
13 Using DEX.EXE H
14 Using COPYTAPE.EXE H
15 Using TCLONE.EXE H
16 Using TAR.EXE H
17 Using TABLEDIT.EXE H
18 Error Messages F
19 Appendix A H
iii
500521 H
Tapestar for DOS
Limited Warranty
QUALSTAR SHALL NOT BE RESPONSmLE OR LIABLE FOR ANY SPECIAL, INCIDEN
TAL OR CONSEQUENTIAL DAMAGES OR LOSS ARISING FROM 1HE USE OF THIS
PRODUCT.
THIS WARRANTY IS IN LIEU OF, AND BUYER WAIVES, ALL 01HER WARRANTIES,
EXPRESSED OR IMPLIED, ARISING BYLAW OR 01HERWISE, INCLUDING WITHOUT
LIMITATION ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. THE REMEDIES STATED IN THIS WARRANTY ARE EXCLU
SIVE.
Qualstar warrants the hardware to be free from defects in material and workmanship under normal
use for a period of one year from the date of shipment from the factory. Qualstar warrants the
media on which software is furnished to be free from defects in material and workmanship under
normal use for a period of 30 days from the date of shipment from the factory. As such, the entire
liability of Qualstar Corporation, and the buyer's exclusive remedy, shall be·a refund of the
purchase price or the replacement of any product not meeting the limited warranty previously
stated. Some states do not allow the exclusion of implied warranties or the limitation of remedies,
so the above exclusions and limitations may not apply to you. You may also have other rights
which vary from state to state.
Qualstar makes no representations as to the suitability of software supplied for use in any
application, and the Buyer agrees to accept all such software on an "as is" basis. Furthermore,
Qualstar does not warrant software to be free from defects, and assumes no responsibility for
damages of any kind, either actual or consequential, for such software failing to perform as
documented or in any other manner. In no event will Qualstar be liable for damages, including
any lost profits, lost savings or other incidental or consequential damages arising out of the use
or inability to use such software, even if Qualstar has been advised of the possibility of such
damages, or for any claim by any other party.
This warranty shall immediately be null and void if, in Qualstar's sole judgment, the product has
been subject to misuse, abuse, negligence or accident, damaged in shipment, subjected to
improper environmental conditions or had its serial numbers and/or other product markings
altered, defaced or removed.
This warranty will remain in effect notwithstanding Buyer's shipment to third parties, but
warranty remedies defined herein are applicable only to Buyer and are not transferable. Buyer
shall disclose to third parties the terms of this warranty and shall indemnify QUalstar from any
failure to make such disclosure and from any warranties made by the Buyer beyond those set
forth herein.
iv 500521 H
Table of Contents
Qualstar Return Policy
IMPORTANT - Read this before opening the package!
Qualstar Corporation has made every effort to provide quality merchandise. If the merchandise
arrives damaged or has been mishandled, please notify the delivery company immediately. If the
merchandise is defective in any other way, please follow these instructions.
If this merchandise was purchased from a dealer or other reseller, contact that dealer or reseller
for return instructions.
If this merchandise was purchased directly from Qualstar, please do the following:
1. Treat the merchandise carefully to assure its suitability for return.
2. Retain all shipping and packing materials. Returned merchandise must be
shipped to Qualstar in the original packing material and carton. If the original
packing material or carton has been damaged, a new set may be requested.
3. Call Qualstar Customer Service at [phone] to request a Return Mer
chandise Authorization (RMA) number. Returned merchandise will not be
accepted without this number.
4. Clearly identify the outside of the carton and the packing list with the RMA
number.
5. Return the merchandise, including cables, manuals, software and all related
documents to:
Qualstar Corporation
6709 Independence Avenue
Canoga Park, CA 91303
FAX: [phone]
Phone: [phone]
v
500521 H
Tapestar for DOS
Technical Assistance
The information contained in this guide is sufficient to resolve most problems which may occur
during software installation and program operation. Technical assistance is available if problems
are experienced which ,").ot covered in this guide. Qualstar technical support is available
between 8 AM and 4:-,~. i'M, Pacific Standard Tune. Be ready to provide the following
information:
1. Model and serial numbers of the tape drive being used;
2. Computer system manufacturer, model, bus (i.e., PC, ISA, EISA, MCA), CPU
used (i.e .. , 286, 386D, 386SX, 486D2, etc.) and speed (16, 33,50 MHz);
3. Tape controller or host adapter model and serial number, including revision
level (read this from the board itself);
4. The current jumper and switch settings on the host adapter card;
5. Operating system and version in use (i.e .. , DOS 5.0, OS2 2.0, etc.);
6. A list of devices installed in the computer (network controllers, modems, etc.);
7. A list of any device drivers loaded (found in CONFIG.SYS);
8. A list of memory-resident programs (e.g., SideKick) installed (found in AUTO
EXEC.BAT);
9. The name and revision of the program in which the problem occurs;
10. The command syntax used to create the problem;
11. A description of the problem encountered, along with any accompanying error
messages.
For technical assistance, please write or call
Qualstar Corporation
6709 Independence Avenue
Canoga Park, CA 91303
FAX: [phone]
Tel: [phone]
vi 500521 H
Table of Contents
-I-- ab••l e or" L....o....n....t..e nt-.II s
Chapter 1 -Introduction to Tapestar for DOS
1.1. Purpose of Th is Guide . . 1-1
1.2. Tapestar Overview . . . 1-1
1.3. Tapestar Package Contents 1-1
1.4. Typographic Conventions. 1-1
1 .5. Syntax Conventions . . . 1-2
1.6. How This Manual Is Organized 1-3
Chapter 2 - MCS-l Installation
2.1. General Information. . 2-1
2.2. Installing the Hardware. 2-1
2.3. Installing the MCS-1 Device Driver for DOS. 2-3
2.3.1. Automatic Device Driver Installation Procedure ............................. 2-3
2.3.2. Manual Device Driver Installation Procedure ................................ 2-4
2.4. Installing the Application Software . . . . 2-5
2.5. Testing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2.5.1. Testing the Device Driver Installation ..................................... 2-5
2.5.2. Using MCS1 DIAG.EXE ............ , .................................... 2-6
2.5.3. Correcting MCS-1 Controller Problems .................................... 2-7
2.5.4. Testing the Tape Drive ................................................ 2-8
2.5.5. Correcting Tape Drive Problems ......................................... 2-9
Chapter 3 - SCSI Installation
3.1. General Information . . . . 3-1
3.2. Host Adapter Installation (UltraStor) . . . . . . . . . . . . . . . . . . . . . . 3-2
3.2.1. Package Contents .................................................... 3-2
3.2.2. Installation Procedure ................................................. 3-2
3.3. Host Adapter Installation (Adaptec 154X). . . . . . . . . . . . . . . . . . . . 3-3
3.3.1. Package Contents .................................................... 3-3
3.3.2. Installation Procedure ................................................. 3-4
3.4. Host Adapter Installation (Adaptec 1640). . . . . . . . . . . . . . . . . . . . 3-5
3.4.1. Package Contents .................................................... 3-5
3.4.2. Installation Procedure ................................................. 3-6
3.5. Installing TAPESTAR-SCSI or TAPESTAR-PLUS FOR DOS. 3-7
3.6. Testing the Tapestar System . . . 3-7
3.7. Troubleshooting Tapestar Problems 3-9
Chapter 4 - Back-It 4 IAN Installation
4.1. Installing Back-It 4 LAN 4-1
vii
500521 H
Tapestar for DOS
4.2. Defining a Tape Device. . . . . . . . . . . . . . . . . . . . . . . 4-1
Chapter 5 - Using TAPETEST .EXE
5.1. Running TAPETEST Interactively 5-1
5.2. Running TAPETEST in the Batch Mode 5-1
5.3. TAPETEST Commands . . . . . . 5-1
5.3.1. ASCII ............................................................. 5-2
5.3.2. Clear Return. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-2
5.3.3. Copy .............................................................. 5-2
5.3.4. EBCDIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-3
5.3.5. Exercise ........................................................... 5-3
5.3.6. Filemark........................................................... 5-3
5.3.7. Help.............................................................. 5-3
5.3.8. Information......................................................... 5-3
5.3.9. Inquiry ............................................................ 5-3
5.3.10. Last Error ........................................ '.' ............... 5-4
5.3.11. List Drives. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-4
5.3.12. Load Tape .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-4
5.3.13. Log .............................................................. 5-4
5.3.14. Mode ............................................................ 5-5
5.3.15. No Rewind ........................................................ 5-5
5.3.16. Position .......................................................... 5-5
5.3.17. Quit ............................................................. 5-5
5.3.18. Read ............................................................. 5-6
5.3.19. Ready ............................................................ 5-6
5.3.20. Rescan ........................................................... 5-6
5.3.21. Reset ............................................................ 5-6
5.3.22. Retension Tape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-6
5.3.23. Rewind............................................................ 5-6
5.3.24. Reverse Read. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-7
5.3.25. Select............................................................ 5-7
5.3.26. Select Partition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-7
5.3.27. Set Buffer ....................................................... " 5-7
5.3.28. Set Partition ..................................................... " 5-7
5.3.29. Show............................................................ 5-7
5.3.30. Space ............................................................ 5-8
5.3.31. Special........................................................... 5-8
5.3.32. Status ............................................................ 5-8
5.3.33. Summarize Tape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-8
5.3.34. Test Tape ......................................................... 5-8
5.3.35. Unload Tape. . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-9
5.3.36. Verify Tape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5-9
5.3.37. Write............................................................ 5-9
Chapter 6 - Using TAPEMENU.EXE
6.1. How TA PEMENU Accepts Keystrokes 6-2
6.2. Troubleshooting TAPEMENU Problems 6-2
Chapter 7 - Drive Selection
7.1. Drive Specifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7- 1
viii 500521 H
Table of Contents
7.2. Examples of Drive SpecifieiS. . . . ",-',7&".).
Chapter 8 - Using TA PE2DSK.EXE
8.1. Determining Tape Data Type ........................ 8-1
8.1.1. Labeled and Unlabeled Tapes ........................................... 8-1
8.1.2. Fixed or Variable Length Blocks .......................................... 8-1
8.1.3. Tape File Format ..................................................... 8-2
8.1.4. Desired Disk File Structure ............................................. 8-2
8.2. TAPE2DSK Command Line Parameters . . . . . . . . . . . . . . . . . . . . 8-3
8.2.1. TAPE2DSKTransfer Mode .............................................. 8-3
8.2.2. TAPE2DSK Filename ................... " .... " ..................... " 8-4
8.2.3. TAPE2DSK Options ................................................... 8-4
8.2.4. TAPE2DSK Drive Specifier. ............................................. 8-S
8.3. Reading Files from Labeled Tape 8-S
8.4. Handling Variable Length Blocks 8-S
8.S. TAPE2DSK Examples . . . . 8-6
Chapter 9 - Using DSK2TA PE.EXE
9.1. Determining the Disk Record Format . . . . . . . . . . . . . . . . . . . . . 9-1
9.1.1. Fixed and Variable Length Disk Records ................................. " 9-1
9.1.2. Disk File Format ..................................................... 9-2
9.1.3. Output Tape Character Set ............................................. 9-2
9.2. The DSK2TAPE Command Line . . . . . . . . . . . . . . . . . . . . . . . 9-3
9.2.1. Transfer Mode Parameter .............................................. 9-3
9.2.2. Files Parameter ...................................................... 9-3
9.2.3. Blocksize Parameter .................................................. 9-3
9.2.4. DSK2TAPE Options ................................................... 9-4
9.2.S. DSK2TAPE Drive Specifier .............................................. 9-4
9.3. DSK2TAPE Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-S
Chapter 10 - Using TLABEL.EXE
10.1. Running TLABEL Interactively. 10-1
10.2. TLABEL Keyboard Usage 10-2
10.3. Main Screen Choices. . . 10-2
10.3.1. TLABEL Main Screen Fields ................................, ........... 10-2
10.4. Supplemental Tape Label Fields. . . . . . . . . . . . . . . . . . . . . . . 10-3
10.4.1. Header 1 Label .................................................... 10-4
10.4.2. Header 2 Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
10.S. Running TLABEL in the Batch Mode . . . . . . . . . . . . . . . . . . . . . 10-S
10.6. TLABEL Command Line Options . . . . . . . . . . . . . . . . . . . . . . 10-6
10.6.1. Changing Record and Block Lengths from the Command Line ................ 10-6
Chapter 11 - Using TCONVERT .EXE
11.1. Setting Source and Destination Controls. . . . . . . . . . . . . . . . . . . . 11-2
11.1.1. Settings for Disk .................................................... 11-3
ix
500521 H
Tapestar for DOS
11.1.2. Settings for Tape ................................................... 11-3
11.2. Positioning the Tape 11-4
11.3. Change Settings Menu. 11-5
11.4. Copying Files from Labeled Tape to Disk. 11-5
11.5. Resolving File Transfer Problems 11-6
11.6. Using TCONVERT to View Files 11-6
Chapter 12 - Using TA PELIST
12.1. The TA PE LIST Command Line . 12-1
12.2. Sending TA PELIST Listing to a File or Printer 12-1
12.3. Sample Run of TAPELIST. . . . . . . . 12-2
Chapter 13 - Using DEX.EXE
13.1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-1
13.1.1. DEX Capabilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-1
13.1.2. DEX Limitations ................................................... 13-1
13.1.3. DEX Operation .................................................... 13-1
13.1.4. Some Practical Uses for DEX .......................................... 13-2
13.2. UsingDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-2
13.2.1. Step 1: Obtaining a Record Layout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-2
13.2.2. Step 2: Interpreting the Record Layout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-3
13.2.3. Step 3. Creating the DEX Control File .................................. ' 13-5
13.2.4. Step 4. Checking the Control File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-7
13.2.5. Step 5. DEXtracting the Data ......................................... 13-7
13.2.6. An Example Using DEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-7
13.2.7. DEX Command-Line Options ........................................ 13-10
13.3. The DEX Control File . . . . . . . . . . . . . . . . . . . . . . . . . . 13-11
13.3.1. DEX Control File Header Statements ................................... 13-11
13.3.2. DEX Field Definitions .............................................. 13-13
13.3.3. DEX Field Specifiers ............................................... 13-13
13.4. Packed and Binary Data Types ...................... 13-16
13.4.1. Packed Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-16
13.4.2. Binary Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-16
13.5. DEX Examples ............................. 13-18
13.5.1. Generating a Field Report ........................................... 13-18
13.5.2. Transferring from Unlabeled Tape .................................... 13-18
13.5.3. Transferring from Labeled Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 13-18
13.6. Sample DEX Field Report. . . . . . . . . . . . . . . . . . . . . . . . . 13-18
Chapter 14 - Using COPYT APE.EXE
14.1. Requirements for Using COPYT APE. 14-1
14.2. Copying and Creating Multivolume Tapes UsingCOPYTAPE . . . . . . . . . .. 14-2
14.2.1. Copying a Labeled Tape ............................................. 14-3
14.2.2. Copying Multivolume Unlabeled Tapes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 14-3
14.3. Using Multiple Source or Destination Drives with COPYTAPE . . . . . . . . . .. 14-3
X 500521 H