5.19 TAPECOPY (Copy a SCSI tape to or from an AWSTAPE disk file)

5.19.1 Function

The Hercules tape copy program copies a SCSI tape to or from an AWSTAPE disk file. TAPECOPY
reads a SCSI tape and outputs an AWSTAPE file representation of the tape, or reads an AWSTAPE file
and creates an identical copy of its contents on a tape mounted on a SCSI tape drive.

If the input file is a SCSI tape it is read and processed until physical EOD (end-of-data) is reached. That
is, it does not stop whenever multiple tapemarks or filemarks are read rather it continues processing until
the SCSI tape drive says there is no more data on the tape.

The resulting AWSTAPE output disk file may be specified for the filename on a Hercules tape device defi-
nition statement. It can then be used in order for the Hercules guest O/S to read the exact same data
without having a SCSI tape drive physically attached to the host system. This allows you to easily transfer
SCSI tape data to other systems that may not have SCSI tape drives attached to them.

The possible return codes and their meaning are:

0 Successful completion.

1 Invalid arguments or no arguments given.

3 Unable to open SCSI tape drive device file.

4 Unable to open AWSTAPE disk file.

5 Unrecoverable I/O error setting variable length block processing for SCSI tape device.

6 Unrecoverable I/O error rewinding SCSI tape device.

7 Unrecoverable I/O error obtaining status of SCSI device.

8 Unrecoverable I/O error reading block header from AWSTAPE disk file.

9 Unrecoverable I/O error reading data block.

10 AWSTAPE block size too large.

11 Unrecoverable I/O error writing tapemark.

12 Unrecoverable I/O error writing block header to AWSTAPE disk file.

13 Unrecoverable I/O error writing data block.

5.19.2 Syntax

Descriptive

TAPECOPY [tapedrive] [awsfile]

or

TAPECOPY [awsfile] [
tapedrive]

Diagram

Êʬ¬¬ TAPECOPY ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ




tapedrive awsfile ¬¬¬¯

or

Êʬ¬¬ TAPECOPY ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ




awsfile tapedrive ¬¬¬¯

5.19.3 Parameter

tapedrive

Specifies the device filename of the SCSI tape drive. Must begin with /dev to be
recognized.

awsfile

Specifies the filename of the AWSTAPE disk file.

The first filename is the input; the second one is the output.

5.19.4 Examples

Example 1:

Copy a SCSI file to an AWSTAPE disk file.

TAPECOPY /dev/nst0/scsifile.bin D:/MVS/TAPE/T3832AA.AWS

5.19.5 Sample Utility Output

Sample 1:

Copying an AWSTAPE disk file to a SCSI drive (this sample abends because the SCSI drive does not
exist).

D:\HERCULES>tapecopy D:/T38321A.AWS /dev/nts0/scsifile.bin

Hercules tape copy program Version 3.05

(c)Copyright 1999-2005 by Roger Bowler, Jan Jaeger, and others

HHCTC001E Error opening /dev/nts0/scsifile.bin: errno=22: Invalid argument

HHCTC000I Abnormal termination

Figure 53: TAPECOPY utility output

Previous Page Next Page