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

392 lines
15 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>Change CICS TCS Entry (CHGCICSTCS)</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="CHGCICSTCS.Top_Of_Page"></a>
<h2>Change CICS TCS Entry (CHGCICSTCS)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>
<ul><li>Batch job (*BATCH)</li>
<li>Interactive job (*INTERACT)</li>
<li>Batch program (*BPGM)</li>
<li>Interactive program (*IPGM)</li>
<li>Batch REXX procedure (*BREXX)</li>
<li>Interactive REXX procedure (*IREXX)</li>
<li>Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)</li>
</ul><b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CHGCICSTCS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCICSTCS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCICSTCS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCICSTCS"></a>
<p>Use the Change CICS Terminal Control System Table (CHGCICSTCS) command to change an entry in the TCS.
</p>
<p>Each TCS entry defines the characteristics of a remote CICS system and details of connections between the local and remote systems. An entry in this table:
</p>
<ul>
<li>Defines the link to a remote system. This can be used by local applications for function shipping, distributed program link (DPL), or distributed transaction processing. It can also be used by the system for transaction routing.
</li>
<li>Can be used in the SYSID option of other table entries to identify the system on which a remote resource resides.
</li>
<li>Can be used in the SYSID option of EXEC CICS commands to identify the location of a remote resource.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCICSTCS.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="#CHGCICSTCS.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Communications name</i>, *LIBL, *CURLIB</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Communications name</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.SYSID"><b>SYSID</b></a></td>
<td valign="top">Remote CICS system</td>
<td valign="top"><i>Communications name</i></td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.NETWORK"><b>NETWORK</b></a></td>
<td valign="top">Network</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *SYSID</td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.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, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.CDEPAGE"><b>CDEPAGE</b></a></td>
<td valign="top">Code page</td>
<td valign="top">1-65535, <b><u>*SAME</u></b>, *SYSVAL</td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.SYSSTS"><b>SYSSTS</b></a></td>
<td valign="top">Status</td>
<td valign="top"><b><u>*SAME</u></b>, *ENABLED, *DISABLED</td>
<td valign="top">Optional, Positional 7</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.SNDPFX"><b>SNDPFX</b></a></td>
<td valign="top">Outbound session prefix</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional, Positional 8</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.SNDLMT"><b>SNDLMT</b></a></td>
<td valign="top">Available outbound sessions</td>
<td valign="top">0-999, <b><u>*SAME</u></b></td>
<td valign="top">Optional, Positional 9</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.RCVPFX"><b>RCVPFX</b></a></td>
<td valign="top">Inbound session prefix</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional, Positional 10</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.RCVLMT"><b>RCVLMT</b></a></td>
<td valign="top">Available inbound sessions</td>
<td valign="top">0-999, <b><u>*SAME</u></b></td>
<td valign="top">Optional, Positional 11</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.INDSYS"><b>INDSYS</b></a></td>
<td valign="top">Indirect CICS system</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional, Positional 12</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSTCS.RMTNETID"><b>RMTNETID</b></a></td>
<td valign="top">Remote network indicator</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NETATR, *LOC, *NONE</td>
<td valign="top">Optional, Positional 13</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCICSTCS.LIB"></a>
<h3>Library (LIB)</h3>
<p>Enter the name of the OS/400 library that contains the group. Possible values are:
</p>
<ul>
<li><b>*LIBL:</b> The library list is used to locate the first OS/400 library that contains the group.
</li>
<li><b>*CURLIB:</b> The current library contains the group. If no current library is specified, the QGPL library is used.
</li>
<li><b>library-name:</b> The name of the OS/400 library that contains the group.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>The name of the group that contains the TCS entry to be changed.
</p>
<ul>
<li><b>group-name:</b> The group name may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.SYSID"></a>
<h3>Remote CICS system (SYSID)</h3>
<p>The system identifier used to identify the remote CICS system that can communicate with the CICS control region. This is the name of the TCS entry.
</p>
<ul>
<li><b>system-identifier:</b> The system identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.NETWORK"></a>
<h3>Network (NETWORK)</h3>
<p>The network name used to identify the other CICS system. This has to be the same as the APPLID specified in the CICS System Initialization Table used to start up the CICS system.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>*SYSID:</b> The CICS system identifier suffixed with four blanks will be used as the network name.
</li>
<li><b>network:</b> The network may have a maximum length of 8 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.MODE"></a>
<h3>Mode (MODE)</h3>
<p>The name that is passed as the mode name.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>*NETATR:</b> The default mode name as specified in the OS/400 network attributes will be used.
</li>
<li><b>mode-name:</b> The maximum length is eight characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.CDEPAGE"></a>
<h3>Code page (CDEPAGE)</h3>
<p>Code page to be used for conversion of data.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>*SYSVAL:</b> Use the iSeries system code page.
</li>
<li><b>code-page:</b> Must be numeric, greater than or equal to 1 and less than or equal to 65535.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.SYSSTS"></a>
<h3>Status (SYSSTS)</h3>
<p>Indicates if the CICS system identifier can be used by a CICS user in the CICS control region, when the CICS Terminal Control System Table entry is defined to the CICS runtime resource table definition Connection Control facility.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>*ENABLED:</b> CICS system identifier can be used by a CICS user.
</li>
<li><b>*DISABLED:</b> CICS system identifier can not be used by a CICS user.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.SNDPFX"></a>
<h3>Outbound session prefix (SNDPFX)</h3>
<p>The prefix to be used as the first part of a conversation identifier for outbound sessions (line connections) to establish unique session names.
</p>
<p>
<b>Note: </b>When the SNDPFX has the same value as the value in RCVPFX, then the SNDLMT will be set to 1 and the RCVLMT will be set to 0.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>*NONE:</b> There are no outbound sessions.
</li>
<li><b>outbound-session-prefix:</b> The maximum length is two characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.SNDLMT"></a>
<h3>Available outbound sessions (SNDLMT)</h3>
<p>The number of outbound sessions (line connections) available to the connected CICS system, that can be active at any one time.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>available-outbound-sessions:</b> Must be numeric, greater than or equal to 0 and less than or equal to 999.
<p>
<b>Note: </b>When SNDPFX is 1 character, the value should not be greater than 999; otherwise the value should not be greater than 99.
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.RCVPFX"></a>
<h3>Inbound session prefix (RCVPFX)</h3>
<p>The prefix to be used as the first part of a conversation identifier for inbound sessions (line connections) to establish unique session names.
</p>
<p>
<b>Note: </b>When the SNDPFX has the same value as the value in RCVPFX, then the SNDLMT will be set to 1 and the RCVLMT will be set to 0.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified in the TCS table entry.
</li>
<li><b>*NONE:</b> There are no inbound sessions.
</li>
<li><b>inbound-session-prefix:</b> The maximum length is two characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.RCVLMT"></a>
<h3>Available inbound sessions (RCVLMT)</h3>
<p>The number of inbound sessions (line connections) available to the connected CICS system, that can be active at any one time.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>available-inbound-sessions:</b> Must be numeric, greater than or equal to 1 and less than or equal to 999.
<p>
<b>Note: </b>When RCVPFX is 1 character, the value should be less than or equal to 999; otherwise the value should be less than or equal to 99.
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.INDSYS"></a>
<h3>Indirect CICS system (INDSYS)</h3>
<p>Indicates whether this CICS system utilizes another CICS system to relay communication with the CICS control region.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: The value currently specified in the TCS table entry will remain the same.
</li>
<li><b>*NONE:</b> The CICS system can directly communicate with the CICS control region.
</li>
<li><b>system-identifier:</b> The system identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSTCS.RMTNETID"></a>
<h3>Remote network indicator (RMTNETID)</h3>
<p>Enter the remote network identifier to be used with the other CICS system.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified for this entry.
</li>
<li><b>*NETATR:</b> The remote network identifier specified in the network attributes is used.
</li>
<li><b>*LOC:</b> Any remote network identifier for the other CICS system may be used. If several remote network identifiers are associated with the other CICS system, the system automatically selects the remote network identifier.
</li>
<li><b>*NONE:</b> No remote network identifier is used.
</li>
<li><b>remote-network-id:</b> The remote network identifier may have a maximum length of 8 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCICSTCS.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCICSTCS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSTCS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>