207 lines
9.9 KiB
HTML
207 lines
9.9 KiB
HTML
|
<?xml version="1.0" encoding="utf-8"?>
|
||
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
||
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="dc.language" scheme="rfc1766" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<meta name="dc.date" scheme="iso8601" content="2005-10-17" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow"/>
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<title>Use of mode tables</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
||
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
|
||
|
|
|
||
|
|
<a name="modet"></a>
|
||
|
|
<h3 id="modet">Use of mode tables</h3>
|
||
|
|
<p>Modes describe session characteristics between the local and remote locations.
|
||
|
|
The use of modes over OptiConnect provides greater flexibility than standard
|
||
|
|
mode support over APPC. Modes over OptiConnect are invoked through a <span class="bold">mode table</span>. The mode table, QMTABLE, is not shipped with
|
||
|
|
OptiConnect and needs to be created if additional customization is required.</p>
|
||
|
|
<p>When subsystem QSOC is started, the QSOC library is checked to see if QMTABLE
|
||
|
|
exists. If QMTABLE does exist, the parameters will be used to start any OptiConnect
|
||
|
|
Agents. Otherwise, a default set of values are placed in storage.</p>
|
||
|
|
<p>To create the OptiConnect Mode table, type the following: </p>
|
||
|
|
<pre class="xmp">CALL QSOC/QYYCMUTL CREATE</pre><p class="indatacontent"> This creates the DDS source file QSOCDDS, with member QSOCDDS, and
|
||
|
|
a sample mode table QMSAMPLE in the QSOC library. The mode table QMTABLE can
|
||
|
|
be created by copying this sample table, or by using the DDS source file.
|
||
|
|
QMTABLE is a physical file and needs to reside in the QSOC library. You
|
||
|
|
can use data file utility (DFU) to alter this table, adding one entry for
|
||
|
|
each mode or location required.</p>
|
||
|
|
<p>For the Fastpath OptiConnect method, add the following entry: </p>
|
||
|
|
<a name="wq28"></a>
|
||
|
|
<div class="notetitle" id="wq28">Note:</div>
|
||
|
|
<div class="notebody">The ROUTING (entry) must always be QYYCDTSU to use the OptiConnect agents
|
||
|
|
that are supplied with QSOC. No entry is required in the mode table for ObjectConnect.</div>
|
||
|
|
<p> The mode table is searched each time an agent job is started (DDM target)
|
||
|
|
for a match against the keyed values. There are three keyed fields in QMTABLE:
|
||
|
|
<span class="bold">LCLLOC,</span> <span class="bold"> RMTLOC</span>, and <span class="bold">MODE.</span> The following priority scheme determines which table entry will
|
||
|
|
be used. The table is searched for the following:</p>
|
||
|
|
<ol type="1">
|
||
|
|
<li>Target system name extracted from network attributes (matched against
|
||
|
|
LCLLOC)</li>
|
||
|
|
<li>Source system name that was sent to the target system (matched against
|
||
|
|
RMTLOC)</li>
|
||
|
|
<li>Mode which was also sent to the target system (matched against the MODE
|
||
|
|
field)</li></ol>
|
||
|
|
<p>A specific value for the above three fields can be matched in the table
|
||
|
|
or '*ANY.' A specific value is always taken over '*ANY,' regardless of the
|
||
|
|
order of the entries in the table.</p>
|
||
|
|
<ol type="1">
|
||
|
|
<li>A specific LCLLOC match is taken over a specific RMTLOC or a specific
|
||
|
|
MODE.</li>
|
||
|
|
<li>A specific RMTLOC match is taken over a specific MODE.</li></ol>
|
||
|
|
<p></p>
|
||
|
|
<a name="wq31"></a>
|
||
|
|
<div class="notetitle" id="wq31">Note:</div>
|
||
|
|
<div class="notebody">The Fields column in the mode table is case sensitive and
|
||
|
|
all entries need to be in uppercase. <a href="rzau3modet.htm#mode">Table 2</a> shows the fields
|
||
|
|
and associated descriptions.</div>
|
||
|
|
<a name="mode"></a>
|
||
|
|
<table id="mode" width="100%" summary="" border="1" frame="border" rules="all">
|
||
|
|
<caption>Table 2. Fields in the Mode table</caption>
|
||
|
|
<thead valign="bottom">
|
||
|
|
<tr>
|
||
|
|
<th id="wq32" width="33%" align="left" valign="bottom">Field</th>
|
||
|
|
<th id="wq33" width="66%" align="left" valign="bottom">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody valign="top">
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">RMTLOC</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Remote location (from the server point of
|
||
|
|
view)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">LCLLOC</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Local location (from the server point of
|
||
|
|
view)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">MODE</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Mode description from DDM file</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBD</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Job description for the Agent job</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBDLIB</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Library for Agent job description</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBQ</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">OptiConnect agent job queue (*JOBD for value
|
||
|
|
from job description)</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBQLIB</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Library for OptiConnect Agent job queue</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">DFTUSER 1, 2</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Default user profile for OptiConnect agent
|
||
|
|
job
|
||
|
|
<ul>
|
||
|
|
<li>*NONE means run under same user profile as client job 1</li>
|
||
|
|
<li>*JOBD means use user profile from job description</li></ul></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">RCLRSC</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">*RCLRSC for disable reclaim resource (default)
|
||
|
|
<ul>
|
||
|
|
<li>*DDMCONV for disable reclaim DDM conversation</li>
|
||
|
|
<li>*BOTH for disable reclaim resource and reclaim DDM conversation</li>
|
||
|
|
<li>*NONE to enable both reclaim resource and reclaim DDM conversation
|
||
|
|
<a name="wq34"></a>
|
||
|
|
<div class="notetitle" id="wq34">Note:</div>
|
||
|
|
<div class="notebody">Disable means that OptiConnect conversations will not be reclaimed.</div></li></ul></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBPRIOR</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">*DYNAMIC for change agent job priority when
|
||
|
|
client job priority is changed (default)
|
||
|
|
<ul>
|
||
|
|
<li>*STATIC for change agent job priority when the agent job is started</li>
|
||
|
|
<li>*NONE for do not change agent job priority</li></ul></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">INIJOB 3</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">This is the minimum number of agent jobs
|
||
|
|
that are maintained in the agent job pool. This number includes both active
|
||
|
|
and available agent jobs.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">MINJOB 3</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">This is the minimum number of available agents
|
||
|
|
that are maintained in the agent job pool. As available agents become active
|
||
|
|
agents, the connection manager submits jobs to maintain the number of available
|
||
|
|
agent jobs.</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">USREXIT 4</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Program name - name of exit program if present
|
||
|
|
<ul>
|
||
|
|
<li>*OBJAUT for object authority checking only job priority is changed (default)</li>
|
||
|
|
<li>*REJECT to reject all connections agent job is started</li>
|
||
|
|
<li>*NETATR use DDM EXIT value from network attributes</li></ul></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">USREXITLIB</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Library for user exit program</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">CONJRNL</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Name of journal for connection journaling
|
||
|
|
<ul>
|
||
|
|
<li>*NONE for none.</li></ul></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">CONJRNLLIB</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Library for connection journaling</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">ROUTING</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Routing Data for Job</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBSTDLY</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">This value controls the rate at which prestart
|
||
|
|
jobs are started in milliseconds</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" headers="wq32">JOBENDDLY</td>
|
||
|
|
<td align="left" valign="top" headers="wq33">Allows the OptiConnect connection manager
|
||
|
|
to shutdown before all idle jobs have ended. This allows the customer to continue
|
||
|
|
with other operations; for example, backups. The remaining idle agents will
|
||
|
|
end at a rate of 1 per JOBENDDLY milliseconds.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
<p></p>
|
||
|
|
<ol type="1">
|
||
|
|
<li>The QSOC user profile must have *CHANGE authority to the user profile
|
||
|
|
with which the agent job is submitted. If this authority does not exist,
|
||
|
|
the agent job will not submit, and the client job will hang for two minutes
|
||
|
|
until it times out.</li>
|
||
|
|
<li>The DFTUSER field replaces the APPC attribute SECURELOC from standard
|
||
|
|
DDM security. This provides greater flexibility than standard DDM as the required
|
||
|
|
security can be set individually for each DDM file.</li>
|
||
|
|
<li>Prestart agents cannot be started, and minimum agents cannot be maintained,
|
||
|
|
if DFTUSER is set to *NONE.</li>
|
||
|
|
<li> The USREXIT field overrides the network attribute field DDMACC.</li></ol>
|
||
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
||
|
|
</body>
|
||
|
|
</html>
|