ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/rbam6volexpand.htm

117 lines
6.9 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="VOL parameter" />
<meta name="abstract" content="The volume (VOL) parameter specifies the volume identifiers of the volumes used in a tape or optical operation." />
<meta name="description" content="The volume (VOL) parameter specifies the volume identifiers of the volumes used in a tape or optical operation." />
<meta name="DC.Relation" scheme="URI" content="rbam6expand.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzau8/kickoff.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbam6volexpand" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>VOL parameter</title>
</head>
<body id="rbam6volexpand"><a name="rbam6volexpand"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">VOL parameter</h1>
<div><p>The volume (VOL) parameter specifies the volume identifiers of
the volumes used in a tape or optical operation. </p>
<div class="section"><p>A tape volume consists of a tape cartridge or reel. An optical
volume consists of a single side of an optical cartridge or a single CD-ROM.
Optical cartridges are dual-sided and each side is a separate volume.</p>
<p>The
volume identifier is the identifier stored on each tape or optical disk (in
the volume label area) that it identifies. An inquiry message is sent to
the system operator if a volume identifier is missing or out of order.</p>
<p>Tape
volumes must be on the tape units in the same order as their identifiers are
specified in the VOL parameter and as the device names are specified in the
DEV parameter of the tape device file commands. However, if the tapes are
read backward (a function supported in COBOL), the volumes must be in reverse
order to that specified in the VOL parameter. Nevertheless, the device names
are still specified in forward order in the DEV parameter.</p>
<p> In general,
the rule for specifying tape volume identifiers is that as many as 6 characters,
containing any combination of letters and digits, can be used. Special characters
can be used if the identifier is enclosed in apostrophes. However, if the
tape is used on a system other than an iSeries™ system, the requirements for
specifying identifiers on that system must be considered. </p>
<p>Optical volume
identifiers can be up to 32 characters long and can contain any combination
of digits and upper case letters. Each optical volume identifier must be unique.
No two optical volumes with the same identifier can be present on the system
at the same time.</p>
<p> For labeled tapes, the following rules apply: </p>
<ul><li>Characters: A maximum of 6 characters, or fewer, can be specified for
each volume identifier. Alphabetic and numeric characters can be used in any
order.</li>
<li>Uniqueness: More than one volume can have the same identifier. You may
have a file using the same identifier for several volumes; in this case, the
system keeps track of the order internally with a sequence number written
on the volumes. However, volume identifiers should be unique whenever possible.</li>
<li>Order: When multiple volumes (with different identifiers) are used in
a single operation, they must be in the same order as the volume identifiers
specified in the VOL parameter.</li>
</ul>
</div>
<div class="section"><h4 class="sectiontitle">Multivolume files</h4><p>If multiple volumes (tapes) are
used in an operation and all have the same volume identifier, that identifier
must be specified in the VOL parameter once for each volume used. For example,
if three tapes named QGPL are used in a save operation, VOL(QGPL QGPL QGPL)
must be specified.</p>
<p>When a multivolume file on <em>tape</em> is processed
and multiple tape units are used, the tape volumes must be placed in the tape
devices in the same order as they are specified in the VOL parameter. For
example, if five volumes and three tape units are used, they are mounted as
follows: VOL1 on unit 1, VOL2 on unit 2, VOL3 on unit 3, VOL4 on unit 1, and
VOL5 on unit 2.</p>
</div>
<div class="section"><h4 class="sectiontitle">Values allowed</h4><dl><dt class="dlterm">*MOUNTED</dt>
<dd>The volume currently placed in the device is used.</dd>
<dt class="dlterm">*NONE</dt>
<dd> No volume identifier is specified.</dd>
<dt class="dlterm">*SAME</dt>
<dd> Previously specified volume identification does not change.</dd>
<dt class="dlterm">*SAVVOL</dt>
<dd>The system, using the save/restore history information, determines which
tape volumes contain the most recently saved version. If the device specified
in the DEV parameter of the restore command does not match the device of the
most recently saved version of the object, an error message is returned to
the user, and the function is ended. If the wrong volume is mounted in the
unit specified by the command, a message is returned to the system operator
that identifies the first volume that must be placed in the device before
the restore operation can begin.</dd>
<dt class="dlterm"><var class="varname">volume-identifier</var></dt>
<dd>Specify the identifiers of one or more volumes in the order in which they
are put on the device and used. Each tape volume identifier contains a maximum
of 6 alphanumeric characters. Each optical volume identifier contains a maximum
of 32 characters. A blank is used as a separator character when listing multiple
identifiers.</dd>
</dl>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbam6expand.htm" title="This section contains the expanded descriptions of some of the parameters commonly used in the CL commands.">Commonly used parameters</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../rzau8/kickoff.htm">Optical programming</a></div>
</div>
</div>
</body>
</html>