227 lines
7.2 KiB
HTML
227 lines
7.2 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>Change Device Desc (ASP) (CHGDEVASP)</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="CHGDEVASP.Top_Of_Page"></a>
|
|
<h2>Change Device Desc (ASP) (CHGDEVASP)</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="#CHGDEVASP.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGDEVASP.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGDEVASP.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGDEVASP"></a>
|
|
<p>The Change Device Description (ASP) (CHGDEVASP) command changes the device description for an auxiliary storage pool (ASP) device.
|
|
</p>
|
|
<p>More information about independent disk pools, see the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGDEVASP.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="#CHGDEVASP.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="#CHGDEVASP.RSRCNAME"><b>RSRCNAME</b></a></td>
|
|
<td valign="top">Resource name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGDEVASP.RDB"><b>RDB</b></a></td>
|
|
<td valign="top">Relational database</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *GEN</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGDEVASP.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Message queue</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *SYSOPR<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="#CHGDEVASP.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGDEVASP.DEVD"></a>
|
|
<h3>Device description (DEVD)</h3>
|
|
<p>Specifies the name of the device description being changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDEVASP.RSRCNAME"></a>
|
|
<h3>Resource name (RSRCNAME)</h3>
|
|
<p>Specifies the resource name that identifies the auxiliary storage pool (ASP) by which a collection of disks is known.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>resource-name</i></b></dt>
|
|
<dd>Specify the name that identifies the ASP by which a collection of disks is known.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDEVASP.RDB"></a>
|
|
<h3>Relational database (RDB)</h3>
|
|
<p>Specifies the relational database (RDB) name to associate with the auxiliary storage pool (ASP) device.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*GEN</b></dt>
|
|
<dd>The RDB name will be generated by the operating system after a successful vary on of the device. If the device is the primary ASP of an ASP group, the RDB name will be the same as the device name. If the ASP device is a secondary ASP, or a user-defined file system (UDFS) ASP, the RDB name will be set to blanks.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>relational-database-name</i></b></dt>
|
|
<dd>Specify the RDB name to associate with the ASP device. The specified RDB name will not be used if the ASP device description is a secondary ASP or UDFS ASP. If the ASP device description is the primary ASP of an ASP group, when the ASP group is varied on, the specified RDB name will become the name by which the relational database is known on this system and other systems which connect to this system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDEVASP.MSGQ"></a>
|
|
<h3>Message queue (MSGQ)</h3>
|
|
<p>Specifies the message queue to which operational messages for this device are sent.
|
|
</p>
|
|
<p>The possible qualified names are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*SYSOPR</b></dt>
|
|
<dd>Messages are sent to the QSYSOPR message queue in QSYS.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
|
<dd>Specify the name of the message queue to which operational messages are sent.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<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>
|
|
</dl>
|
|
<dl>
|
|
<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>
|
|
</dl>
|
|
<dl>
|
|
<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="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGDEVASP.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text (if any) does not change.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<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="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDEVASP.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGDEVASP DEVD(WAREHOUSE) RSRCNAME(WAREHOUSE2)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the device description to an ASP resource that is known as WAREHOUSE2.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGDEVASP.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2618</b></dt>
|
|
<dd>Device description &1 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGDEVASP.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|