FILENO=nnnnn

Specifies the file number of the dataset inside of the AWS or HET virtual tape.
This may be a standard label file number or an absolute file number depending
on the value of the SL= keyword.

SL=value

If the value is YES then standard label numbers are present, if the value is NO
then the file numbers are absolute numbers. This keyword also impacts the
meaning of the FILENO= keyword.

7.1.5 AWSPUT Control Statement

The AWSPUT control statement causes a dataset to be copied into the AWS or HET virtual tape file.
Multiple AWSPUT statements may be specified. A set of standard labels are produced as each statement
is processed. If necessary the dataset is staged into a temporary dynamically allocated dataset prior to
insertion into the virtual tape.

The AWS or HET virtual tape output file may specify any DCB attributes that are meaningful in the users
environment:

RECFM=V

Variable length output, LRECL and BLKSIZE as specified. The records are in a
format consistent with that produced by AWSUTIL.

RECFM=F

Fixed length output, LRECL and BLKSIZE as specified. The records are in a
format consistent with that produced by the VTTS family of utilities.

RECFM=U

Undefined length output, BLKSIZE as specified. The records are written in an
aggregated BLKSIZE length block. Note: This is the preferred method when
the virtual tape is to be transported to other environments such as Hercules.

Descriptive

AWSPUT {INDD=ddname | INDSN=dsname},OUTDSN=dsname [,TAPEDSN=tapedsn]

[,UNLOAD={IEBCOPY | IDCAMS}] [,TYPE={EXPORT | REPRO}]

Diagram

Êʬ¬¬ AWSPUT ¬¬¬§¬¬¬ INDD=dsname ¬¬¬¬§¬¬¬ , ¬¬¬¬¬¬¬ OUTDSN=ddname ¬¬¬¬¬¬¬¬¬¬¬Ê

INDSN=dsname ¬¬¬¯

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

, ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

TAPEDSN=tapedsn ¬¯

ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

, ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

UNLOAD= ¬¬¬§¬¬¬ IEBCOPY ¬¬¬«

IDCAMS ¬¬¬¬¯

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

INDD=ddname

Specifies the statically allocated DDNAME representing the file to be copied
and placed into the AWS or HET virtual tape file.

INDSN=dsname

Specifies the datasetname to be dynamically allocated and placed into the
AWS or HET virtual tape file.

OUTDSN=dsname

The dataset name (up to 44 bytes) to be placed into the labels which preceed
and follow the file on the virtual tape.

TAPEDSN=tapedsn

The datasetname (up to 17 bytes) to be placed in the label.

UNLOAD=value

Selects the utility (IEBCOPY or IDCAMS) to be called to stage the input data-
set prior to insertion into the virtual tape.

TYPE=value

If UNLOAD=IDCAMS is selected then the TYPE value specifies the method
(EXPORT or REPRO) to be used to stage the dataset prior to insertion into the
virtual tape.

7.1.6 Samples

Sample 1:

Create an AWS virtual tape from several input datasets/input DDs:

//VIRTTAPE EXEC PGM=AWSSL

//STEPLIB DD DSN=your.loadlib,DISP=SHR

//AWSPRINT DD SYSOUT=*

//myddnam1 DD DSN=your.file1,DISP=SHR

//myddnam2 DD DSN=your.file2,DISP=SHR

//AWSFILE DD DSN=volser.aws,DISP=(NEW,CATLG,DELETE),

// SPACE=(your_space_parms),

// DCB=(your_DCB_parms)

//AWSCNTL DD *

AWSVOL VOLSER=mytape,COMPRESS=0

AWSPUT INDSN=your.first.dataset

AWSPUT INDSN=your.second.dataset,UNLOAD=IEBCOPY

AWSPUT INDD=myddnam1

AWSPUT INDD=myddnam1,UNLOAD=IEBCOPY

/*

Figure 61: AWSSL JCL (Create AWS virtual tape)