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

1067 lines
36 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 SIT Entry (CHGCICSSIT)</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="CHGCICSSIT.Top_Of_Page"></a>
<h2>Change CICS SIT Entry (CHGCICSSIT)</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="#CHGCICSSIT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCICSSIT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCICSSIT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCICSSIT"></a>
<p>Use the Change CICS System Initialization Table (CHGCICSSIT) command to change the entry in the SIT.
</p>
<p>The System Initialization Table (SIT) is used to specify the initial startup conditions and control parameters for your system. 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).
</p>
<p>
<b>Note: </b>It should be understood that changes to the SIT can affect the performance and run-time characteristics of your CICS system. Changes made to a SIT entry should be well tested and understood before being put into a production environment.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCICSSIT.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="#CHGCICSSIT.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="#CHGCICSSIT.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="#CHGCICSSIT.GLTGRP"><b>GLTGRP</b></a></td>
<td valign="top">GLT group</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSSIT.WRKARASIZE"><b>WRKARASIZE</b></a></td>
<td valign="top">Common work area size</td>
<td valign="top">0-3584, <b><u>*SAME</u></b></td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSSIT.APPLID"><b>APPLID</b></a></td>
<td valign="top">Application</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, DBDCCICS</td>
<td valign="top">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSSIT.DATFORM"><b>DATFORM</b></a></td>
<td valign="top">Date format</td>
<td valign="top"><b><u>*SAME</u></b>, *MMDDYY, *DDMMYY, *YYMMDD</td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSSIT.DUMP"><b>DUMP</b></a></td>
<td valign="top">CICS system dumps allowed</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional, Positional 7</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGCICSSIT.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 8</td>
</tr>
<tr>
<td valign="top">Element 1: CICS device masking</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *DFT</td>
</tr>
<tr>
<td valign="top">Element 2: Autoinstall inactivity limit</td>
<td valign="top">
0-180000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 3: Device dependent suffixing</td>
<td valign="top">
<b><u>*SAME</u></b>, *DDS, *NODDS</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCICSSIT.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 9</td>
</tr>
<tr>
<td valign="top">Element 1: Maximum files left open</td>
<td valign="top">
0-32767, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Open file inactivity limit</td>
<td valign="top">
0-1440, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CHGCICSSIT.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 10</td>
</tr>
<tr>
<td valign="top">Element 1: Maximum trace buffer entries</td>
<td valign="top">
125-10000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Active at startup</td>
<td valign="top">
<b><u>*SAME</u></b>, *NO, *YES</td>
</tr>
<tr>
<td valign="top">Element 3: Wrapped when full</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top" rowspan="9"><a href="#CHGCICSSIT.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 11</td>
</tr>
<tr>
<td valign="top">Element 1: Active at startup</td>
<td valign="top">
<b><u>*SAME</u></b>, *NO, *YES</td>
</tr>
<tr>
<td valign="top">Element 2: Automatic switching</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *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>, <b><u>*SAME</u></b>, *NONE</td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *CURLIB</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>, <b><u>*SAME</u></b>, *NONE</td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CHGCICSSIT.USRTRC"><b>USRTRC</b></a></td>
<td valign="top">User trace active at startup</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional, Positional 12</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCICSSIT.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 13</td>
</tr>
<tr>
<td valign="top">Element 1: Age limit</td>
<td valign="top">
0-512, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Recover data</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top" rowspan="13"><a href="#CHGCICSSIT.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 14</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>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>*SAME</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>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>*SAME</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>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="13"><a href="#CHGCICSSIT.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 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">
7-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>*SAME</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>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>*SAME</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>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Extent size</td>
<td valign="top">
0-16000, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 3: Maximum extents</td>
<td valign="top">
0-32767, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCICSSIT.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 16</td>
</tr>
<tr>
<td valign="top">Element 1: Maximum active CICS shells</td>
<td valign="top">
1-32767, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Minimum active CICS shells</td>
<td valign="top">
1-32767, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCICSSIT.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 17</td>
</tr>
<tr>
<td valign="top">Element 1: ATI user profile</td>
<td valign="top">
<i>Simple name</i>, <b><u>*SAME</u></b>, *INVOKER</td>
</tr>
<tr>
<td valign="top">Element 2: Recover data</td>
<td valign="top">
<b><u>*SAME</u></b>, *YES, *NO</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSSIT.DSCOMP"><b>DSCOMP</b></a></td>
<td valign="top">Datastream compression</td>
<td valign="top"><b><u>*SAME</u></b>, *ALL, *NONE, 3270, 5250</td>
<td valign="top">Optional, Positional 18</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCICSSIT.TCPPORT"><b>TCPPORT</b></a></td>
<td valign="top">TCP port number</td>
<td valign="top">1-65535, <b><u>*SAME</u></b>, *NONE, *CICS</td>
<td valign="top">Optional, Positional 19</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCICSSIT.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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>Enter the name of the group containing the SIT entry to be changed.
</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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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 starting the CICS control region.
</p>
<p>Possible values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NONE:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>512:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>DBDCCICS:</b> This is the default VTAM application identifier to be used with the CICS control region.
</li>
<li><b>VTAM-application:</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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*MMDDYY:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*YES:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.DEVCTL"></a>
<h3>CICS device processing (DEVCTL)</h3>
<p>Enter the parameters used by the terminal control facility.
</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 are used to generate the CICS terminal 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 terminal identifier. For example, terminal mask = 0A5B, iSeries device name = XYZ1234567, CICS terminal identifier = XA3B.
</p>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*DFT:</b> The CICS terminal mask will consist of the last four non-blank characters of the iSeries device description.
</li>
<li><b>terminal-mask:</b> The maximum length is four characters. The characters can be alphanumeric or one of the special characters, $, @, or #.
<p><b>Element 2: Autoinstall inactivity limit</b>
</p>
<p>The amount of idle time after a CICS shell has ended, that the CICS autoinstall terminal is deleted. The format is <b>hhmmss</b>.
</p>
</li>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>hhmmss:</b> A number in the range 0 through 180000. When the value specified is a 0, then delete the autoinstall terminal as soon as the session is ended.
</li>
</ul>
<ul>
<p><b>Element 3:</b> Device dependent suffixing.
</p>
<p>Whether or not device dependent suffixing is enabled.
</p>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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 are left open to a CICS shell when a task ends.
</p>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>max-open:</b> A number in the range 0 through 32767. When the value specified is a 0, then an unlimited number of CICS files can be left open.
<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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>minutes:</b> A number in the range 0 through 1440 (24 hours). When the value specified is a 0, then there is no limit to the amount of time that a file can remain open without activity.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NO:</b> 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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*YES:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.AUXTRCCTL"></a>
<h3>Auxiliary trace processing (AUXTRCCTL)</h3>
<p>Enter the control parameters used by the auxiliary tracing facility in the CICS control region.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NO:</b> The trace is not active.
</li>
<li><b>*YES:</b> The 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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*YES:</b> 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 used by the auxiliary trace facility.
</p>
<p>Possible library values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*CURLIB:</b> 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>
<p>Possible file name values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NONE:</b> There is no iSeries user space utilized by the auxiliary trace facility.
</li>
<li><b>Aux-1-file:</b> Specify the name of the iSeries user space object.
</li>
</ul>
<p><b>Element 4: Auxiliary trace file 2</b>
</p>
<p>The name of the second iSeries user space that will be used by the auxiliary trace facility.
</p>
<p>
<b>Note: </b>This can not be the same as the iSeries user space object specified in Element 3 (Auxiliary trace file 1).
</p>
<p>Possible library values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*CURLIB:</b> 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>
<p>Possible file name values are:
</p>
<ul>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NONE:</b> There is no iSeries user space utilized by the auxiliary trace facility.
</li>
<li><b>Aux-2-file:</b> Specify the name of the iSeries user space object.
</li>
</ul>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NO:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.TSCTL"></a>
<h3>Temporary storage processing (TSCTL)</h3>
<p>Enter the control parameters used by the temporary storage facility.
</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 control region. Data that is older than the specified limit will not be recovered. The value is specified in days.
</p>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>temp-storage-age:</b> A number in range 0 through 512. When the value specified is a 0, then all data is to be recovered.
<p><b>Element 2: Recover Temporary Storage Queues</b>
</p>
<p>Indicates if the temporary storage queues are recovered during emergency restart of the CICS control region.
</p>
</li>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*YES:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>LSO-ext-sz:</b> A number in the range 0 through 16000.
<p><b>Element 3: LSO Maximum Extents</b>
</p>
<p>Maximum number of attempts allowed to extend the CICS LSO.
</p>
</li>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>LSO-exts:</b> A number in the range 0 through 32767.
<p><b>Element 4: System Size</b>
</p>
<p>Size of the CICS system space object stated in K bytes.
</p>
</li>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
</ul>
<p>Possible system storage requirement values are:
</p>
<ul>
<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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>Sys-exts:</b> A number in the range 0 through 32767.
<p><b>Element 7: User Size</b>
</p>
<p>Size of the CICS user space object stated in K bytes.
</p>
</li>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
</ul>
<p>Possible user storage requirement values are:
</p>
<ul>
<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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>user-ext-sz:</b> A number in the range 0 through 16000. 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>*SAME: Keep the value currently specified in the SIT entry.
</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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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 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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>LSO-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
<p>Possible system 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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>Sys-exts:</b> A number in the range 0 through 32767.
</li>
</ul>
<p>Possible user 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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.ITVCTL"></a>
<h3>Interval control processing (ITVCTL)</h3>
<p>Enter the parameters used by the interval control facility.
</p>
<p>Possible values are:
</p>
<ul>
<p><b>Element 1: Maximum active CICS shells</b>
</p>
<p>The maximum number of batch user shells to be used by interval control, that can be active at the same time.
</p>
<li>*SAME: Keep the value currently specified in the SIT entry.
</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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>btch-shell-min:</b> A number in the range 1 through the value of Element 1 (Batch Shell Maximum).
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.TDCTL"></a>
<h3>Transient data information (TDCTL)</h3>
<p>Enter the control parameters used by transient data facility
</p>
<p>Possible values are:
</p>
<p><b>Element 1: ATI user profile</b>
</p>
<p>The iSeries user profile to be associated with the transaction that is automatically initiated when the transient data trigger level is reached.
</p>
<ul>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*INVOKER:</b> Use the iSeries user profile that is associated with the CICS shell that caused the transient data trigger level to be reached.
</li>
<li><b>user-profile:</b> The 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 transient data queues are recovered during emergency restart of the CICS control region.
</p>
</li>
<li>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*YES:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the System Initialization Table entry.
</li>
<li><b>*ALL:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCICSSIT.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>*SAME: Keep the value currently specified in the SIT entry.
</li>
<li><b>*NONE:</b> 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="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCICSSIT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCICSSIT.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCICSSIT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>