560 lines
21 KiB
HTML
560 lines
21 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>Create Device Desc (Media Lib) (CRTDEVMLB)</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="CRTDEVMLB.Top_Of_Page"></a>
|
||
|
|
<h2>Create Device Desc (Media Lib) (CRTDEVMLB)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CRTDEVMLB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTDEVMLB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTDEVMLB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTDEVMLB"></a>
|
||
|
|
<p>The Create Device Description (Media Library) (CRTDEVMLB) command creates a device description for a media library device.
|
||
|
|
</p>
|
||
|
|
<p>Initially, all tape drive resources associated with this device description are allocated for use by this system. To change the allocation of drive resources within a tape library, use the Work with Media Library Status (WRKMLBSTS) command or the Vary Configuration (VRYCFG) command.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Allocating drives is only allowed when DEVCLS(*TAP) is specified.
|
||
|
|
</p>
|
||
|
|
<p>More information about using this command is in the Local Device Configuration book, SC41-5121.
|
||
|
|
</p>
|
||
|
|
<p><b>Restriction:</b> The user of this command must have *IOSYSCFG authority.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTDEVMLB.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="#CRTDEVMLB.DEVD"><b>DEVD</b></a></td>
|
||
|
|
<td valign="top">Device description</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Key, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.DEVCLS"><b>DEVCLS</b></a></td>
|
||
|
|
<td valign="top">Device class</td>
|
||
|
|
<td valign="top">*OPT, *TAP</td>
|
||
|
|
<td valign="top">Required, Key, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.RSRCNAME"><b>RSRCNAME</b></a></td>
|
||
|
|
<td valign="top">Resource name</td>
|
||
|
|
<td valign="top"><i>Name</i>, *NONE</td>
|
||
|
|
<td valign="top">Required, Key, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.TYPE"><b>TYPE</b></a></td>
|
||
|
|
<td valign="top">Device type</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*RSRCNAME</u></b></td>
|
||
|
|
<td valign="top">Optional, Key</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.ONLINE"><b>ONLINE</b></a></td>
|
||
|
|
<td valign="top">Online at IPL</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.UNLOADWAIT"><b>UNLOADWAIT</b></a></td>
|
||
|
|
<td valign="top">Unload wait time</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SYSGEN</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.MAXDEVTIME"><b>MAXDEVTIME</b></a></td>
|
||
|
|
<td valign="top">Maximum device wait time</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SYSGEN</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.RSCALCPTY"><b>RSCALCPTY</b></a></td>
|
||
|
|
<td valign="top">Resource allocation priority</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.INLMNTWAIT"><b>INLMNTWAIT</b></a></td>
|
||
|
|
<td valign="top">Initial mount wait time</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b>, *IMMED, *NOMAX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.EOVMNTWAIT"><b>EOVMNTWAIT</b></a></td>
|
||
|
|
<td valign="top">End of volume mount wait time</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*JOB</u></b>, *IMMED, *NOMAX</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.GENCTGID"><b>GENCTGID</b></a></td>
|
||
|
|
<td valign="top">Generate cartridge ids</td>
|
||
|
|
<td valign="top"><b><u>*VOLID</u></b>, *SYSGEN</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.ROBOTDEV"><b>ROBOTDEV</b></a></td>
|
||
|
|
<td valign="top">Robot device descriptions</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 2 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.ROBOTHOST"><b>ROBOTHOST</b></a></td>
|
||
|
|
<td valign="top">Robot host</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 2 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.LCLINTNETA"><b>LCLINTNETA</b></a></td>
|
||
|
|
<td valign="top">Local internet address</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTDEVMLB.MSGQ"><b>MSGQ</b></a></td>
|
||
|
|
<td valign="top">Message queue</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SYSOPR</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Message queue</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTDEVMLB.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*CHANGE</u></b>, *ALL, *USE, *EXCLUDE, *LIBCRTAUT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTDEVMLB.DEVD"></a>
|
||
|
|
<h3>Device description (DEVD)</h3>
|
||
|
|
<p>Specifies the name of the device description.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.DEVCLS"></a>
|
||
|
|
<h3>Device class (DEVCLS)</h3>
|
||
|
|
<p>Specifies the class of the media library being created.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*OPT</b></dt>
|
||
|
|
<dd>The device is an optical media library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TAP</b></dt>
|
||
|
|
<dd>The device is a tape media library.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.RSRCNAME"></a>
|
||
|
|
<h3>Resource name (RSRCNAME)</h3>
|
||
|
|
<p>Specifies the resource name that identifies the hardware that the description represents. A resource name must be provided before the device can be varied on.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No resource name is specified at this time.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>resource-name</i></b></dt>
|
||
|
|
<dd>Specify the name that identifies the media library device hardware on the system.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*STG) specified to determine the resource name.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.TYPE"></a>
|
||
|
|
<h3>Device type (TYPE)</h3>
|
||
|
|
<p>Specifies the type of device that this description represents.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The device type is used to support prompting of this command; the value is not saved as part of the device description.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*RSRCNAME</u></b></dt>
|
||
|
|
<dd>The device type is determined from the resource name parameter.
|
||
|
|
<p>Any of the following device types, listed in numeric order, are valid:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>3494
|
||
|
|
</li>
|
||
|
|
<li>3495
|
||
|
|
</li>
|
||
|
|
<li>3570
|
||
|
|
</li>
|
||
|
|
<li>3590
|
||
|
|
</li>
|
||
|
|
<li>3995
|
||
|
|
</li>
|
||
|
|
<li>399F
|
||
|
|
</li>
|
||
|
|
<li>9427
|
||
|
|
</li>
|
||
|
|
<li>9429
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Device types 3995 and 399F are valid only when DEVCLS(*OPT) is specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.ONLINE"></a>
|
||
|
|
<h3>Online at IPL (ONLINE)</h3>
|
||
|
|
<p>Specifies whether this object is automatically varied on at initial program load (IPL).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>This device is varied on automatically at IPL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>This device is not varied on automatically at IPL.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.UNLOADWAIT"></a>
|
||
|
|
<h3>Unload wait time (UNLOADWAIT)</h3>
|
||
|
|
<p>Specifies the amount of time the system waits for another request to use the mounted volume before unloading the volume if there are outstanding requests for an available drive.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when DEVCLS(*OPT) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSGEN</u></b></dt>
|
||
|
|
<dd>The system default value is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>unload-wait-time</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait. Valid values range from 1 through 120.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.MAXDEVTIME"></a>
|
||
|
|
<h3>Maximum device wait time (MAXDEVTIME)</h3>
|
||
|
|
<p>Specifies the maximum number of minutes a volume can remain mounted in an internal device if there are requests for other volumes.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when DEVCLS(*OPT) is specified, and is ignored for DEVCLS(*TAP).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSGEN</u></b></dt>
|
||
|
|
<dd>The system default value is used. This allows a maximum device wait time to be specified for each library device user rather than the same value for each user of the library device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The requests will wait until a tape resource is available.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value is valid for tape devices only.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>max-device-time</i></b></dt>
|
||
|
|
<dd>For optical devices, specify the number of minutes the volume can remain mounted. Valid values range from 1 through 60. For tape devices, specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.RSCALCPTY"></a>
|
||
|
|
<h3>Resource allocation priority (RSCALCPTY)</h3>
|
||
|
|
<p>Specifies the resource allocation priority.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when DEVCLS(*TAP) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The priority of the job is used as the resource allocation priority.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>resource-allocation-priority</i></b></dt>
|
||
|
|
<dd>Specify the priority this job is given when requesting a resource. Valid values range from 1 (highest) through 99 (lowest).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.INLMNTWAIT"></a>
|
||
|
|
<h3>Initial mount wait time (INLMNTWAIT)</h3>
|
||
|
|
<p>Specifies the maximum amount of time a request will wait for allocation of a tape resource for the initial mount.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when DEVCLS(*TAP) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The allocation wait time is determined by the default wait time attribute of the job requesting the allocation, rounded up to the nearest minute.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMMED</b></dt>
|
||
|
|
<dd>The request will not wait for a tape resource to become available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The request will wait until a tape resource is available.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>initial-mount-wait-time</i></b></dt>
|
||
|
|
<dd>Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.EOVMNTWAIT"></a>
|
||
|
|
<h3>End of volume mount wait time (EOVMNTWAIT)</h3>
|
||
|
|
<p>Specifies the maximum amount of time a request will wait for allocation of a tape resource for the end of volume mount.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only when DEVCLS(*TAP) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*JOB</u></b></dt>
|
||
|
|
<dd>The allocation wait time is determined by the default wait time attribute of the job requesting the allocation, rounded up to the nearest minute.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMMED</b></dt>
|
||
|
|
<dd>The request will not wait for a tape resource to become available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>The request will wait until a tape resource is available.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-of-volume-mount-wait-time</i></b></dt>
|
||
|
|
<dd>Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.GENCTGID"></a>
|
||
|
|
<h3>Generate cartridge ids (GENCTGID)</h3>
|
||
|
|
<p>Specifies how the cartridge identifiers are assigned to each volume for tape libraries without bar code readers.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*VOLID</u></b></dt>
|
||
|
|
<dd>The volume identifier is used as the cartridge identifier. Cartridge identifiers can be assigned by mounting each volume and reading the volume identifier.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSGEN</b></dt>
|
||
|
|
<dd>The system generates the cartridge identifiers for each volume. If system-generated identifiers are used, tape operations must use the generated cartridge identifiers. The cartridge identifiers are assigned sequentially in the form SLT001, SLT002, SLT003, and so on.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.ROBOTDEV"></a>
|
||
|
|
<h3>Robot device descriptions (ROBOTDEV)</h3>
|
||
|
|
<p>Specifies the name of the device description representing the robot for library devices with separate robots.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.ROBOTHOST"></a>
|
||
|
|
<h3>Robot host (ROBOTHOST)</h3>
|
||
|
|
<p>Specifies the TCP/IP host name or Internet address of the robotic library manager. A maximum of 2 robot library managers can be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No robotic host is specified at this time.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>host-name</i></b></dt>
|
||
|
|
<dd>The specified name of the robotic library manager. The user may enter the robot host name by entering the robot host name or the domain qualified robot host name. The domain qualified robot host name allows input of 255 bytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>host-internet-address</i></b></dt>
|
||
|
|
<dd>The specified address of the robotic library manager. The internet address must be of the form ddd.ddd.ddd.ddd where ddd is a decimal number ranging from 0 to 255. This decimal number should not contain leading zeros. If the host internet address is entered from a command line, the address must be enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.LCLINTNETA"></a>
|
||
|
|
<h3>Local internet address (LCLINTNETA)</h3>
|
||
|
|
<p>Specifies the local internet address of the interface that is connecting to the robot library manager. This is the interface the operating system will start when TCP/IP needs to be started to use the tape media library.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No TCP/IP address is specified at this time.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>local-ip-address</i></b></dt>
|
||
|
|
<dd>Specify the local internet address to be started. The internet address must be of the form ddd.ddd.ddd.ddd where ddd is a decimal number ranging from 0 to 255. This decimal number should not contain leading zeros. If the local internet address is entered from a command line, the address must be enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.MSGQ"></a>
|
||
|
|
<h3>Message queue (MSGQ)</h3>
|
||
|
|
<p>Specifies the qualified name of the message queue to which messages are sent.
|
||
|
|
</p>
|
||
|
|
<p>The possible qualified names are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSOPR</u></b></dt>
|
||
|
|
<dd>Messages are sent to the QSYSOPR message queue in QSYS library.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue to which operational messages are sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>No text is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTDEVMLB.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CHANGE</u></b></dt>
|
||
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USE</b></dt>
|
||
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBCRTAUT</b></dt>
|
||
|
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTDEVMLB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTDEVMLB DEVD(LIB01) DEVCLS(*OPT)
|
||
|
|
RSRCNAME(LIB01) ONLINE(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a device description for a media library device named LIB01. The library is an optical library and the physical resource name is LIB01. The device description is varied on at IPL.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTDEVMLB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF261A</b></dt>
|
||
|
|
<dd>Device description &1 not created due to errors.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67B0</b></dt>
|
||
|
|
<dd>Tape resource &2 not in specified library device
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF67D1</b></dt>
|
||
|
|
<dd>Library device description not created
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTDEVMLB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|