420 lines
16 KiB
HTML
420 lines
16 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 CICS PCT Entry (CHGCICSPCT)</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="CHGCICSPCT.Top_Of_Page"></a>
|
|
<h2>Change CICS PCT Entry (CHGCICSPCT)</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="#CHGCICSPCT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCICSPCT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCICSPCT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCICSPCT"></a>
|
|
<p>Use the Change CICS Program Control Table (CHGCICSPCT) command to change an entry in the PCT.
|
|
</p>
|
|
<p>The Program Control Table (PCT) contains a definition for each transaction that may be run from this system. Each local transaction must be linked with a program which is defined in the Program Processing Table (PPT). Each remote transaction should have an associated remote system identifier which is defined in the Terminal Control Table (System Entry) (TCS).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCICSPCT.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="#CHGCICSPCT.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="#CHGCICSPCT.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="#CHGCICSPCT.TRANSID"><b>TRANSID</b></a></td>
|
|
<td valign="top">Transaction</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.SYSID"><b>SYSID</b></a></td>
|
|
<td valign="top">Remote CICS system</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.RMTTRANSID"><b>RMTTRANSID</b></a></td>
|
|
<td valign="top">Remote transaction</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *TRANSID</td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.PGMID"><b>PGMID</b></a></td>
|
|
<td valign="top">CICS program</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.TRANSTS"><b>TRANSTS</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="#CHGCICSPCT.PURGE"><b>PURGE</b></a></td>
|
|
<td valign="top">Can be purged while executing</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional, Positional 8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.WAITTIME"><b>WAITTIME</b></a></td>
|
|
<td valign="top">Maximum deadlock wait time</td>
|
|
<td valign="top">0-7000, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 9</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.IDLETIME"><b>IDLETIME</b></a></td>
|
|
<td valign="top">Maximum device I/O wait time</td>
|
|
<td valign="top">0-7000, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 10</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.DUMP"><b>DUMP</b></a></td>
|
|
<td valign="top">Dump when Abend</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional, Positional 11</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.TWASIZE"><b>TWASIZE</b></a></td>
|
|
<td valign="top">Transaction work area size</td>
|
|
<td valign="top">0-32767, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 12</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.SCRNSZE"><b>SCRNSZE</b></a></td>
|
|
<td valign="top">Screen size used</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *DFT, *ALT</td>
|
|
<td valign="top">Optional, Positional 13</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.LCLQUEUE"><b>LCLQUEUE</b></a></td>
|
|
<td valign="top">Local system queuing</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional, Positional 14</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPCT.UCTRN"><b>UCTRN</b></a></td>
|
|
<td valign="top">Auto upper case translation</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional, Positional 15</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCICSPCT.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="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Enter the name of the group to which the PCT entry to be changed belongs.
|
|
</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="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.TRANSID"></a>
|
|
<h3>Transaction (TRANSID)</h3>
|
|
<p>Enter the transaction identifier of the PCT entry to be changed.
|
|
</p>
|
|
<ul>
|
|
<li><b>transaction-identifier:</b> The transaction identifier may have a maximum length of 4 characters. Any characters on the keyboard can be entered, but lowercase letters and special characters should be enclosed in apostrophes.
|
|
<p>When there is not enough space to enter the apostrophes, then enter an ampersand (&) in the first character position to get an extended field size that allows for the entry of additional characters. Blanks are accepted but, when the entry is defined to a control region, anything after the blank is ignored. For example, 'ab g' will be treated as 'ab' in the control region.
|
|
</p>
|
|
<p>Hexadecimal characters should be enclosed in apostrophes and preceded by an uppercase X, for example X'A1A2A3A4'. Any hexadecimal value will be accepted, but, if the value is not a printable character, the entry will be rejected when it is defined to a control region.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.SYSID"></a>
|
|
<h3>Remote CICS system (SYSID)</h3>
|
|
<p>Enter the name of the remote system that owns the transaction.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*NONE:</b> The transaction is held on the local system.
|
|
</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="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.RMTTRANSID"></a>
|
|
<h3>Remote transaction (RMTTRANSID)</h3>
|
|
<p>Enter the identifier by which the transaction is known on the remote system. This field is not valid for the local system, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*TRANSID:</b> The local and remote transaction identifiers are the same. The name in the transaction identifier field will be used.
|
|
</li>
|
|
<li><b>remote-transaction-identifier:</b> The remote transaction identifier may have a maximum length of 4 characters. Any characters on the keyboard can be entered, but lowercase letters and special characters should be enclosed in apostrophes.
|
|
<p>When there is not enough space to enter the apostrophes, then enter an ampersand (&) in the first character position to get an extended field size that allows for the entry of additional characters. Blanks are accepted but, when the entry is defined to a control region, anything after the blank is ignored. For example, 'ab g' will be treated as 'ab' in the control region.
|
|
</p>
|
|
<p>Hexadecimal characters should be enclosed in apostrophes and preceded by an uppercase X, for example X'A1A2A3A4'. Any hexadecimal value will be accepted, but, if the value is not a printable character, the entry will be rejected when it is defined to a control region.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.PGMID"></a>
|
|
<h3>CICS program (PGMID)</h3>
|
|
<p>Enter that name of the program to be started by this transaction identifier. This program should have a PPT entry. This field is valid only for the local system, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>program-identifier:</b> The program 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="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.TRANSTS"></a>
|
|
<h3>Status (TRANSTS)</h3>
|
|
<p>Indicates whether or not the transaction may be used.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*ENABLED:</b> The transaction may be used.
|
|
</li>
|
|
<li><b>*DISABLED:</b> The transaction may not be used.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.PURGE"></a>
|
|
<h3>Can be purged while executing (PURGE)</h3>
|
|
<p>Indicates whether or not the transaction may be purged.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*YES:</b> The transaction may be purged.
|
|
</li>
|
|
<li><b>*NO:</b> The transaction may not be purged.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.WAITTIME"></a>
|
|
<h3>Maximum deadlock wait time (WAITTIME)</h3>
|
|
<p>Enter the amount of time in seconds that the transaction can be in a dead lock state. The format is <b>mmss</b>
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>dead-lock-timeout:</b> A number in the range 0 through 7000 (70 minutes). When the value specified is a 0, then the transaction identifier can be in a dead lock state for an unlimited amount of time.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.IDLETIME"></a>
|
|
<h3>Maximum device I/O wait time (IDLETIME)</h3>
|
|
<p>Enter the amount of time in seconds that the transaction waits for terminal input or output. The format is <b>mmss</b>.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>read-timeout:</b> A number in the range 0 through 7000 (70 minutes). When the value specified is a 0, then the transaction identifier can wait for unlimited amount of time for terminal input or output.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.DUMP"></a>
|
|
<h3>Dump when Abend (DUMP)</h3>
|
|
<p>Indicates whether or not a transaction dump is taken when the transaction terminates abnormally. This field is valid only for the local system, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*YES:</b> Take a transaction dump.
|
|
</li>
|
|
<li><b>*NO:</b> Do not take a transaction dump.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.TWASIZE"></a>
|
|
<h3>Transaction work area size (TWASIZE)</h3>
|
|
<p>Enter the size of the associated Transaction Work Area (TWA). This field is valid only for the local system, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>twa-size:</b> A number in the range 0 through 32767. Enter 0 if there is no TWA associated with the transaction.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.SCRNSZE"></a>
|
|
<h3>Screen size used (SCRNSZE)</h3>
|
|
<p>Indicates whether the default or the alternate screen size associated with the terminal to be used to run the transaction.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*DFT:</b> The default screen size is to be used.
|
|
</li>
|
|
<li><b>*ALT:</b> The alternate screen size is to be used.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.LCLQUEUE"></a>
|
|
<h3>Local system queuing (LCLQUEUE)</h3>
|
|
<p>Indicates whether or not queuing on the local system is to be performed.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PCT entry.
|
|
</li>
|
|
<li><b>*YES:</b> Local system queuing is to be performed.
|
|
</li>
|
|
<li><b>*NO:</b> Local system queuing is not to be performed.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPCT.UCTRN"></a>
|
|
<h3>Auto upper case translation (UCTRN)</h3>
|
|
<p>Indicates whether the terminal input to this transaction is to be translated to uppercase at any terminal on which this transaction is run.
|
|
</p>
|
|
<p>Possible UCTRN values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Specifies that the value currently specified in the Program Control Table is to apply.
|
|
</li>
|
|
<li><b>*NO:</b> Specifies that terminal input uppercase translation is dependent upon the UCTRN setting in effect in the Terminal Control Table for each individual terminal.
|
|
</li>
|
|
<li><b>*YES:</b> Specifies that data entered in lowercase from any terminal is to be translated to uppercase before being passed to this transaction.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGCICSPCT.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGCICSPCT.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|