342 lines
12 KiB
HTML
342 lines
12 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 JCT Entry (ADDCICSJCT)</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="ADDCICSJCT.Top_Of_Page"></a>
|
|
<h2>Add CICS JCT Entry (ADDCICSJCT)</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="#ADDCICSJCT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDCICSJCT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDCICSJCT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDCICSJCT"></a>
|
|
<p>Use the Add CICS Journal Control Table (ADDCICSJCT) command to add an entry to the JCT.
|
|
</p>
|
|
<p>When a file is defined in the FCT, you can specify whether or not activity on that file is to be journaled and also specify the id of the journal file. Journal files are identified by a number in the range 1 through 99. In the JCT, you define the characteristics of each journal file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDCICSJCT.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="#ADDCICSJCT.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="#ADDCICSJCT.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="#ADDCICSJCT.JFILE"><b>JFILE</b></a></td>
|
|
<td valign="top">Number</td>
|
|
<td valign="top">1-99</td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.JRNSTS"><b>JRNSTS</b></a></td>
|
|
<td valign="top">Status</td>
|
|
<td valign="top"><b><u>*ENABLED</u></b>, *DISABLED</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.JRNSWT"><b>JRNSWT</b></a></td>
|
|
<td valign="top">Automatic switching</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.JRNLIB"><b>JRNLIB</b></a></td>
|
|
<td valign="top">Journal Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.RECLMT"><b>RECLMT</b></a></td>
|
|
<td valign="top">Record capacity</td>
|
|
<td valign="top">1-99999, <b><u>1</u></b></td>
|
|
<td valign="top">Optional, Positional 7</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.NEWJRN"><b>NEWJRN</b></a></td>
|
|
<td valign="top">Switch journal at startup</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional, Positional 8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.USRJOB"><b>USRJOB</b></a></td>
|
|
<td valign="top">Submit user job when switched</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional, Positional 9</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.SBMUSRJOB"><b>SBMUSRJOB</b></a></td>
|
|
<td valign="top">Submit user job at shutdown</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional, Positional 10</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDCICSJCT.JRNFILE"><b>JRNFILE</b></a></td>
|
|
<td valign="top">File</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 11</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Journal Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#ADDCICSJCT.JRNMBR"><b>JRNMBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional, Positional 12</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDCICSJCT.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="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Enter the name of the group to which this JCT entry is to be added.
|
|
</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="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.JFILE"></a>
|
|
<h3>Number (JFILE)</h3>
|
|
<p>Enter the user journal number. This user journal can also be used for automatic journaling of file activity. The number is also used to identify this JCT entry.
|
|
</p>
|
|
<ul>
|
|
<li><b>journal:</b> A number in the range 1 through 99.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.JRNSTS"></a>
|
|
<h3>Status (JRNSTS)</h3>
|
|
<p>Indicates whether or not the journal number can be used.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*ENABLED: The journal number can be used.
|
|
</li>
|
|
<li><b>*DISABLED:</b> The journal number cannot be used.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.JRNSWT"></a>
|
|
<h3>Automatic switching (JRNSWT)</h3>
|
|
<p>Indicates whether or not the journal can be switched automatically, when it is full, to the next file generation
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*YES: The journal will be switched automatically when it is full.
|
|
</li>
|
|
<li><b>*NO:</b> The journal will not be switched automatically when it is full.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.JRNLIB"></a>
|
|
<h3>Journal Library (JRNLIB)</h3>
|
|
<p>The iSeries library name that will contain the journal. This field is valid only when the JRNSWT field contains *YES.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The iSeries file name that is used will be generated by the CICS control region. The iSeries file name is composed of the mask: AEGJC<b>nnxxx</b> where <b>nn</b> is the journal number and <b>xxx</b> is the generation number.
|
|
</p>
|
|
<ul>
|
|
<li><b>library-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="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.RECLMT"></a>
|
|
<h3>Record capacity (RECLMT)</h3>
|
|
<p>The number of records accumulated in order to switch to the next generation of the journal. This field is valid only when the JRNSWT field contains *YES.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>1: The journal is switched once one record is accumulated.
|
|
</li>
|
|
<li><b>number-of-records-per-file:</b> A number in the range 1 through 99999.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.NEWJRN"></a>
|
|
<h3>Switch journal at startup (NEWJRN)</h3>
|
|
<p>Indicates whether or not the journal will be switched to the next generation when the CICS control region is started. This field is valid only when the JRNSWT field contains *YES.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*NO: Switch only when the journal is full.
|
|
</li>
|
|
<li><b>*YES:</b> Switch when the CICS control region is started normally and when the journal is full.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.USRJOB"></a>
|
|
<h3>Submit user job when switched (USRJOB)</h3>
|
|
<p>The iSeries program that is submitted via the SBMUSRJOB CL command when the journal is switched. This field is valid only when the JRNSWT field contains *YES.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This iSeries submitted program will not accept any parameters and the program object must exist in the library list associated with the CICS control region.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*NONE: No iSeries job is submitted when the journal is switched.
|
|
</li>
|
|
<li><b>job-submit-when-switched:</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="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.SBMUSRJOB"></a>
|
|
<h3>Submit user job at shutdown (SBMUSRJOB)</h3>
|
|
<p>Indicates if the iSeries job will be submitted when the CICS control region ends. This is not valid when the USRJOB field contains *NONE.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*NO: Do not submit the iSeries job when CICS control region ends.
|
|
</li>
|
|
<li><b>*YES:</b> Submit the iSeries job when CICS control region ends.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.JRNFILE"></a>
|
|
<h3>File (JRNFILE)</h3>
|
|
<p>The name of the file that will be utilized by the journal number. This field is valid only when the JRNSWT field contains *NO.
|
|
</p>
|
|
<p>Possible library values are:
|
|
</p>
|
|
<ul>
|
|
<li>*LIBL: The library list for the job that is associated to the CICS control region is used to locate the file.
|
|
</li>
|
|
<li><b>*CURLIB:</b> The current library for the job that is associated to the CICS control region is used to locate the file. 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 file is located.
|
|
</li>
|
|
</ul>
|
|
<p><b>journal-name:</b> Specify the name of the file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSJCT.JRNMBR"></a>
|
|
<h3>Member (JRNMBR)</h3>
|
|
<p>The name of the member in the file that will be utilized by the journal number. This field is valid only when the JRNSWT field contains *NO.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li>*FIRST: No file member is specified. The first member in the file is used.
|
|
</li>
|
|
<li><b>journal-member-name:</b> Specify the name of the file member.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ADDCICSJCT.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ADDCICSJCT.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSJCT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|