194 lines
8.9 KiB
HTML
194 lines
8.9 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 (STRCICS)</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="STRCICS.Top_Of_Page"></a>
|
|
<h2>Start CICS (STRCICS)</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="#STRCICS.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRCICS.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRCICS.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRCICS"></a>
|
|
<p>The Start CICS (STRCICS) command will start a CICS control region and specifies how to recover CICS Temporary Storage/Transient Data files. In addition, this command indicates what will happen to previous release CICS resource definition tables encountered in this control region. The CICS control region must be completely started prior to executing any associated CICS shells (batch or user). Refer to the STRCICSUSR CL command in order to start a CICS user shell.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRCICS.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="#STRCICS.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="#STRCICS.STRTYPE"><b>STRTYPE</b></a></td>
|
|
<td valign="top">Type of start</td>
|
|
<td valign="top">*COLD, *EMER, <b><u>*WARM</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRCICS.SITLIB"><b>SITLIB</b></a></td>
|
|
<td valign="top">System Initialization Table</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRCICS.SITGRP"><b>SITGRP</b></a></td>
|
|
<td valign="top">System initialization group</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRCICS.CONVERT"><b>CONVERT</b></a></td>
|
|
<td valign="top">Convert</td>
|
|
<td valign="top"><b><u>*PROMPT</u></b>, *CVT, *NOCVT</td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRCICS.CTLRGN"></a>
|
|
<h3>Control region (CTLRGN)</h3>
|
|
<p>The name of the CICS control region to be started. This can be obtained from your CICS System Administrator. The name of the CICS control region is also known as the CICS SYSID.
|
|
</p>
|
|
<p><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 one of the special characters, $, @, or #.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRCICS.STRTYPE"></a>
|
|
<h3>Type of start (STRTYPE)</h3>
|
|
<p>Indicates how to recover the CICS temporary storage and transient data files when the CICS control region is started.
|
|
</p>
|
|
<p>STRTYPE is needed only if you need to do a *COLD or *EMER start.
|
|
</p>
|
|
<p>The possible STRTYPE values are:
|
|
</p>
|
|
<ul>
|
|
<li>*WARM: The recovery of the CICS temporary storage and transient data files is based upon the TSCTL and TDCTL values respectively in the CICS system initialization table.
|
|
<p>When *NO is specified on the TSCTL <b>recover data</b> (element 2) value, the CICS temporary storage queues are cleared. When *NO is specified on the TDCTL <b>recover data</b> (element 2) value, the CICS transient data queues are cleared.
|
|
</p>
|
|
<p>When *YES is specified on the TSCTL <b>recover data</b> (element 2) value, all recoverable and non-recoverable CICS temporary storage queues are recovered. When *YES is specified on the TDCTL <b>recover data</b> (element 2) value, all recoverable and non-recoverable CICS transient data queues are recovered.
|
|
</p>
|
|
</li>
|
|
<li><b>*COLD:</b> The CICS temporary storage and transient data queues are cleared.
|
|
</li>
|
|
<li><b>*EMER:</b> The recovery of the CICS temporary storage queues is based on the TSCTL value in the CICS system initialization table. The recovery of the CICS transient data queues is based on the TDCTL value in the CICS system initialization table.
|
|
<p>When *NO is specified on the TSCTL <b>recover data</b> (element 2) value, the CICS temporary storage queue is cleared. When *NO is specified on the TDCTL <b>recover data</b> (element 2) value, the CICS transient data queue is cleared.
|
|
</p>
|
|
<p>When *YES is specified on the TSCTL <b>recover data</b> (element 2) value, the recoverable CICS temporary storage queues that are recovered is governed by the TSCTL <b>age limit</b> (element 1) value in the CICS system initialization table. When *YES is specified on the TDCTL <b>recover data</b> (element 2) value, all recoverable CICS transient data queues are recovered.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRCICS.SITLIB"></a>
|
|
<h3>System Initialization Table (SITLIB)</h3>
|
|
<p>The name of the iSeries library that contains the CICS System Initialization Table to be used to initialize the CICS control region.
|
|
</p>
|
|
<p>The possible SITLIB values are:
|
|
</p>
|
|
<ul>
|
|
<li>*LIBL: The library list is used to locate the first CICS group that contains the CICS System Initialization Table.
|
|
</li>
|
|
<li><b>*CURLIB:</b> The current library for the job is used as the CICS group that contains the CICS System Initialization Table.
|
|
</li>
|
|
<li><b>library-name:</b>Specify the name of the CICS group that contains the CICS System Initialization Table.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRCICS.SITGRP"></a>
|
|
<h3>System initialization group (SITGRP)</h3>
|
|
<p>The name of the CICS group that contains the CICS System Initialization Table to be used to initialize the CICS control region.
|
|
</p>
|
|
<ul>
|
|
<li>*FIRST: No CICS group is specified. The first CICS group found is used.
|
|
</li>
|
|
<li><b>group-name:</b> The maximum length is ten 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="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRCICS.CONVERT"></a>
|
|
<h3>Convert (CONVERT)</h3>
|
|
<p>Indicates what will happen to any previous release tables that are encountered in the CICS control region. Tables that are older than the previous release will not be converted.
|
|
</p>
|
|
<p>The possible CONVERT values are:
|
|
</p>
|
|
<ul>
|
|
<li>*PROMPT: Tables from the previous release of CICS will require the operator to respond as to whether they get converted to the current release.
|
|
</li>
|
|
<li><b>*CVT:</b> Tables from the previous release of CICS will be automatically converted to the current release.
|
|
<p>Tables that are converted will cause a conversion of all groups contained in the tables.
|
|
</p>
|
|
</li>
|
|
<li><b>*NOCVT</b> Tables from the previous release of CICS will NOT be automatically converted to the current release.
|
|
<p>When the CICS system initialization table is from the previous release of CICS, then the CICS control region will not be started. All other tables will allow the CICS control region to be started, but the data in the tables will be ignored.
|
|
</p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="STRCICS.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="STRCICS.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRCICS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|