144 lines
6.0 KiB
HTML
144 lines
6.0 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>Start CICS User (STRCICSUSR)</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="STRCICSUSR.Top_Of_Page"></a>
|
|
<h2>Start CICS User (STRCICSUSR)</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="#STRCICSUSR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRCICSUSR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRCICSUSR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRCICSUSR"></a>
|
|
<p>The start CICS user (STRCICSUSR) command starts a CICS user shell associated with an active CICS control region for the OS/400 user who initiated this command. The command also specifies whether a CICS transaction is to be initiated when the CICS user shell has been started.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRCICSUSR.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="#STRCICSUSR.CTLRGN"><b>CTLRGN</b></a></td>
|
|
<td valign="top">Control region</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>CICS</u></b></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRCICSUSR.TRANID"><b>TRANID</b></a></td>
|
|
<td valign="top">Transaction ID</td>
|
|
<td valign="top"><i>Communications name</i>, *DATA, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRCICSUSR.DATA"><b>DATA</b></a></td>
|
|
<td valign="top">Initial TIOA data</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRCICSUSR.CTLRGN"></a>
|
|
<h3>Control region (CTLRGN)</h3>
|
|
<p>The name of the CICS control region with which the CICS user shell will be associated. The name of the CICS control region is also known as the CICS system ID.
|
|
</p>
|
|
<ul>
|
|
<li><b>control-region:</b> The length is four characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or $, @, or #.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRCICSUSR.TRANID"></a>
|
|
<h3>Transaction ID (TRANID)</h3>
|
|
<p>The name of the CICS transaction identifier used to initiate a CICS program identifier defined in the CICS program processing table.
|
|
</p>
|
|
<p>The possible TRANID values are:
|
|
</p>
|
|
<ul>
|
|
<li>*NONE: The default CICS screen (which is blank) is displayed, prompting the CICS user to enter the CICS four-character transaction identifier.
|
|
<p>When the CICS transaction is completed, the CICS user shell will stay active, waiting for the next transaction from the user. This process is known as a <u> multi-shot</u> CICS transaction environment.
|
|
</p>
|
|
</li>
|
|
<li>*DATA: Specifies that the first four characters of the DATA parameter are used as the CICS transaction identifier, to be the first transaction. This too is a <u> multi-shot</u> CICS transaction environment, because the shell remains active after the initial transaction is completed.
|
|
</li>
|
|
<li><b>transaction-id:</b> The transaction 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 #. Use of this value means that when this CICS transaction is completed, the CICS user shell returns to the point at which the STRCICSUSR command was entered, and no other transaction is executed. This process is known as a <u> single-shot</u> transaction environment.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRCICSUSR.DATA"></a>
|
|
<h3>Initial TIOA data (DATA)</h3>
|
|
<p>Indicates the data that is to be used to prime the CICS terminal input/output area (TIOA) for the first RECEIVE command.
|
|
</p>
|
|
<p>The possible DATA values are:
|
|
</p>
|
|
<ul>
|
|
<li>*NONE: No data is passed to the CICS transaction.
|
|
</li>
|
|
<li><b>initial-TIOA-data:</b> Can be up to 3000 characters. The following restrictions apply to this value:
|
|
<ul>
|
|
<li>If the first characters equal *CICS, the results will be unpredictable.
|
|
</li>
|
|
<li>If TRANID(*DATA) is specified, the first four characters will be taken as the transaction identifier.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="STRCICSUSR.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="STRCICSUSR.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICSUSR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|