ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/wrkmedrdar.htm

230 lines
8.0 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Work with Media for OnDemand (WRKMEDRDAR)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="WRKMEDRDAR.Top_Of_Page"></a>
<h2>Work with Media for OnDemand (WRKMEDRDAR)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#WRKMEDRDAR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKMEDRDAR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKMEDRDAR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKMEDRDAR"></a>
<p>The Work with Media for OnDemand (WRKMEDRDAR) Command allows you to specify the media that is used by OnDemand. Media can be defined for tape and optical devices.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKMEDRDAR.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#WRKMEDRDAR.TYPE"><b>TYPE</b></a></td>
<td valign="top">Media type</td>
<td valign="top">*OPTVOL, *STGGRP, *TAPDEV, *TAPVOL</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMEDRDAR.OPTVOL"><b>OPTVOL</b></a></td>
<td valign="top">Optical volume</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMEDRDAR.STGGRP"><b>STGGRP</b></a></td>
<td valign="top">Storage group</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMEDRDAR.TAPDEV"><b>TAPDEV</b></a></td>
<td valign="top">Tape device</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#WRKMEDRDAR.TAPVOL"><b>TAPVOL</b></a></td>
<td valign="top">Tape volume</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKMEDRDAR.TYPE"></a>
<h3>Type (TYPE)</h3>
<p>Specifies the type of media to work with.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*OPTVOL</b></dt>
<dd>This option allows you to work with optical volumes that are defined to OnDemand. Using this option, you may add, remove, display, and change the optical volumes.
</dd>
<dt><b>*STGGRP</b></dt>
<dd>This option allows you to work with an optical storage group. Using this option, you may create, delete, display, and change the storage groups.
</dd>
<dt><b>*TAPDEV</b></dt>
<dd>This option allows you to work with the tape devices that are defined to OnDemand. Using this option, you may add, remove, display, and change the tape devices.
</dd>
<dt><b>*TAPVOL</b></dt>
<dd>This option allows you to work with tape volumes that are defined to OnDemand. Using this option, you may add, remove, display, and change the tape volumes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMEDRDAR.OPTVOL"></a>
<h3>Optical volume (OPTVOL)</h3>
<p>Specifies the identifier of an optical volume for which entries are shown on the Work with Optical Volumes display.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All volumes are shown.
</dd>
<dt><b><i>generic*-optical-volume-identifier</i></b></dt>
<dd>Specify the generic identifier of the optical volumes to work with.
</dd>
<dt><b><i>optical-volume-identifier</i></b></dt>
<dd>Specify the identifier of an optical volume to work with.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMEDRDAR.STGGRP"></a>
<h3>Storage group (STGGRP)</h3>
<p>Specifies the name of the optical storage group for which entries are shown on the Work with OnDemand Storage Groups display.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All storage groups are shown.
</dd>
<dt><b><i>generic*-storage-group-name</i></b></dt>
<dd>Specify the generic name of the storage groups to work with
</dd>
<dt><b><i>storage-group-name</i></b></dt>
<dd>Specify the name of a storage group to work with.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMEDRDAR.TAPDEV"></a>
<h3>Tape device (TAPDEV)</h3>
<p>Specifies the name of a tape device for which entries are shown on the Work with OnDemand Tape Devices display.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All tape devices are shown.
</dd>
<dt><b><i>generic*-tape-device-name</i></b></dt>
<dd>Specify the generic name of the tape devices to work with.
</dd>
<dt><b><i>tape-device-name</i></b></dt>
<dd>Specify the name of a tape device to work with.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKMEDRDAR.TAPVOL"></a>
<h3>Tape volume (TAPVOL)</h3>
<p>Specifies the identifier of a tape volume for which entries are shown on the Work with OnDemand Tape Volumes display.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All tape volumes are shown.
</dd>
<dt><b><i>generic*-tape-volume-identifier</i></b></dt>
<dd>Specify the generic identifier of the tape volumes to work with.
</dd>
<dt><b><i>tape-volume-identifier</i></b></dt>
<dd>Specify the identifier of a tape volume to work with.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKMEDRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
WRKMEDRDAR TYPE(*OPTVOL)
</pre>
</p>
<p>This command example initiates the OnDemand media functions for all optical volumes (*OPTVOL). Other media types that can be specified include storage groups (*STGGRP), tape devices (*TAPDEV), and tape volumes (*TAPVOL).
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
WRKMEDRDAR TYPE(*OPTVOL) OPTVOL(OND*)
</pre>
</p>
<p>This command is similar to Example 1 but provides a generic value for the optical volume name to subset the list of volume names with which to work. Each media type described in Example 1 allows the entry of a specific name, a generic name, or *ALL.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="WRKMEDRDAR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKMEDRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>