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

202 lines
8.3 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>Display CICS CVT (DSPCICSCVT)</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="DSPCICSCVT.Top_Of_Page"></a>
<h2>Display CICS CVT (DSPCICSCVT)</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="#DSPCICSCVT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPCICSCVT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPCICSCVT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPCICSCVT"></a>
<p>Use the Display CICS Conversion Vector Table (DSPCICSCVT) command to display a CVT entry. You can only view this entry; you can neither makes changes to it nor delete it.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCICSCVT.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="#DSPCICSCVT.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="#DSPCICSCVT.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="#DSPCICSCVT.CMDTYPE"><b>CMDTYPE</b></a></td>
<td valign="top">API command type</td>
<td valign="top"><b><u>*FIRST</u></b>, *ALL, *FILE, *TDQUEUE, *TSQUEUE, *START, *LINK</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCICSCVT.RSRCID"><b>RSRCID</b></a></td>
<td valign="top">Resource identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*FIRST</u></b>, *ALL</td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCICSCVT.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 5</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPCICSCVT.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="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSCVT.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Enter the name of the group containing the CVT entry to be displayed.
</p>
<p>Possible values are:
</p>
<ul>
<li>*FIRST: No group is specified. The first 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="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSCVT.CMDTYPE"></a>
<h3>API command type (CMDTYPE)</h3>
<p>Enter a command type. This field will be used with the resource identifier field to locate the required CVT entries.
</p>
<p>Possible values are:
</p>
<ul>
<li>*FIRST: Display the first CVT entry that matches the resource definition field value.
</li>
<li><b>*ALL:</b> Display all CVT entries that match the resource definition field value.
</li>
<li><b>*FILE:</b> Display all *FILE entries that match the resource definition field value.
</li>
<li><b>*TDQUEUE:</b> Display all *TDQUEUE entries that match the resource definition field value.
</li>
<li><b>*TSQUEUE:</b> Display all *TSQUEUE entries that match the resource definition field value.
</li>
<li><b>*START:</b> Display all *START entries that match the resource definition field value.
</li>
<li><b>*LINK:</b> Display all *LINK entries that match the resource definition field value.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSCVT.RSRCID"></a>
<h3>Resource identifier (RSRCID)</h3>
<p>Enter a resource identifier. This field will be used with the command type field to locate the required CVT entries.
</p>
<p>Possible values are:
</p>
<ul>
<li>*FIRST: Display the first CVT entry that matches the command type field value.
</li>
<li><b>*ALL:</b> Display all CVT entries that match the command type field value.
</li>
<li><b>resource-identifier: </b>For a command type of *TDQUEUE or *START, the maximum length of the resource identifier is 4 characters. For a command type of *FILE, *TSQUEUE, or *LINK, the maximum length of the resource identifier is 8 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*-rsrcid:</b> Specify the generic name of a resource 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 CVT entries with a resource identifier beginning with the generic name, and matching the command type field value, are shown. If an asterisk is not included with the generic name, the system assumes it to be the complete resource identifier.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCICSCVT.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="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCICSCVT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCICSCVT.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>