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

1036 lines
35 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>Add CICS SIT Entry (ADDCICSSIT)</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="ADDCICSSIT.Top_Of_Page"></a>
<h2>Add CICS SIT Entry (ADDCICSSIT)</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="#ADDCICSSIT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDCICSSIT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDCICSSIT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDCICSSIT"></a>
<p>Use the Add CICS System Initialization Table (ADDCICSSIT) command to add an entry to the SIT.
</p>
<p>The System Initialization Table (SIT) is used to specify the initial startup conditions and control parameters for your system. An Add is not valid if SIT entry already exists for this group.
</p>
<p>Because only one set of conditions can apply to the system at any one time, only one SIT entry is allowed per group and per Group List Table (GLT). You can create as many SIT entries as you like, but each one must belong to a different group and a different GLT.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDCICSSIT.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="#ADDCICSSIT.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="#ADDCICSSIT.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="#ADDCICSSIT.GLTLIB"><b>GLTLIB</b></a></td>
<td valign="top">GLT library</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="#ADDCICSSIT.GLTGRP"><b>GLTGRP</b></a></td>
<td valign="top">GLT group</td>
<td valign="top"><i>Communications name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSSIT.WRKARASIZE"><b>WRKARASIZE</b></a></td>
<td valign="top">Common work area size</td>
<td valign="top">0-3584, <b><u>512</u></b></td>
<td valign="top">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSSIT.APPLID"><b>APPLID</b></a></td>
<td valign="top">Application</td>
<td valign="top"><i>Communications name</i>, <b><u>DBDCCICS</u></b></td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSSIT.DATFORM"><b>DATFORM</b></a></td>
<td valign="top">Date format</td>
<td valign="top"><b><u>*MMDDYY</u></b>, *DDMMYY, *YYMMDD</td>
<td valign="top">Optional, Positional 7</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSSIT.DUMP"><b>DUMP</b></a></td>
<td valign="top">CICS system dumps allowed</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional, Positional 8</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#ADDCICSSIT.DEVCTL"><b>DEVCTL</b></a></td>
<td valign="top">CICS device processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional, Positional 9</td>
</tr>
<tr>
<td valign="top">Element 1: CICS device masking</td>
<td valign="top">
<i>Character value</i>, <b><u>*DFT</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Autoinstall inactivity limit</td>
<td valign="top">
0-180000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Device dependent suffixing</td>
<td valign="top">
<b><u>*DDS</u></b>, *NODDS</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDCICSSIT.FILECTL"><b>FILECTL</b></a></td>
<td valign="top">File processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 10</td>
</tr>
<tr>
<td valign="top">Element 1: Maximum files left open</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Open file inactivity limit</td>
<td valign="top">
0-1440, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#ADDCICSSIT.INTTRCCTL"><b>INTTRCCTL</b></a></td>
<td valign="top">Internal trace processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional, Positional 11</td>
</tr>
<tr>
<td valign="top">Element 1: Maximum trace buffer entries</td>
<td valign="top">
125-10000, <b><u>125</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Active at startup</td>
<td valign="top">
<b><u>*NO</u></b>, *YES</td>
</tr>
<tr>
<td valign="top">Element 3: Wrapped when full</td>
<td valign="top">
<b><u>*YES</u></b>, *NO</td>
</tr>
<tr>
<td valign="top" rowspan="9"><a href="#ADDCICSSIT.AUXTRCCTL"><b>AUXTRCCTL</b></a></td>
<td valign="top">Auxiliary trace processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="9">Optional, Positional 12</td>
</tr>
<tr>
<td valign="top">Element 1: Active at startup</td>
<td valign="top">
<b><u>*NO</u></b>, *YES</td>
</tr>
<tr>
<td valign="top">Element 2: Automatic switching</td>
<td valign="top">
<b><u>*YES</u></b>, *NO</td>
</tr>
<tr>
<td valign="top">Element 3: Auxiliary trace A object</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Auxiliary trace A object</td>
<td valign="top"><i>Communications name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Communications name</i>, <b><u>*CURLIB</u></b></td>
</tr><tr>
<td valign="top">Element 4: Auxiliary trace B object</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Auxiliary trace B object</td>
<td valign="top"><i>Communications name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Communications name</i>, <b><u>*CURLIB</u></b></td>
</tr><tr>
<td valign="top"><a href="#ADDCICSSIT.USRTRC"><b>USRTRC</b></a></td>
<td valign="top">User trace active at startup</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 13</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDCICSSIT.TSCTL"><b>TSCTL</b></a></td>
<td valign="top">Temporary storage processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 14</td>
</tr>
<tr>
<td valign="top">Element 1: Age limit</td>
<td valign="top">
0-512, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Recover data</td>
<td valign="top">
<b><u>*YES</u></b>, *NO</td>
</tr>
<tr>
<td valign="top" rowspan="13"><a href="#ADDCICSSIT.SHRSTG"><b>SHRSTG</b></a></td>
<td valign="top">Shared storage information</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="13">Optional, Positional 15</td>
</tr>
<tr>
<td valign="top">Element 1: LSO storage requirements</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Size</td>
<td valign="top">
10-16000, <b><u>10</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: System storage requirements</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Size</td>
<td valign="top">
46-16000, <b><u>46</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: User storage requirements</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Size</td>
<td valign="top">
3-16000, <b><u>3</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="13"><a href="#ADDCICSSIT.NONSHRSTG"><b>NONSHRSTG</b></a></td>
<td valign="top">Nonshared storage processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="13">Optional, Positional 16</td>
</tr>
<tr>
<td valign="top">Element 1: LSO storage requirements</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Size</td>
<td valign="top">
7-16000, <b><u>7</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: System storage requirements</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Size</td>
<td valign="top">
7-16000, <b><u>7</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: User storage requirements</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Size</td>
<td valign="top">
5-16000, <b><u>5</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>0</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDCICSSIT.ITVCTL"><b>ITVCTL</b></a></td>
<td valign="top">Interval control processing</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 17</td>
</tr>
<tr>
<td valign="top">Element 1: Maximum active CICS shells</td>
<td valign="top">
1-32767, <b><u>5</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Minimum active CICS shells</td>
<td valign="top">
1-32767, <b><u>2</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDCICSSIT.TDCTL"><b>TDCTL</b></a></td>
<td valign="top">Transient data information</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 18</td>
</tr>
<tr>
<td valign="top">Element 1: ATI user profile</td>
<td valign="top">
<i>Simple name</i>, <b><u>*INVOKER</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Recover data</td>
<td valign="top">
<b><u>*YES</u></b>, *NO</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSSIT.DSCOMP"><b>DSCOMP</b></a></td>
<td valign="top">Datastream compression</td>
<td valign="top"><b><u>*ALL</u></b>, *NONE, 3270, 5250</td>
<td valign="top">Optional, Positional 19</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSSIT.TCPPORT"><b>TCPPORT</b></a></td>
<td valign="top">TCP port number</td>
<td valign="top">1-65535, <b><u>*NONE</u></b>, *CICS</td>
<td valign="top">Optional, Positional 20</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDCICSSIT.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="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Enter the name of the group to which this SIT entry is to be added.
</p>
<p><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 #.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.GLTLIB"></a>
<h3>GLT library (GLTLIB)</h3>
<p>Enter the name of the iSeries library that contains the group holding the group list table. This name is also used to identify this SIT entry.
</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="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.GLTGRP"></a>
<h3>GLT group (GLTGRP)</h3>
<p>Enter the name of the group that contains the group list table. All the groups specified in the group list table will be used when the CICS control region is started.
</p>
<p>Possible values are:
</p>
<ul>
<li>*NONE: No group list table will be 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="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.WRKARASIZE"></a>
<h3>Common work area size (WRKARASIZE)</h3>
<p>Enter the size of the Common Work Area (CWA) portion of the Common System Area (CSA).
</p>
<p>Possible values are:
</p>
<ul>
<li>512: The common work area is 512 bytes.
</li>
<li><b>CWA-size:</b> A number in the range 0 through 3584.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.APPLID"></a>
<h3>Application (APPLID)</h3>
<p>Enter the VTAM application identifier for the CICS control region.
</p>
<p>Possible values are:
</p>
<ul>
<li>DBDCCICS: This is the default VTAM application identifier to be used with the CICS control region.
</li>
<li><b>VTAM-application-id:</b> The VTAM application identifier 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="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.DATFORM"></a>
<h3>Date format (DATFORM)</h3>
<p>Indicates how the CICS control region system date is formatted when the EXEC CICS FORMATTIME command is issued.
</p>
<p>Possible values are:
</p>
<ul>
<li>*MMDDYY: Month, day, year.
</li>
<li><b>*DDMMYY:</b> Day, month, year.
</li>
<li><b>*YYMMDD:</b> Year, month, day.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.DUMP"></a>
<h3>CICS system dumps allowed (DUMP)</h3>
<p>Indicates whether or not a CICS control region dump can be taken.
</p>
<p>Possible values are:
</p>
<ul>
<li>*YES: CICS control region dumps can be taken.
</li>
<li><b>*NO:</b> CICS control region dumps can not be taken.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.DEVCTL"></a>
<h3>CICS device processing (DEVCTL)</h3>
<p>Enter the terminal control parameters.
</p>
<p>Possible values are:
</p>
<ul>
<p><b>Element 1: CICS device masking</b>
</p>
<p>Identifies which digits of the iSeries device name, as specified in the device identifier field of the TCT, are used to generate the terminal identifier when the user signs on to the CICS control region. The digits are identified by using an offset relative to zero, that is, 1 is the second digit of the iSeries device name.
</p>
<p>
<b>Note: </b>When one of the characters is not a number, then the character will be used in that position of the CICS terminal identifier. For example, terminal mask = 0A5B, iSeries device name = XYZ1234567, CICS terminal identifier = XA3B.
</p>
<li>*DFT: The terminal mask will consist of the last four non-blank characters of the iSeries device description.
</li>
<li><b>terminal-mask:</b> The terminal mask may have a maximum length of 4 characters. The characters can be alphanumeric or one of the special characters, $, @, or #.
</li>
</ul>
<ul>
<p><b>Element 2: Autoinstall inactivity limit</b>
</p>
<p>The amount of idle time after a shell has ended, that the autoinstall terminal is deleted. The format is <b>hhmmss</b>.
</p>
<li>0: Delete the autoinstall terminal as soon as the session is ended.
</li>
<li><b>hhmmss:</b> A number in the range 0 through 180000, that is up to 18 hours idle time.
</li>
</ul>
<ul>
<p><b>Element 3:</b> Device dependent suffixing.
</p>
<p>Whether or not device dependent suffixing is enabled.
</p>
<li>*DDS: Allow device dependent suffixing. BMS will always try to load a suffixed version of a map set. The suffix that is used will be determined in the following manner; If the transaction uses the alternate screen size, BMS will try to load a map version that has the alternate suffix. If the load fails (or the transaction does not use the alternate screen size) BMS tries to load a version that has a default map suffix. If this fails too, BMS tries to load the unsuffixed version.
</li>
<li>*NODDS: BMS is not to load suffixed versions of map sets. Specifying this option avoids the search for suffixed versions.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.FILECTL"></a>
<h3>File processing (FILECTL)</h3>
<p>Enter the parameters used by the file control facility.
</p>
<p>Possible values are:
</p>
<ul>
<p><b>Element 1: Maximum files left open</b>
</p>
<p>The maximum number of files that will be left open to a CICS shell at task end.
</p>
<li>0: An unlimited number of files can be left open.
</li>
<li><b>max-open:</b> A number in the range 0 through 32767.
<p><b>Element 2: Open file inactivity limit</b>
</p>
<p>The amount of time in minutes that a file can be left open with no activity.
</p>
</li>
<li>0: There is no limit to the amount of time that a file can remain open without activity.
</li>
<li><b>minutes:</b> A number in the range 0 through 1440 (24 hours).
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.INTTRCCTL"></a>
<h3>Internal trace processing (INTTRCCTL)</h3>
<p>Enter the control parameters used by the internal tracing facility.
</p>
<p>Possible values are:
</p>
<ul>
<p><b>Element 1: Maximum trace buffer entries</b>
</p>
<p>Maximum number of entries allowed in the internal trace buffer. The number entered here also controls the maximum number of entries in each auxiliary trace space object specified in the AUXTRCCTL optional parameter - elements 3 and 4.
</p>
<li>125: A maximum of 125 entries are allowed in the internal trace buffer.
</li>
<li><b>trace-buffer-entries:</b> A number in the range 125 through 10000.
<p><b>Element 2: Active at startup</b>
</p>
<p>Indicates whether or not the internal trace is active, when the CICS control region is started.
</p>
</li>
<li>*NO: Trace is not active.
</li>
<li><b>*YES:</b> Trace is active.
<p><b>Element 3: Wrapped when full</b>
</p>
<p>Indicates whether or not the internal trace should be wrapped when the internal trace buffer is full.
</p>
</li>
<li>*YES: The internal trace entries will be wrapped.
</li>
<li><b>*NO:</b> The internal trace is to be stopped.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.AUXTRCCTL"></a>
<h3>Auxiliary trace processing (AUXTRCCTL)</h3>
<p>Specified the control parameters used by the auxiliary tracing facility.
</p>
<p>Possible values are:
</p>
<ul>
<p><b>Element 1: Active at startup</b>
</p>
<p>Indicates whether or not the auxiliary trace is active when the CICS control region is started.
</p>
<li>*NO: The trace is not active.
</li>
<li><b>*YES:</b> Trace is active.
<p><b>Element 2: Automatic switching</b>
</p>
<p>Indicates what to do when the auxiliary trace user space is full.
</p>
</li>
<li>*YES: The trace user space is to be switched.
</li>
<li><b>*NO:</b> The auxiliary trace is to be stopped.
<p><b>Element 3: Auxiliary trace file 1</b>
</p>
<p>The name of the first iSeries user space object that will be utilized by the auxiliary trace facility.
</p>
<p>Possible library values are:
</p>
<ul>
<li>*CURLIB: The current library for the job that is associated with the CICS control region is used to locate the iSeries user space object. 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 library where the iSeries user space object is located.
</li>
</ul>
</li>
<li><b>Aux-trace1:</b> Specify the name of the iSeries user space object.
<p><b>Element 4: Auxiliary file 2</b>
</p>
<p>The name of the second iSeries user space that will be utilized by the auxiliary trace facility.
</p>
<p>
<b>Note: </b>This cannot be the same as the iSeries user space object specified in Element 3 (Auxiliary Trace 1).
</p>
<p>Possible library values are:
</p>
<ul>
<li>*CURLIB: The current library for the job that is associated to the CICS control region is used to locate the iSeries user space object. 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 library where the iSeries user space object is located.
</li>
</ul>
</li>
<li><b>Aux-trace2:</b> Specify the name of the iSeries user space object.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.USRTRC"></a>
<h3>User trace active at startup (USRTRC)</h3>
<p>Indicates whether or not user trace entries can be created when the CICS control region is started.
</p>
<p>Possible values are:
</p>
<ul>
<li>*NO: User trace entries will not be created.
</li>
<li><b>*YES:</b> User trace entries will be created.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.TSCTL"></a>
<h3>Temporary storage processing (TSCTL)</h3>
<p>Enter the parameters to be used by the temporary storage facility. During a warm start, all recoverable temporary storage queues are recovered.
</p>
<p>Possible values are:
</p>
<ul>
<p><b>Element 1: TS Age Limit</b>
</p>
<p>The age limit of temporary storage data used by the temporary storage recovery program during emergency restart of the CICS control region. Data that is older than the specified limit will not be recovered. The value is specified in days.
</p>
<li>0: All data is to be recovered.
</li>
<li><b>temp-storage-age:</b> A number in the range 0 through 512.
<p><b>Element 2: Recover Temporary Storage Queues</b>
</p>
<p>Indicates whether or not the temporary storage queues are recovered during emergency restart of the CICS control region.
</p>
</li>
<li>*YES: Recover temporary storage queues.
</li>
<li><b>*NO:</b> Do not recover temporary storage queues.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.SHRSTG"></a>
<h3>Shared storage information (SHRSTG)</h3>
<p>Enter the shared storage requirements.
</p>
<p>
<b>Note: </b>The maximum size that each of the three types of shared storage can be is 16,775,216. To calculate the maximum size add the following; the size * 1024, and the extent size * maximum extents * 1024.
</p>
<p>Possible LSO storage requirement values are:
</p>
<ul>
<p><b>Element 1: LSO Size</b>
</p>
<p>Size of the CICS local space object (LSO) stated in K bytes.
</p>
<li>10: CICS LSO will be defined with 10K bytes of storage.
</li>
<li><b>LSO-sz:</b> A number in the range 10 through 16000.
<p><b>Element 2: LSO Extent Size</b>
</p>
<p>Size of the CICS LSO extents stated in K bytes.
</p>
</li>
<li>0: CICS LSO will not be extended when it is filled.
</li>
<li><b>LSO-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 3: Maximum LSO Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS LSO.
</p>
</li>
<li>0: CICS LSO will not be extended when it is filled.
</li>
<li><b>LSO-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
<p>Possible system storage requirement values are:
</p>
<ul>
<p><b>Element 4: System Size</b>
</p>
<p>Size of the CICS system space object stated in K bytes.
</p>
<li>46: CICS system space object will be defined with 46K bytes of storage.
</li>
<li><b>Sys-sz:</b> A number in the range 46 through 16000.
<p><b>Element 5: System Extent Size</b>
</p>
<p>Size of the CICS system space object extents stated in K bytes.
</p>
</li>
<li>0: CICS system space object will not be extended with it is filled.
</li>
<li><b>Sys-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 6: Maximum System Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS system space object.
</p>
</li>
<li>0: CICS system space object will not be extended when it is filled.
</li>
<li><b>Sys-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
<p>Possible user storage requirement values are:
</p>
<ul>
<p><b>Element 7: User Size</b>
</p>
<p>Size of the CICS user space object stated in K bytes.
</p>
<li>3: CICS user space object will be defined with 3K bytes of storage.
</li>
<li><b>user-sz:</b> A number in the range 3 through 16000.
<p><b>Element 8: User Extent Size</b>
</p>
<p>Size of the CICS user space object extents stated in K bytes.
</p>
</li>
<li>0: CICS user space object will not be extended when it is filled.
</li>
<li><b>user-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 9: Maximum User Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS user space object.
</p>
</li>
<li>0: CICS user space object will not be extended when it is filled.
</li>
<li><b>user-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.NONSHRSTG"></a>
<h3>Nonshared storage processing (NONSHRSTG)</h3>
<p>Enter the non-shared storage requirements.
</p>
<p>
<b>Note: </b>The maximum size that each of the three types of non-shared storage can be is 16,775,216. To calculate the maximum size add the following; the size * 1024, and the extent size * maximum extents * 1024.
</p>
<p>Possible LSO storage requirement values are:
</p>
<ul>
<p><b>Element 1: LSO Size</b>
</p>
<p>Size of the CICS LSO stated in K bytes.
</p>
<li>7: CICS LSO will be defined with 7K bytes of storage.
</li>
<li><b>LSO-sz:</b> A number in the range 7 through 16000.
<p><b>Element 2: LSO Extent Size</b>
</p>
<p>Size of the CICS LSO extents stated in K bytes.
</p>
</li>
<li>0: CICS LSO will not be extended when it is filled.
</li>
<li><b>LSO-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 3: Maximum LSO Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS LSO.
</p>
</li>
<li>0: CICS LSO will not be extended when it is filled.
</li>
<li><b>LSO-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
<p>Possible System storage requirement values are:
</p>
<ul>
<p><b>Element 4: System Size</b>
</p>
<p>Size of the CICS system space object stated in K bytes.
</p>
<li>7: CICS system space object will be defined with 7K bytes of storage.
</li>
<li><b>Sys-sz:</b> A number in the range 7 through 16000.
<p><b>Element 5: System Extent Size</b>
</p>
<p>Size of the CICS system space object extents stated in K bytes.
</p>
</li>
<li>0: CICS system space object will not be extended when it is filled.
</li>
<li><b>Sys-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 6: Maximum System Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS system space object.
</p>
</li>
<li>0: CICS system space object will not be extended when it is filled.
</li>
<li><b>Sys-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
<p>Possible User storage requirement values are:
</p>
<ul>
<p><b>Element 7: User Size</b>
</p>
<p>Size of the CICS user space object stated in K bytes.
</p>
<li>5: CICS user space object will be defined with 5K bytes of storage.
</li>
<li><b>user-sz:</b> A number in the range 5 through 16000.
<p><b>Element 8: User Extent Size</b>
</p>
<p>Size of the CICS user space object extents stated in K bytes.
</p>
</li>
<li>0: CICS user space object will not be extended when it is filled.
</li>
<li><b>user-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 9: Maximum User Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS user space object.
</p>
</li>
<li>0: CICS user space object will not be extended when it is filled.
</li>
<li><b>user-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.ITVCTL"></a>
<h3>Interval control processing (ITVCTL)</h3>
<p>Enter the parameters used by interval control facility.
</p>
<p>Possible values are:
</p>
<p><b>Element 1: Maximum active CICS shells</b>
</p>
<ul>
<p>The maximum number of batch user shells to be used by interval control, that can be active at the same time.
</p>
<li>5: Five batch user shells can be active at the same time.
</li>
<li><b>btch-shell-max:</b> A number in the range 1 through 32767.
<p><b>Element 2: Minimum active CICS shells</b>
</p>
<p>The number of batch user shells to be used by interval control, that will remain active.
</p>
</li>
<li>2: Two batch user shells will always be active.
</li>
<li><b>btch-shell-min:</b> A number in the range 1 through the value of Element 1 (Maximum active CICS shells).
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.TDCTL"></a>
<h3>Transient data information (TDCTL)</h3>
<p>Enter the control parameters used by the transient data facility during an emergency restart. During a warm start, all recoverable transient data queues are recoverable.
</p>
<p>Possible values are: <b>Element 1: ATI User Profile</b>
</p>
<ul>
<p>The iSeries user profile to be associated with the transaction that is automatically initiated when the transient data trigger level is reached.
</p>
<li>*INVOKER: Use the iSeries user profile that is associated with the shell that caused the transient data trigger level to be reached.
</li>
<li><b>user-profile:</b> A user profile 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 #.
<p><b>Element 2: Recover data</b>
</p>
<p>Indicates whether or not the transient data queues are recovered during emergency restart of the CICS control region.
</p>
</li>
<li>*YES: Recover transient data queues.
</li>
<li><b>*NO:</b> Do not recover transient data queue.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.DSCOMP"></a>
<h3>Datastream compression (DSCOMP)</h3>
<p>Indicates the device types for which datastream compression is to be enabled.
</p>
<p>Possible values are:
</p>
<ul>
<li>*ALL: Specifies that datastream compression is to be enabled for all device types.
</li>
<li><b>*NONE:</b> Specifies that datastream compression is not to be enabled for any device types.
</li>
<li><b>3270:</b> Specifies that datastream compression is to be enabled for 3270 device types.
</li>
<li><b>5250:</b> Specifies that datastream compression is to be enabled for 5250 device types.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSSIT.TCPPORT"></a>
<h3>TCP port number (TCPPORT)</h3>
<p>Specifies if the CICS TCP/IP Listener should be started at control region startup, and if so, the TCP port that CICS Clients will use to connect to the listener.
</p>
<p>The possible values are:
</p>
<ul>
<li>*NONE: No CICS TCP/IP Listener is to be used.
</li>
<li><b>*CICS:</b> The CICS TCP/IP Listener is started at control region startup to allow CICS Clients to connect using TCP/IP with the port number specified in the IBM-CICS entry of the Service Table.
</li>
<li><b>TCP port number:</b> A number in the range of 1 through 65535. When a value is specified for this parameter, the CICS TCP/IP Listener is started at control region startup to allow CICS Clients to connect using TCP/IP with the specified port number.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDCICSSIT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDCICSSIT.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>