210 lines
8.6 KiB
HTML
210 lines
8.6 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 TST Entry (CHGCICSTST)</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="CHGCICSTST.Top_Of_Page"></a>
|
|
<h2>Change CICS TST Entry (CHGCICSTST)</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="#CHGCICSTST.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGCICSTST.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGCICSTST.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGCICSTST"></a>
|
|
<p>Use the Change CICS Temporary Storage Table (CHGCICSTST) command to change an entry in the TST.
|
|
</p>
|
|
<p>A temporary storage queue is a file used by an application program to store data for later retrieval.
|
|
</p>
|
|
<p>A Temporary Storage Table (TST) entry may define a recoverable or a remote temporary storage queue. TST entries are not required for local, unrecoverable temporary storage queues.
|
|
</p>
|
|
<p>A temporary storage queue is a file used by an application program to store data for later retrieval. A Temporary Storage Table (TST) entry needs to be created for all recoverable and all remote temporary storage queues. You do not need to create TST entries for local, unrecoverable temporary storage queues.
|
|
</p>
|
|
<p>You can create a TST entry with a generic name that can be used as a prefix to the full name that will be supplied by the application programs in EXEC CICS temporary storage commands. A prefix enables you to create one entry to apply to many temporary storage queues. CICS will use the TST entry associated with the prefix. You must take care, therefore, that there is no ambiguity in your TS queue names.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGCICSTST.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="#CHGCICSTST.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="#CHGCICSTST.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="#CHGCICSTST.TSQUEUE"><b>TSQUEUE</b></a></td>
|
|
<td valign="top">Queue</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSTST.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *RECOVERABLE, *REMOTE</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSTST.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></td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGCICSTST.RMTQUEUE"><b>RMTQUEUE</b></a></td>
|
|
<td valign="top">Remote queue name</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *TSQUEUE</td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGCICSTST.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="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSTST.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Enter the name of the group that contains the TST 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="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSTST.TSQUEUE"></a>
|
|
<h3>Queue (TSQUEUE)</h3>
|
|
<p>Enter either the complete name of the queue or a partial, generic name. This is the name that will be used in EXEC CICS temporary storage commands. This name is also used to identify this TST entry.
|
|
</p>
|
|
<ul>
|
|
<li><b>queue-prefix:</b> The queue name 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>
|
|
<p>For a generic name a partial queue name is used, for example ABC.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSTST.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Indicates whether the temporary storage queue is recoverable or remote.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the TST entry.
|
|
</li>
|
|
<li><b>*RECOVERABLE:</b> The temporary storage queue is recoverable.
|
|
</li>
|
|
<li><b>*REMOTE:</b> The temporary storage queue is remote.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSTST.SYSID"></a>
|
|
<h3>Remote CICS system (SYSID)</h3>
|
|
<p>Enter the identifier of the system owning the temporary storage queue. The system should have a TCS entry. This field is valid only for remote queues, that is when the type field contains *REMOTE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the TST entry.
|
|
</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="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGCICSTST.RMTQUEUE"></a>
|
|
<h3>Remote queue name (RMTQUEUE)</h3>
|
|
<p>Enter the name by which the temporary storage queue is known on the remote system. This field is valid only for remote queues, that is when the type field contains *REMOTE.
|
|
</p>
|
|
<p>The possible RMTQUEUE values are:
|
|
</p>
|
|
<ul>
|
|
<li>*SAME: Keep the value currently specified in the TST entry.
|
|
</li>
|
|
<li><b>*TSQUEUE:</b> The local and remote temporary storage queue names are the same. The name in the TSQUEUE field will be used.
|
|
</li>
|
|
<li><b>remote-queue:</b> The temporary storage queue name 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="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGCICSTST.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CHGCICSTST.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGCICSTST.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|