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

239 lines
7.5 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 (SNPT) (CHGDEVSNPT)</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="CHGDEVSNPT.Top_Of_Page"></a>
<h2>Change Device Desc (SNPT) (CHGDEVSNPT)</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="#CHGDEVSNPT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGDEVSNPT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGDEVSNPT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGDEVSNPT"></a>
<p>The Change Device Description (SNA Pass-Through) (CHGDEVSNPT) command changes a device description for an SNA pass-through device.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDEVSNPT.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="#CHGDEVSNPT.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="#CHGDEVSNPT.LOCADR"><b>LOCADR</b></a></td>
<td valign="top">Local location address</td>
<td valign="top">00-FE, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDEVSNPT.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDEVSNPT.ACTTMR"><b>ACTTMR</b></a></td>
<td valign="top">Activation timer</td>
<td valign="top">1-2550, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDEVSNPT.SNPTDEV"><b>SNPTDEV</b></a></td>
<td valign="top">SNA pass-through device desc</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDEVSNPT.SNPTGRP"><b>SNPTGRP</b></a></td>
<td valign="top">SNA pass-through group name</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGDEVSNPT.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="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGDEVSNPT.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="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDEVSNPT.LOCADR"></a>
<h3>Local location address (LOCADR)</h3>
<p>Specifies the local location address for this device.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>location-address</i></b></dt>
<dd>Specify the location address.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDEVSNPT.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</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="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDEVSNPT.ACTTMR"></a>
<h3>Activation timer (ACTTMR)</h3>
<p>Specifies, for switched connections, the amount of time (in seconds) that the SNA pass-through support waits for the device to respond to the activation request from the host iSeries system. If the device does not respond within this time, it is considered not available.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>activation-timer</i></b></dt>
<dd>Specify a number ranging from 1 through 2550 indicating the number of seconds before the device is considered not available.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDEVSNPT.SNPTDEV"></a>
<h3>SNA pass-through device desc (SNPTDEV)</h3>
<p>Specifies the name of the associated SNA pass-through device that is attached to a host or advanced program-to-program communications (APPC) controller.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No name is specified.
</dd>
<dt><b><i>associated-device-name</i></b></dt>
<dd>Specify the name of a device that is attached to a host or an APPC controller that is associated with this device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDEVSNPT.SNPTGRP"></a>
<h3>SNA pass-through group name (SNPTGRP)</h3>
<p>Specifies the name configured for a group of host devices in a configuration list. This indicates that this device is tied to any one of the devices in that group which is available.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No name is specified.
</dd>
<dt><b><i>group-name</i></b></dt>
<dd>Specify the name configured for a group of host devices that must be associated with this device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDEVSNPT.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="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDEVSNPT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGDEVSNPT DEVD(SNPTDEV1) LOCADR(05) SNPTDEV(DOWNDEV1)
</pre>
</p>
<p>This command changes an SNA pass-through device description named SNPTDEV1. The location address of the device is X'05'. The SNA pass-through device name associated with this device is DOWNDEV1.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDEVSNPT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2618</b></dt>
<dd>Device description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDEVSNPT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>