148 lines
9.9 KiB
HTML
148 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 lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<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))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="DRDA and DDM prestart jobs" />
|
|
<meta name="abstract" content="Server information that pertains to prestart jobs, such as the Display Active Prestart Jobs (DSPACTPJ) command, uses the term program start request exclusively to indicate requests made to start prestart jobs, even though the information might pertain to a prestart job that was started as a result of a TCP/IP connection request." />
|
|
<meta name="description" content="Server information that pertains to prestart jobs, such as the Display Active Prestart Jobs (DSPACTPJ) command, uses the term program start request exclusively to indicate requests made to start prestart jobs, even though the information might pertain to a prestart job that was started as a result of a TCP/IP connection request." />
|
|
<meta name="DC.subject" content="prestart jobs, using, stored procedure" />
|
|
<meta name="keywords" content="prestart jobs, using, stored procedure" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal1subsyss.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal1monitorprestart.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal1manageprestart.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal1removeprestart.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal1routing.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chgpje.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dspactpj.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbal1confddmsubs.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rbal1usepsj" />
|
|
<meta name="DC.Language" 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. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>DRDA and
|
|
DDM prestart jobs</title>
|
|
</head>
|
|
<body id="rbal1usepsj"><a name="rbal1usepsj"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">DRDA<sup>®</sup> and
|
|
DDM prestart jobs</h1>
|
|
<div><p>Server information that pertains to prestart jobs, such as the <span class="cmdname">Display
|
|
Active Prestart Jobs (DSPACTPJ)</span> command, uses the term <dfn class="term">program
|
|
start request</dfn> exclusively to indicate requests made to start prestart
|
|
jobs, even though the information might pertain to a prestart job that was
|
|
started as a result of a TCP/IP connection request.</p>
|
|
<div class="section"><p>The following list contains the prestart job entry attributes
|
|
with the initially configured value for the DDM TCP/IP server. They can be
|
|
changed with the <span class="cmdname">Change Prestart Job Entry (CHGPJE)</span> command.</p>
|
|
<ul><li>Subsystem Description. The subsystem that contains the prestart job entries
|
|
is QUSRWRK in V5R2. In earlier releases, it was QSYSWRK.</li>
|
|
<li>Program library and name. The program that is called when the prestart
|
|
job is started is QSYS/QRWTSRVR.</li>
|
|
<li>User profile. The user profile that the job runs under is QUSER. This
|
|
is what the job shows as the user profile. When a request to connect to the
|
|
server is received from a client, the prestart job function swaps to the user
|
|
profile that is received in that request.</li>
|
|
<li>Job name. The name of the job when it is started is QRWTSRVR.</li>
|
|
<li>Job description. The job description used for the prestart job is *USRPRF.
|
|
Note that the user profile is QUSER so this will be whatever QUSER's job description
|
|
is. However, the attributes of the job are changed to correspond to the requesting
|
|
user's job description after the userid and password (if present) are verified.</li>
|
|
<li>Start jobs. This indicates whether prestart jobs are to automatically
|
|
start when the subsystem is started. These prestart job entries are shipped
|
|
with a start jobs value of *YES. You can change these to *NO to prevent unnecessary
|
|
jobs starting when a system IPL is performed. <div class="note"><span class="notetitle">Note:</span> If the DDM server jobs
|
|
are not running and the DDM listener job is batch, immediate DDM server jobs
|
|
will still be run under the QSYSWRK subsystem.</div>
|
|
</li>
|
|
<li>Initial number of jobs. As initially configured, the number of jobs that
|
|
are started when the subsystem is started is 1. This value can be adjusted
|
|
to suit your particular environment and needs.</li>
|
|
<li>Threshold. The minimum number of available prestart jobs for a prestart
|
|
job entry is set to 1. When this threshold is reached, additional prestart
|
|
jobs are automatically started. This is used to maintain a certain number
|
|
of jobs in the pool.</li>
|
|
<li>Additional number of jobs. The number of additional prestart jobs that
|
|
are started when the threshold is reached is initially configured at 2.</li>
|
|
<li>Maximum number of jobs. The maximum number of prestart jobs that can be
|
|
active for this entry is *NOMAX.</li>
|
|
<li>Maximum number of uses. The maximum number of uses of the job is set to
|
|
200. This value indicates that the prestart job will end after 200 requests
|
|
to start the server have been processed. In certain situations, you might
|
|
need to set the MAXUSE parameter to 1 in order for the TCP/IP server to function
|
|
properly. When the server runs certain ILE stored procedures, pointers to
|
|
destroyed objects might remain in the prestart job environment; subsequent
|
|
uses of the prestart job would cause MCH3402 exceptions. In V5R2, changes
|
|
were made in <span class="keyword">i5/OS™</span> to minimize
|
|
this possibility.</li>
|
|
<li>Wait for job. The *YES setting causes a client connection request to wait
|
|
for an available server job if the maximum number of jobs is reached.</li>
|
|
<li>Pool identifier. The subsystem pool identifier in which this prestart
|
|
job runs is set to 1.</li>
|
|
<li>Class. The name and library of the class the prestart jobs will run under
|
|
is set to QSYS/QSYSCLS20.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section"><p>When the start jobs value for the prestart job entry has been
|
|
set to *YES, and the remaining values are as provided with their initial settings,
|
|
the following events happen for each prestart job entry: </p>
|
|
<ul><li>When the subsystem is started, one prestart job is started.</li>
|
|
<li>When the first client connection request is processed for the TCP/IP server,
|
|
the initial job is used and the threshold is exceeded.</li>
|
|
<li>Additional jobs are started for the server based on the number defined
|
|
in the prestart job entry.</li>
|
|
<li>The number of available jobs will not reach below 1.</li>
|
|
<li>The subsystem periodically checks the number of prestart jobs in a pool
|
|
that are unused and ends excess jobs. It always leaves at least the number
|
|
of prestart jobs specified in the initial jobs parameter.</li>
|
|
</ul>
|
|
<p>Server information that pertains to prestart jobs (such as the <span class="cmdname">Display
|
|
Active Prestart Jobs (DSPACTPJ)</span> command) will use the term program
|
|
start request exclusively to indicate requests made to start prestart jobs,
|
|
even though the information might pertain to a prestart job that was started
|
|
as a result of a TCP/IP connection request.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rbal1monitorprestart.htm">Monitor prestart jobs</a></strong><br />
|
|
Prestart jobs can be monitored by using the <span class="cmdname">Display Active
|
|
Prestart Jobs (DSPACTPJ)</span> command.</li>
|
|
<li class="ulchildlink"><strong><a href="rbal1manageprestart.htm">Manage prestart jobs</a></strong><br />
|
|
The information presented for an active prestart job can be refreshed by pressing the F5 key while on the Display Active Prestart Jobs display.</li>
|
|
<li class="ulchildlink"><strong><a href="rbal1removeprestart.htm">Remove prestart job entries</a></strong><br />
|
|
If you decide that you do not want the servers to use the prestart job function, you must follow the instructions in this topic.</li>
|
|
<li class="ulchildlink"><strong><a href="rbal1routing.htm">Routing entries</a></strong><br />
|
|
An <span class="keyword">i5/OS</span> job
|
|
is routed to a subsystem by using the routing entries in the subsystem description.
|
|
The routing entry for the listener job in the QSYSWRK subsystem is present
|
|
after <span class="keyword">i5/OS</span> is installed.
|
|
This job is started under the QUSER user profile, and the QSYSNOMAX job queue
|
|
is used.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal1subsyss.htm" title="These topics discuss DRDA/DDM server jobs.">DRDA/DDM server jobs</a></div>
|
|
</div>
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
|
<div><a href="rbal1confddmsubs.htm" title="By default, the DDM TCP/IP server jobs run in the QUSRWRK subsystem. Using iSeries Navigator, you can configure DDM server jobs to run all or certain server jobs in alternate subsystems based on the client's IP address.">Configure the DDM server job subsystem</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="../cl/chgpje.htm">Change Prestart Job Entry (CHGPJE) command</a></div>
|
|
<div><a href="../cl/dspactpj.htm">Display Active Prestart Jobs (DSPACTPJ) command</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |