400 lines
16 KiB
HTML
400 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>Add CICS PCT Entry (ADDCICSPCT)</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="ADDCICSPCT.Top_Of_Page"></a>
|
|
<h2>Add CICS PCT Entry (ADDCICSPCT)</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="#ADDCICSPCT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDCICSPCT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDCICSPCT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDCICSPCT"></a>
|
|
<p>Use the Add CICS Program Control Table (ADDCICSPCT) command to add an entry to 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDCICSPCT.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="#ADDCICSPCT.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="#ADDCICSPCT.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="#ADDCICSPCT.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="#ADDCICSPCT.SYSID"><b>SYSID</b></a></td>
|
|
<td valign="top">Remote CICS system</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.RMTTRANSID"><b>RMTTRANSID</b></a></td>
|
|
<td valign="top">Remote transaction</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*TRANSID</u></b></td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.PGMID"><b>PGMID</b></a></td>
|
|
<td valign="top">CICS program</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.TRANSTS"><b>TRANSTS</b></a></td>
|
|
<td valign="top">Status</td>
|
|
<td valign="top"><b><u>*ENABLED</u></b>, *DISABLED</td>
|
|
<td valign="top">Optional, Positional 7</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.PURGE"><b>PURGE</b></a></td>
|
|
<td valign="top">Can be purged while executing</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional, Positional 8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.WAITTIME"><b>WAITTIME</b></a></td>
|
|
<td valign="top">Maximum deadlock wait time</td>
|
|
<td valign="top">0-7000, <b><u>0</u></b></td>
|
|
<td valign="top">Optional, Positional 9</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.IDLETIME"><b>IDLETIME</b></a></td>
|
|
<td valign="top">Maximum device I/O wait time</td>
|
|
<td valign="top">0-7000, <b><u>0</u></b></td>
|
|
<td valign="top">Optional, Positional 10</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.DUMP"><b>DUMP</b></a></td>
|
|
<td valign="top">Dump when Abend</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional, Positional 11</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.TWASIZE"><b>TWASIZE</b></a></td>
|
|
<td valign="top">Transaction work area size</td>
|
|
<td valign="top">0-32767, <b><u>0</u></b></td>
|
|
<td valign="top">Optional, Positional 12</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.SCRNSZE"><b>SCRNSZE</b></a></td>
|
|
<td valign="top">Screen size used</td>
|
|
<td valign="top"><b><u>*DFT</u></b>, *ALT</td>
|
|
<td valign="top">Optional, Positional 13</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.LCLQUEUE"><b>LCLQUEUE</b></a></td>
|
|
<td valign="top">Local system queuing</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional, Positional 14</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSPCT.UCTRN"><b>UCTRN</b></a></td>
|
|
<td valign="top">Auto upper case translation</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional, Positional 15</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDCICSPCT.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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Enter the name of the group to which this PCT entry is to be added.
|
|
</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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.TRANSID"></a>
|
|
<h3>Transaction (TRANSID)</h3>
|
|
<p>Enter the transaction identifier used to start a program defined in the processing program table. This name is also used to identify this PCT entry.
|
|
</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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.SYSID"></a>
|
|
<h3>Remote CICS system (SYSID)</h3>
|
|
<p>For a remote transaction, enter the identifier of the system owning the transaction. The system should have a TCS entry.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*NONE: 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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 a local system, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*TRANSID: The local and remote transaction identifiers are the same. The contents of the transaction identifier field in this PCT entry 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.PGMID"></a>
|
|
<h3>CICS program (PGMID)</h3>
|
|
<p>Enter the identifier of the program to be started when the transaction is used. The program should be defined in the PPT. This field is only valid for local transactions, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<ul>
|
|
<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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.TRANSTS"></a>
|
|
<h3>Status (TRANSTS)</h3>
|
|
<p>Indicates whether or not the transaction can be used.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*ENABLED: The transaction can be used.
|
|
</li>
|
|
<li><b>*DISABLED:</b> The transaction cannot be used.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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>*YES: 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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>0: The transaction can be in a dead lock state for an unlimited amount of time.
|
|
</li>
|
|
<li><b>dead-lock-timeout:</b> Enter a number in the range 0 7000 (70 minutes).
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.IDLETIME"></a>
|
|
<h3>Maximum device I/O wait time (IDLETIME)</h3>
|
|
<p>Enter the amount of time in seconds that the transaction may wait for terminal input or output. The format is <b>mmss</b>.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>0: The transaction may wait for unlimited amount of time for terminal input or output.
|
|
</li>
|
|
<li><b>read-timeout:</b> A number in the range 0 through 7000 (70 minutes).
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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>*YES: A transaction dump will be taken on abnormal termination of the transaction.
|
|
</li>
|
|
<li><b>*NO:</b> A transaction dump will not be taken on abnormal termination on the transaction.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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>0: There is no TWA associated with the transaction.
|
|
</li>
|
|
<li><b>twa-size:</b> A number in the range 0 through 32767.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.SCRNSZE"></a>
|
|
<h3>Screen size used (SCRNSZE)</h3>
|
|
<p>Indicates whether the default or the alternate screen size is to be used for the terminal running this transaction.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*DFT: 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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>*YES: 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSPCT.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>*NO: 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="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ADDCICSPCT.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ADDCICSPCT.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSPCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|