7. Mainframe Utilities

7.1 AWSSL (AWS virtual tape)

AWSSL is written by Reed H. Petty and is available on the CBT MVS Utilities Tape (CBTTAPE) at

7.1.1 Function

AWSSL moves MVS (OS390, etc.) datasets directly to/from AWS (and HET) virtual tape files. AWSSL
strives to maintain compatibility with other AWS/HET utilities including AWSUTIL, VTTS, HETUTL and the
Hercules Emulator.

AWSSL creates AWS and HET format virtual tapes which contain one to many datasets of any record
format, with or without standard labels. The program will also retrieve datasets from AWS/HET files of any
record format with the exception of spanned blocks. The retrieved datasets may be reblocked if neces-
sary. If DCB attributes are omitted on the receiving dataset and if standard labels are present within the
AWS structure, then the DCB attributes of the receiving dataset will be defaulted to those within the
HDR1 label.

7.1.2 Input Parameter

All input parameters are taken from control statements supplied by the AWSCNTL DD statement. The
statements consist of a major function to be performed (e.g. TAPEVOL, EXPORT, etc.), and keywords
which supply values to that function.

Control statement keywords may be continued to as many records as necessary. Continued statements
are indicated by the last keyword argument suffixed with a comma and additional keywords on the next
record. Additional keywords must not begin in column one.

7.1.3 AWSVOL Control Statement

The AWSVOL control statement supplies characteristics of the virtual tape volume including volume serial
number, owner and compression. AWSVOL must be the first control statement specified.

Descriptive

AWSVOL VOLSER=volser [,OWNER=owner] [
,COMPRESS={0 | 1 | 2}]
[,LEVEL={1 |
n}]

Diagram

Êʬ¬¬ AWSVOL ¬¬¬ VOLS
ER=volser ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬¬¬¬¬¬¬Ê

OWNER=owner ¬¬¬¯

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

COMPRESS= ¬¬¬§¬¬¬ 0
¬¬¬«

ª¬¬¬
1 ¬¬¬«

2 ¬¬¬¯

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

LEVEL= ¬¬¬§¬¬¬ 1 ¬¬¬«

n ¬¬¬¯

VOLSER=volser

This specifies the volume serial number, volser is a 1 to 6 byte argument.

OWNER=owner

The given owner will be included into the VOL1 owner field, owner is a 1 to 10
byte argument.

COMPRESS=n

Compression, 0 = no compression, 1 = zlib, 2 = bzip. If COMPRESS=0 is
coded then an AWS format is assumed. Default is HET format with COM-
PRESS=1 (zlib).

LEVEL=n

Specifies the level of compression (0 – 9). Default is LEVEL=1.

7.1.4 AWSGET Control Statement

The AWSGET control statement will supply values that are necessary to retrieve a dataset from an AWS
or HET virtual tape volume. Decompression is invoked automatically when required.

Descriptive

AWSGET INDSN=dsname,OUTDD=ddname [,FILENO=nnnnn] [,SL={YES | NO}]

Diagram

Êʬ¬¬ AWSGET ¬¬¬ INDSN=dsname ¬¬¬ ,
¬¬¬ OUTDD=ddname ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

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

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

FILENO=nnnnn ¬¯

SL= ¬¬¬§¬¬¬ YES ¬¬¬«

NO ¬¬¬¬¯

INDSN=dsname

This specifies the dataset name (up to 44 bytes) of a dataset stored inside of
the AWS or HET virtual tape.

OUTDD=ddname

This is the DDNAME representing the dataset to receive the data from the vir-
tual tape.