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

170 lines
6.7 KiB
HTML
Raw Permalink 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>Display CICS PCT (DSPCICSPCT)</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="DSPCICSPCT.Top_Of_Page"></a>
<h2>Display CICS PCT (DSPCICSPCT)</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="#DSPCICSPCT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPCICSPCT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPCICSPCT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPCICSPCT"></a>
<p>Use the Display CICS Program Control Table (DSPCICSPCT) command to display a PCT entry. You can only view this entry; you can neither change it nor delete it.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCICSPCT.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="#DSPCICSPCT.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Communications name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCICSPCT.GROUP"><b>GROUP</b></a></td>
<td valign="top">Group</td>
<td valign="top"><i>Communications name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCICSPCT.TRANSID"><b>TRANSID</b></a></td>
<td valign="top">Transaction</td>
<td valign="top"><i>Character value</i>, <b><u>*FIRST</u></b>, *ALL</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCICSPCT.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Location of Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional, Positional 4</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPCICSPCT.LIB"></a>
<h3>Library (LIB)</h3>
<p>Enter the name of the iSeries library which contains the group.
</p>
<p>Possible values are:
</p>
<ul>
<li>*LIBL: The library list is used to locate the first iSeries library that contains the group.
</li>
<li><b>*CURLIB:</b> The current library contains the group. 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 iSeries library that contains the group.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSPCT.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Enter the name of the group containing the PCT entry to be displayed.
</p>
<p>Possible values are:
</p>
<ul>
<li>*FIRST: No CICS group is specified. The first CICS group found is used.
</li>
<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="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSPCT.TRANSID"></a>
<h3>Transaction (TRANSID)</h3>
<p>Enter the name of the PCT entry to be displayed.
</p>
<p>Possible values are:
</p>
<ul>
<li>*FIRST: Display the first PCT entry.
</li>
<li><b>*ALL:</b> Display all the PCT entries.
</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 (&amp;) 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>
<li><b>generic*-transid:</b> Specify the generic name of the CICS transaction identifier. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all PCT entries with transaction identifiers beginning with the generic name are displayed. If an asterisk is not included with the generic name, the system assumes it to be the complete transaction identifier.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSPCT.OUTPUT"></a>
<h3>Location of Output (OUTPUT)</h3>
<p>Enter the location of the output from this command.
</p>
<p>Possible values are:
</p>
<ul>
<li>*: The output is either displayed (if requested by an interactive job) or printed with the job spool output (if requested by a batch job).
</li>
<li><b>*PRINT:</b> The output is printed with the job spool output.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCICSPCT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCICSPCT.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSPCT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>