334 lines
11 KiB
HTML
334 lines
11 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 Comm Side Information (CHGCSI)</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="CHGCSI.Top_Of_Page"></a>
|
|
<h2>Change Comm Side Information (CHGCSI)</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="#CHGCSI.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCSI.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCSI.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCSI"></a>
|
|
<p>The Change Communications Side Information (CHGCSI) command is used to change a side information object in a specific library.
|
|
</p>
|
|
<p>Refer to the APPC Programming book, SC41-5443, for information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCSI.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" rowspan="3"><a href="#CHGCSI.CSI"><b>CSI</b></a></td>
|
|
<td valign="top">Side information</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Side information</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="#CHGCSI.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
|
<td valign="top">Remote location</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCSI.TNSPGM"><b>TNSPGM</b></a></td>
|
|
<td valign="top">Transaction program</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCSI.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>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCSI.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *LOC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCSI.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
|
<td valign="top">Local location</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *LOC, *NETATR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCSI.MODE"><b>MODE</b></a></td>
|
|
<td valign="top">Mode</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NETATR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCSI.RMTNETID"><b>RMTNETID</b></a></td>
|
|
<td valign="top">Remote network identifier</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *LOC, *NETATR, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCSI.CSI"></a>
|
|
<h3>Side information (CSI)</h3>
|
|
<p>Specifies the name of the side information object to be changed. An object name must be specified.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library is used to locate the side information object. If no library is specified as the current library, the QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the side information object is located.
|
|
</dd>
|
|
<dt><b><i>side-information-name</i></b></dt>
|
|
<dd>Specify the name of the object that will contain the desired side information object. The side information object is accessed by the symbolic destination name (sym_dest_name) parameter on the Initialize_Conversation (CMINIT) call.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.RMTLOCNAME"></a>
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
|
<p>Specifies the remote location name with which your program communicates. The Common Programming Interface (CPI)- Communications partner_LU_name, which consists of the remote network identifier and the remote location, determines the remote logical unit of the remote program.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The remote location name does not change.
|
|
</dd>
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
|
<dd>Specify the name of the remote location that is associated with the symbolic destination name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.TNSPGM"></a>
|
|
<h3>Transaction program (TNSPGM)</h3>
|
|
<p>Specifies the name of the transaction program on the remote system to be started.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The transaction program name does not change.
|
|
</dd>
|
|
<dt><b><i>transaction-program-name</i></b></dt>
|
|
<dd>Specify up to 64 characters for the transaction program name.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>If the specified transaction program name contains characters that are not in the character set 00640, the hexadecimal representation of the transaction program name are displayed. For example, a transaction program name whose hexadecimal representation is 21F0F0F1 is displayed as X'21F0F0F1'.
|
|
</p>
|
|
<p>More information on character sets is in the CPI Communications Reference, SC26-4399.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text does not change.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>'description'</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="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device description used for the remote system.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The device name does not change.
|
|
</dd>
|
|
<dt><b>*LOC</b></dt>
|
|
<dd>The device is determined by the system.
|
|
</dd>
|
|
<dt><b><i>device-name</i></b></dt>
|
|
<dd>Specify the name of the device that is associated with the remote location.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.LCLLOCNAME"></a>
|
|
<h3>Local location (LCLLOCNAME)</h3>
|
|
<p>Specifies the local location name.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The local location name does not change.
|
|
</dd>
|
|
<dt><b>*LOC</b></dt>
|
|
<dd>The location name is determined by the system.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The LCLLOCNAME value specified in the system network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>local-location-name</i></b></dt>
|
|
<dd>Specify the name of your location. Specify the local location if you want to indicate a specific location name for the remote location.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.MODE"></a>
|
|
<h3>Mode (MODE)</h3>
|
|
<p>Specifies the mode used to control the session. This name is the same as the Common Programming Interface (CPI)- Communications mode_name.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The mode name does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The mode in the network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>BLANK</b></dt>
|
|
<dd>Eight blank characters are used.
|
|
</dd>
|
|
<dt><b><i>mode-name</i></b></dt>
|
|
<dd>Specify a mode name for the remote location.
|
|
<p>
|
|
<b>Note: </b>SNASVCMG and CPSVCMG are not allowed.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCSI.RMTNETID"></a>
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
|
<p>Specifies the remote network identifier used with the remote location. The Common Programming Interface (CPI)- Communications partner_LU_name, which consists of the remote network identifier and the remote location, determines the remote logical unit of the remote program.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The remote network ID does not change.
|
|
</dd>
|
|
<dt><b>*LOC</b></dt>
|
|
<dd>The remote network ID for the remote location is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The remote network identifier specified in the network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The remote network has no name.
|
|
</dd>
|
|
<dt><b><i>remote-network-id</i></b></dt>
|
|
<dd>Specify a remote network ID.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCSI.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGCSI CSI(QGPL/SIDEOBJ) RMTNETID(*NETATR)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the remote network ID to *NETATR in the communications side information object SIDEOBJ in library QGPL.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGCSI.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF3B8B</b></dt>
|
|
<dd>Communications side information object &1 not changed in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCSI.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|