379 lines
15 KiB
HTML
379 lines
15 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 PPT Entry (CHGCICSPPT)</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="CHGCICSPPT.Top_Of_Page"></a>
|
|
<h2>Change CICS PPT Entry (CHGCICSPPT)</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="#CHGCICSPPT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCICSPPT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCICSPPT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCICSPPT"></a>
|
|
<p>Use the Change CICS Processing Program Table (CHGCICSPPT) command to change an entry in the PPT.
|
|
</p>
|
|
<p>The Processing Program Table (PPT) defines the programs that may be invoked by the transaction identifiers held in the PCT. A PPT entry may define:
|
|
</p>
|
|
<ul>
|
|
<li>A program invoked by a local transaction id. The program may be local or remote.
|
|
</li>
|
|
<li>A program that is invoked by either the EXEC CICS LINK or the EXEC CICS XCTL commands.
|
|
</li>
|
|
<li>A BMS map set and user spaces used on the local system.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCICSPPT.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="#CHGCICSPPT.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="#CHGCICSPPT.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="#CHGCICSPPT.PGMID"><b>PGMID</b></a></td>
|
|
<td valign="top">CICS program</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.CICSMAP"><b>CICSMAP</b></a></td>
|
|
<td valign="top">BMS map set</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.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 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.RMTPGMID"><b>RMTPGMID</b></a></td>
|
|
<td valign="top">Remote CICS program</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *PGMID</td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGCICSPPT.PGMOBJ"><b>PGMOBJ</b></a></td>
|
|
<td valign="top">Program object</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 7</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Program object</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.CICSDEBUG"><b>CICSDEBUG</b></a></td>
|
|
<td valign="top">CICS debug</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *DEBUG, *NODEBUG</td>
|
|
<td valign="top">Optional, Positional 10</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.APISET"><b>APISET</b></a></td>
|
|
<td valign="top">API commands</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *FULLAPI, *DPLSUBSET</td>
|
|
<td valign="top">Optional, Positional 11</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.TRANSID"><b>TRANSID</b></a></td>
|
|
<td valign="top">Transaction</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional, Positional 12</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.PGMSTS"><b>PGMSTS</b></a></td>
|
|
<td valign="top">Status</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *ENABLED, *DISABLED</td>
|
|
<td valign="top">Optional, Positional 8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSPPT.PGMLNG"><b>PGMLNG</b></a></td>
|
|
<td valign="top">Calling convention</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *COBOL, *C</td>
|
|
<td valign="top">Optional, Positional 9</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCICSPPT.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="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Enter the name of the group containing the PPT 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="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.PGMID"></a>
|
|
<h3>CICS program (PGMID)</h3>
|
|
<p>Enter the program identifier used to initiate an iSeries program object. This field is also used to identify this PPT entry.
|
|
</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="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.CICSMAP"></a>
|
|
<h3>BMS map set (CICSMAP)</h3>
|
|
<p>Indicates if the program identified in the PGMID field is a BMS map set or a user space.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*NO:</b> The program identifier is not a BMS map set or user space, it is an application program.
|
|
</li>
|
|
<li><b>*YES:</b> The program identifier is a BMS map set or a user space.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.SYSID"></a>
|
|
<h3>Remote CICS system (SYSID)</h3>
|
|
<p>Enter the identifier of the remote system owning the program. This field is valid only for PPT entries defining application programs, that is when the CICSMAP field contains *NO. 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 PPT entry.
|
|
</li>
|
|
<li><b>*NONE:</b> The program 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="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.RMTPGMID"></a>
|
|
<h3>Remote CICS program (RMTPGMID)</h3>
|
|
<p>Enter the identifier by which the program 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 PPT entry.
|
|
</li>
|
|
<li><b>*PGMID:</b> The local and remote program identifiers are the same. The local identifier will be used to access the program.
|
|
</li>
|
|
<li><b>remote-pgm-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="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.PGMOBJ"></a>
|
|
<h3>Program object (PGMOBJ)</h3>
|
|
<p>Enter the name of the iSeries program object or user space object that will be utilized by the program identifier. This field is valid only for the local system, that is when the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible library values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*LIBL:</b> The library list for the job that is associated to the CICS control region is used to locate the iSeries program object or user space object.
|
|
</li>
|
|
<li><b>*CURLIB:</b> The current library for the job that is associated to the CICS control region is used to locate the iSeries program object or user space object. If no library is specified as the current library, the QGPL library is used.
|
|
</li>
|
|
<li><b>library-name:</b> Specify the name of the library where the iSeries program object or user space object is located.
|
|
</li>
|
|
</ul>
|
|
<p>Possible object values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>object-name:</b> Specify the name of the iSeries program object or user space object.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.CICSDEBUG"></a>
|
|
<h3>CICS debug (CICSDEBUG)</h3>
|
|
<p>Indicates whether or not the CICS-supplied transaction CEDF can be used when running an iSeries program object. This field is valid only when the CICSMAP field is referencing an application program held on the local system, that is when the CICSMAP field contains *NO and the system identifier field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*DEBUG:</b> CEDF can be used with the iSeries program object.
|
|
</li>
|
|
<li><b>*NODEBUG:</b> CEDF cannot be used with the iSeries program object.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.APISET"></a>
|
|
<h3>API commands (APISET)</h3>
|
|
<p>Indicates which of the EXEC CICS commands can be executed in an application program. This field is valid only when the CICSMAP field references an application program held on the local system, that is when the CICSMAP field contains *NO and the system identifier field contains *NONE.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the program identifier starts with AEG, then this field must contain *FULLAPI.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*FULLAPI:</b> All the EXEC CICS commands can be used in application programs.
|
|
</li>
|
|
<li><b>*DPLSUBSET:</b> Only the EXEC CICS commands specified in the distribute programming link subset can be used in application programs.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.TRANSID"></a>
|
|
<h3>Transaction (TRANSID)</h3>
|
|
<p>Enter the overriding transaction identifier under which the server program runs during a distributed program link. This transaction identifier should have its own PPT entry. This parameter 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: Enter the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*NONE:</b> There is no overriding transaction identifier to be used.
|
|
</li>
|
|
<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="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.PGMSTS"></a>
|
|
<h3>Status (PGMSTS)</h3>
|
|
<p>Indicates whether or not the program identifier can be used.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*ENABLED:</b> The program identifier can be used.
|
|
</li>
|
|
<li><b>*DISABLED:</b> The program identifier cannot be used.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSPPT.PGMLNG"></a>
|
|
<h3>Calling convention (PGMLNG)</h3>
|
|
<p>Enter the program language convention used to call the OS/400 program object. This determines how CICS passes parameters to the program object.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the PPT entry.
|
|
</li>
|
|
<li><b>*COBOL:</b> CICS uses the CICS COBOL calling convention to invoke the OS/400 program object
|
|
</li>
|
|
<li><b>*C:</b> CICS uses the CICS C calling convention to invoke the OS/400 program object
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGCICSPPT.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGCICSPPT.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSPPT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|