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

182 lines
7.3 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>Work with CICS CVT (WRKCICSCVT)</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="WRKCICSCVT.Top_Of_Page"></a>
<h2>Work with CICS CVT (WRKCICSCVT)</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="#WRKCICSCVT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#WRKCICSCVT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#WRKCICSCVT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="WRKCICSCVT"></a>
<p>Use the Work with CICS Conversion Vector Table (WRKCICSCVT) command to list entries in the CVT. You can then change, remove, copy, or display entries, or add new ones to the list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKCICSCVT.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="#WRKCICSCVT.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="#WRKCICSCVT.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="#WRKCICSCVT.CMDTYPE"><b>CMDTYPE</b></a></td>
<td valign="top">API command type</td>
<td valign="top">*FIRST, <b><u>*ALL</u></b>, *FILE, *TDQUEUE, *TSQUEUE, *START, *LINK</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#WRKCICSCVT.RSRCID"><b>RSRCID</b></a></td>
<td valign="top">Resource identifier</td>
<td valign="top"><i>Character value</i>, *FIRST, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 4</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="WRKCICSCVT.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="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKCICSCVT.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Enter the name of the group from which the CVT entries are to be listed.
</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="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKCICSCVT.CMDTYPE"></a>
<h3>API command type (CMDTYPE)</h3>
<p>Enter a command type. This field will be used with the resource identifier field to select the entries to be listed.
</p>
<p>Possible values are:
</p>
<ul>
<li>*ALL: List all CVT entries that match the RSRCID field value.
</li>
<li><b>*FIRST:</b> List the first CVT entry that matches the RSRCID field value.
</li>
<li><b>*FILE:</b> List all file command entries.
</li>
<li><b>*TDQUEUE:</b> List all TD queue entries.
</li>
<li><b>*TSQUEUE:</b> List all TS queue entries.
</li>
<li><b>*START:</b> List all start command entries.
</li>
<li><b>*LINK:</b> List all link command entries.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="WRKCICSCVT.RSRCID"></a>
<h3>Resource identifier (RSRCID)</h3>
<p>Enter the resource identifier. This will be used with the command type field value to select the CVT entries to be listed.
</p>
<p>Possible values are:
</p>
<ul>
<li>*ALL: List all CVT entries that match the command type field value.
</li>
<li><b>*FIRST:</b> List the first CVT entry that matches the command type field value.
</li>
<li>
</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="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKCICSCVT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="WRKCICSCVT.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#WRKCICSCVT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>