Virtual TAPE (VTAPE) is a software enhancement to VM.
It allows you to define and use
virtual tape drives as if they were real tape drives.
CP commands are used to mount virtual tapes on virtual tape drives.
Data written to virtual tapes is stored in
virtual tape libraries on disk.
These libraries can be shared by different VM systems.
Like real tapes, virtual tapes can be mounted, written, rewound,
read, and unloaded. TAPE DUMP and other CMS commands that use real
tapes can use virtual tapes as well.
Read and/or write passwords can be assigned to virtual tapes.
When a virtual tape is no longer required, it can be scratched.
Expired tapes are scratched and library reports are created by
library maintenance CMS programs.
A query command is provided to show information about:
- tapes in any open library.
- the status of the libraries.
- the status of currently mounted tapes.
- statistics on tape mounts and usage.
A virtual tape can be mounted for input by several users at
the same time. A tape volume that is mounted for output by one user
can be mounted by other users for input.
Any system (CMS, DOS, MVS, TPF, VM) that is operating
as a VM guest system can use virtual tapes.
Any CMS command, program, or exec that uses tape can use
virtual tapes as well as real tapes. A virtual tape drive must be
defined to your virtual machine. The drive can be defined using
the CP Define command, or in your CP directory entry.
You can then mount a scratch, dummy, or existing virtual tape
on your drive with the VTMOUNT command, and use the tape.
All I/O operations respond as if you were using a real tape.
To find out if a virtual tape is "moving", both the CP Query and
the VTQUERY Active commands display the current record position
of a virtual tape.
Tape drives can be defined as virtual 3420s, 3480s, 3490s and 3590s.
Virtual tape drives can be created with the CP DEFINE command,
and SPECIAL statements can be placed in a user's directory
entry to provide virtual tape drives at each logon.
A tape created on a virtual 3420 can be read on a
virtual 3480, 3490 or 3590
and vice versa. Tape positioning commands (forward and back space
file, rewind, locate block, etc.) are immediate direct access commands
on virtual tapes.
To help you keep track of what is on your virtual tapes, you
can assign descriptions to them with the VTMOUNT or VTSET commands.
You can list these descriptions and search for
tapes that match descriptions or
parts of descriptions with the VTQUERY command.
All virtual tape drives have autoloaders.
The VTLOADER command provides the ability to:
- add tapes to a loader
- remove tapes from a loader
- set the loader to automatic, manual, or system mode
- query the loader status
The VTSET AUTOLIB command will place a tape drive into an
automatic-library mode. In this mode,
LOAD DISPLAY CCWs that are
written to the display of a 3480, 3490 or 3590 tape drive by an MVS
system are used to control the mounting of tapes. VTAPE scans the
message written to the display. If the message starts with
Mnnnnn, then the requested tape is mounted on the drive. If the
message ends with an 'S' then a standard label tape is mounted, if not
an unlabeled tape is mounted. See the VTSET and VTLOADER
commands for more information.
Dummy tapes allow
you to test functions that require tapes when the data
written to the tape does not have to be saved.
The data written to a dummy tape is discarded, except for the
standard label. The standard label on a labeled dummy tape
is kept as long as the tape is mounted, and can be read
for verification and rewritten. You can think of dummy
tapes as being in a dummy tape library that is always open.
Up to 24 libraries can be defined to a system. All of
these libraries can be opened for input or output by each VM
system using Virtual TAPE. However, the same library can not be open
for output by two different VM systems at the same time. A library
that is open for output by one VM system can be opened for input
by several other VM systems. The VTQUERY LIBRARY STATUS command
will display the defined libraries, the libraries that are open
for input or output, and the system default library.
Since you can have more than one output library, many commands
(such as VTMOUNT 181 SCRATCH) need to know which library the
scratch tape should come from. So that you don't have to specify
the library on every command, there is a "default" output library.
The default output library for a specific tape drive is determined
in the following order:
- the default for the tape drive, if one is set.
- the default for the user, if the userid is in the default list.
- the default for the user's class, if set.
- the system default, if one is set.
A tape drive default can be set using the VTSET DEFAULTLIB vdev
option. The user and class default lists are defined in the VTAPE
system definition file (VTSYSTEM). The system default can be set
in several ways as follows:
- the DEFAULTLIB option on the VTOPEN command.
- the first output library opened if DEFAULTLIB is not specified.
- the DEFAULTLIB SYStem option of the VTSET command
The DEFAULTLIB option of the VTQUERY command can be used to
query the default for a drive, a user, or the system.
Throughout the VTAPE documentation, the term "output library"
refers to any open output library.
The term "default library" refers to the default library for
a drive, a user, a user class, or the system.
When you refer to a tape in a default library, you can omit the
library prefix. If library A is the default library, tape A00025
can be entered as 25 in any command. However, because the drive,
user, class, and system defaults can all be different, you must be
sure which default library will be used when you enter a command.
You can always include the library prefix if you wish.
This chapter describes the IBM CP commands that have been enhanced
for Virtual TAPE.
Only the VTAPE enhancements to these commands are described in this
section.
The command syntax diagram conventions are as follows:
- The uppercase portion of a keyword denotes the minimum abbreviation.
For example, a keyword shown as TApes can be entered as TA, TAP, TAPE,
or TAPES. Upper and lower case is not significant when you enter
a command from your terminal.
- Words shown in italic are variable keywords, and you should
replace them with any desired value.
- Certain variable keywords are
used repeatedly, such as vdev and pnnnnn. vdev refers to a
virtual device number in z/VM architecture.
- pnnnnn refers to the tape volume number, or volume serial number
of a virtual tape. p is the virtual tape library prefix,
and nnnnn is the tape volume number. Leading zeros in a virtual tape
number can be omitted in all commands. For example, tape
A00025 can be entered as A25 in any command.
- When a list of choices is enclosed by square brackets, you may
select one or more of the choices or omit the field. If there is a
large number of choices, they may be listed vertically.
- When a list of choices is enclosed by curly braces, you must
select one or more of the choices when you enter the command.
If you want to define a virtual 3480
tape drive at device number 181, the syntax diagram shows:
DEFine devicetype < AS > vdev
You could enter:
def v3480 181
and you would have a virtual 3480 tape drive at 181.
Words shown in italic are also used in command response
descriptions to designate variable information such as a virtual
device number or a tape volume number.
Use the DEFINE command to define a virtual tape drive.
DEFine devicetype < AS > vdev < SHare { options } >
< userid vdev >
options:
MAXshr n
USerid userid
devicetype
| The type of virtual tape drive you want to define.
Valid device types are:
V3420
V3480
V3480-B11
V3490
V3490-B04
V3490-B40
V3590
|
AS
| Is optional, and is ignored.
|
vdev
| The desired virtual tape drive number (address).
|
MAXshr
| Specifies the maximun number of additional drives that are
allowed to share this drive. The default is 64.
|
SHare
| Sets the drive defined as capable of being shared.
|
USerid userid
| Specifies a single user that is allowed to share the drive.
|
userid vdev
| Connects the drive defined to another drive owner by userid
|
- SHare is a special feature added to allow multiple Operating
Systems to logicaly share a Virtual tape drive using Assign and
Unassign. Unless you are testing Assign/Unassign code you should not
use this option.
- For normal CMS use, such as TAPE DUMP or TAPE LOAD,
there is no difference between virtual 3420 and virtual 3480 or 3490
tape drives. Note that virtual tapes created on one type of drive
can be read on any other type of drive.
- For CP diagnose x'210', the information returned in the RDEVMDL
field of the Virtual/Real Device Characteristics Block (VRDCBLOK)
shows the model number of the device you have defined.
The device characteristics
information starting in fullword 4 shows the
characteristics and features for the type and model defined.
- The appropriate sense,
sense ID, and device characteristics information is given, depending
on the device type and model of the virtual tape drive.
- If you define a V3490 without specifying a model number, it will
default to a model B04.
If you define a V3480 without specifying a model number, it will
default to a model B22.
The model for V3420 is 8.
- A V3490-B04 is usually
defined to operating systems with a device type
of 3480. A V3490-B40 simulates a 36-track drive that uses 3490
compression. A V3480 (B22 by default) is an IDRC-capable drive.
A V3480-B11 is not IDRC-capable.
See the appropriate tape hardware reference manuals for details on the
differences in the drive types.
TAPE vdev DEFINED
The IBM CP QUERY command will display your
real and virtual tape drives.
For virtual tapes, the display will list the tape drive address,
the tape volume number (if a tape is mounted), and the record
position of the tape.
vdev
Query < Virtual > vdev-vdev
TApes
Virtual
| Optional for G class users. Class A and B users must use
"Query Virtual vdev"; otherwise, CP will return a response
for the real device at address vdev.
|
vdev
| The device number (address) of a virtual tape drive.
|
vdev-vdev
| A range of device numbers.
|
TApes
| Displays all your (real and virtual) tape drives.
|
TAPE vdev ON TAPE rdev (This is an attached real tape drive.)
TAPE vdev V3420 NOTRDY R/W DEFLIB p
TAPE vdev V3480 pnnnnn R/W AT REC nnn
TAPE vdev V3490 pnnnnn R/W Snnnn AT REC nnn message1 message2
TAPE vdev V349E pnnnnn R/W AT LOAD POINT NOTRDY LEAVE
These are sample responses, and show all possible fields (but not
all possible combinations).
A drive that shows 'ON TAPE' is a real tape drive attached to you.
A drive that shows Vnnnn is a virtual tape drive.
A virtual drive with a tape mounted will show either AT REC nnn
or AT LOAD POINT.
Snnnn is the virtual subchannel number.
The fields in the responses are:
vdev
| The virtual device number (address) of the tape drive.
|
ON TAPE rdev
| A real tape drive. Real device rdev is attached to your
userid as virtual device number vdev. The rest of the
information below pertains to virtual tape drives.
|
{ V3420 | V3480 | V3490 | V349E | V3590 }
| The type of tape drive: a virtual 3420, 3480,
3490 B04, 3490 B40 or 3590).
|
NOTRDY
| The tape is not ready. If NOTRDY appears in the
tape volume number position (the fourth word),
it means there is no tape on the drive.
If there is a tape on the drive, but the drive is not ready,
NOTRDY appears after the tape record position.
|
DEFLIB p
| The default library for a mount request.
If a library prefix is not entered on the VTMount command, the
default library prefix can come from several sources.
- The tape drive, if a library prefix was set for the
drive using VTSET.
- The default library user or class list in the
VTSYSTEM definition file.
- The default library for the system.
|
AT LOAD POINT
| The tape is at load point (rewound).
|
AT REC nnn
| The tape is positioned at tape record nnn.
|
Snnnn
| The device subchannel number.
|
LEAVE
| The tape is in LEAVE status, specified with VTSET or VTMOUNT.
In this special mode,
rewind/unload CCWs from Start I/O or Start Subchannel (including
Diagnose I/O such as issued by TAPE RUN) will rewind the tape but
not unload it. In this mode, you must use VTRUN vdev
to unload the tape.
|
message1 message2
| The messages that have been written to the display with the
Load Display CCW for a virtual 3480 3490 or 3590.
One or two messages will be displayed.
|
The VTAPE CP commands are:
VTLOADER:
- Add tapes to an autoloader.
- Mount tapes from an autoloader.
- Query the autoloader.
- Remove tapes from an autoloader.
- Set the autoloader mode.
- Set the autoloader size.
VTMOUNT:
- Mount dummy, scratch, or existing tapes on a virtual tape drive.
VTQUERY:
- Display information about tapes in a library.
- Display information about active (mounted) tapes.
- Query the status of defined and open libraries.
- Display the space used and available in output libraries.
- Display statistics about tape drive and tape utilization.
VTREW:
- Rewind a virtual tape volume. The
CP REWIND command, the CMS TAPE REW command, and any other program
that sends a rewind CCW to a tape drive will also rewind the tape.
VTRUN:
- Rewind and unload a tape from
a virtual tape drive. The CMS TAPE RUN command
and any other program that sends a rewind and unload CCW
to a tape drive will also unload the tape.
VTSCRTCH:
- Remove a tape from a virtual tape library.
VTSET:
- Change the characteristics of a virtual tape volume.
- Set a tape drive in "auto-library" mode.
- Set the number of buffers to be used for I/O to a tape.
- Set a drive or the system default library prefix.
- Set the leave status of a tape drive.
- Set a library or library minidisk restricted.
The command syntax diagram conventions are as follows:
- The uppercase portion of a keyword denotes the minimum abbreviation.
For example, a keyword shown as TApes can be entered as TA, TAP, TAPE,
or TAPES. Upper and lower case is not significant when you enter
a command from your terminal.
- Words shown in italic are variable keywords, and you should
replace them with any desired value. Certain variable keywords are
used repeatedly, such as vdev and pnnnnn. vdev refers to a
virtual device number in z/VM architecture.
- pnnnnn refers to the tape volume number, or volume serial number
of a virtual tape. p is the virtual tape library prefix,
and nnnnn is the tape number. Leading zeros in a virtual tape
volume number can be omitted in all commands. For example, tape
A00025 can be entered as A25 in any command.
- When a list of choices is enclosed by square brackets, you may
select one or more of the choices or omit the field. If there is a
large number of choices, they may be listed vertically.
- When a list of choices is enclosed by curly braces, you must
select one or more of the choices when you enter the command.
Words shown in italic are also used in command response
descriptions to designate variable information such as a virtual
device number or a tape volume number.
Use the VTLOADER command to add or remove virtual tape or
dummy volumes for the autoloader on a virtual tape drive.
ADD { optionsA }
Mount or MNT
VTLoader < < USERid > userid > vdev Query
REMove { optionsB }
SET MOde { optionsC }
SET SLots nn
optionsA: optionsB: optionsC:
p nn AUTOmatic
nnnnn ... ALL MANual
pnnnnn ... LAST nn SYStem
nnnnn-nnnnn ... SLOT nn
pnnnnn-pnnnnn ... SLOT nn ALL
DUMMY < COunt n > SLOT nn FOR mm
PRefix p
SCRatch < COunt n >
mount-options
USERid userid
| Allows you to perform autoloader commands on another user's tape
drive, if you are authorized. If the target userid is less than
5 bytes in length and is a valid hex number, the USERID keyword is
required.
|
vdev
| The device number of the virtual tape drive for which you are
issuing autoloader commands.
|
Loader options, usage notes and examples are described
on the following pages.
ADD tapelist mount-options
| Adds one or more tapes to the autoloader,
starting with the first empty slot.
Tapes in the autoloader are mounted on the drive
in various ways, depending on the autoloader mode. See the
usage notes for more information.
p
| Requests that a scratch tape be mounted from a specific output
library. p is invalid for dummy or existing tape requests.
If the library prefix is numeric, the PRefix option must be used.
(See Section "Numeric Library Prefixes." for additional information)
| nnnnn nnnnn-nnnnn
| Requests that a specific volume or range of volumes be added to
a loader, to be mounted from a default library. Up to ten volumes or
ranges can be specified. The default library can be a drive, user,
class or
system default. nnnnn is the volume number, and leading zeros
can be omitted. nnnnn with the OUTPUT option can be used to
mount existing or scratch tapes.
| pnnnnn pnnnnn-pnnnnn pnnnnn-nnnnn nnnnn-pnnnnn
| Requests that a specific volume or range of volumes be added to
a loader, to be mounted from a specific library. Up to ten volumes or
ranges can be specified. p is the prefix for the requested
library, and nnnnn is the requested volume number. Leading zeros
in the volume number can be omitted; volume A00025 can be specified
as A25. If the library prefix is specified more than once, the same
prefix must be specified for all volumes. If p is the dummy
library prefix, dummy tapes will be added to the loader.
| DUmmy < COunt nn >
| Adds one or more dummy tapes to a loader. The COUNT parameter
can be used to add multiple dummy tape to the loader. If the count
value exceeds the capacity of the loader, the add will stop when the
loader is full.
| PRefix p
| Specifies the prefix for numeric libraries.
(See Section "Numeric Library Prefixes." for additional information)
| SCratch < COunt nn >
| Adds one or more scratch tapes to a loader. The COUNT parameter
can be used to add multiple scratch tape to the loader. If the count
value exceeds the capacity of the loader, the add will stop when the
loader is full.
| mount-options
| Any mount option that is valid for the type of tape being mounted
can be specified on an autoloader ADD request. The options must
follow the tape type or volume request. The COUNT option for
dummy and scratch tapes can be mixed with the mount options.
|
|
REMove options
| Removes one or more tapes from the autoloader. Remove has several
different forms, but only one remove operation can be requested at
a time.
nn
| Removes the first nn tapes from the autoloader.
| ALL
| Removes all tapes from the autoloader.
| LAST nn
| Removes the last nn tapes from the autoloader.
| SLOT nn
| Removes the tape from slot nn and moves the following tapes
up to fill the slot.
| SLOT nn ALL
| Removes all tapes starting with slot nn.
| SLOT nn FOR mm
| Removes tapes starting with slot nn for mm slots
and moves the following tapes up to fill the empty slots.
|
|
Mount or MNT
| Causes the next tape in the autoloader to be mounted on the
drive, if there is not a tape currently mounted.
|
Query
| Shows the tapes in the autoloader.
|
SET MODE { AUTOmatic | MANual | SYStem }
| Sets the operating mode of the autoloader.
|
SET SLOTS nn
| Sets the number of slots in the autoloader, or the number of tapes
the autoloader can hold.
|
- You can define and use autoloaders for all virtual tape
drives. However, SYSTEM mode is not useful for autoloaders on
virtual 3420s, since the Load Display CCW command to load the
next tape is only valid for 3480s 3490s and 3590s.
- When a tape is mounted from the autoloader, the tape in slot 1
is always selected. The remaining tapes are moved up to fill the gap;
the tape that was in slot 2 is moved to slot 1, and so forth.
- When you add scratch tapes to the autoloader, volume numbers
are not normally assigned until the tape is actually
mounted (unless you use SCRATCH option with VOL).
Also, you can place any volume in the loader, but when the
time comes to mount the tape, the mount may fail for various reasons:
you do not own the tape, the tape is mounted on another user's drive,
the library has been closed, etc. These conditions are checked
at mount time.
- When you add tapes to an autoloader in automatic mode, or
set the mode of an autoloader to automatic, the first tape from
the loader will be mounted if the drive does not already have a tape
mounted.
nn tapes have been added to autoloader for vdev
nn tapes have been removed from autoloader for vdev
Autoloader for vdev has been set to automatic operation
Autoloader for vdev has been set to manual operation
Autoloader for vdev has been set to system operation
For these examples the A and B libraries are open for output,
the C library is open for input and the Z library is the dummy
library. The loader is in automatic mount mode.
vtloader 181 add scratch size 5 keep 3 count 2
2 tapes have been added to autoloader for 181
vtloader 181 add scratch b limit 20 keep 3
1 tape has been added to autoloader for 181
vtloader 181 add dummy limit 20 vol 1300 count 2
2 tapes have been added to autoloader for 181
vtloader 181 add a1 15 22 35-36
5 tapes have been added to autoloader for 181
vtloader 181 add b760 822 out
2 tapes have been added to autoloader for 181
vtloader 181 query
Slot Type Volume
1 Scratch
2 Scratch
3 Scratch B
4 Dummy 01300
5 Dummy 01301
6 Input A00001
7 Input A00015
8 Input A00022
9 Input A00035
10 Input A00036
11 Output B00760
12 Output B00822
12 tapes in loader, 8 slots available for 0181 in automatic mode
- Any request that does not include a library prefix
will be mounted from a default library. The default library could
be the default for the drive, for the user, for the user's class,
or the system default library.
- Any request for a specific library will fail at mount time if the
requested library is not open.
- Any request for an output or scratch tape will fail at mount time
if the requested library is not open for output or if the requested
tape is already mounted for output on another drive.
- The tapes in slots 4 and 5 will be mounted as dummy tapes
with volume serial numbers of p01300 and p01301
where p is the dummy tape library prefix.
vtloader 181 query
Slot Type Volume
1 Input 00097
2 Input A00189
3 Input B00324
4 Output 00027
5 Output A00040
6 Output B00099
7 Scratch
8 Scratch
9 Scratch B
10 Scratch B
11 Scratch A02800
12 Dummy
13 Dummy
14 Dummy 00030
15 Dummy 00024
16 Input C00021
16 tapes in loader, 4 slots available for 0181 in automatic mode
vtloader 181 remove last 5
5 tapes have been removed from autoloader for 181
vtloader 181 query
Slot Type Volume
1 Input 00097
2 Input A00189
3 Input B00324
4 Output 00027
5 Output A00040
6 Output B00099
7 Scratch
8 Scratch
9 Scratch B
10 Scratch B
11 Scratch A02800
11 tapes in loader, 9 slots available for 0181 in automatic mode
vtloader 181 remove slot 3 for 6
6 tapes have been removed from autoloader for 181
vtloader 181 query
Slot Type Volume
1 Input 00097
2 Input A00189
3 Scratch B
4 Scratch B
5 Scratch A02800
5 tapes in loader, 15 slots available for 0181 in automatic mode
Use the VTMOUNT (or VTMNT)
command to mount a virtual tape volume on a virtual
tape drive.
nnnnn < optionA optionB >
VTMount vdev pnnnnn < optionA optionB >
VTMnt DUmmy < optionD >
SCratch < optionB optionC optionD >
Users who are authorized to mount tapes for
other users can use this form:
< < USERid > userid > vdev type: options:
optionA: optionB:
INput BLOCK
MOdify BUffers nn
NOAssign DEscription
NORing LEave
OUtput LIMit nn
PAssword password SIze nn
RIngin
optionC: optionD:
ASsign userid LEave
KEep nn LIMit nn
REadpw password NL
p NOLable
VOlume nnnnn VOlume nnnnn
VOlume pnnnnn
WRitepw password
Three different groups of tapes are recognized for the VTMOUNT
command: Scratch tapes, existing tapes, and dummy tapes. Existing
tapes can be mounted for input or output. Scratch and dummy tapes
are always output tapes. Scratch tapes can be mounted from any
library that is open for output.
vdev
| The device number (address) of the virtual tape drive on which
to mount the tape.
|
nnnnn
| Requests that a specific volume be mounted from a default
library. The default library can be a drive, user, class or
system default. nnnnn is the volume number, and leading zeros
can be omitted. nnnnn with the OUTPUT option can be used to
mount existing or scratch tapes.
|
pnnnnn
| Requests that a volume be mounted from a specific library.
p is the prefix for the requested library, and
nnnnn is the requested volume number. Leading zeros in the volume
number can be omitted; volume A00025 can be specified as A25. pnnnnn
with the OUTPUT option can be used to mount existing or scratch
tapes. If p is the dummy library prefix, a dummy tape will be
mounted. Dummy tapes are always mounted for output.
|
DUmmy
| Requests that a dummy tape be mounted. A dummy tape is a tape
that can be written to normally, but VTAPE does not preserve the data.
Standard labels are preserved and can be written to and read from
on a dummy tape.
Dummy tapes can be used in any situation where a tape must be present,
such as a logging or intermediate backup tape during testing,
if you will not need to read the data after it is written.
|
SCratch
| Requests that a scratch tape be mounted. To mount a scratch tape
from an output library other than the default library, specify the
library prefix as an option.
|
USERid userid
| Allows authorized users to mount a tape on
another user's virtual tape drive. If the userid is less than
5 bytes in length and could be interpreted as a
hexadecimal number, the USERID keyword is required.
When you specify this option, it must be the first option after
the VTMOUNT command.
|
ASsign userid
| Assigns ownership of a scratch tape to the specified userid
when the tape is mounted.
|
BLOCK
| Provides the ability to process virtual tapes by
library block. This option is normally used only by the
VTREST (VTAPE Restore) command.
|
BUFfers nn
| Selects the number of buffers to be assigned to this tape.
Buffers are 4096-byte blocks of pageable virtual storage used
to perform I/O to the virtual tape library.
|
DEscription
| Assigns a description to a scratch or existing tape mounted for
output. The description can be up to 64 characters long and
can include blanks and other special characters. If a description
includes blanks, it
must be entered as a character string enclosed in single quotes.
See usage note 1 for more information.
|
KEep nn
| Specifies the number of days this tape should be retained
in the library.
|
INput
| Requests that the tape be mounted for input. This is the
default for existing tapes. Input is not allowed for scratch or
dummy tapes.
|
LEave
| Places the virtual tape in LEAVE status.
When a tape is in LEAVE status, rewind/unload CCWs
(including the TAPE RUN and VMFPLC2 RUN commands)
will cause the tape to be rewound but not unloaded.
The VTRUN CP command will unload a virtual tape regardless of
the LEAVE status. When the tape is unloaded, the tape drive
will not remain in LEAVE status.
|
LIMit nn
| Limits the number of records that will be written to a tape before
a unit exception(EOT) is presented to a guest. The limit value when set
for a vdev applies to any output tape mounted on the drive. Limit is
provide
to test end of volume routines with short tapes. If you are testing
with standard label tape, you should specify a value of at least four
to write one data record to the tape.
|
MOdify
| Allows an existing tape to be mounted for output without
updating the tape's creation date. Normally, the creation
date is updated when a tape is mounted for output. MODIFY is
not allowed for dummy or scratch tapes.
|
NL
| Specifies that a scratch or dummy tape should not be initialized
with a standard label.
|
NOAssign
| Prevents ownership of an existing tape being mounted for output
from being reassigned to the user mounting the tape.
Normally,
a user mounting a tape for output becomes its owner.
|
NOLabel
| A synonym for NL.
|
NORing
| A synonym for INPUT.
|
OUtput
| Allows an existing tape to be mounted for output. The
creation date will be updated to the current date, and the user
mounting the tape will become its owner. Output is ignored for
dummy and scratch tapes, since they are always output tapes.
|
PAssword password
| Specifies the password for a protected tape.
For an output tape, the specified password is compared
to the WRITE password if the tape has one, or
to the READ password if the tape has a READ but not a WRITE password.
For an input tape, the
specified password is compared to the READ password.
|
REadpw password
| Assigns a READ password to a scratch tape when it is mounted. If
a read password is set, it must be entered for all subsequent
mounts of the tape for input or output.
A read password can be from 1 to 4 characters in length.
|
RIngin
| A synonym for OUTPUT.
|
p
| A library prefix alone is used to mount a scratch tape from a
specific output library.
|
SIze nn
| Allows the size to be set for a scratch or existing tape being
mounted for output. The size nn is specified in megabytes, from 1
to the maximum size tape that you are allowed to create.
|
VOlume nnnnn or VOlume pnnnnn
| Requests a specific dummy or scratch tape be mounted. nnnnn
requests a specific dummy tape or a specific scratch tape from
a default output library be mounted. The default library can be
the drive, user, class or system default. pnnnnn requests that
a specific
scratch tape be mounted from a specific library.
pnnnnn cannot be used with a dummy tape requests. (You can
use DUMMY VOL nnnnn, but not DUMMY VOL pnnnnn.)
If the request is for a scratch tape,
nnnnn must be a scratch volume.
Leading zeros may be omitted in the volume number.
|
WRitepw password
| Assigns a WRITE password to a scratch tape when it is mounted. If
a write password is set, it must be entered for all subsequent
mounts of the tape for output.
A write password can be from 1 to 4 characters in length.
|
- You can set and query a tape's description
to help identify its contents. A tape description can be from 1 to
64 characters long, and can contain blanks and other special
characters. Since the description may contain blanks, you must
enclose the description in a pair of single quotes when you set it.
The enclosing quotes do not become part of the description.
To include a quote character in the description itself,
use two successive quotes as shown in the first example below.
If the description consists of a single word, the quotes are not
required.
If this command is entered from the keyboard, the CMS and
CP command processors will translate the entered description to
uppercase before passing it to the VTMOUNT command.
In the examples below, the description will be saved in uppercase.
If you want to
assign a mixed-case description to a tape, use the VTMOUNT command
from an EXEC2 or Rexx exec using EXECIO CP or Diag 8.
If this is done,
the Virtual Tape subsystem will preserve the mixed-case description.
Also see the DESCRIPTION option of the VTSET command.
vtmnt 181 scratch desc 'tape dump of maint''s a-disk'
This mounts a scratch tape from the default library
and gives it a description.
vtmnt 181 scratch b keep 90 desc 'vm put 9104' size 10
This mounts a scratch tape from library B, which must be an
output library.
vtmnt 181 a25 buf 50
This mounts volume A00025 from library A as an input tape,
and specifies 50 buffers to use when reading the tape.
vtmnt 181 dum
This mounts a dummy tape on drive 181.
pnnnnn mounted on vdev
pnnnnn mounted on vdev for userid
HCPVT4A007I pnnnnn mounted on vdev by userid
The second message confirms a mount on another user's drive.
The third message (an asynchronous informational message)
is given to the target userid.
Other messages, such as Size set to nn,
will confirm options used with VTMOUNT.
Use VTQUERY to display information about virtual tape libraries
or volumes. VTQUERY can be interrupted with the PA1 key. The VTQUERY
command has several forms. Examples are given after the command syntax.
ACtive < selectA displayA >
DEFaults < options >
LIbrary < selectL displayL >
LIbrary STatus < MDisk >
VTQuery REstricted < ALL | LIb p >
SCratchset < p >
SPace < MDisk >
STatistics < RESET >
STats < RESET >
selectA: selectL: displayL:
p p COunt
nnnnn ... nnnnn ... DAte
pnnnnn ... pnnnnn ... DEScription
nnnnn-nnnnn ... nnnnn-nnnnn ... DETail
pnnnnn-pnnnnn ... pnnnnn-pnnnnn ... FUll
ALL ALL HDR1
DUmmy DSname dsname HDR2
INput FInd 'xxx' HEx
LDisk nnn LDisk nnn LAbel
MDisk vdev MDisk vdev PAssword
NODummy NL SHort
OUtput NOLabel VOl1
Prefix p OWner userid
USerid userid PAssword
PRefix p
SCRatch
SL
displayA: options:
COunt SYstem
USer < userid >
< VDev > vdev < OPTions >
The VTQUERY command has six major forms, which will:
- Display active (mounted) tape information
- Display System, User or device defaults
- Display information for tapes in a library
- Display the open/closed status of the libraries
- Display any restrictions that have been set on libraries or disks
- Display space information and percent full of an output library
- Display statistics on tape drive usage and tape mounts
VTQUERY ACTIVE checks all currently mounted tapes,
selects one or more tapes based on the options
you specify, and displays information about them.
ACtive
| Requests information about virtual tapes that are currently active
(mounted) in the system on which the command is issued.
One or more of the selection options listed
under option A can be given. Mounted tapes that match all of the
selection criteria will be displayed.
If no other options are requested, VTQUERY ACTIVE will show your active
tapes. Although VTQUERY ACTIVE will show
active tapes from all open libraries, it will only show
tapes that are active on the processor you are on.
|
p
| A single letter will be interpreted as a
library prefix letter.
Tapes mounted from the specified library will be selected.
If the library prefix is numeric, the PRefix option must be used.
(See Section "Numeric Library Prefixes." for additional information)
|
nnnnn pnnnnn nnnnn-nnnnn pnnnnn-pnnnnn
| Up to ten volumes or volume ranges can be entered to select
tapes for display. If library prefixes are specified they must
all be the same. You can also specify pnnnnn-nnnnn or
nnnnn-pnnnnn. Leading zeros in the tape number may be omitted.
|
ALL
| Selects tapes mounted by all users. The default is to select
tapes that you have mounted, unless you enter specific tape
volume numbers.
|
COunt
| Suppresses the display of selected tapes and gives a count
of tapes that meet the selection criteria.
|
DUmmy
| Selects mounted dummy tapes.
|
INput
| Selects tapes mounted for input.
|
LDisk nnn
| Selects active tapes for the requested library disk.
nnn is the relative number of the library disk from 0 to 255.
|
MDisk vdev
| Selects active tapes for the requested library minidisk.
vdev is the hexadecimal device number of the library minidisk
as defined in the CP user directory.
|
NODummy
| Selects mounted non-dummy tapes.
|
OUtput
| Selects tapes mounted for output.
|
PRefix p
| Specifies the prefix for numeric libraries.
(See Section "Numeric Library Prefixes." for additional information)
|
USerid userid
| Selects tapes mounted by the specified user.
The wild character '*' can be used to select multiple userids having
the same root. (ex: US TPF1*)
|
Use VTQUERY DEFAULTS to display the defaults for the System,
a user or a tape drive. If system, user or a vdev are not
entered, the default is user. You can also use CP's "Query Virtual
TAPE" or "Query Virtual vdev" command
to display the default library prefix for a tape drive.
SYstem
| Shows the defaults for the system.
|
USer < userid >
| Shows the defaults for a user.
|
< VDev > vdev < OPTions >
| Shows the defaults for your tape drive at address vdev. When
OPTions is requested, options setable by VTSET are displayed.
|
Use VTQUERY LIBRARY STATUS to find out which libraries are
available.
LIbrary STatus
| Shows the status (open, closed, or output) of each defined library.
|
LIbrary STatus MDisk
| Shows the status (open, closed, or output) of each defined library,
followed by the starting minidisk and the number of active minidisks
in each library.
|
VTQUERY LIBRARY displays information about tapes in a virtual
tape library. Although there are a lot of
options, most of them are used infrequently.
The options are grouped into
two types, selection options and display options.
The selection options select tapes.
The display options control what information is shown for the
tapes that are selected.
The options are described in detail on the following pages.
The selection options are:
- p (tapes in library p)
- nnnnn (tape nnnnn from the selected library)
- nnnnn-nnnnn (a range of tapes from the selected library)
- pnnnnn (tape nnnnn from library p)
- pnnnnn-pnnnnn (a range of tapes from library p)
- ALL (tapes owned by all users)
- DSNAME (standard labeled tapes with a given dataset name)
- FIND (tapes with a given word or phrase in the description)
- LDISK (tapes stored on a specific library disk)
- MDISK (tapes stored on a specific library minidisk)
- NL (tapes without an IBM standard label)
- NOLABEL (tapes without an IBM standard label)
- OWNER (tapes owned by a given user)
- PASSWORD (tapes with a read and/or write password)
- PREFIX (Prefix for numeric libraries)
- SCRATCH (selects tapes even if they are scratch tapes)
- SL (tapes with an IBM standard label)
The display options are:
- COUNT (shows only the number of tapes that were selected)
- DATE (shows date instead of userid on description displays)
- DETAIL (shows library information for each selected tape)
- DESCRIPTION (shows the description for each selected tape)
- FULL (shows detail, descriptions, and minidisk information)
- HDR1 (shows the header 1 record for standard label tapes)
- HDR2 (shows the header 2 record for standard label tapes)
- HEX (shows labels in hex with HDR1, HDR2, or VOL1)
- LABEL (shows label information: RECFM, LRECL, etc.)
- PASSWORD (shows the passwords for each selected tape)
- SHORT (shows the owners and volume numbers only)
- VOL1 (shows the volume record for standard label tapes)
If no selection options are given, VTQUERY LIBRARY will show
library information about all of your virtual tapes. The
default display option is "detail", except for selection options
FIND and PASSWORD. The default display option for FIND is
"description". The default display option for PASSWORD is
"password". You can use
the following additional options to select different tapes:
p
| Selects virtual tapes in a specific
library. p is the prefix letter of the desired library. If you
do not specify a library, by itself or with a volume number,
tapes will be selected from your default library.
If the library prefix is numeric, the PRefix option must be used.
(See Section "Numeric Library Prefixes." for additional information)
|
nnnnn pnnnnn nnnnn-nnnnn pnnnnn-pnnnnn
| Up to ten volumes or volume ranges can be entered to select
tapes for display. If library prefixes are specified, they must
all be the same. You can also specify pnnnnn-nnnnn or
nnnnn-pnnnnn. Leading zeros in the tape number may be omitted.
|
ALL
| Selects tapes owned by all users. The default is to
process only tapes that you own. (The OWNER option will select tapes
owned by a particular user.)
ALL and OWNER are conflicting options.
|
DSname dsname
| Selects IBM standard labeled tapes with a
specific data set name.
DSname dsname* will select standard labeled
tapes with a dataset name that begins with
the character string specified. DSname *dsname will select
standard labeled tapes with a dataset name that
contains the specified character string anywhere within it.
|
FInd 'xxx'
| selects tapes whose description contains the given character
string (a word, a phrase, etc.)
anywhere within it. The character string may
contain blanks or other special characters, and must be enclosed
in quotes. If it consists of only one word, the quotes are optional.
Upper and lower case are ignored for the comparison.
Leading and trailing asterisks are not required or supported
as wildcard characters, although the special form
FIND '*' or FIND * will select all tapes that have descriptions.
The default display option for find is "description".
|
LAbeled
| Selects tapes that have an IBM standard label.
|
LDisk nnn
| Selects tapes assigned to the specified library disk.
nnn is the relative number of the library disk from 0 to 255.
If you are doing a query to see which tapes are on a
library disk that is having errors, you should use the SHORT display
option. The SHORT display option only processes directory information;
it does not attempt to read tape data from the library disk.
|
MDisk vdev
| Selects tapes assigned to the specified library minidisk.
vdev is the hexadecimal device number of the library minidisk
as defined in the CP user directory.
If you are doing a query to see which tapes are on a
library minidisk that is having errors, you should use the SHORT display
option. The SHORT display option only processes directory information;
it does not attempt to read tape data from the library disk.
|
NL
| Selects tapes that do not have an IBM standard label.
|
NOLabel
| Selects tapes that do not have an IBM standard label.
|
OWner userid
| Selects tapes owned by the given user. (The ALL option selects
tapes owned by all users.)
OWNER and ALL are conflicting options.
The wild character '*' can be used to select multiple userids having
the same root. (ex: OW TPF1*)
|
PAssword
| Selects tapes which have a read and/or a write password. The
default display option for password is "password".
|
PRefix p
| Specifies the prefix for numeric libraries.
(See Section "Numeric Library Prefixes." for additional information)
|
SCRatch
| Selects all tapes in a range, even if the tape is a scratch tape.
(This will result in a message for each scratch tape, saying
"pnnnnn is a scratch tape" for each one.)
Normally, only the "owned" tapes in a range are selected and displayed.
|
SL
| Selects tapes that have an IBM standard label.
|
- You can only query tapes from a single library. If you enter
the library prefix more than once on the command, the same prefix
must be entered each time.
The display option controls how much information is given for
the tapes selected by the selection options.
When you are querying a range of tapes, the scratch (un-owned) tapes
in the range are not displayed
unless you specify SCRATCH.
The default display option depends on the selection options.
For the PASSWORD selection option, the default display
option is "password". For FIND, the default display option
is "description".
For all other selection options, the default
display option is "detail".
You can specify a display option to override the default.
COunt
| Suppresses the display of selected tapes, and gives only a count
of tapes that meet the selection criteria.
|
DAte
| Shows the tape's creation date, instead of the owner's
userid, when descriptions are being displayed.
|
DEScription
| Shows the description for each selected tape.
This is the default if you use the FIND option to
search for a tape with a particular description.
If descriptions are being shown, the owner's userid is normally
shown in the display. If you would like to see the creation date
instead of the owner's userid, use the DATE option.
|
DETail
| Shows the library information for each selected tape.
This is the default dislay option,
unless DESCRIPTION, FIND, or PASSWORD were used as selection
criteria.
|
FUll
| Shows the library information shown by DETAIL, along with the
library minidisk and the description for the tape. The resulting
display is 160 characters wide. FULL is primarily
intended to be used from an exec or CMS program,
where the response is returned
in a buffer and used by the exec or program.
|
HDR1
| Shows the header 1 label for a standard label tape.
This option implies the SL selection option.
|
HDR2
| Shows the header 2 label for a standard label tape.
This option implies the SL selection option.
|
HEx
| Shows standard labels in hex when used with the HDR1, HDR2 and
VOL1 options.
|
LAbel
| Shows format information for a standard label tape. Shows the
volume serial, dataset name,
record format, logical record length, block size, density and
recording format of the tape.
|
PAssword
| Shows the passwords, if any, for each selected tape. PASSWORD
is also a tape selection option. If no other display option
is given, and you specify PASSWORD, you will see the passwords
for the tape.
|
SHort
| Shows only the volume number, owner, library
minidisk, and the first block number for each selected tape.
The "first block" is the internal library pointer to the first block
of the tape.
|
VOl1
| Shows the volume label for a standard label tape.
This option implies the SL selection option.
|
VTQUERY REstricted displays any restrictions that have been set
for a library or any library minidisks. See the VTSET command
for more information on library restrictions.
REstricted < ALL >
| Shows if any libraries and library disks are restricted for
all open output libraries. ALL is the default if LIbrary is not
specified on the VTQUERY REstricted command.
|
REstricted LIbrary p
| Shows whether the specified library is restricted, and if any
of that library's minidisks are restricted.
|
VTQUERY SCRATCHSET displays the allocation of scratch tapes,
associated with CP classes and/or userids. The display can be limited
to 1 library by specifying the library prefix p
VTQUERY SPACE shows space and percent full information for an
output library. Space information is shown in 4096-byte blocks.
SPace
| Shows space information and the percent
full of an output library.
|
SPace MDisk
| Shows space information and the percent
full of each library minidisk in an output library.
|
VTQUERY STATISTICS (or VTQUERY STATS) shows information about
tape drive and tape usage.
STatistics or STats
| Shows tape drive and tape usage information. The fields are
described below.
|
STatistics RESET or STats RESET
| Shows tape drive and tape usage information and then resets the
counters. The "maximum" counters are reset to the "current" values.
All other values are reset to zero.
|
Sample responses for the most common VTQUERY commands are
shown below.
VTQUERY DEFAULTS
E10OPER Defaults Libr Size---Max Keep---Max Bufs---Max Maxvols
B 10 20 3 90 20 50 500
VTQUERY DEFAULTS SYSTEM
SYSTEM Defaults Libr Size---Max Keep---Max Bufs---Max Maxvols
B 10 20 3 90 20 50 10
VTQUERY DEFAULTS 181
0181 Defaults Libr Size---Max Keep---Max Bufs---Max Maxvols
B 10 20 3 90 20 50 500
VTQUERY DEFAULTS 181 OPTIONS
0181 Options Libr Autolib Limit Buffers Disposition
None Input 0 20 Unload
VTQUERY ACTIVE
Volume User Vdev Status At recd Tot recs % Full Size Buffers Keep
B00001 FRED 0181 Input 15 1433 15 12M 40 90
1 tape selected
VTQUERY ACTIVE USER MAINT
Volume User Vdev Status At recd Tot recs % Full Size Buffers Keep
B00001 MAINT 0181 Output 1673 1673 29 12M 40 90
A00001 MAINT 0182 Input 745 1433 15 12M 40 90
A00040 MAINT 0288 Output 1673 1673 29 12M 40 90
3 tapes selected
VTQUERY ACTIVE 1
Volume User Vdev Status At recd Tot recs % Full Size Buffers Keep
B00001 MAINT 0181 Output 1673 1673 29 12M 40 90
A00001 MAINT 0182 Input 745 1433 15 12M 40 90
A00001 FRED 0181 Input 15 1433 15 12M 40 90
2 tapes selected
VTQUERY ACTIVE 1 40
Volume User Vdev Status At recd Tot recs % Full Size Buffers Keep
B00001 MAINT 0181 Output 1673 1673 29 12M 40 90
A00001 MAINT 0182 Input 745 1433 15 12M 40 90
A00001 FRED 0181 Input 15 1433 15 12M 40 90
A00040 MAINT 0288 Output 1673 1673 29 12M 40 90
4 tapes selected
VTQUERY LIB A25
Volume Owner Created Keep Records % Full Size Data Set Name
A00025 FRED 07/09/94 999 4897 29 12 NO LABEL TAPE
1 tape selected
VTQUERY LIB A 25 32 1-3 18
Volume Owner Created Keep Records % Full Size Data Set Name
A00001 FRED 04/25/93 120 4897 22 12 NO LABEL TAPE
A00002 BILL 06/25/92 600 3220 28 12 NO LABEL TAPE
A00003 FRED 03/18/93 120 305 15 12 NO LABEL TAPE
A00018 JIM 01/12/93 120 2897 35 12 NO LABEL TAPE
A00025 FRED 07/09/94 999 6595 40 12 NO LABEL TAPE
A00032 GEORGE 04/18/93 120 113 9 12 NO LABEL TAPE
6 tapes selected
VTQUERY LIB A 25 32 1-3 18 DESC DATE
Volume Created Description
A00001 04/25/93 DESCRIPTION FOR TAPE 1
A00002 06/25/92
A00003 03/18/93 DESCRIPTION FOR TAPE 3
A00018 01/12/93
A00025 07/09/94 TAPE DUMP OF MY A-DISK ON JULY 9TH.
A00032 04/18/93 DESCRIPTION FOR TAPE 32
6 tapes selected
VTQUERY LIB A 25 32 1-3 18 DESC ALL
Volume Owner Description
A00001 FRED DESCRIPTION FOR TAPE 1
A00002 BILL
A00003 FRED DESCRIPTION FOR TAPE 3
A00018 JIM
A00025 FRED TAPE DUMP OF MY A-DISK ON JULY 9TH.
A00032 GEORGE DESCRIPTION FOR TAPE 32
6 tapes selected
VTQUERY LIB A 25 32 1-3 18 FIND * ALL
Volume Owner Description
A00001 FRED DESCRIPTION FOR TAPE 1
A00003 FRED DESCRIPTION FOR TAPE 3
A00025 FRED TAPE DUMP OF MY A-DISK ON JULY 9TH.
A00032 GEORGE DESCRIPTION FOR TAPE 32
4 tapes selected
VTQUERY LIB FIND 'JULY 9' DATE
Volume Created Description
A00025 07/09/94 TAPE DUMP OF MY A-DISK ON JULY 9TH.
1 tape selected
VTQUERY LIB FIND 'JULY 9' ALL
Volume Owner Description
A00025 FRED TAPE DUMP OF MY A-DISK ON JULY 9TH.
1 tape selected
VTQUERY LIBRARY SHORT
Volume Owner Mdisk 1st blk
A00001 FRED F30 000021F3
A00003 FRED F31 0100013B
A00025 FRED F30 000040E0
3 tapes selected
VTQUERY LIB OWNER FRED
Volume Owner Created Keep Records % Full Size Data Set Name
A00001 FRED 04/25/93 120 4897 22 12 NO LABEL TAPE
A00003 FRED 03/18/93 120 305 15 12 NO LABEL TAPE
A00025 FRED 07/09/94 45 4897 69 12 NO LABEL TAPE
3 tapes selected
VTQUERY LIB OWNER FRED COUNT
3 tapes selected
VTQUERY LIBRARY A25 PASSWORD
Volume Owner Created Keep Rdpass Wrpass Size Data Set Name
A00025 FRED 07/09/94 125 RRXP WWZP 12 VIRTUAL.TAPE
1 tape selected
VTQUERY LIBRARY A203 VOL1 HDR1 HDR2
Volume Label
A00203 VOL1A002030 VTAPE VSSI
A00203 HDR1RTB.TAPE BACKUP A0020300010001 00 93060 930630000000BSS
A00203 HDR2U327600000040PARS /RES P
1 tape selected from library A
VTQUERY LIBRARY A203 VOL1 HDR1 HEX
Volume Offset Hex data Character data
A00203 00 E5D6D3F1C1F0F0F2F0F3F0404040404040404040 *VOL1A002030 *
20 4040404040404040404040404040404040404040 * *
40 40E5E3C1D7C540E5E2E2C9404040404040404040 * VTAPE VSSI *
60 4040404040404040404040404040404040404040 * *
A00203 00 C8C4D9F1D9E3C24BE3C1D7C540C2C1C3D2E4D740 *HDR1RTB.TAPE BACKUP *
20 40C1F0F0F2F0F3F0F0F0F1F0F0F0F140404040F0 * A0020300010001 0*
40 F040F9F3F0F6F040F9F3F0F6F3F0F0F0F0F0F0F0 *0 93060 930630000000*
60 C2E2E240C2E2E240C2FF01005430900000404040 *BSS BSS B........ *
1 tape selected from library A
VTQUERY LIBRARY STATUS
Libraries: Open=ABC, Output=A, Defined=ABCD
VTQUERY LIBRARY STATUS MDISK
Libraries: Input=C Output=AB Default=B Defined=ABCD
Library A, Basemd=0F00, Mdisks=4, Status=Output
Library B, Basemd=0F10, Mdisks=2, Status=Output
Library C, Basemd=0F20, Mdisks=2, Status=Input
Library D, Basemd=0F30, Mdisks=0, Status=Closed
VTQUERY RESTRICTED
Library A use is restricted
VTQUERY RESTRICTED
Library A use is restricted
Library A disk 1 minidisk 0F01 use is restricted
VTQUERY RESTRICTED LIB A
Library A use is restricted
Library A disk 1 minidisk 0F01 use is restricted
VTQUERY RESTRICTED ALL
No restrictions were found for any library
VTQUERY SCRatchset
Scratch sets exception list for library A
Class list(s)
CLASS=ADE - TAPE=129 TO 144
CLASS=G,TAPE=1 to 7
USERID list(s)
USERID=MVS999 - TAPE=16 TO 47
Scratch sets exception list for library B
Class list(s)
CLASS=G - TAPE=1 TO 288
CLASS=G - TAPE=601 TO 616
There are no scratch sets USERID exception list.
VTQUERY SPACE A
Library A, Basemd=0F00, Mdisks=4, blocks=100000, in use=25000, %full=25
VTQUERY SPACE
Library B, Basemd=0F10, Mdisks=2, blocks=50000, in use=25000, %full=50
VTQUERY SPACE MDISK:
Library B, Basemd=0F10, Mdisks=2, blocks=50000, in use=25000, %full=50
Disk 0F10, Blocks=25000, in use=6237, % full=50, output tapes mounted=17
Disk 0F11, Blocks=25000, in use=6460, % full=52, output tapes mounted=29
Drives defined Vtapes mounted Dummy mounted --------Mount requests---------
Curr Max Curr Max Curr Max Total Input Output Scrtch Dummy
239 286 22 27 162 194 1302 143 40 285 834
Mbytes of data Avg mount 3420s defnd 3480s defnd 3490s defnd 3590s defnd
Read Written duration Curr Max Curr Max Curr Max Curr Max
229 983 01:52:11 94 118 141 168 4 8 0 0
Last reset: 03/04/93 at 12:00:15
Drives defined
| The current number of virtual tape drives defined systemwide,
and the largest number that have been concurrently defined since the
counters were reset (or since the system was IPLed).
|
Vtapes mounted
| The current number of virtual tapes mounted on virtual drives,
and the largest number that have been concurrently mounted since the
counters were reset (or since the system was IPLed). This number
does not include dummy tapes.
|
Dummy mounted
| The current number of dummy tapes mounted on virtual drives,
and the largest number that have been concurrently mounted since the
counters were reset (or since the system was IPLed).
|
Mount requests
| The total number of times any user has used the VTMOUNT command
to mount a tape. This is broken down into mounts of existing input
and output virtual tapes, virtual scratch tapes, and dummy tapes.
|
Mbytes of data
| The total number of megabytes of data that have been read from and
written to virtual tapes. This number does not include data written to
dummy tapes.
|
Avg mount duration
| The average length of time all tapes have been mounted, not
including dummy tapes. This also does not include tapes that are
still mounted; the counters used to calculate
the average duration are updated whenever a tape is unloaded.
|
3420s defnd etc.
| The number of tape drives of each type that are currently defined,
and the largest number that have been defined since the counters were
reset.
|
Last Reset:
| The date and time the statistics counters were reset. This
will be the time the VTAPE system was initialized, or the VTQ STATS
RESET command was issued.
|
The VTREW command will rewind a virtual tape.
VTREW vdev
vdev
| The device number (address) of the
virtual tape drive to be rewound. This parameter does not default and
may not be omitted.
|
- The CP REWIND and CMS TAPE REW commands will also
rewind a virtual tape.
pnnnnn rewound on vdev
The VTRUN command will rewind and unload a virtual tape volume.
VTRUN vdev < userid >
vdev
| The device number (address) of the
tape drive from which to unload the tape. VTRUN will unload a
tape regardless of the tape's LEAVE status. See the VTSET command
for more information on LEAVE status.
|
userid
| The userid of the user from which the tape should be unloaded.
This parameter gives authorized users the ability to
unload a tape from another user's virtual tape drive.
|
- Rewind/unload CCWs (including those issued
by TAPE RUN, or by an operating system such as MVS)
will normally unload a virtual tape.
However, if the tape or the drive is
in LEAVE status, rewind/unload CCWs
will cause the tape to be rewound but not unloaded.
Using VTRUN is the only way to unload a tape from a drive in LEAVE
status.
pnnnnn unloaded from vdev
pnnnnn has been unloaded for userid
pnnnnn has been unloaded by userid
The last message is sent to a user whose tape has been unloaded
by another user.
Use the VTSCRTCH command to scratch virtual tapes
from an output library. VTSCRTCH can be interrupted with the PA1 key.
VTSCRtch { p } < options >
{ nnnnn ... }
{ pnnnnn ... }
{ nnnnn-nnnnn ... }
{ pnnnnn-pnnnnn ... }
options:
OWner < userid >
PAssword password
PRefix p
PURge
p
| Specifies the prefix of the output library for this
scratch request. If a prefix is entered using the p option,
one or more tape volume numbers or ranges must also be entered.
If the library prefix is numeric, the PRefix option must be used.
(See Section "Numeric Library Prefixes." for additional information)
|
nnnnn pnnnnn nnnnn-nnnnn pnnnnn-pnnnnn
| Up to ten tape volumes or volume ranges can be entered to select
tapes to scratch. If a library prefix is specified, it must
be the library prefix of an output library. You can also
specify pnnnnn-nnnnn or nnnnn-pnnnnn. A volume number range
can specify a maximum of ten volumes to be scratched. Leading zeros
in the tape numbers may be omitted.
|
< OWner > userid
| Allows authorized users to scratch tapes owned by another user.
The authorization is defined in the VTAPE system configuration file.
If the userid is one character in length or could be identified as
a tape volume number, the userid keyword must be specified.
|
PAssword password
| Supplies the password to scratch protected tapes.
|
PRefix p
| Specifies the prefix for numeric libraries. If a prefix is entered
using the PRefix p option, one or more tape volume numbers or ranges
must also be entered.
(See Section "Numeric Library Prefixes." for additional information)
|
PURge
| Allows tapes that have not expired to be scratched.
|
- When scratching a range of tapes, the scratch can be interrupted
with the Break key (usually PA1).
- You can only scratch tapes from a single library. If you enter
the library prefix more than once on the command, the same prefix
must be entered each time.
- If you specify a password, PURGE, or a userid, it will apply to
all of the tape volume numbers entered.
pnnnnn has been scratched
Use the VTSET command to change tape volume information or
to set defaults for a tape drive or the system. The first section
of the syntax diagram shows options for changing tape volume
information. The second section
shows options for setting tape drive or
system defaults and restricting the use of a library or
library minidisk.
< p >
< nnnnn ... { options } >
VTSET < pnnnnn ... { options } >
< nnnnn-nnnnn ... { options } >
< pnnnnn-pnnnnn ... { options } >
options:
DEscription PAssword password
KEep days PRefix p
KEep +days REadpw password
KEep -days SIze nn
LIMit nn VOlser volser
OWner userid WRitepw password
VTSET < DEFaultlib SYstem p >
< RELeased { optionsA } >
< REStricted { optionsA } >
< VDev vdev { optionsB } >
optionsA: optionsB: optionsC:
LIbrary p ASsign INput
LDisk nnn AUTolib { optionC } OUTput
MDisk vdev BUffers nn MODify
LEave
LImit nnn
MAXShr nnn
NOAutolib
NOShare
SEQnum nnn
SHAre
SHRUsr userid
UNASsign
UNload
REStricted
| Restricts a library or library minidisk from use by general
users. See the usage notes for more information.
|
RELeased
| Release a restricted library or library minidisk.
|
LIbrary p
| Specifies the prefix of the library to be restricted or released.
|
LDisk nnn
| Specifies the relative disk number of the library disk
to be restricted or released for the specified library.
nnn is the relative number of the library disk from 0 to 255.
|
MDisk vdev
| Specifies the vdev of the library minidisk
to be restricted or released for the specified library.
vdev is the hexadecimal device number of the library minidisk
as defined in the CP user directory.
|
DEFaultlib SYstem p
| Sets the default library prefix for the system to p. The
requested library will be used when a prefix
is not specified on VTAPE commands. The system default prefix
will be used if the drive, user, and class default are not set for
the user issuing the command.
|
ASsign
| Assigns ownership of a shared virtual drive to the this
user if no othed user already owns the drive.
|
AUTolib < optionC >
| Places the virtual tape drive in auto-library mode for automatic
mounts in response to "Mnnnnn" or "MPRIVAT" messages
written to the display on 3480, 3490 or 3590 drives.
optionC
INput
causes automatically mounted tapes to be mounted for input only.
OUTput
causes automatically mounted tapes to be mounted for output. It
also changes the owner and creation date of the tape to the current
guest and current date to today's date.
MODify
causes automatically mounted tapes to be mounted for output, but
does not update the owner or creation date of the tape.
See the usage notes for more information on this option.
|
BUffers nn
| Sets the number of buffers allocated when a virtual tape
is mounted.
Buffers are 4096-byte blocks of pageable virtual storage used
to perform I/O to the virtual tape library.
The next tape mounted on the drive will use the requested
number of buffers.
|
DEFaultlib p
| Sets the default library prefix for tape drive to p. The
specified library will be used for mounts on the drive,
unless a library prefix is entered on the mount command.
|
LEave
| Places the virtual tape drive in LEAVE mode. When
a tape drive is in LEAVE mode, rewind/unload CCWs
(including the TAPE RUN and VMFPLC2 RUN commands)
will cause the tape to be rewound but not unloaded.
The VTRUN CP command will unload a virtual tape regardless of
the LEAVE status.
|
LIMit nn
| Limits the number of records that will be written to a tape before
a unit exception(EOT) is presented to a guest. When set for a mounted
tape volume, the limit value is for the current tape only.
Limit is provided
to test end of volume routines with short tapes. If you are testing
with standard label tape, you should specify a value of at least four
to write one data record to the tape. When specified for a tape, the
tape must be mounted for output for the limit to take effect.
|
MAXshr nnn
| Sets the maximun numbers of virtual drives that are allowed
to share a shared drive.
|
NOautolib
| Removes the virtual tape drive from auto-library mode so automatic
mounts no longer take place.
|
NOShare
| Sets a shared drive to non-shared mode.
|
SEQnum nnn
| Assigns a specific manufacturer sequence number to a shared drive.
|
SHAre
| Sets an unshared drive to shared mode.
|
SHRUsr userid
| Sets a specificd user as the only user that can share the drive.
|
UNASsign
| Releases the assignment of a shared drive from the current user.
|
UNload
| Removes LEAVE mode from a tape drive, and changes the drive
back to the normal UNLOAD mode. Rewind/unload CCWs
will then be handled normally.
|
p
| Specifies the prefix of the output library for this
set request. If a prefix is entered using the p option,
one or more tape volume numbers or ranges must also be entered.
If the library prefix is numeric, the PRefix option must be used.
(See Section "Numeric Library Prefixes." for additional information)
|
nnnnn pnnnnn nnnnn-nnnnn pnnnnn-pnnnnn
| Up to ten tape volumes or volume ranges can be entered to select
tapes for set. If a library prefix is specified, it must
be the library prefix of an output library. You can also
specify pnnnnn-nnnnn or nnnnn-pnnnnn. A volume number range
can specify a maximum of ten volumes to be set. Leading zeros
in the tape numbers may be omitted.
|
DEscription
| Sets or changes a virtual tape's description.
The description can be up to 64 characters long, and can contain
blanks and other special characters. Since the description may
contain blanks, it must be enclosed in single quotes for the VTSET
command.
See usage note 5 for more information.
|
KEep days
| Sets a new retention period. The number of days
specified can increase, reduce, or set a new value for the retention
period. days is a
plus, minus, or absolute number of days used to set
or adjust the retention period.
|
OWner userid
| Assigns ownership of a virtual tape to a different userid.
|
PAssword password
| Specifies the current password. This is required in
order to make any changes to a password-protected virtual tape.
If the tape has a WRITE password, it must be specified.
If the tape only has a READ password, it must be specified.
|
PRefix p
| Specifies the prefix for numeric libraries. If a prefix is entered
using the PRefix p option, one or more tape volume numbers or ranges
must also be entered.
(See Section "Numeric Library Prefixes." for additional information)
|
REadpw password
| Sets a read password for a tape. The read password can
be from 1 to 4 characters long.
|
SIze nn
| Changes the size of a tape. nn is the requested volume
size in megabytes.
|
VOlser volser
| Changes the internal volume serial of a standard-labeled
tape. volser is the new volume serial for the tape. The volser in
the standard label will be updated, but the library volume number
(pnnnnn) will not be changed. If fewer than six
characters are entered, they will be right justified, padded
with leading zeros, and the library prefix letter
will be used for the first character.
|
WRitepw password
| Sets a write password for a tape.
The write password can be from 1 to 4 characters.
|
VDev vdev
| Selects a tape drive for drive set options.
|
- More than one option can be specified on a single request, for
the options that apply to a tape volume.
- You can only set values for tapes from a single library. If
you enter the library prefix more than once on the command,
the same prefix must be entered each time.
- If you are setting tape values, the values entered will apply to
all of the tape volume numbers entered.
- If you have the specified tape mounted for output, the
values will be set.
If another user has the tape mounted for output,
the values will not be set.
- You can set and query a tape's description
to help you identify its contents.
A tape description can be from 1 to
64 characters long, and can contain blanks and other special
characters. Since the description may contain blanks, you must
enclose the description in single quotes when you set it.
The quotes do not become part of the description.
(To include a quote character, use two successive quotes as shown
in the first example below.)
If the description consists of a single word, the quotes are not
required.
If this command is entered from the keyboard, the CMS and
CP command processors will translate the entered description to
uppercase before passing it to the VTSET command processor.
In the examples below, the description will be saved in uppercase.
To assign a mixed-case description to a tape, you must issue
the VTSET command from an EXEC2 or Rexx exec using EXECIO CP or Diag 8.
If this is done,
the Virtual Tape subsystem will preserve the mixed-case description.
- AUTOLIB is intended for MVS or other systems that
write mount messages to the display of 3480, 3490 or 3590 tape drives
with the LOAD DISPLAY CCW. Tape management system or any
application that writes to the display can also
use the AUTOLIB feature. When a tape drive is in
AUTOLIB mode, the LOAD DISPLAY CCWs cause VTAPE to automatically
mount the requested tape on the drive. This feature acts
like a tape library
robot that reads the tape drive display and retrieves and mounts
the tapes. The INPUT/OUTPUT/MODIFY options control how existing tapes
are mounted, as described above.
If an existing tape is requested to be mounted and there are tapes
in the drives autoloader, the tapes in the autoloader are ignored.
If a scratch is requested and the first tape in the autoloader is a
scratch, the scratch from the autoloader will be mounted. This allows
mount options to be specified for the scratch tapes that are mounted.
Dummy tapes can be requested through the autolib facility by using
the dummy library prefix on the mount request
ie:(MZ01123S) JCL(VOL=SER=Z01123). Where Z is the dummy prefix If
If a dummy tape is requested and the first tape in the autoloader
is a dummy tape, the dummy tape from the autoloader will be
mounted. This allows mount options to be specified for the dummy tapes
that are mounted. Dummy tapes are requested
- When a library is restricted, the library and all its
minidisks are marked as restricted. The VTOPEN command can also
open a library restricted. If you release the
restriction on one or more minidisks, maintenance users can mount or
use tapes from the non-restricted minidisks.
This is generally used with VTREST to rebuild a
damaged VTAPE library minidisk. See the VTREST command for
more information.
General users will not be able to use a library until the
library restriction is released.
Restricting a library or minidisk can also be used
to quiesce a library that is to be closed, or to stop
the allocation of virtual tapes to a disk that is getting I/O errors.
- The use of the restricted, released and defaultlib system options
of VTSET are controlled by CP command privilege class.
vtset vdev 181 buffers 15 default d leave
Buffers for 0181 have been set to 15
Default library prefix for 0181 has been set to D
0181 has been set to leave mode
vtset vdev 181 default z autolib output limit 100
Default library prefix for 0181 has been set to Z
0181 has been set to autolib mode
Limit for 0181 has been set to 100
vtset 1 keep 10 size 15 description 'this is tape 1'
Keep for D1 set to 10 days
Size for D1 has been set to 15 megabytes
Description for D1 set to THIS IS TAPE 1
vtset b 1-3 5 owner vssivp1
HCPVY3A017E B1 is a scratch volume
Owner for volume B2 has been changed from E10OPER to VSSIVP1
Owner for volume B3 has been changed from E10OPER to VSSIVP1
Owner for volume B5 has been changed from E10OPER to VSSIVP1
Use the VTTest command to verify the syntax of a VTSYSTEM file.
VTTest fname
fname
| The name of the file to check.
|
The file being tested will go through syntax checking, but it will
not be put online even if the test is successful.
Use the COPYTAPE command to copy a real or virtual tape
to another real or virtual tape.
COPYTAPE < invdev < outvdev > > ( options
options:
DEN density REW 3490B XF
EOT RUN 3490C 18TRACK
FILes nnn SLTape 3590B
MODe xx SLUpdate 3590C
invdev
| The virtual device number (address) of the input tape
drive. Use a valid CMS tape address
(180-187, 288-28F, or TAP0-TAPF) only. The default is 181.
|
outvdev
| The virtual device number (address) of the output tape
drive. Use a valid CMS tape address
(180-187, 288-28F, or TAP0-TAPF) only. The default is 182.
|
DEN density
| Specifies the output tape density. The default is the highest
density supported by the output tape device.
|
EOT
| Requests a copy to the end of the input tape (two tape marks).
|
FILes nn
| Requests that a specific number of tape files be copied.
If the SLTAPE or SLUPDATE option is also specified, 3 physical
files will be copied for each file requested,
to copy the HDR1 label, the data file, and the EOF1 label.
|
MODe xx
| Specifies an output modeset byte. The default is D3. MODE and DEN
are mutually exclusive.
|
REW
| Requests that both tapes be rewound when the copy is completed.
|
RUN
| Requests that both tapes be unloaded when the
copy is completed.
|
SLTape
| Indicates that an IBM standard labeled tape is being copied.
The input and output tapes are rewound at the start of the copy.
|
SLUpdate
| Requests that the VOL1 and HDR1 labels that are written on the
output tape should be updated with the volume serial of the tape.
If you are copying a standard labeled tape and do not use this option,
the volume serial number in the VOL1 and HDR1 label on the output
tape will not match the volume serial number of the tape when the
copy is completed. If the output
tape is not a standard labeled tape, you will be prompted for an output
serial number. SLUPDATE implies SLTAPE.
|
XF
| Requests 3480 compaction format.
|
18TRACK
| Requests 3480 basic recording format.
|
3490B
| Requests basic 3490 recording format.
|
3490C
| Requests 3490 compaction format.
|
3590B
| Requests basic 3590 recording format.
|
3590C
| Requests 3590 compaction format.
|
- COPYTAPE will copy a single tape. The data on the input tape
must fit on the output tape.
- If two tape marks in a row are read from the input tape on a
multifile copy, a message will be issued that an empty file was
copied.
- If the SLTAPE or SLUPDATE option is specified, the input and output
tapes are rewound before the copy starts. If neither of these options
is requested, the tapes are not repositioned when the copy starts.
Internal volser volser on vdev, does not match VTAPE volser volser
The internal volume serial number (within the standard label)
on a virtual output tape does not match the output virtual tape
volume number. This message is only issued
with the SLUPDATE option, which asks that the standard label that
is being read from the input tape to be updated to match the
volume number of the tape that the standard label will be written to.
The next two messages ask for a response.
Enter 'I' to use the internal volser or 'V' to use the VTAPE volser
Enter 'U' to unload the tape and exit
A response of I will leave the standard label
on the output
tape as is. The volume serial in the standard label will not match
the volume serial of the output tape.
A response of V will write the volume serial of the
output tape into the standard label.
A response of U will unload the tape and exit the program.
Tape on vdev is not a standard label tape
The first record on the output tape is not an IBM standard
VOL1 label. If you enter a volume serial number, the copy will
continue. If you enter UNLOAD, the output tape
will be unloaded and the copy will terminate.
Enter 6 character volume serial or 'UNLOAD' for tape on vdev
Enter a volume serial to use for the output tape, or UNLOAD
to unload the tape.
Volume serial entered volser. Correct?
Enter Y for Yes or N for No.
This is a verification message. If the volser displayed is correct,
enter Y; otherwise, enter N
Input tape on vdev is sl volume volser
This message is issued when a VOL1 label is read, if the
SLUPDATE option was requested.
Output tape on vdev is sl volume volser
This message is issued when a VOL1 label is updated,
if the SLUPDATE option was requested.
New internal volser for tape on vdev is volser
This message is issued when a VOL1 label is copied from an
input tape to an output tape, when the
SLTAPE option is requested without SLUPDATE. Note that in this case,
the tape volume number and the volser in the standard label will not
match after the copy.
VTAPE number for tape on vdev is pnnnnn
This message is issued when a VOL1 label is copied with the
SLTAPE option, if the output tape is a virtual tape.
End of output tape on vdev.
An end of tape indication was returned to the WRTAPE macro for the
output tape. The input tape will not fit on the output tape.
End of job nnn tape marks processed
This message displays the actual number of tape marks read.
If the EOT option was requested, the number is one more
than the number of files processed (to count the double tape mark).
If the SLTAPE or SLUPDATE option was requested, the number
displayed is three times the number of files requested (since the
HDR1, the file, and the EOF1 were copied for each file requested).
Invalid tape device identification vdev
The device address supplied for the input or output tape
is invalid for CMS, or there is not a tape drive at that address.
CMS only supports tape addresses 180-18F, 280-28F, and TAP0-TAPF.
Use the CMS HELP command to display the VTAPE help menu and
information about the format and use of the VTAPE commands.
Help can also be used to review the explanation and action
for any VTAPE CP or CMS message.
DMSnnnnx
RVTnnnx
Help VTAPE < MENU >
VTAPe any_vtape_command
DMSnnnnx
| Displays the explanation and action for the specified VTAPE
CMS message. nnnn is the CMS message number and x is the
message severity letter ( I information, E error, W warning, etc. ).
VTAPE CMS messages are in the message number range of 2000 to 2499.
|
RVTnnnx
| Displays the explanation and action for the specified VTAPE
CP message. nnn is the CP message number and x is the
message severity letter ( I information, E error, W warning, etc. ).
VTAPE CP messages are in the message number range of 000 to 399.
|
VTAPE < MENU >
| Displays a menu of all VTAPE commands. The help for any
specific command can be selected from the menu.
|
VTAPe any_vtape_command
| Displays the syntax and options for the specified VTAPE command.
|
TAPSENSE is a VM tool written by Henry Nussbacher at the
Weizmann Institute of Science in Rechovot, Israel.
TAPSENSE is public domain software.
TAPSENSE will display the sense information for a
virtual or real tape drive.
TAPSENSE vdev
vdev
| The virtual address of a real or virtual
tape drive.
If your virtual machine is an XA-mode machine, this can
be any device address. 370-mode virtual machines must use a device
address from 0 to 1FFF.
|
All sense bytes are inspected and their meanings displayed; the
most common responses are listed below.
DMSTAP100I Density at 6250.
DMSTAP100I Tape Unit Model is 3420-8.
DMSTAP100I Intervention required/not ready.
DMSTAP100I Tape unit selected is NOT READY.
DMSTAP100I Tape unit selected is READY and not busy.
DMSTAP100I File protect/no ring present.
DMSTAP100I Tape positioned at load point.
DMSTAP100I Dual density drive.
DMSTAP100I 3420 not set to 1600 BPI.
DMSTAP100I 6250 BPI R/W capability.
TBROWSE is a VM tool written by Yossie Silverman at the
Weizmann Institute of Science in Rechovot, Israel.
TBROWSE is public domain software.
TBROWSE is used to scan tapes in a full-screen BROWSE-like
environment.
TBROWSE < maxblock < vdev > >
maxblock
| The largest block this program should encounter
in the current file. Upper limit is virtual storage size (up to 16m).
|
vdev
| The virtual address of the tape to be browsed
(180-187 or 280-287).
|
QUIT
| Use the QUIT subcommand to exit immediately from TBROWSE
leaving the tape positioned following the last block viewed.
The QUIT subcommand closes any printer spool file opened by
the PRINT subcommand.
|
CP or CMS
| Use the CP or CMS subcommand to enter into CP READ
(return with 'B') or CMS SUBSET (return with 'RETURN').
|
PRINT
| Use the PRINT subcommand to print the current screen of data
on the virtual printer (00E). '*** END OF BLOCK ***' is
printed highlighted as on screen. Note that the printer
spool file is only closed when the QUIT subcommand is
executed.
|
DISK < n < fname < ftype < fmode > > > >
| Use the DISK subcommand to copy n blocks, starting with the
one currently displayed, to the CMS file fname ftype fmode. If
not specified, the default fileid is "TBROWSE CMSUT1 A1".
Files are copied using the current mode and ASCII
translation settings. If the mode becomes invalid or an
error is encountered, the DISK function will terminate and
TBROWSE will display the block that couldn't be written.
|
SAVE < fname < ftype < fmode > > >
| The SAVE subcommand behaves like the DISK command except
that all blocks are copied from the one currently displayed
until the end-of-file.
|
V < n >
| Use the V subcommand to set the first column displayed. The
setting applies to the block currently displayed and all
following blocks. The L and R subcommands give similar
capability.
n is the starting column. The default is one.
|
MODE < F < nn > | V | VB | U >
| Use the MODE subcommand to set the formatting mode of the
blocks read starting with the one currently displayed.
F will set fixed (blocked) mode.
nn is the LRECL to be used in F mode. The
default is 80.
V will set variable mode. The length of each block
will be taken from information in the record.
VB will set variable blocked mode. The logical record
length and the block length will be taken from
information in the record.
U will set undefined block mode. The physical block
will be treated as a single record. This mode is
chosen whenever another mode does not apply.
Modes U and V display the current record such that it
wraps around from line to line. Modes F and VB
display one logical record per line with
truncation occurring if the record plus the display column is
greater than the console line width.
|
FSR < n >
| Use the FSR subcommand to advance the tape one or more
blocks. If end of file is sensed, the last block of the
file is displayed.
n specifies how many blocks to skip. The default is
one.
|
BSR < n >
| Use the BSR subcommand to move the tape back one or more
blocks. If end of file is sensed, the first block of the
file is displayed.
n specifies how many blocks to backspace. The default is
one.
|
FSF < n >
| Use the FSF subcommand to advance the tape to the next file
and display the first block of that file. If end of tape is
sensed, the last file on the tape is displayed.
n specifies how many files to skip. The default is
one.
|
BSF < n >
| Use the BSF subcommand to move the tape to the previous file
and display the first block of that file. If start of tape
is sensed, the first file on the tape is displayed.
n specifies how many files to move. The default is
one.
|
REW
| Use the REW subcommand to rewind the tape and display the
first block of the first file.
|
TOP
| Use the TOP subcommand to move the tape to the first block
in the current file.
|
BOT
| Use the BOT subcommand to move the tape to the last block in
the current file.
|
F or FH
| Use the F subcommand to advance within a block to the next
screen full of records. If less than a screen of records
remains in the block, the message '*** END OF BLOCK ***' is displayed
following the last record. Use FH to skip half a
screen of records.
|
B or BH
| Use the B subcommand to move within a block to the previous
screen of records. If less than a screen of records
remains, the message '*** START OF BLOCK ***' is displayed
following the first record. Use BH to skip half a screen of
records.
|
RESET
| Use the RESET subcommand to reset the display start column
and the top of screen record number to 1.
|
L < n >
| Use the L subcommand to move the display column to the left.
n is the number of columns to move. The default is
the screen width.
|
R < n >
| Use the R subcommand to move the display column to the
right.
n is the number of columns to move. The default is
the screen width.
|
HEX < ON or OFF >
| Use the HEX subcommand to set hexadecimal display mode.
"ON" will cause records and blocks to be displayed in
hexadecimal format.
"OFF" will cause records and blocks to be displayed in
character format.
HEX with no parm will toggle the option.
|
ASCII < ON or OFF >
| Use the ASCII subcommand to alter the ASCII translation on
input setting.
"ON" will set the ASCII translate on input mode so all
records and blocks displayed will be translated from
ASCII to EBCDIC. This option should be used for ASCII input tapes.
"OFF" will reset the ASCII translate on input mode so
that records and blocks displayed will not be translated
from ASCII to EBCDIC.
ASCII with no parm will toggle the option.
|
n
| Type a number as a subcommand to place that record at the top
of the screen.
|
=
| The = subcommand repeats the last command. The last command
entered will be executed again.
|
?
| The ? subcommand redisplays the last command entered in the
input area.
The command will be executed only if the user presses the ENTER
key.
|
1
| The & character can be used as a prefix for TBROWSE
subcommands to leave the subcommand in the display area
after execution, similar to the & command in Xedit.
This allows a command to be executed each time
the Enter key is pressed.
|
Most of the subcommands are accessible by PA/PF keys as follows:
PA1 CP PA2 CMS
1 BSR 2 FSR 3 QUIT
4 L 5 R 6 RESET
7 F 8 B 9 DISK
10 BSF 11 FSF 12 PRINT
PF13 through PF24 perform the same commands as PF1 through PF12.
[ Top of Page | Previous Page | Next Page | Table of Contents ]