arguments:

source

Name (and optionally path) of the source tape file.

destination

Name (and optionally path) of the destination tape file.

5.18.4 Examples

Example 1:

Create an AWSTAPE file from an existing HET tape file.

HETUPD -s D:/MVS/TAPE/T001002.HET D:/MVS/TAPE/T001002.AWS

Example 2:

Change the compression level to 2 with BZLIB compression and create a new HET tape file.

HETUPD -2 -b D:/MVS/TAPE/TLEV009.HET D:/MVS/TAPE/TLEV002.HET

5.18.5 Sample Utility Output

Sample 1:

Change the compression level to 4 (best match between speed and compression rate) and create a new
HET tape file.

D:\HERCULES>hetupd -4 D:/MVS/TAPE/T38321A.HET D:/MVS/TAPE/T38321B.HET

Hercules HET copy/update program Version 3.05

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

Figure 52: HETUPD utility output

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]