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

422 lines
18 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Configure Device Media Library (CFGDEVMLB)</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="CFGDEVMLB.Top_Of_Page"></a>
<h2>Configure Device Media Library (CFGDEVMLB)</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="#CFGDEVMLB.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CFGDEVMLB.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CFGDEVMLB.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CFGDEVMLB"></a>
<p>The Configure Device Media Library (CFGDEVMLB) command connects the media library device description with the communication interface for media library devices that require a communication interface. The CFGDEVMLB command will configure the necessary communication information based on the input to the command, will update the necessary information in the device description specified, and will attempt to vary on the media library device description. Refer to the Storage Solutions topic in iSeries Information Center at http://www.iseries.ibm.com/infocenter for more information about configuring media library devices.
</p>
<p>For a LAN-attached media library device, the information on the Library Manager console must also be updated. To determine the necessary information for the Library Manager, use the Display LAN Media Library (DSPLANMLB) command.
</p>
<p>This command must be issued once for each media library device description that uses a communication interface.
</p>
<p>User *PUBLIC will be given *USE authority to any objects that this command creates: controller, device, and so on. The objects that the CFGDEVMLB command creates will be named the same as the resource name specified on the command for ADPTTYPE(*RS232) and same as the remote location name for ADPTTYPE(*LAN). The owner of the objects will be the user profile of the user executing the command.
</p>
<p><b>Restrictions</b>
</p>
<ul>
<li>You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
</li>
<li>You must have use (*USE) authority for the following CL commands: CRTDEVAPPC, CRTCTLAPPC, CRTDEVASC, CRTCTLASC, CRTLINASC, CHGDEVMLB, and VRYCFG.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CFGDEVMLB.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="#CFGDEVMLB.DEV"><b>DEV</b></a></td>
<td valign="top">Library device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.ADPTTYPE"><b>ADPTTYPE</b></a></td>
<td valign="top">Adapter type</td>
<td valign="top"><b><u>*RS232</u></b>, *LAN</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Communication resource name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.PROTOCOL"><b>PROTOCOL</b></a></td>
<td valign="top">Protocol</td>
<td valign="top"><b><u>*APPC</u></b>, *TCP</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.LIND"><b>LIND</b></a></td>
<td valign="top">Line description</td>
<td valign="top">Values (up to 2 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location</td>
<td valign="top">Values (up to 2 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.ADPTADR"><b>ADPTADR</b></a></td>
<td valign="top">LAN remote adapter address</td>
<td valign="top">Values (up to 2 repetitions): 000000000001-FFFFFFFFFFFF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.ROBOTHOST"><b>ROBOTHOST</b></a></td>
<td valign="top">Robot host</td>
<td valign="top">Values (up to 2 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CFGDEVMLB.LCLINTNETA"><b>LCLINTNETA</b></a></td>
<td valign="top">Local internet address</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CFGDEVMLB.DEV"></a>
<h3>Library device (DEV)</h3>
<p>Specifies the media library device. The device description must exist on the system whether it was autoconfigured, or it was created with the Create Device Media Library (CRTDEVMLB) command.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the media library device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.ADPTTYPE"></a>
<h3>Adapter type (ADPTTYPE)</h3>
<p>Specifies how the media library device is attached to the system.
</p>
<dl>
<dt><b><u>*RS232</u></b></dt>
<dd>Indicates that the media library device is attached with a RS-232 port.
</dd>
<dt><b>*LAN</b></dt>
<dd>Indicates that the media library device is attached with a token-ring or ethernet local area network line.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.RSRCNAME"></a>
<h3>Communication resource name (RSRCNAME)</h3>
<p>Specifies the resource name of the RS-232 port. Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*CMN) to determine what resources exist on the system.
</p>
<p>
<b>Note: </b>This parameter is required when ADPTTYPE(*RS232) is specified.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the resource name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.PROTOCOL"></a>
<h3>Protocol (PROTOCOL)</h3>
<p>Specifies the communication protocol to use to communicate with the robot.
</p>
<p>
<b>Note: </b>This parameter is required when ADPTTYPE(*LAN) is specified.
</p>
<dl>
<dt><b><u>*APPC</u></b></dt>
<dd>Indicates the APPC protocol will be used to communicate with the robot.
</dd>
<dt><b>*TCP</b></dt>
<dd>Indicates the TCP/IP protocol will be used to communicate with the robot.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.LIND"></a>
<h3>Line description (LIND)</h3>
<p>Specifies the line description to which the media library device is attached. The line description must already exist on the system. Use the Work with Configuration Status (WRKCFGSTS) command, with CFGTYPE(*LIN), to display a list of line descriptions that are configured on the system.
</p>
<p>
<b>Note: </b>This parameter is required when ADPTTYPE(*LAN) and PROTOCOL(*APPC) are specified. A maximum of 2 line descriptions can be specified.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of line description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.RMTLOCNAME"></a>
<h3>Remote location (RMTLOCNAME)</h3>
<p>Specifies the remote location name of the Library Manager to which the media library device will communicate.
</p>
<p>This parameter information should be obtained from the Library Manager console. To determine the remote location name on the Library Manager, select COMMANDS from the action bar of the MAIN MENU. From the COMMANDS pull-down, select LM LAN Options, and then select LM LAN Information. The LM LAN Information panel will display the correct location name and network identifier for this media library device.
</p>
<p>
<b>Note: </b>This parameter is required when ADPTTYPE(*LAN) and PROTOCOL(*APPC) are specified. A maximum of 2 remote location names can be specified.
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the remote location nameusing the format <b>nnnnnnnn.cccccccc</b>, where <b>nnnnnnnn</b> is the remote network identifier (ID) and <b>cccccccc</b> is the remote location name. If no network ID is specified, the network attributes are used to determine the default network ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.ADPTADR"></a>
<h3>LAN remote adapter address (ADPTADR)</h3>
<p>Specifies the LAN adapter address of the remote controller from the Library Manager.
</p>
<p>This parameter information should be obtained from the Library Manager console. To determine the adapter address on the Library Manager, select COMMANDS from the action bar of the MAIN MENU. From the COMMANDS pull-down, select LM LAN Options, and then select LM LAN Information. The LM LAN Information panel will display the correct adapter address for this media library device.
</p>
<p>
<b>Note: </b>This parameter is required when ADPTTYPE(*LAN) and PROTOCOL(*APPC) are specified. A maximum of 2 adapter addresses can be specified.
</p>
<dl>
<dt><b><i>X'000000000001'-X'FFFFFFFFFFFF'</i></b></dt>
<dd>Specify the LAN adapter address.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.ROBOTHOST"></a>
<h3>Robot host (ROBOTHOST)</h3>
<p>Specifies the TCP/IP host name or internet address of the robotic library manager.
</p>
<p>
<b>Note: </b>This parameter is required when ADPTTYPE(*LAN) and PROTOCOL(*TCP) are specified. A maximum of 2 robot host names or robot internet addresses can be specified.
</p>
<dl>
<dt><b><i>host-name</i></b></dt>
<dd>Specify the name of the robotic library manager. You may enter the 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>
<dt><b><i>internet-address</i></b></dt>
<dd>Specify the internet address of the TCP/IP interface.
<p>The robot host internet address must be of the form <b>ddd.ddd.ddd.ddd</b> where <b>ddd</b> is a decimal number ranging from 0 to 255 and should not contain leading zeroes.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CFGDEVMLB.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 media tape library.
</p>
<p>
<b>Note: </b>This parameter may only be specified when ADPTTYPE(*LAN) and PROTOCOL(*TCP) are specified.
</p>
<dl>
<dt><b><i>internet-address</i></b></dt>
<dd>Specify the local internet address to be started.
<p>The internet address must be of the form <b>ddd.ddd.ddd.ddd</b> where <b>ddd</b> is a decimal number ranging from 0 to 255 and should not contain leading zeroes.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CFGDEVMLB.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Configuring a RS232-attached Media Library Device</b>
</p>
<p>
<pre>
CFGDEVMLB MLB(TAPLIB01) ADPTTYPE(*RS232) RSRCNAME(CMN01)
</pre>
</p>
<p>This command will create the necessary RS-232 communication line, controller, and device and change the necessary parameters in the media library device description. It will also attempt to vary on the media library device. The command does this in the following order:
</p>
<ul>
<li>Create Line Description (Async) - CRTLINASC CMN01 with a resource name of CMN01.
</li>
<li>Create Controller Description (Async) - CRTCTLASC CMN01.
</li>
<li>Create Device Description (Async) - CRTDEVASC CMN01.
</li>
<li>Change Device Description - CHGDEVMLB TAPLIB01 to change the parameter robot device to ROBOTDEV(CMN01) and to change the parameter online at IPL to ONLINE(*YES).
</li>
<li>Vary Configuration - VRYCFG TAPLIB01 to vary on the media library device.
</li>
</ul>
<p>If any of these commands is not successful, the CFGDEVMLB command will not be successful. Note that multiple media library device descriptions could have the same communication line. In this case, the line description, controller, and device will not be recreated, but the CHGDEVMLB and VRYCFG commands will still be used.
</p>
<p><b>Example 2: Configuring a LAN-attached Media Library Device</b>
</p>
<p>
<pre>
CFGDEVMLB DEV(TAPLIB02) ADPTTYPE(*LAN) LIND(TRNLINE)
RMTLOCNAME(APPN.MLD01) ADPTADR(0123456789AB)
</pre>
</p>
<p>This command will create the necessary LAN communication controller and device and change the necessary parameters in the media library device description. It will also attempt to vary on the media library device. Note that the line description must exist prior to using the CFGDEVMLB command. The command does this in the following order:
</p>
<ul>
<li>Create Controller Description (APPC) - CRTCTLAPPC MLD01 with ONLINE(*YES).
</li>
<li>Create Device Description (APPC) - CRTDEVAPPC MLD01.
</li>
<li>Vary Configuration - VRYCFG MLD01 to vary on MLD01 APPC controller that was created.
</li>
<li>Change Device Description - CHGDEVMLB TAPLIB02 to change the parameter robot device to ROBOTDEV(MLD01) and to change the parameter online at IPL to ONLINE(*YES).
</li>
<li>Vary Configuration -VRYCFG TAPLIB02 to vary on the media library device.
</li>
</ul>
<p>If any of these commands is not successful, the CFGDEVMLB command will not be successful. Note that multiple media library device descriptions could have the same communication line. In this case, the controller description, and device will not be recreated, but the CHGDEVMLB and VRYCFG commands will still be used.
</p>
<p><b>Example 3: Configuring a LAN-attached Media Library Device with Two Remote Locations</b>
</p>
<p>
<pre>
CFGDEVMLB DEV(TAPLIB02) ADPTTYPE(*LAN) PROTOCOL(*APPC)
LIND(TRNLINE)
RMTLOCNAME(APPN.MLD01A APPN.MLD01B)
ADPTADR(0123456789AB 0123456789CD)
</pre>
</p>
<p>This command will create the necessary LAN communication controllers and devices and change the necessary parameters in the media library device description. It will also attempt to vary on the media library device. Note that the line description must exist prior to using the CFGDEVMLB command. The command does this in the following order:
</p>
<ul>
<li>Create Controller Description (APPC) - CRTCTLAPPC MLD01A with ONLINE(*YES).
</li>
<li>Create Device Description (APPC) - CRTDEVAPPC MLD01A.
</li>
<li>Vary Configuration -VRYCFG MLD01A to vary on MLD01A APPC controller that was created.
</li>
<li>Create Controller Description (APPC) - CRTCTLAPPC MLD01B with ONLINE(*YES).
</li>
<li>Create Device Description (APPC) - CRTDEVAPPC MLD01B.
</li>
<li>Vary Configuration -VRYCFG MLD01B to vary on MLD01B APPC controller that was created.
</li>
<li>Change Device Description - CHGDEVMLB TAPLIB02 to change the parameter robot device to ROBOTDEV(MLD01A MLD01B) and to change the parameter online at IPL to ONLINE(*YES).
</li>
<li>Vary Configuration -VRYCFG TAPLIB02 to vary on the media library device.
</li>
</ul>
<p>If any of these commands is not successful, the CFGDEVMLB command will not be successful. Note that multiple media library device descriptions could have the same communication line. In this case, the controller description, and device will not be recreated, but the CHGDEVMLB and VRYCFG commands will still be used.
</p>
<p><b>Example 4: Configuring a LAN-attached Media Library Device to Communicate Using TCP/IP</b>
</p>
<p>
<pre>
CFGDEVMLB DEV(TAPLIB02) ADPTTYPE(*LAN) PROTOCOL(*TCP)
ROBOTHOST(MLD01A) LCLINTNETA(10.1.2.3)
</pre>
</p>
<p>This command will change the robot information in the device description to the TCP/IP information provided. It will also attempt to vary on the media library device. Note that TCP/IP should be configured prior to using the CFGDEVMLB command. The command does this in the following order:
</p>
<ul>
<li>Change Device Description - CHGDEVMLB TAPLIB02 to change the parameter robot host to ROBOTHOST(MLD01A) and the internet address to LCLINTNETA(10.1.2.3).
</li>
<li>Vary Configuration - VRYCFG TAPLIB02 to vary on the media library device.
</li>
</ul>
<p>If any of these commands is not successful, the CFGDEVMLB command will not be successful.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CFGDEVMLB.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF222E</b></dt>
<dd>&amp;1 special authority is required.
</dd>
<dt><b>CPF6708</b></dt>
<dd>Command ended due to error.
</dd>
<dt><b>CPF672B</b></dt>
<dd>Resource &amp;1 not valid.
</dd>
<dt><b>CPF672C</b></dt>
<dd>Device &amp;1 not allowed.
</dd>
<dt><b>CPF672D</b></dt>
<dd>Network ID &amp;1 not in correct format.
</dd>
<dt><b>CPF672E</b></dt>
<dd>Line description &amp;2 wrong type.
</dd>
<dt><b>CPF672F</b></dt>
<dd>Resource &amp;1 not found.
</dd>
<dt><b>CPF6745</b></dt>
<dd>Device &amp;1 not a media library device.
</dd>
<dt><b>CPF67E5</b></dt>
<dd>Local area network information not valid.
</dd>
<dt><b>CPF9814</b></dt>
<dd>Device &amp;1 not found.
</dd>
<dt><b>CPF9825</b></dt>
<dd>Not authorized to device &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CFGDEVMLB.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>