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

214 lines
7.6 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 GLT Entry (ADDCICSGLT)</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="ADDCICSGLT.Top_Of_Page"></a>
<h2>Add CICS GLT Entry (ADDCICSGLT)</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="#ADDCICSGLT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDCICSGLT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDCICSGLT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDCICSGLT"></a>
<p>Use the Add CICS Group List Table (ADDCICSGLT) command to add an entry to the GLT.
</p>
<p>Each resource definition must belong to a group and each group must belong to a group list. The GLT must itself be assigned to a group. The library and group of the GLT is specified in the SIT and will be used at system startup to select the required resource definitions.
</p>
<p>You can create more than one GLT, but each GLT must be assigned to a different group. Only the GLT named in the SIT will be used at system startup.
</p>
<p>At startup, each entry in the GLT is read and the resources installed from those groups, excluding the GLT and the SIT. If you want to install any resources belonging to the group named in the GLTGRP parameter of the SIT, then you must add the name of that group to its own GLT.
</p>
<p>Each GLT entry specifies:
</p>
<ul>
<li>The library name and group name of the GLT
</li>
<li>The library name and group name of a group to be installed at system startup.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDCICSGLT.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="#ADDCICSGLT.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="#ADDCICSGLT.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="#ADDCICSGLT.INSLIB"><b>INSLIB</b></a></td>
<td valign="top">Install library</td>
<td valign="top"><i>Communications name</i>, *LIBL, *CURLIB</td>
<td valign="top">Required, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#ADDCICSGLT.INSGRP"><b>INSGRP</b></a></td>
<td valign="top">Install group</td>
<td valign="top"><i>Communications name</i></td>
<td valign="top">Required, Positional 4</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDCICSGLT.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="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSGLT.GROUP"></a>
<h3>Group (GROUP)</h3>
<p>The name of the group to which the GLT 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="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSGLT.INSLIB"></a>
<h3>Install library (INSLIB)</h3>
<p>The name of the iSeries library that contains the group to be used when starting the control region. This is also known as the first part of the name of the GLT entry.
</p>
<p>
<b>Note: </b>When INSLIB(QCICS) is specified, then the INSGRP must be an IBM CICS group.
</p>
<p>The possible INSLIB values are:
</p>
<ul>
<li><b>*LIBL:</b> The library list for the job that is associated with the control region is used to locate the group.
</li>
<li><b>*CURLIB:</b> The current library for the job that is associated with the control region is used to locate 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 library where the group is located.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDCICSGLT.INSGRP"></a>
<h3>Install group (INSGRP)</h3>
<p>The group to be used when starting the control region, that contains the tables. This is also known as the second part of the name of the GLT entry.
</p>
<p>
<b>Note: </b>When INSLIB(QCICS) is specified, this must be one of the IBM groups.
</p>
<p>The following describes which group is used to install which optional supplied transactions:
</p>
<dl>
<dt><b>Group</b></dt>
<dd><b> Supplied Transaction
</b></dd>
<dt><b>AEGEDF</b></dt>
<dd>CEBR - Browse Temporary Storage Queues
</dd>
<dt><b>AEGEDF</b></dt>
<dd>CEDF - Execution Diagnostic Facility
</dd>
<dt><b>AEGINTER</b></dt>
<dd>CECI - Command-Level Interpreter Facility
</dd>
<dt><b>AEGINTER</b></dt>
<dd>CECS - Command-Level Syntax-Checking Facility
</dd>
<dt><b>AEGISC</b></dt>
<dd>CMPX - Local Queueing Shipper
</dd>
<dt><b>AEGISC</b></dt>
<dd>CPMI - Synchronization Level 1 Mirror Transaction
</dd>
<dt><b>AEGISC</b></dt>
<dd>CRSR - Relay Transaction
</dd>
<dt><b>AEGISC</b></dt>
<dd>CRTE - Transaction Routing
</dd>
<dt><b>AEGISC</b></dt>
<dd>CVMI - Synchronization Level 1 Mirror Transaction
</dd>
<dt><b>AEGOPER</b></dt>
<dd>CEMT - Master Terminal Facility
</dd>
<dt><b>AEGSPI</b></dt>
<dd>CEDA - Resource Definition On-Line Facility
</dd>
</dl>
<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="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDCICSGLT.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDCICSGLT.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDCICSGLT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>